初回起動から最終的な書き出しまで Luxel を活用できます。

Luxel をインストール

1. Luxel をインストールして起動します。
2. 権限を許可する前に、アプリを固定した場所に置いてください。
3. Finder または Launchpad から Luxel を開きます。
4. macOS のメニューバーにある Luxel のステータス項目を確認します。

Luxel には macOS 26.0 以降が必要です。メニューバーから動作するため、キャプチャの開始や設定を開く主な場所はメニューバー項目です。

最初のキャプチャ

1. メニューバーから Luxel を開きます。
2. 「対象」から対象を選ぶか、「範囲」で任意の領域を描きます。
3. 収録に必要な場合だけ、システムオーディオ、マイク、カメラを有効にします。
4. 「ソースを収録」「範囲を収録」「オーディオを収録」のいずれかをクリックします。
5. メニューバーのステータス操作、収録中の操作、またはショートカットで収録を停止します。

通知を有効にする

1. 「設定」>「録音」を開きます。
2. 「音声を検出したときに通知」をオンにします。
3. 説明を読み、「有効にする」を選んでオプトインします。
4. 最初に通知を許可し、次にマイクへのアクセスを許可します。
5. 「システムのデフォルト」または特定のマイクを選びます。

サインイン後も利用するには「ログイン時に開く」をオンにします。検出は Luxel が開いている間だけ動作します。

動作を選ぶ

Luxel がきっかけを検出すると、通知に「録音を開始」と「閉じる」が表示されます。「録音を開始」は、選択したマイクでオーディオのみの録音を1件開始します。「閉じる」は何も行わず、通知を開くだけの場合は録音せずに Luxel をアクティブにします。

集中モードなどの macOS の通知設定により、通知が遅れたり表示されなかったりする場合があります。通知は補助機能であり、Luxel が会話を認識する保証はありません。

リプレイバッファを設定

1. 「設定」>「リプレイバッファ」を開きます。
2. リプレイバッファを有効にし、初回の同意画面を承認します。
3. 長さを 30 秒、1 分、2 分、5 分から選びます。
4. 24 FPS または 30 FPS を選びます。
5. クリップに Mac の音声が必要な場合だけ「システムオーディオを含める」をオンにします。
6. クリップをエディタで開くか、クイック書き出し先を使うかを選びます。

メニューから使う

1. メニューバーの操作からリプレイバッファを開始します。
2. 状態が開始中からバッファ中になるまで待ちます。
3. 「書き出す」をクリックし、選択した直近の時間を保存します。
4. 「開始」と「停止」でバッファを有効または無効にします。
5. 「リプレイバッファをクリップ」ショートカットまたは luxel clip で同じ操作を実行できます。

選択範囲を描く

「範囲」をクリックして全画面の選択オーバーレイを開きます。ドラッグして領域を描き、ハンドルでサイズを変えるか、「ディスプレイ全体」を使います。最小サイズは 32 × 32 ピクセルです。

サイズプリセットは 1280 × 720、1920 × 1080、800 × 600。アスペクト比は自由、16:9、4:3、1:1、9:16、21:9 です。

便利な操作

• カウントダウン、停止までの時間、音声、カメラ、比率、サイズを設定します。
• 権限がある場合はマイクとカメラを切り替えます。
• ルーペで端を正確に合わせます。
• 「プリセット」設定で他のディスプレイを暗くするか、前回の選択を復元します。
• 割り込みを減らすには、通知の案内から集中モード設定を開きます。

エディタで

1. 音声を含む収録をエディタで開きます。
2. 文字起こしプレビューでテキストを生成または確認します。
3. テキストを検索するか範囲を選び、再生位置を移動します。
4. 自動で発話をまとめるには「文字起こしの発話を分割」をオンにします。
5. 長い収録で未処理の文字起こしを速く得るには、「設定」>「文字起こし」でオフにします。

話者を識別して管理

1. 「設定」>「文字起こし」で「話者を識別」を有効にします。
2. 文字起こしを生成し、検出した各音声をローカルで分離してラベル付けします。
3. 「話者」カードで自動検出を使うか、正確な人数または範囲を指定して再検出します。
4. 音声例を再生し、検出した話者に名前を付け、既知の話者として保存、既存プロフィールへ関連付け、または無視できます。
5. 今後の文字起こしでは、保存した既知の話者を自動照合できます。

音声プロフィールと話者処理は Mac 内に留まります。

コマンドラインから

luxel transcribe demo.m4a > demo.txt
luxel transcribe demo.mp4 --output demo.json --format json --overwrite
luxel transcribe demo.mp4 --locale en_US --semantic-turns --diarize

デフォルトではプレーンテキストが stdout に出力されます。 --format json を使うと発話ごとの完全なデータを取得でき、 --diarize が有効な場合は話者ラベルも含まれます。

Luxel とペアリング

luxel pair
luxel doctor

ペアリングすると Luxel に承認画面が表示されます。アプリと CLI は資格情報を別々に macOS キーチェーンへ保存します。「設定」>「コマンドライン」で外部操作を無効にしたり、ペアリング済みクライアントを取り消したりできます。

一般的な例

luxel record --display main --fps display --countdown 3
luxel record --active-window --fps 120
luxel toggle --last-area
luxel stop
luxel clip --seconds 30
luxel latest --reveal
luxel preferences

メディアの例

luxel record --active-window --preset "Default" --save-to ~/Movies/Luxel
luxel editor ~/Movies/demo.mp4
luxel convert demo.mp4 demo.webm
luxel convert demo.mp4 demo-av1.mp4 --format av1
luxel convert demo.mp4 demo.gif --start 2 --duration 5 --fps 15 --width 800 --height 450
luxel convert demo.mp4 demo.mov --format prores422 --quality high
luxel export request.json output.webm --overwrite --json
luxel transcribe demo.m4a > demo.txt
luxel transcribe demo.mp4 --output demo.json --format json --diarize --overwrite

エージェントスキル

Luxel Skillsをインストールすると、対応するコーディングエージェントがCLIの全機能を使用したり、レビュー用のWebM証跡を目的に沿って作成したりできます。

npx skills add https://github.com/rawcontext/luxel-skills
npx skills add https://github.com/rawcontext/luxel-skills --skill luxel
npx skills add https://github.com/rawcontext/luxel-skills --skill luxel-evidence

コマンドのリファレンスと操作にはluxelを、意図的な録画と添付のワークフローにはluxel-evidenceを選んでください。

GitHubのLuxel Skillsページをご利用ください。

フォルダへのアクセス

Luxel は「ムービー」フォルダ、設定した収録フォルダ、アプリで許可したフォルダを使用できます。ターミナルのパスが App Sandbox を迂回することはありません。

luxel access add ~/Desktop/Exports
luxel access check ~/Desktop/Exports/demo.mp4
luxel access list
luxel access revoke <grant-id>

access add は Luxel のフォルダ選択を開きます。そこで選んだフォルダにアプリの使用権限が与えられます。

セキュリティとプライバシー

各呼び出しは、127.0.0.1上の認証済み短期接続を使います。Luxel は未ペアリングのクライアント、古いリクエスト、再利用された nonce、変更された本文、非ループバックのエンドポイントを拒否します。CLI がセキュリティスコープ付きブックマークを受け取ったり、メディアを処理したりすることはありません。

URL スキーム

Luxel は luxel:// URL スキームを登録します。呼び出し元に権限がない場合、キャプチャ開始とリプレイバッファのクリップには確認が必要です。stop、preferences、latest などはデフォルトで許可されます。

luxel://record?target=display&display=main&fps=display&countdown=3
luxel://record?target=activeWindow&preset=Default
luxel://toggle
luxel://stop
luxel://clip?seconds=30
luxel://preferences
luxel://latest?reveal=true

x-callback URL

自動化コマンドは x-success と x-error コールバック URL を受け付けます。ファイル作成に成功したコマンドには filePath、収録開始には recordingID、失敗には errorMessageをご利用ください。

が追加されます。x-callback 自動化には URL スキームを直接使います。

クイックプリセット

書き出しプリセットは追加、複製、削除、名前変更、クイック収録への割当ができます。形式、サイズ規則、フレームレート、保存先、後処理に対応します。保存先は「収録」フォルダまたはクリップボードです。GIF、MP4、HEVC MP4、ProRes 422 MOV、ProRes 4444 MOV、APNG を使え、WebM と AV1 はエディタと CLI から利用できます。

リプレイバッファ

リプレイバッファ設定では、有効化、クリップ時間、24/30 FPS、システムオーディオ、起動時再開、エディタまたはクイック書き出し先を設定します。

コマンドライン

コマンドライン設定では外部操作、CLI リポジトリ、ペアリングの取消、コマンド用フォルダを管理します。

システム動作

システム設定にはメニューバータイマー、通知、ログイン時起動、アップデート、謝辞があります。

対応ロケール

• 英語
• ドイツ語 (ドイツ)
• スペイン語 (イベリア半島)
• フランス語 (フランス)
• イタリア語 (イタリア)
• 日本語 (日本)
• 韓国語 (韓国)
• ベトナム語
• 簡体中国語
• ポルトガル語 (ブラジル)
• ポルトガル語（ポルトガル）

権限メッセージ

カメラ、マイク、画面キャプチャ、音声認識のメッセージは選択した言語で表示されます。対応機能を有効にするか収録を始めたときだけ権限を求めます。

Luxel は macOS の言語設定に自動で従います。