Meltype

Meltype for Mac

雪解けのように、半角/全角の壁を溶かす日本語入力。

release macOS 13.3 以降 プレビュー版

ダウンロード  ·  トップの README  ·  不具合の報告・提案

Windows Mac Linux

Mac 版のインストール・設定・困ったときの説明です。キー操作と、どの OS でも共通の機能は USAGE.md にあります。

プレビュー版です。 動かないところやビルドエラーがあれば、エラーの全文とあわせて Issues で教えてください!


動く環境


インストール

Meltype はアプリではなく「入力ソース」(日本語入力) です。Meltype.app をダブルクリックしても何も起きません。

  1. Releases から Meltype-<version>-mac.zip をダウンロードして、zip 全体を展開する
  2. 「Install Meltype.command」をダブルクリック
    • 「開発元が未確認のため開けません」と出たら、右クリック (control + クリック) →「開く」→「開く」
    • macOS 15 以降は、一度ダブルクリックしてから、システム設定 → プライバシーとセキュリティ → 下のほうの「このまま開く」を押す
    • それでも開けないときは、「ターミナル」で bash ~/Downloads/Meltype-mac/install.sh を実行する
  3. インストーラーが Meltype を登録・起動します。初回は Meltype の選択を試み、配布 ZIP の更新時は更新前の入力ソースへ戻します

起動エラーが出たときは、入力メニューから ABC または標準の日本語入力を選んでください。入力メニューに Meltype が出てこないときは、困ったときを見てください。

配布 ZIP からの更新も同じ手順です。Meltype.app を先に削除したり、手で上書きしたりせず、新しい ZIP 全体を展開してインストーラーを実行してください。ソースビルドからの更新も、外側のアプリを残して内容を交換します。更新時は入力メニューを再起動せず、更新前の入力ソースへ戻します。

Homebrew から入れる場合は、最初に tap を追加してからインストールします。以後は brew upgrade --cask meltype で更新できます。

brew tap yksr-melt/Meltype https://github.com/yksr-melt/Meltype.git
brew install --cask yksr-melt/Meltype/meltype

使い方

入力メニューの「日本語・英語の自動判定」で使います。JIS キーボードの 英数 / かな で、英数 (直接入力) / 日本語に切り替えます。

設定・学習データ・ユーザー辞書は ~/Library/Application Support/Meltype にあります (入力メニューの「Meltype のデータフォルダを開く」)。設定は Windows 版と同じ config.json で、入力メニューの「Meltype の設定ファイル (config.json) を開く…」で開いて直接編集します。VS Code などのエディターでは、項目の補完と説明が出ます。

かな漢字変換は、同梱の Mozc で行います。Zenzai (llama.cpp の llama-server と zenz-v3.2-small、同梱) で、キャレットの前の文を文脈にして変換します (既定で ON。CPU で計算します)。使わないときは config.json の "UseZenzai": false、自分の llama-server・モデルを使うときは "ZenzaiServerPath"・"ZenzaiModelPath" に場所を書きます。

入力モードのショートカット

入力メニューのモード (日本語・英語の自動判定 / 英数の直接入力) は、macOS の「サービス」にキーを割り当てて切り替えられます。最初はキーを割り当てていません。

  1. Meltype をインストールした後、いったんログアウトしてログインし直す (サービスの一覧に Meltype の項目が出るようになります)
  2. システム設定 → キーボード → キーボードショートカット → サービス → 一般 を開く
  3. 次の項目を有効にして、ショートカット欄をダブルクリックしてキーを割り当てる
操作 サービス名
自動判定 Meltype:日本語・英語の自動判定
英数の直接入力 Meltype:英数の直接入力
日本語 ⇔ 英数 Meltype:日本語 ⇔ 英数

ユーザー辞書

ユーザー辞書は、データフォルダ (~/Library/Application Support/Meltype) の userdict.txt に、1 行に「読み単語」(UTF-8、読みはひらがな) で書きます。変換では最優先に使います。1 文字の読みは、その 1 文字だけを変換するときだけ使います。

macOS の「ユーザ辞書」の語は、次の手順で userdict.txt に取り込めます。

  1. システム設定 → キーボード →「テキスト置換…」で、使いたい項目を選んで Finder にドラッグする (ユーザ辞書.plist ができます)
  2. 入力メニューの「macOSのユーザー辞書を取り込む…」で、そのファイルを選ぶ

Windows 版との違い (今のところ)


困ったとき

不具合を報告するときは、どのアプリで・何と打って・どうなったか (できればスクリーンショットも) を教えてください。

パスワード欄

ロック画面や、Finder・システム設定などから開く macOS の認証ダイアログでは、Meltype が打鍵をそのまま通します。

Chrome でパスワード欄にフォーカスしたまま別のアプリに切り替えると、切り替え先の入力メニューで Meltype を選べなくなります。Chrome に戻り、パスワード欄以外にフォーカスしてから、別のアプリに切り替えてください。

Safari や一般のネイティブアプリのパスワード欄は、現在 Meltype で判別できません。入力メニューで入力ソースを ABC に変更してから、パスワードを入力してください。


アンインストール

入力ソースから Meltype を外してから、ターミナルで次を実行します。

launchctl remove io.github.yksr-melt.Meltype.manual
rm -rf ~/Library/Input\ Methods/Meltype.app
# 設定と学習データも消すなら
rm -rf ~/Library/Application\ Support/Meltype

この内容は docs/MACOS.md から作っています。間違いを見つけたら 問題を報告する から教えてください。