使い方
基本操作、絞り込み、ウィンドウ操作、リンク、トラブルシューティング
- 01 Hold⌘Cmdを押したまま
- 02 StepTab× nTabで次のウィンドウへ
- 03 Release⌘Cmdを離すと切り替わる
| ⌘Tab | 切り替え画面を表示します。Cmdを押したままTabで移動し、Cmdを離すと切り替わります。 |
| ⇧⌘Tab | 逆方向に移動します。 |
| ⌥Tab | 並列スイッチャーを表示します。同じ画面を独自の設定で開き、はじめは前面アプリの窓だけを並べます。Optを押したまま移動し、Optを離すと切り替わります。 |
| ⇧⌥Tab | 並列スイッチャーを逆方向に移動します。 |
| ⌘J/N | 次へ移動します(↓と同じ)。 |
| ⌘K/P | 前へ移動します(↑と同じ)。 |
| ⌘S | 開いている切り替え画面を絞り込みモードに切り替えます。 |
| ⌘/⌥, | 切り替え画面を閉じて設定画面を開きます。 |
並列スイッチャー
Section titled “並列スイッチャー”Opt+Tabでもう1つのスイッチャーを開きます。Cmd+Tabと同じ画面・同じ操作で、設定だけが別です。はじめは前面アプリの窓だけを並べるので、同じアプリの窓の行き来にCmd+/は要りません。Cmd+Tabはこれまでどおりすべてのアプリの窓を並べます。Optを離すと切り替わります。Cmd+Tabのスイッチャーと同じ規則で確定します。
設定画面のSwitchersタブには、スイッチャーごとの子タブCmd+TabとOpt+Tabがあり、どちらにも同じ行が並びます。どのアプリの窓を並べるか、ほかのSpaceの窓・隠したアプリ・最小化・フルスクリーンの窓・窓のないアプリをどう扱うか、グループ分けしたときにそれらをどこへ置くかを選べます。Opt+Tabの各行はCmd+Tabにリンクしていて、リンクを外すまでCmd+Tabの値に従います。ただしShow windows ofだけは、リンクを外した状態のActive appから始まります。Link all to Cmd+Tabですべての行をリンクに戻せます。並び順、あいまい検索、グループ分けの仕方、パネルの表示先・幅・文字の大きさ、表示の待ち時間、パネルの中の操作などは2つのスイッチャーで共通で、それぞれのタブに残ります。並列スイッチャーを切るとOpt+TabとShift+Opt+Tabは前面のアプリに届くようになり、入れ直すと再起動なしに同じ設定で動きます。
設定ファイルでは2つのスイッチャーをswitchers区画のmain(Cmd-Tab)とparallel(並列)に対等に書きます。parallelの各項目は"inherit"と書くとCmd-Tabのスイッチャーと同じになります。共通の設定は最上位に書きます。mainやparallelに書いても無視され、診断ログに記録されます。
{ "switchers": { "main": { "windowScope": "allApps" }, "parallel": { "windowScope": "inherit", "minimizedMode": "show", "enabled": false } }}switchers区画の無い今の設定ファイルは今までどおりに読め、並列スイッチャーは前面アプリの窓だけで動きます。
- 01 Open⌘Space絞り込みモードで開く
- 02 TypeA–Z入力して一覧を絞る
- 03 Switch↩選んだウィンドウに切り替わる
| ⌘Space | 切り替え画面を絞り込みモードで表示します。このモードではCmdを離しても閉じません。Cmd+Tabで開いた画面で押すと、そのまま絞り込みモードに切り替わります。Sでも同じく切り替わります。 |
| A–Z | 入力した文字をアプリ名かウィンドウタイトルに含む行だけを残します。大文字と小文字は区別しません。 |
| ↑↓ | 選択を移動します。 |
| ↩ | 選んだウィンドウに切り替えます。 |
| ⌫ | 入力を1文字消します。 |
| ←→、CtrlB/F | 入力位置を1文字動かします。 |
| CtrlA/E | 先頭・末尾へ飛びます。 |
| CtrlH | 入力を1文字消します(⌫と同じ)。 |
| fn+⌫、CtrlD | 後ろの1文字を消します。 |
| CtrlW | 1語消します。 |
| CtrlU/K | 先頭まで・末尾まで消します。 |
| CtrlN/P | 選択を移動します(↓/↑と同じ)。 |
| CtrlM | 選んだウィンドウに切り替えます(↩と同じ)。 |
| CtrlG | 入力を残したまますぐ閉じます。 |
| esc | 入力を消します。入力が空のときは切り替え画面を閉じます。 |
上の表にないCtrl+文字キーは、絞り込み中は入力に入らず捨てられます。 |
ローマ字入力
Section titled “ローマ字入力”絞り込み入力はローマ字でも一致します。たとえばgijirokuはぎじろくと議事録に一致します。かな読みは同梱の変換表でそのまま動きます。漢字読みには辞書が必要です。
漢字辞書の用意
Section titled “漢字辞書の用意”漢字読みを使うには、設定ファイルの隣にmigemo-dictを置いてLanternaを再起動します。
curl -L -o SKK-JISYO.L https://raw.githubusercontent.com/skk-dev/dict/master/SKK-JISYO.Lcurl -L -o skk2migemo.sh https://raw.githubusercontent.com/peacock0803sz/Lanterna/main/scripts/skk2migemo.shbash skk2migemo.sh SKK-JISYO.L ~/Library/Application\ Support/Lanterna/migemo-dictSKK辞書はEUC-JPで配布されているため、スクリプトがUTF-8に変換します。送り仮名つきのエントリは対象外で、/で区切られた候補はタブ区切りにほぐし、;以降の注釈を落として素の漢字だけを残します。リポジトリを持っている場合はscripts/skk2migemo.shをそのまま使えます。
入力ソースの固定
Section titled “入力ソースの固定”Lanternaは切り替え画面のキーを入力メソッドより先に読むため、絞り込みの文字はIMEを通りません。ただし、選択中の入力ソースに応じてキーを書き換えるツールの影響は受けます。たとえば日本語の入力ソースのときだけ有効なKarabiner-Elementsの親指シフト設定では、abcがLanternaに届く前に別の文字に書き換わります。
これを避けるには、Filter設定のForce keyboardで入力ソースを選ぶか、config.jsonの"forcedInputSource"に"com.apple.keylayout.ABC"のようなIDを指定します。切り替え画面を開いている間だけその入力ソースに切り替わり、閉じたときとLanternaを終了したときに元の入力ソースに戻ります。閉じる時点で手で別の入力ソースを選んでいれば、その入力ソースが残ります。キーがない場合は固定しません。
ウィンドウ操作
Section titled “ウィンドウ操作”切り替え画面を開いている間にCmdかOptionを押しながら次のキーを押すと、選んでいる行のウィンドウやアプリを操作できます。操作しても切り替え画面は閉じず、一覧がその場で更新されます。
| ⌘/⌥W | ウィンドウを閉じます。 |
| ⌘/⌥Q | アプリを終了します。 |
| ⌘/⌥H | アプリを隠します。 |
| ⌘/⌥M | ウィンドウを最小化します。 |
既定では、隠したアプリと最小化したウィンドウはほかのウィンドウの下に移り、HIDDEN APPSやMINIMIZEDといった見出しの下にまとめて並びます。操作に失敗したときは表示が元に戻り、短い通知が出ます。Lanterna自身の行は操作できません。開いているウィンドウが無いアプリの行では、閉じると最小化は対象が無いことを知らせ、終了と隠すはそのアプリに効きます。
一覧の絞り込みとグループ分け
Section titled “一覧の絞り込みとグループ分け”スイッチャーの表示中に⌘/を押すと、開いたときに前面にあったアプリのウィンドウだけが並びます。一覧の上の帯にそのアプリの名前が出て、入力した検索語はそのまま残ります。もう一度押すとすべてのアプリに戻ります。次に開いたときは、SwitchersタブにあるそのスイッチャーのShow windows ofの設定から始まります。Active appにすると、毎回前面のアプリだけから始められます。
起動したままで開いているウィンドウが無いアプリは、「No open windows」と書かれた行として並べられます。その行を選ぶとアプリが前面に出ます。SwitchersタブのApps without windowsで、混ぜて並べるか、隠すか、APPS WITHOUT WINDOWSの見出しの下にまとめるかを選べます。既定は隠す設定で、そのときも検索語にアプリ名が合えば見つかります。
Groupsタブで一覧をグループ分けできます。
- By Spaceでは、Spaceごとのウィンドウを見出しの下にまとめます。見出しにはデスクトップの名前と、ディスプレイが複数あるときはそのディスプレイの名前が出ます。表示中のSpaceが先に並び、ほかのSpaceのウィンドウは下の区画ではなく自分のグループに入ります。
- Manuallyでは、最大9つのグループを作り、アプリをバンドルIDで割り当てます。起動中のアプリから選ぶか、IDを入力して足します。見出しには、グループの番号、グループに付けた名前、そのグループのアプリ名のいずれかを出せます。割り当てていないアプリは最初のグループに入ります。
グループ分けしているときは、MINIMIZEDなど下にまとめる区画ごとに、一覧の末尾に置くか各グループの中に置くかを、SwitchersタブのPlacement when groupedで選べます。ただしBy Spaceでは、ウィンドウが無いアプリはどのSpaceにも属さないため常に最後のグループの後に並びます。ほかのSpaceのウィンドウも自分のグループに入るため、その置き場所の設定は使われません。グループが1つしかない一覧には見出しが出ません。
パネルの表示先と幅
Section titled “パネルの表示先と幅”AppearanceタブのShow Panel onで、パネルを出すディスプレイを選びます。Primary display(メニューバーのあるディスプレイ)、Display with cursor(カーソルのあるディスプレイ)、Display with focused window(前面アプリのフォーカスのある窓のディスプレイ)、All displays(すべてのディスプレイ)から選びます。既定はPrimary displayです。All displaysではすべてのディスプレイに同じ一覧が出て、キー入力を受け付けるのはカーソルのあるディスプレイの1枚だけです。切り替えは次に開くパネルから効きます。
同じタブのPanel Widthで、パネルの幅をNarrowからWideまで5段階で変えられます。真ん中の段階が標準の幅です。幅の変更も次に開くパネルから効き、ディスプレイに収まらない幅は収まる大きさに収められます。
同じタブのShow delayで、パネルを出すまでの待ち時間を0から1000ミリ秒まで50刻みで変えられます。0(Off表示)では今までどおりすぐ出ます。待ち時間を入れると、待ち切る前に離せばパネルを出さずに切り替わり、押し続ければいつものパネルが出ます。待ち時間の変更も次に開くパネルから効きます。
同じタブのHover to selectで、ポインタの下の列に選択が移るようになります。既定は切で、入れるとポインタを動かした分だけ選択が移ります。パネルが開いた瞬間に載っていただけでは選択は動きません。Scroll to selectで、スクロールが表示域ではなく選択を動かすようになり、表示域は選択に追従します。既定は切です。列のクリックは2つの入・切に関わらず、その列を選んでそのまま切り替えます。同じタブのNumber jumpで、行番号で行へ直接飛べるようになります。左右どちらのCommand・Optionでも、押したまま数字を順に押して離すと切り替わります。CommandとOptionの両方を押しているときは、Cmd+TabのパネルはCommandを離したときに、Opt+Tabのパネルは2つのうち後に離したほうで切り替わります。番号は修飾キーを押している間だけ出ます。既定は切です。Row numbersで番号を付ける範囲(窓の列だけ・すべての列)を選びます。同じタブのReorder rowsで、グループ表示の中で選択列をShiftと矢印キーで動かせるようになり、並びは再起動後も保たれます。既定は切です。同じタブのAuto-focus single matchは、絞り込みで行が1件になったあと短い待ちを置いてその行に移り、パネルを閉じます。既定は入です(autoFocusSingleCandidate)。
同じタブのApp icon badgesで、未読の数などDockのアイコンに出ているバッジを、そのアプリのすべての列のアイコンに重ねて出します。窓の列にも、窓のないアプリの列にも出ます。既定は切です。バッジはパネルを開くときにDockから読み、開いている間の変化は次に開いたときに映ります。1000以上の数は999+と出ます。同じ場所のアプリを複数起動しているときは、どのアイコンがどれのものかをDockが示さないため、それらの列にはバッジを出しません。バッジは許可済みのアクセシビリティの権限で読み、ほかの権限は求めません。設定ファイルではappIconBadgesで、省略可能で、無いときは切として読みます。
アプリと窓への切り替え
Section titled “アプリと窓への切り替え”GeneralタブのSwitchingには2つの切り替えがあり、どちらも既定は切です。変更は再起動なしに、次にアプリや窓へ切り替えたときから効きます。
Open a window when switching to an app that has noneは、窓のないアプリの列を確定したときに、そのアプリのDockアイコンを押したときと同じ動作をします。窓を開くか、隠れた状態を解くか、何もしないかはアプリが決めます。Lanternaは結果を確かめません。
Bring only the chosen window forwardは、窓の列を確定したときに、選んだ窓だけを前に出し、同じアプリのほかの窓をすべてのディスプレイで今の場所に留めようとします。選んだ窓と一緒に同じアプリの別の窓まで前に出てしまうmacOSの振る舞いへの回避策です。入れていても、ほかの窓が一瞬前に出て見えることがあります。入れた状態の切り替えがおかしいときは、バグ報告テンプレートで報告してください。
設定ファイルでは2つの切り替えはreopenWindowlessAppsとraiseOnlyChosenWindowです。どちらも省略可能で、無いときは切として読みます。
キーバインドの変更
Section titled “キーバインドの変更”下の一覧のキーはすべて、設定ファイルの keybindings か設定のキーボードタブで変えられます。キーは物理位置で扱われるため、入力ソースによらず同じように動きます。
| 操作 | 既定のキー |
|---|---|
| 表示 | ⌘Tab |
| 逆方向に表示 | ⇧⌘Tab |
| 絞り込み用に表示 | ⌘Space |
| 並列表示 | ⌥Tab |
| 並列で逆方向に表示 | ⇧⌥Tab |
| 次へ | ↓、J、N、CtrlN |
| 前へ | ↑、K、P、CtrlP |
| 確定 | ↩、テンキーの Enter、CtrlM |
| キャンセル | esc、⌘.、CtrlG |
| 前面アプリだけに切り替える | ⌘/ |
| 1文字削除 | ⌫、CtrlH |
| カーソルを左へ | ←、CtrlB |
| カーソルを右へ | →、CtrlF |
| カーソルを先頭へ | CtrlA |
| カーソルを末尾へ | CtrlE |
| 後ろを1文字削除 | fn+⌫、CtrlD |
| 1語削除 | CtrlW |
| 先頭まで削除 | CtrlU |
| 末尾まで削除 | CtrlK |
| クエリ消去 | esc |
| ウィンドウを閉じる | ⌘/⌥W |
| アプリを終了する | ⌘/⌥Q |
| アプリを隠す | ⌘/⌥H |
| ウィンドウを最小化する | ⌘/⌥M |
| 絞り込みに切り替える | S |
| 設定画面を開く | ⌘/⌥, |
| 行番号へ飛ぶ | ⌘/⌥+数字 |
| 列を上へ動かす | ⇧⌘/⌥↑ |
| 列を下へ動かす | ⇧⌘/⌥↓ |
表示、逆方向に表示、絞り込み用に表示はシステム全体に届き、ウィンドウ操作と前面アプリだけに切り替える操作、設定画面を開く操作は入力中に誤爆するため、これらのキーはすべてCmd、Ctrl、Optのいずれかが必要です。2つの並列表示の呼び出しにはCmdかOptが必ず要ります。どちらも含まないキーは、離して確定する手段が無くなるため受け付けません。行番号へ飛ぶ、列を上へ動かす、列を下へ動かす操作もCmd、Ctrl、Optのいずれかが必要です。修飾キーなしの英字・数字キーへの割り当ては絞り込みが切の間だけ効き、絞り込み中はクエリへの文字として入ります。どの操作にもないCtrl+文字キーは、絞り込み中はクエリに入らず捨てられます。同じ数の修飾キーを求める割り当てが並んだときは、Ctrlを求める割り当てが先に選ばれます。ほかのアクションが使っているキーは割り当てられませんが、クエリ消去とキャンセルはキーを共有できます。キーが空のアクションは既定に戻りますが、既定も使われている場合はアクションが未割り当てのままになり、診断ログに記録されます。起動用の変更はそのまま反映されます。
- RepoGitHubリポジトリgithub.com/peacock0803sz/Lanterna
- ReleasesReleases…/Lanterna/releases
- LicenseLICENSE…/blob/main/LICENSE
- ContributingCONTRIBUTING…/blob/main/CONTRIBUTING.md
トラブルシューティング
Section titled “トラブルシューティング”クラッシュ後にCmd+Tabが戻らない
Section titled “クラッシュ後にCmd+Tabが戻らない”Lanternaは起動中にCmd+TabとShift+Cmd+Tabをシステムから預かり、終了時に返却します。kill -9やクラッシュで終了すると返却できないため、両方のショートカットが無効のまま残ります。
他にできることがある前に、Lanternaが起動していないことを確認してください。復旧処理は現在の状態を読まずにショートカットを有効化するため、別のLanternaが起動したまま実行すると、そのプロセスからショートカットを奪ってしまいます。同時に複数起動することはサポートしていません。
pgrep -x Lanterna # 何も出なければOK。出る場合は先に `pkill Lanterna` を実行する次にLanternaを起動して正常に終了し直し、終了時の復旧処理でショートカットを戻します。
/Applications/Lanterna.app/Contents/MacOS/Lanterna &sleep 1pkill Lanternaそれでも戻らない場合は一度ログアウトして入り直してください。システムのショートカット割り当てはログインセッション単位です。
ウィンドウが表示されない
Section titled “ウィンドウが表示されない”アクセシビリティと入力監視の2つの権限が許可されていることを確認し(ガイド参照)、Lanternaを再起動してください。
これで解決しない場合は、バグ報告テンプレートを使って報告してください。