A command-line wrapper for diagrams and gloss so we can leverage them outside haskell.

The goal is to provide a good subset of features from both libraries.

See mindra-clj for an example of a client library. It talks to mindra via stdin/stdout using just formatted text.

Only the SVG backend is supported, and only a very small subset of diagrams is exposed. See svg-parser for what is supported and how the commands are parsed into diagram(s).

See mindra-clj-diagrams for some examples.

Most of the gloss features are supported. We should be able to use mindra for creating both static pictures and animations (with event handling!). See gloss-parser for what is supported and how the commands are parsed into gloss picture(s).

See mindra-clj-gloss for some examples.

Install:

brew install rorokimdim/brew/mindra

Upgrade:

brew upgrade mindra

Uninstall:

brew uninstall mindra

Binaries are available at releases.

No pre-built binaries available at this time. We will need to build from source using stack install or cabal install.

Install stack, clone this repository and run the following in repository directory.

stack install

A. Start mindra command

mindra

It should print READY INIT which means it is ready to receive the INIT (initialization) command.

B. Initialize it for either diagrams or gloss

For diagrams

Configure for SVG of size 300px by 400px:

INIT Diagrams SVG 300 400

Note: Each command should be followed by a blank line.

For gloss

Configure for a window of size 500px by 500px, at position 10px, 10px on the screen, with the title “My Title”, and white background color (red, green, blue, alpha values):

INIT Gloss
Window 500 500 10 10 "My Title"
Color 255 255 255 255

Note: Each command should be followed by a blank line.

C. Draw something

For diagrams

SVG Circle 100

For gloss

PICTURE Circle 100

Note: Each command should be followed by a blank line.

Hit ESC to close window.

1. Haskell
2. Diagrams and Gloss
3. All of these libraries and all the things they depend on

Due to limited licensed bands and the ever increasing traffic demands, the mobile communication industry is striving for offloading licensed bands traffic to unlicensed bands. A lot of challenges come along with the operation of LTE in unlicensed bands while co-locating with legacy Wi-Fi operation in unlicensed band. In this co-existing environment, it is imperative to identify the technologies so that an intelligent decision can be made for maintaining quality of service (QoS) requirement of users.

Next to this unlicensed co-existing environment, a second concern is the sharing of the licensed bands where DVB-T operates. This is called white space reuse. The reuse factor used in DVB-T systems leads to unused spectrum at a given location. Users can opt to use this spectrum if and only if no DVB-T transmission is present and they transmit using less power than TV broadcast stations. It is thus necessary to periodically sense if the spectrum is unused by the primary user or other secondary users. On the other hand the primary user, the TV broadcast stations, will want to detect if there is illegal use of their licensed spectrum at the time they want to use it.

Wireless technology identification can be implemented in multiple ways. We decided to use machine learning techniques, given many recent breakthroughs and success in other domains. Furthermore, it allows learning identifying wireless technologies on its own by giving it data. How we captured this data is described in the next section.

We consider two techniques for machine learning: one where we manually extract features using export knowledge and one where we give raw RSSI data to the machine learning model. The second technique exploits the autonomous feature learning capabilities of neural networks.

We manually extracted the following features:

• r0,r1,…,r19 are 20 intervals selected from the input histogram. r0 corresponds with the most left part of the histogram with frequency > 0, while r19 represents the most right part of the histogram with frequency > 0. Each interval thus contains 5% of the histogram and its value resembles the frequency of RSSI values within the corresponding interval.
• minR is the minimum RSSI value with frequency > 0 and thus the left boundary of the histogram.
• maxR is the maximum RSSI value with frequency > 0 and thus the right boundary of the histogram.
• nP is the measured amount of peaks in the histogram.
• wP is the width of the highest peak.
• stdHist is the standard deviation of the histogram values.
• stdData is the standard deviation of the RSSI values upon which the histogram is calculated.
• meanData is the mean of the RSSI values upon which the histogram is calculated.
• medianData is the median of the RSSI values upon which the histogram is calculated.

Manually feature extraction allows faster signal classification, but requires expert knowledge. The autonomous feature learning model is more flexible because it adapts to new situations given enough useful data. Using complex DNN models also allows slightly higher accuracy (98%) than manual feature selection methods (97%).

We used two datasets that are part of the eWINE project.

The first dataset, used for training, was captured at various locations in Ghent, Belgium. The dataset can be found here.

A second dataset, used for validation, was captured at Dublin, Ireland. The dataset can be found here.

The models for both manual and automatic feature extraction are present in manual feature extraction/rssilearningmanual.m and automatic feature learning/neuralnetworkautomatic.m respectively. Manual feature extraction uses the features as described before as input, while automatic feature extraction uses 256 RSSI values which are derived from 16 IQ samples per RSSI value. The neural network architecture of the manual model can be seen below.

For further information, you can contact me at jaron.fontaine@ugent.be.

This is the open source code for the old version of OutSystems Now. This version of OutSystems Now, brings your OutSystems experience to your mobile device, providing a fast way to access all your applications, including CRM, Customer Portal, or any other custom app built with the OutSystems Platform.

Note that this is a deprecated version of OutSystems Now and is no longer supported by OutSystems. You can find more details on the OutSystems Now website.

The source code is made available for you to create your own version of the application.

This way you can apply your own branding, such as the application name, logo and splash screens.

You can also have control over push notifications and enhance your business with a true mobile experience

You will need a Windows development environment such as Visual Studio 2013 and a Windows Store Developer account. You can submit the application to Windows Store if it complies with the store guidelines. The newly created application will be under your responsibility and should be supported by you.

You can clone (or fork) the repository or just download it as a zip file to have a local copy.

If you have not already have the development environment, download and install Microsoft Visual Studio in your computer. Open the CordovaApp.sln solution file (in the folder platforms\windows).

Open the GitHub source code in your development environment and you are ready to start building your own version of the application.

To learn more about the Windows development you can check out Windows Universal Apps guide.

Submitting your own Windows App to the Windows Store means that you need to reserve your app name first. This action will ensure that no one else uses the name. Learn how you can reserve your app name. After reserving you app name you need to change the display name. To change the display name of your app, follow the next instructions:

• In the Solution Explorer, double-click on the appxmanifest file of CordovaApp.Phone project

  • Select the Application tab
  • Change the Display name
  • Repeat these steps for the CordovaApp.Windows project

  

Now that you have changed the display name of your app, you need to associate your app with the app name that you initially reserved for Windows Store submission. To associate your app with the Store,follow the next instructions:

• In the Solution Explorer, right-click on the CordovaApp.Phone project

  • Select Store
  • Click on Associate App with the Store
  • Sign in to the Windows Phone Store
  • Select the App Name for your app
  • Associate your app
  • Repeat these steps for the CordovaApp.Windows project

  

In your Visual Studio project you can find all images related with the application logo and splash screen on the Visual Assets tab of the appxmanifest file of your CordovaApp projects. You will need several different image sizes due to the multitude of devices. You can find that images under the images folder (platforms > windows > images).

You will also want to customize the OutSystems logo image that appears on the first screen, where the user types the environment address. You can find that image (logo_original.png) under the img folder (platforms > windows > www > img). Replace it with an image with the same dimensions (530×80) and a transparent background. If you need help creating icons and splash screen, there are several websites, such as TiCons, that can help you generate all the necessary files.

To push notifications we suggest that you use a third-party service such as Pushwoosh or UrbanShip (paid services). These services simplify the whole process of pushing notifications and, better yet, they provide a single way of doing it for iOS, Android and Windows. No need to develop custom push mechanisms for each vendor. There are several other companies offering the same services and you can work with any of those if you wish. Most of them are paid services, so a subscription fee may be necessary.

To learn more about Push Notifications, check out the online information about Push notifications for Windows Phone.

To enable the deep linking feature on your own application you need to change the Application Protocol. Open the AppManifest file of the Windows Phone project and select the Declarations tab. Find the Protocol declaration and change both the Display Name and Name. Repeat these steps for the AppManifest file of the Windows 8.1 project.

Once you have your own version of the OutSystems Now application, you can distribute it. Learn how you can do it with the Publish Windows apps and games guide for Windows.

Step 1 : Planning Phase

• Build a mock app, or wireframae with pen and paper
• Once we exactly know what we are building , it will be easy
• Components
  • Header
    • Logo
    • Nav bar items (home , about us, cart)
  • Body component
    • Search
    • Restaurant Card Container
      • Restro Cards
        • name , star rating , cusines, delivery time
  • Footer
    • copyright
    • Links
    • Address
    • Contact

• our website is driven by data ( our web site is driven by configs)
• Controlling UI based on the Data coming
• Example : In swiggy , based on location the data changes and UI behaves accordingly

• whenever we use map we need to use the key
• IT takes a big performance hit , if we dont use keys
• React doesnt uniquely identify that items , so it will re render again all items , so we must use the keys whenever we use map in react
• • some devs will use index as a key . React says never use index as a key (anti-pattern)
• unique key (best practice)>>>> index as key >>>>>>> not using key (not acceptiable)

• export syntax : export default < componentName > //default export (1st type)

• import syntax : import < componentName > from < fileLocation >

• We cant write default export more than once , we should write only one default export

• By default a file can export only one thing

• To export multiple things we use names exports

  • just write export infront of that things ( export const CON_URL=”sdgfdg”)

  • How to import named export

    • import {CON_URL} from “../../utils/constants”; //example

• We should not keep any hardcoded data or anything in the component files
• We need to call in seperate files ( const.js or config.js or utils.js)

• REACT can do faster , efficient DOM manipulation

• useState – Hooks

  React Hook – A normal javascript function given to us by react , which is prebuilt ( utility function)

  Hooks In react

  • useState() – Gives the Super Powerful react state variables
    • import {useState} from “react”;
    • used to create State Variable
      • it maintains the state of the component
      • local state Variable scope is inside the component
      • const [restroList] = useState([//pass default value]); //Local state variable creation syntax by react
      • let restroList ; //noraml Js variable creation
    • To modify the restroList
      • by a function , the function comes as second parameter in the array
        • const [restroList , setRestroList]= useState([{Defaultdata}]);
  • useEffect()

  - React fber is ongoing reimplemntation of Reacts core algorithm

• Incremental Rendering : Ability to split the rendering work into chunks and spread out over multiple frames (React makes application faster)

  • On the UI we have a DOM
    • Suppose we have 7 restaurant cards
      • After filtering our Ui changes to 3 restaurant cards
        -When we have 7 restaurants cards at beginning , react creates a Virtual DOM (Represntation of an Actual DOM ) –> Javascript Object (React Virtual Dom)

  - *ReactFiber* It will calculate the Differnce between the objects when any event happens and calculate the result and update the DOM at every render cycle

• impoert {useEffect} from “react”;
• useEffect will take two arguments
  • 1st Arrow function( Call back function)
  • 2nd Dependency Array

• When will useEffect call back function called?

  • this call backfunction is called After our component renders
  • If we want something to be called after our page renders we use UseEffect

• when we fect the swiggy api , we are getting error
• Access to fetch at API’ from origin ‘http://localhost:1234‘ has been blocked by CORS policy
• What is CORS policy ? Who is blocking us ?
  • Our browsers block us from calling API from one origin to other origin
• How to bypass this cors ploicy error – Use CORS chrome exteniosn

• Shimmer UI is a technique for displaying loading states in web and mobile apps. It provides a FAKE PAGE the appearance of content that will eventually load, improving the user experience by providing visual feedback and reducing perceived wait times
• We make user psychologocly better
• when we load a page , we see a blank cards and eventually they will filled with data

• const [btn, setbtn] = useState(‘Click me’);
• btn: This is the state variable that holds the current state value.
• setbtn: This is the state updater function. You call this function to update the state value of btn. When you call setbtn, React will re-render the whole component again with the new state value.
  • Do you know?
    • Many developers have doubt that How const state variable is updated , when it is constant?
    • Answer : When we are using state setter it is re rendering the whole component , so the old const variable is not same , as it is totally rerendered it is actg like new variable , so it will update the value adn refernce and will re render

• and it will updatge only the portion required

• Never Use anchor tag in react to navgiate through pages , beacuase anchor tag will rerender the whole page again when navigated

• Install @reduxjs/toolkit and react-redux
• Build our Redux store
• Connect our store to our App (React and redux bridge)
• Create a slice (cart slice)
• When we click on add button –> Dispatch an action
• Selector

Easy to use health check for your FastAPI. This is the root module that will let you add implement and expand your usage of health checks, with FastAPI.

This module does not contain any service checkers, but you can easily add them. The other modules are not in this root module due to different dependencies required for each one. This is made so you only bring in the packages that you need to not add extra packages.

pip install fastapi-healthcheck or poetry add fastapi-healthcheck

Here is what you need to get started.

from fastapi import FastAPI
from fastapi_healthcheck import HealthCheckFactory, healthCheckRoute
from fastapi_healthcheck_sqlalchemy import HealthCheckSQLAlchemy

app = FastAPI()

# Add Health Checks
_healthChecks = HealthCheckFactory()

# SQLAlchemy comes from fastapi-healthcheck-sqlalchemy
_healthChecks.add(HealthCheckSQLAlchemy(alias='postgres db', connectionUri=cs.value, table=SmtpContactsSqlModel, tags=('postgres', 'db', 'sql01')))

# This will check external URI and validate the response that is returned.
# fastapi-healthcheck-uri
_healthChecks.add(HealthCheckUri(alias='reddit', connectionUri="https://www.reddit.com/r/aww.json", tags=('external', 'reddit', 'aww')))
app.add_api_route('/health', endpoint=healthCheckRoute(factory=_healthChecks))

When you request your health check, it will go and check all the entries that have been submitted and run a basic query against them. If they come back as expected, then a status code is 200. But if it runs into an error, it will return a 500 error.

{
    "status":"Healthy",
    "totalTimeTaken":"0:00:00.671642",
    "entities":[
        {
            "alias":"postgres db",
            "status":"Healthy",
            "timeTaken":"0:00:00.009619",
            "tags":["postgres","db","sql01"]
        },
        {
            "alias":"reddit",
            "status":"Unhealthy",
            "timeTaken":"0:00:00.661716",
            "tags":["external","reddit","aww"]
        }
    ]
}

• fastapi_healthcheck_sqlalchemy
• fastapi_healthcheck_uri
• fastapi_healthcheck_mongodb

If you have made a public service module and want to see it on this list, please open a new issue so we can add it to the list.

You can easily expand on this core module to add other health checks for other services. Generate a new service that pulls in HealthCheckInterface and HealthCheckBase. With those, you can build the respective class around the interface.

Once you have your service ready to go, add it to the HealthCheckFactory, and let the testing start.

If you would like to see an example of a custom service see fastapi_healthcheck_sqlalchemy. This will give you a better example of what you need to do to create your own module to interface with healthcheck.

Forms – An amazing Forms component for Laravel.

The Forms package lets you generate forms as well as fields with standard make commands. Inside your forms for models you can specify the fields that need to be generated and then simply pass the form to the view. No more writing html forms, error handling etc. It can handle Eloquent relationships and easily work with ajax requests for more dynamic form submissions.

• Matt Lantz (@mattylantz, mattlantz at gmail dot com)

1. PHP 8.2+
2. OpenSSL

Start a new Laravel project:

composer create-project laravel/laravel your-project-name

Then run the following to add Forms

composer require "grafite/forms"

Time to publish those assets!

php artisan vendor:publish --provider="Grafite\Forms\FormsProvider"

https://docs.grafite.ca/utilities/forms

The package was renamed in version 3 to 4. This means that the following would need to be changed on your code base:

form-maker.php -> forms.php

Grafite\FormMaker -> Grafite\Forms

@formMaker -> @forms

<x-fm></x-fm> -> <x-f></x-f>

<x-fm-action></x-fm-action> -> <x-f-action></x-f-action>

<x-fm-delete></x-fm-delete> -> <x-f-delete></x-f-delete>

<x-fm-search></x-fm-search> -> <x-f-search></x-f-search>

js.hcaptcha.com cdn.jsdelivr.net

Forms is open-sourced software licensed under the MIT license

Please add as many details as possible regarding submission of issues and feature requests

THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

The theme is based on Bootstrap3. And it is built with HTML5, CSS and jQuery with proper use of google rich-snippets markup.

• Boxed
• Full Width

• Colours better, but we need the nav link text not to be orange -just white, hover pale blue
• Can we the links be made up of a smaller dark blue box inside the nav (like the reference site)
• The mini logo isn’t working as it’s tiny. It should be text (eg Choose a currency…) until you scroll down, and when nav becomes sticky we replace that text with the mini logo (but much bigger than you have it right now.
• The posted by text at the top of the article wants to be viewed by user as continuous text eg. “Posted by John Cameron on February 17, 2017 in AUD, GBP, GBP to AUD.” but in code each will be inside schema.
• Can you make the related posts at bottom exactly the same format at the ones on the side column?
• The rates scroller at bottom needs to be width of container not full-width. Also it doesn’t scroll anymore?

#Final Changes

• The side image banners, are they the same size as the Torfx ad on the Future Currency website? Reason being, I want the side column width to be same as the ads.
• Can we use a better style on the Exchange Rates UK logo eg: [http://www.exchangerates.org.uk/info-currency-news-item-2017.php?id=17463]
• the last share buttons drops below up on narrower desktop view, once you scroll past them (ie they become sticky)
• The footer links, can we make them like [http://www.exchangerates.org.uk/info-currency-news-item-2017.php?id=17463]
• Related posts, this is still not quite right

#Final Changes 1

• the related posts at bottom, there will be no image as the text is taking up too much space. Any ideas?
• can we lose the icon/bottom border under the side bar headings (eg Exchange Rate Calc) and can the margins be so that the headings start further to the left so the text lines up with the text underneath?

Simple Line Icons [http://simplelineicons.com/].

Bootstrap 3 [http://getbootstrap.com/]

Owl Carousel 2 [https://owlcarousel2.github.io/OwlCarousel2/]

Sticky JS [http://stickyjs.com/]

You’re can not use this theme in your personal and private projects. Only ExchangeRatesUK.org.uk hold the copyright for this project.

中文文档

RSSBud can help you quickly discover and subscribe to RSS feeds from websites or apps, especially those provided by RSSHub. It supports the parameters feature of RSSHub which facilitates extra functionalities such as filtering by feed content and full text fetching.

Telegram Group

• Detects RSS feeds in web pages
• Detects RSSHub feeds applicable for web pages (supports almost all rules of RSSHub Radar)
• Detects other RSS feeds applicable for web pages (powered by RSSBud Rules)
• Optimized for mobile environment (automatically expands URLs and adapts to common mobile sub-domains)
• Share sheet extension
• Quick subscription to Reeder, Fiery Feeds, Ego Reader, and system default RSS reader
• Quick subscription to Tiny Tiny RSS, Miniflux, Fresh RSS, Feedly, Inoreader, Feedbin, The Old Reader, Feeds Pub
• Parameter editor for RSSHub feeds
• Rules kept up-to-date automatically
• Customizable remote rules files
• Simultaneously matches against multiple rules files
• RSSHub access control (automatically generates MD5 access code)
• Supports x-callback-url; can be used in “Shortcuts” app to facilitate a variety of powerful functions (see Shortcut Workshop and Scheme)

If RSSBud doesn’t support your RSS reader/service, or you want to integrate RSSBud into your workflow, you can write shortcuts utilizing RSSBud’s support for x-callback-url to fulfill your needs. Let’s start with the following ones!

RSSBud Starter Shortcut by cayZ | A template for RSSBud related shortcuts that sets up the variables and supports share sheets.

Analyze with RSSBud and Send with Telegram by cayZ | Send RSSBud analysis results to Telegram with customizable message template and recipient.

Analyze with RSSBud and Subscribe with Pocket Casts by cayZ | Send RSSBud analysis results to Pocket Casts (podcast RSS only).

Scan QR and Analyze with RSSBud by cayZ | Get URL from scanned QR code and analyze with RSSBud.

If you think you’ve got an idea of a shortcut that can benefit a larger audience, you’re welcomed to submit an issue!

RSSBud has implemented the x-callback-url protocol, which provides a standardized means for iOS developers to expose and document the methods they make available to other apps via custom URL schemes.

You can open the following URL to let RSSBud analyze the provided URL and return the RSS feed chosen by the user:

rssbud://x-callback-url/analyze?url[&x-callback-parameters...]

• url The URL you want RSSBud to analyze

• feed_title The name of the RSS feed chosen by the user
• feed_url The URL of the RSS feed chosen by the user

If you happen use both RSSBud and PopClip on macOS, here’s a handy extension that can be used to analyze selected URLs with RSSBud. Simply select everything in the code block below and you will see an option to install the extension in PopClip.

#popclip
name: RSSBud
icon: iconify:ph:rss-bold
url: rssbud:///analyze?url=***

The core functionality of RSSBud comes from RSSBud Core, a sub-project written in JavaScript. The code is mainly referenced from RSSHub Radar.

Make sure you have Node.js installed before you build with Xcode.

If you wish to use the action extension, please set up your own App Group in both the iOS and Action Extension targets and modify RSSBud.appGroupIdentifier accordingly.

RSSBud’s functionality is largely powered by rules from two open-source projects. Please consider contributing to the appropriate rules if a particular feed can’t be discovered by RSSBud.

• RSSHub Radar Rules are created and maintained by the RSSHub community. They are used to discover RSSHub feeds.

  Submit new RSSHub Radar rules

• RSSBud Rules are a superset of RSSHub Radar rules. The extended schema allows non-RSSHub feeds (e.g. official RSS feeds that are not discoverable by parsing HTML) to be discovered. Please consider contributing to RSSHub Radar rules first if the feed is an RSSHub feed.

  Submit new RSSBud rules

• RSSHub Radar by DIYgod (Browser extension)
• RSSAid by Leetao (Flutter)

RSSBud is made by cayZ and is open-source under the MIT License.

This repository contains my personal solutions to LeetCode problems, written in Java, JavaScript, SQL, and pandas.

All solution files are kept directly in the root of the repository. Each file is named after the problem it solves, often including the problem number and a descriptive title.

• ✅ Solutions to a wide range of LeetCode problems
• ✅ Java (.java), JavaScript (.js), SQL (.sql), and pandas (.py) code
• ✅ Clear, readable implementations
• ✅ Covers various topics such as arrays, strings, trees, dynamic programming, recursion, SQL queries, and data manipulation with pandas

• All solution files are in the root directory.
• File naming: {problem-number}-{problem-title}.{js|java|sql|py} (e.g., 1-two-sum.java, 2-add-two-numbers.js, 175-combine-two-tables.sql, 1876-substrings-of-size-three-with-distinct-characters.py)
• No subfolders for topics or languages.

• Java:
  Compile and run using:

  javac ProblemFileName.java
  java ProblemFileName

• JavaScript:
  Run using Node.js:

  node ProblemFileName.js

• SQL:
  Run in your preferred SQL environment (e.g., MySQL, PostgreSQL, LeetCode’s online editor).
• pandas (Python):
  Run using Python 3:

  python ProblemFileName.py

This repository serves as a personal reference for:

• Practicing coding problems
• Reviewing core data structures and algorithms
• Preparing for coding interviews

Contributions are welcome!
If you’d like to add a new solution or improve an existing one:

• Fork the repository
• Add your solution in the root directory
• Use the existing naming convention
• Open a pull request

Check out my LeetCode submissions and progress:
👉 https://leetcode.com/Sanjay3005v

Sanjay V
📧 sanjay3005v@gmail.com
🔗 GitHub | LinkedIn

Feel free to star ⭐ the repository if you find it useful!

macSKKはmacOS用のSKK方式の日本語入力システム (インプットメソッド) です。

macOS用のSKK方式の日本語入力システムにはすでにAquaSKKがありますが、いくつか独自の機能を作りたいと思い新たに開発しています。

macSKKを使用するには macOS 13.3 (Ventura) 以降が必要です。
Universal Binary (Apple Silicon & Intel Mac) でビルドしていますが、動作確認はApple Silicon環境でのみ行っています。

• 日本語入力システムはパスワードなどの機密情報を処理する可能性があるため安全性が求められるプログラムです。そのためmacSKKはmacOSのSandbox機構を使いネットワーク通信やファイルの読み書きに制限をかけることでセキュリティホールを攻撃されたときの被害を減らすように心掛けます。
• 不正なコードが含まれるリスクを避けるため、サードパーティによる外部ライブラリは使用していません。
• すべてをSwiftだけでコーディングしており、イベント処理にCombineを、UI部分にはSwiftUIを使用しています。
• 単語登録モードや送り仮名入力中などキー入力による状態変化管理が複雑なのでユニットテストを書いてエンバグのリスクを減らす努力をしています。

しばらくはAquaSKKにはあるけどmacSKKにない機能を実装しつつ、徐々に独自機能を実装していこうと考えています。

• 複数辞書を使用できるようにする
• マイ辞書に保存しないプライベートモード
• アプリごとに直接入力させるかどうかを設定できるようにする
  • ddskkを使っているときのGUI版Emacs.appなど
• 過去の入力を使った入力補完
• 数値変換
• 送りありエントリのブロック形式
• キー配列の設定 (Dvorakなど)
• ローマ字変換ルールの設定
• SKKServを辞書として使う
• キーバインドの変更
• Java AWT製アプリケーションで入力ができない問題のワークアラウンド対応 (JetBrain製品など)

• 自動更新確認
  • Network Outgoingが可能なXPCプロセスを作成し、GitHub Releasesから情報を定期的に取得して新しいバージョンが見つかったらNotification Centerに表示する
• 辞書のJSON形式への対応
• xterm.jsを利用するアプリケーションでaiueoでひらがなが入力できない問題のワークアラウンド対応 (VSCode Terminal, Hyperなど)
• iCloudにマイ辞書を保存して他環境と共有できるようにする
• マイ辞書の暗号化
  • 編集したい場合は生データでのエクスポート & インポートできるようにする

2023年現在、Mac App Storeでは日本語入力システムを配布することができないため、Appleのソフトウェア公証を受けたアプリケーションバイナリをGitHub Releasesで配布しています。dmgファイルをダウンロードしマウントした中にあるpkgファイルからインストールしてください。

もしHomebrew Caskでインストールしたい場合は、 brew install --cask macskk でインストールできます。詳しくは https://formulae.brew.sh/cask/macskk を参照してください。

また独自Cask定義 brew install --cask mtgto/macskk/macskk でもインストールできます。Homebrew公式との違いとしてはこちらはGitHub Actionsで作業を自動化しているのでリリース直後にすぐ反映されます。詳しくは https://github.com/mtgto/homebrew-macSKK を参照してください。

macSKKのインストール後に、システム設定→キーボード→入力ソースから「ひらがな」(アイコンは▼あ)と「ABC」(アイコンは▼A)を追加してください。カタカナ、全角英数、半角カナは追加しても追加しなくても問題ありません。
もしインストール直後に表示されなかったり、バージョンアップしても反映されない場合はログアウト & ログインを試してみてください。

SKK辞書は ~/Library/Containers/net.mtgto.inputmethod.macSKK/Data/Documents/Dictionaries に配置してください。まずは https://github.com/skk-dev/dict の SKK-JISYO.L から使ってみるとよいでしょう。
その後、macOSメニューバーの入力メニュー→環境設定を開き、辞書設定で使用する辞書を有効に切り替えてください。EUC-JPでないエンコーディングの場合はiボタンからエンコーディングを切り替えてください。現在はEUC-JP (EUC-JIS-2004を含む) とUTF-8に対応しています。辞書ファイルの形式はYAML形式、JSON形式なども提案されていますが現在はJSON形式のみ対応しておりYAML形式には未対応です。

辞書の削除は上記フォルダから辞書ファイルをゴミ箱に移動するかファイルを削除してください。macSKKが自動で無効化します。

ユーザー辞書は ~/Library/Containers/net.mtgto.inputmethod.macSKK/Data/Documents/Dictionaries/skk-jisyo.utf8 にUTF-8形式で保存されます。
ユーザー辞書はテキストエディタで更新可能です。別プロセスでユーザー辞書が更新された場合はmacSKKが自動で再読み込みを行います。

macSKKが入力メソッドとして選択されているときに入力メニューから「設定…」でGUIの設定画面を開くことができます。またプライベートモードのように入力メニューから直接有効・無効を切り替えるものがあります。

設定は Plist 形式で ~/Library/Containers/net.mtgto.inputmethod.macSKK/Data/Library/Preferences/net.mtgto.inputmethod.macSKK.plist に保存されます。

有効な辞書で有効な読みが見つからない場合、単語登録モードに移行します。

例として “あああ” で変換しようとしても辞書になかった場合 [登録：あああ] のようなテキストが表示されます。

この状態でテキストを入力しEnterすることでユーザー辞書にその読みで登録されます。漢字変換も可能ですが単語登録モードで変換候補がない変換が行われた場合は入力されなかったと扱い、入れ子で単語登録モードには入れなくなっています。

単語登録モードでのみ C-y でクリップボードからペーストできます (AquaSKKと同様です)。通常のペーストコマンド Cmd-v はアクティブなアプリケーションに取られて利用できないため、特殊なキーバインドにしています。

単語登録をしない場合はEscキーや C-g でキャンセルしてください。

変換候補が選択されている状態で Shift-x を入力すると (よみ) /(変換結果)/ を削除します(yes/no) という表示に切り替わります。この状態でyesと入力してenterするとユーザー辞書から選択していた変換候補を削除します。noを選んだり Escキーや C-g でキャンセルした場合には何も行いません。

現状は選択されている変換候補がユーザー辞書にない場合は 削除します(yes/no) という表示を行いますが、実際には何も行いません(ユーザー辞書以外を書き換えたくないため)。将来は他辞書からの削除ができるような対応をするかもしれませんが現在は未定です。

入力中、ユーザー辞書にある送りなし変換エントリから先頭が一致する変換履歴がある場合、入力テキストの下部に候補を表示します。タブキーを押すことで表示されているところまで入力が補完されます。

現在、補完の対象となるのはユーザー辞書の送りなしエントリだけです。

辞書に “だい# /第#0/第#1/” のように、読みに”#”、変換候補に “#(数字)” を含むエントリは数値変換エントリです。

macSKKではタイプ0, 1, 2, 3, 8, 9に対応しています。
数値として使えるのは0以上2^63-1 (Int64.max) までです。

ユーザー辞書に追加される変換結果は “だい# /第#0/” のように実際の入力に使用した数値は含まない形式で追加されます。

デフォルトではQWERTY配列になっていますが、設定画面からキー配列を変更できます。

システムで有効なキー配列のうち、英語用のキー配列のみを選択リストに表示しています。

qやlやCtrl-jなど、SKKで使用されるキーバインドを変更できます。
変更するには、設定画面のキーバインドからデフォルトのキーバインドのセットを複製してから修正してください。

もしおかしな挙動だったり、設定にはないような特殊なキーバインドを希望したい場合はIssueでお知らせください。

どのキーを入力したときにどのような文字に変換するかをカスタマイズすることができます。
例えばローマ字入力表のカスタマイズもできますが、それ以外でも句読点としてカンマやピリオドを入力するように設定したり、全角で入力したい記号を設定することができます。

~/Library/Containers/net.mtgto.inputmethod.macSKK/Data/Documents/Settings/kana-rule.conf にファイルを置くことで、ローマ字テーブルの変更や記号入力をカスタマイズすることができます。

上記のパスにファイルがない場合、もしくは正常に読み込めなかった場合は ~/Library/Input Methods/macSKK.app/Contents/Resources/kana-rule.conf がデフォルトで使用されます。
カスタマイズしたい際はmacSKK.app内にある kana-rule.conf ファイルもしくは https://github.com/mtgto/macSKK/blob/main/macSKK/kana-rule.conf を元にカスタマイズするのがよいでしょう。
設定ファイルの変更を監視しているため更新されたら即座に反映されます。

ローマ字変換ルール設定ファイルはUTF-8 + LF (BOMなし) で作成してください。
簡単な使い方はデフォルトファイルにもあるので参照してみてください。

ファイルを配置したのに反映されない場合はConsole.appでエラーが出てないか確認してみてください。
ローマ字変換定義ファイルの XX 行目の記述が壊れているため読み込みできません のようなログが出ているかもしれません。
正常に読み込めている場合は 独自のローマ字かな変換ルールを適用しました というログが出力されます。

現在制限として、カタカナや半角カナモードでの文字をひらがなモードでの文字と異なる文字を使用する場合、未確定入力中はカタカナでも半角カナでもひらがなのルールが使用されてします。

例えば a,あ,か,ｻ という設定がある状態で a を入力した場合はこうなります。

プライベートモードが有効なときは変換結果がユーザー辞書に反映されません。ユーザー辞書以外の辞書やプライベートモードを有効にする前のユーザー辞書の変換候補は参照されます。

プライベートモードの有効・無効は入力メニュー→プライベートモードから切り替えできます。

直接入力を有効にしたアプリケーションでは、日本語変換処理を行いません。独自でIME機能を持つEmacs.appなどで使用することを想定しています。

直接入力の有効・無効の切り替えは、切り替えたいアプリケーションが最前面のときに入力メニュー→”(アプリ名)で直接入力”から行えます。
また有効になっているアプリケーションのリストは設定→直接入力から確認できます。

直接入力を有効にしたアプリケーションはBundle Identifier単位で記録しているため、アプリケーションを移動させても設定は無効になりません。また特殊なGUIアプリケーションはBundle Identifierをもたないため直接入力を設定できません (Android StudioのAndroidエミュレータとか)。

ユーザー辞書が更新された場合、一定期間おきにファイル書き出しが行われます。またシステム再起動時やバージョンアップのインストール実行後などmacSKKプロセスが正常終了する際にファイル書き出しが終わっていない更新がある場合はファイル書き出しを行ってから終了します。
もし即座にファイル書き出ししたい場合は入力メニューから”ユーザー辞書を今すぐ保存”を選んでください。

Command + Option + Escからの強制終了時やシグナルを送っての終了時は保存されないので注意してください。

macSKKは現在開発中のアプリケーションです。そのため安定していない可能性が高いです。
なるべく不具合が修正された最新バージョンを使っていただきたいため、定期的に新しいバージョンがないかをチェックして見つかった場合は通知センターで通知します。

新規バージョンの確認はGitHubのReleasesページのAtom情報を取得して行います。
バージョンチェックは12時間おきにバックグラウンドで実行されます。

macSKKアプリ自体はApp Sandboxでインターネット通信ができないように設定しているため、GitHubのReleaseページの取得はmacSKKからXPCを介して外部プロセスで行います。

skkservサーバーをSKK辞書として使用することができます (macSKKがskkservサーバーとして機能するわけではないです)。
まだ作り込みが甘いのでベータ機能だと思ってください。

設定の辞書メニューからSKKServを有効にすることで使用できます。

• アドレスはIPv4, IPv6, ホスト名のいずれかを指定してください。
• ポート番号は通常は1178が使われるようです
• 応答エンコーディングは通常はEUC-JPが使われることが多いようですがskkservの実装によってはUTF-8を返すものもあるようです。
• SKKServ設定画面のテストボタンは設定中のskkservにバージョン取得コマンドを試します。正常な応答があれば「skkservへの接続に成功しました」と表示されます。

現状は以下の制限があります。

• 同時に1サーバーまで接続可能です。
• TCP接続が切断されたり1秒以内に送信できなかったり1秒以内に応答がなかった場合は取得できなかったものとして扱います。
• 常にファイル辞書よりも変換候補は後に出るようにしています。
  • 並び替えのUIで迷ったために先送り。将来並び替えできるようにすると思います。

動作確認はyaskkserv2でのみ行っています。

現在アンインストールする手順は用意していないためお手数ですが手動でお願いします。
今後、dmg内にアンインストーラを同梱予定です。

手動で行うには、システム設定→キーボード→入力ソースから「ひらがな」「ABC」を削除後、以下のファイルを削除してください。

• /Library/Input Methods/macSKK.app
• ~/Library/Containers/net.mtgto.inputmethod.macSKK

A. C-j がVisual Studio Codeのキーボードショートカット設定の editor.action.joinLines にデフォルトでは割り当てられていると思われます。Cmd-K Cmd-S から editor.action.joinLines で検索し、キーバインドを削除するなり変更するなりしてみてください。

A. macos_forward_to_ime_modifier_mask に CTRL を追加することでIMEに C-j が渡されてひらがなモードに切り替えできるようになります。 SHIFT も入れておかないと漢字変換開始できなくなるので、 SHIFT|CTRL を設定するのがよいと思います。

A. Karabiner-Elementsで C-j をかなキーに置換することで対応することができます。作者は以下のようなComplex Modificationsを ~/.config/karabiner/assets/complex_modifications/macskk.json に配置しています。将来 https://github.com/pqrs-org/KE-complex_modifications に配置して簡単にインストールできるようにしようと思っています。

{
    "description": "macSKK for Terminal/iTerm2",
    "manipulators": [
        {
            "conditions": [
                {
                    "bundle_identifiers": [
                        "^com\\.googlecode\\.iterm2",
                        "^com\\.apple\\.Terminal"
                    ],
                    "type": "frontmost_application_if"
                },
                {
                    "input_sources": [
                        {
                            "input_source_id": "^net\\.mtgto\\.inputmethod\\.macSKK\\.(ascii|hiragana|katakana|hankaku|eisu)$"
                        }
                    ],
                    "type": "input_source_if"
                }
            ],
            "from": {
                "key_code": "j",
                "modifiers": {
                    "mandatory": [
                        "left_control"
                    ]
                }
            },
            "to": [
                {
                    "key_code": "japanese_kana"
                }
            ],
            "type": "basic"
        }
    ]
}

Ghostty v1.1.0で、q/lなどで入力モードが変更されたかどうかをGhostty側で判定してくれるようになりました。ただしOS側の現在の入力モードが変わったかどうかをチェックしているため、切り替え前と切り替え後の入力モードを両方ともmacOSのキーボード設定で有効にしておく必要があります。
例えばmacSKKの「ひらがな」だけを入れている場合、qでカタカナモードに変更してもOSでの入力モードは「macSKKのひらがな」のままと認識されてしまいqがそのまま入力されてしまいます。同様にmacSKKの「ABC」を入れていないと、lを入力してもモードが変わってないとGhosttyには解釈されてlがそのまま入力されてしまいます。
https://zenn.dev/mtgto/articles/macskk-karabiner-settings-for-ghostty も参考にしてください。

xterm.js利用の問題と思われます。 #356

入力メニューにある「1文字目を未確定扱い (互換性)」を有効にすることで aiueo のようなローマ字1文字からなるひらがなの入力ができるようになります。あくまで一時的な回避策 (ワークアラウンド) なので、aiueo のあとは他の文字を打つかEnterが押されないと入力が確定されないままとなります。

#119 と同じ問題と思われます。
v0.20.0ではKitty, LINE, Alacrittyについて「空文字挿入」というワークアラウンドを初期設定でもっています。

空文字挿入の設定は、アプリが最前面にあるときに入力メニューから設定可能です。
またmacSKKの設定内の「互換性の設定」からも可能です。

日本語 の設定で入力モードの英字を有効にしてから ABC, 日本語 の順に削除するとmacSKKだけにしたりできるようです。
参考: https://zenn.dev/yoshiyoshifujii/articles/78798db6472bf4

macOSの日本語入力システムは、ユーザーライブラリ (~/Library) とシステムライブラリ (/Library) の二種類の配置場所があるのですが、 Secure Keyboard Entry が有効なアプリケーション内で日本語入力システムを使用できるようにするにはシステムライブラリにインストールされている必要があるようです。

参考: #351

v2.0.0からシステムライブラリへのインストールが可能にできるように変更しました。システムライブラリへのインストールをお試しください。

コントリビュートのガイドを .github/CONTRIBUTING.md に用意しています。

Xcodeでビルドし、 ~/Library/Input Methods に macSKK.app を配置してからシステム設定→キーボード→入力ソースで ひらがな (macSKK) などを追加してください。

macOS 14以降ではApp Sandboxの制限が強くなりました。すでにリリース版macSKKを使っている環境で開発版のmacSKKを使用すると起動時に 「"macSKK"がほかのアプリからのデータへのアクセスを求めています。」 というダイアログが表示されることがあります。これはリリース版で署名に使用しているTeam IDと異なるProvisioning Profileを使用している (もしくはAd hoc署名を使っている) 場合に同じユーザー辞書ファイルにアクセスすることで発生します。この状態で「許可」を選んでしまうとリリース版のmacSKKが逆に読み込めなくなるなどの想定しない問題が発生する可能性があります。お手数ですがBundle Identifierを変更するなどを検討してください。

X.Y.Z 形式のバージョン (MARKETING_VERSION) とビルド番号 (CURRENT_PROJECT_VERSION) の更新が必要です。

メジャー、マイナー、パッチ、どのバージョンアップでも1ずつインクリメントしてください。
Xcodeから手動でやってもいいし、agvtoolでもいいです。

agvtool next-version

Info.plistにCFBundleShortVersionStringで管理するのではなくpbxprojにMARKETING_VERSIONで管理する形式だとagvtool next-marketing-version が使えないみたいなのでXcodeで手動で変えてください。

• CHANGELOGを記述
• バージョンアップ
• make clean && make release
• GitHubのReleaseを作成、dmgとdSYMsをアップロード、CHANGELOGをコピペ

macSKKはGNU一般公衆ライセンスv3またはそれ以降のバージョンの条項の元で配布されるフリー・ソフトウェアです。

詳細は LICENSE を参照してください。