コンテンツにスキップ
Lanterna

使い方

基本操作、絞り込み、ウィンドウ操作、リンク、トラブルシューティング

  1. 01 Hold⌘Cmdを押したまま
  2. 02 StepTab× nTabで次のウィンドウへ
  3. 03 Release⌘Cmdを離すと切り替わる
⌘Tab 切り替え画面を表示します。Cmdを押したままTabで移動し、Cmdを離すと切り替わります。
⇧⌘Tab 逆方向に移動します。
⌥Tab 並列スイッチャーを表示します。同じ画面を独自の設定で開き、はじめは前面アプリの窓だけを並べます。Optを押したまま移動し、Optを離すと切り替わります。
⇧⌥Tab 並列スイッチャーを逆方向に移動します。
⌘J/N 次へ移動します(↓と同じ)。
⌘K/P 前へ移動します(↑と同じ)。
⌘S 開いている切り替え画面を絞り込みモードに切り替えます。
⌘/⌥, 切り替え画面を閉じて設定画面を開きます。

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区画の無い今の設定ファイルは今までどおりに読め、並列スイッチャーは前面アプリの窓だけで動きます。

  1. 01 Open⌘Space絞り込みモードで開く
  2. 02 TypeA–Z入力して一覧を絞る
  3. 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+文字キーは、絞り込み中は入力に入らず捨てられます。 |

絞り込み入力はローマ字でも一致します。たとえばgijirokuはぎじろくと議事録に一致します。かな読みは同梱の変換表でそのまま動きます。漢字読みには辞書が必要です。

漢字読みを使うには、設定ファイルの隣にmigemo-dictを置いてLanternaを再起動します。

ターミナルウィンドウ
curl -L -o SKK-JISYO.L https://raw.githubusercontent.com/skk-dev/dict/master/SKK-JISYO.L
curl -L -o skk2migemo.sh https://raw.githubusercontent.com/peacock0803sz/Lanterna/main/scripts/skk2migemo.sh
bash skk2migemo.sh SKK-JISYO.L ~/Library/Application\ Support/Lanterna/migemo-dict

SKK辞書はEUC-JPで配布されているため、スクリプトがUTF-8に変換します。送り仮名つきのエントリは対象外で、/で区切られた候補はタブ区切りにほぐし、;以降の注釈を落として素の漢字だけを残します。リポジトリを持っている場合はscripts/skk2migemo.shをそのまま使えます。

切り替え画面を開いている間に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つしかない一覧には見出しが出ません。

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と矢印キーで動かせるようになり、並びは再起動後も保たれます。既定は切です。

下の一覧のキーはすべて、設定ファイルの 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を求める割り当てが先に選ばれます。ほかのアクションが使っているキーは割り当てられませんが、クエリ消去とキャンセルはキーを共有できます。キーが空のアクションは既定に戻りますが、既定も使われている場合はアクションが未割り当てのままになり、診断ログに記録されます。起動用の変更はそのまま反映されます。

クラッシュ後に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 1
pkill Lanterna

それでも戻らない場合は一度ログアウトして入り直してください。システムのショートカット割り当てはログインセッション単位です。

アクセシビリティと入力監視の2つの権限が許可されていることを確認し(ガイド参照)、Lanternaを再起動してください。

これで解決しない場合は、バグ報告テンプレートを使って報告してください。