yldm-tech/Kando has 118 GitHub stars and 42 forks. GitHot measured 0 stars in 24 hours. Last checked 2026-11-15 15:50 UTC. Last push 2026-11-15.
できること
- Add a video by pasting a link from YouTube, Bilibili or any other site yt-dlp supports (Help › Supported Websites… lists them, with their logos), or pick a local file (mp4, mov, mkv, webm and other video files) or drag it onto the window. Local files are transcribed where they are, not copied.
- Browse, in the sidebar, is a built-in browser: open a site, sign in if it needs it, and click Download Video to add the page you are on. Every download, from Browse, the link field, the command line or MCP, carries the sign-in of the sites you signed in to there; Clear Sign-in Data… signs you out of all of them.
- Jobs run one after another through download, transcription, translation and export. A failed job says why, links to the setting that fixes it, and can be retried or removed.
- Speech is recognized on your computer with whisper.cpp, which detects the spoken language. Settings › Speech Recognition lists seven whisper models, from Tiny (77.7 MB) to Large v3 (3.1 GB), and downloads the one you choose from Hugging Face.
計測したスター増加
- 24時間
- 0
- 7日間
- 更新が遅れています
- 15日間
- 更新が遅れています
- 1か月
- 更新が遅れています
期間ごとの純増数です。期間は重複しており、日別の値ではありません。未計測の値は空欄です。スター数は注目度の指標であり、品質の保証ではありません。
概要
Learn a language from videos in that language: downloads with yt-dlp, transcribes on your computer with whisper.cpp, translates each line and plays bilingual subtitles.
AIREADME.ja.md
オリジナルKando
English · 简体中文 · 日本語 · 繁體中文 · 한국어
Kando は、ある言語で話されている動画からその言語を学ぶためのデスクトップアプリです。中国語名は「看懂」(「見て分かる」の意)です。YouTube や Bilibili のリンクを貼り付けるか、動画ファイルをウィンドウにドロップすると、Kando は yt-dlp で動画をダウンロードし、whisper.cpp でお使いのコンピューター上で音声を文字起こしし、OpenAI 互換のモデルでセリフを 1 つずつ翻訳し、原文と訳文を同時に画面に表示しながら元の動画を再生します。Go で書かれており、ネイティブのインターフェースは MyGo と Breeze UI で描画しています。Web ビューは使っていません。

インターフェースは日本語、英語、簡体字中国語、繁体字中国語、韓国語に対応しています。最初は簡体字中国語で表示されるので、「設定」›「一般」›「表示言語」で切り替えてください。ウインドウはすぐに選んだ言語に変わります。以下で引用しているラベルは日本語のインターフェースの表示そのままです。
機能
- YouTube、Bilibili、そのほか yt-dlp が対応するサイトのリンクを貼り付けて動画を追加できます(対応サイトはロゴ付きで「ヘルプ」›「対応サイト…」に一覧があります)。ローカルファイル(mp4、mov、mkv、webm などの動画ファイル)を選ぶか、ウィンドウにドラッグすることもできます。ローカルファイルはコピーせず、その場所のまま文字起こしします。
- サイドバーの「ブラウザ」は内蔵ブラウザです。サイトを開き、必要ならログインして「動画をダウンロード」をクリックすると、表示中のページをライブラリに追加できます。以後のダウンロードは、「ブラウザ」、リンク欄、コマンドライン、MCP のどこからでも、ここでログインしたサイトのログイン状態を引き継ぎます。「ログイン情報を消去…」でそれらすべてからログアウトします。
- ジョブはダウンロード、文字起こし、翻訳、書き出しの順に 1 件ずつ実行されます。失敗したジョブには理由と、それを解決する設定へのリンクが表示され、再試行や削除ができます。
- 音声認識は whisper.cpp でお使いのコンピューター上で行い、話されている言語は whisper.cpp が判別します。「設定」›「音声認識」には Tiny(77.7 MB)から Large v3(3.1 GB)まで 7 種類の whisper モデルが並び、選んだものを Hugging Face からダウンロードします。
- 翻訳はデフォルトで EveryAPI を使いますが、OpenAI 互換のチャット API ならどれでも使えます。「設定」›「AI サービス」には OpenAI、OpenRouter、Groq、DeepSeek、xAI、Mistral、Qwen(DashScope)、Kimi、Zhipu GLM、SiliconFlow、Ollama、LM Studio のプリセットと、カスタムエンドポイントがあります。翻訳先の言語、モデルに直前のセリフも読ませる文脈考慮モード、プロンプトは「設定」›「翻訳」で変更できます。
- 処理が完了した動画ごとに、動画と同じ場所に SubRip ファイルが 2 つ作られます。原文のセリフを収めた
<video>.srtと、各セリフの訳を原文の上に置いた<video>.bilingual.srtです(ダウンロードした動画ではvideo.srtとvideo.bilingual.srt)。 - プレーヤーでは字幕を二言語、原文のみ、訳文のみ、オフから選べます。字幕の遅延は 0.1 秒刻みで調整でき、スタイルも変更できます。前後のセリフへの移動、今のセリフの聞き直し、聞き取れるまでの 1 セリフのリピートもできます。サイドパネルでは、すべてのセリフを一覧・検索でき(セリフをクリックするとその位置へジャンプします)、動画を約 30 秒ずつ 4〜12 個のクリップに分けて表示し、その動画のファイルと入手元も確認できます。どの動画も、前回視聴を止めた位置から再開されます。
- ライブラリは通常のファイルが入った
.kandoフォルダで、Finder やファイルマネージャーで管理できます。複数のライブラリを持ってサイドバーから切り替えられ、サイドバーではライブラリを入手元(YouTube、Bilibili、その他のサイト、ローカルファイル)で絞り込むこともできます。 - 任意で、Google でサインインしたあと、プレーヤーから動画とその二言語字幕を自分のオブジェクトストレージ(Cloudflare R2、Amazon S3、Alibaba Cloud OSS、Tencent Cloud COS、または任意の S3 互換ストレージ)にアップロードできます。設定項目 を参照してください。
- 再生、字幕、ウィンドウ操作のキーボードショートカットがあり、チートシート(⌘/)と「設定」›「キーボードショートカット」に一覧があります。
- 不具合の報告に添えられるログファイルがあります。「ヘルプ」›「ログファイルを表示」(またはコマンドパレット ⌘K)で表示できます。macOS では
~/Library/Logs/Kando/kando.log、ほかの OS ではユーザー設定フォルダ内のKando/logsフォルダにあるkando.logです。失敗した各ジョブの理由(Kando が保存しているキーと AI サービスのアドレスは除く)と、失敗したツールの出力の最後の 64 KB を記録します。キーのように見える文字列はすべて***と書かれます。5 MB を超えると新しいファイルになり、その前の 2 つが残ります。

インストール
ダウンロード
macOS(Apple シリコンと Intel)、Windows(x86-64 と ARM64)、Linux(x86-64 と ARM64)向けのビルドは GitHub Releases にあります。お使いのシステムに合わせてファイルを選びます。<version> はリリースのバージョン(0.5.0 など)です。
macOS: Apple シリコンの Mac では
kando-<version>-arm64.dmg、Intel の Mac ではkando-<version>-amd64.dmg。ディスクイメージを開き、Kando を「アプリケーション」フォルダにドラッグします。Windows: ほとんどの PC では
kando-setup-<version>-amd64.exe、Arm 版 Windows の PC ではkando-setup-<version>-arm64.exe。インストーラーを実行します。まだ署名していないため、実行前に SmartScreen の警告が出ることがあります。「詳細情報」から「実行」を選んでください。Debian、Ubuntu とその派生ディストリビューション: x86-64 では
kando_<version>_amd64.deb、ARM64 ではkando_<version>_arm64.deb。ダウンロードしたフォルダでsudo apt install ./kando_<version>_<arch>.debを実行してインストールします。その他の Linux ディストリビューション: リリースのインストールスクリプトを実行します。パッケージを自分でダウンロードする必要はありません。
curl -fsSL https://github.com/yldm-tech/Kando/releases/latest/download/install.sh | shお使いのマシン向けの最新の
kando-<version>-linux-<arch>.tar.gzをダウンロードして署名を検証し、root なしで現在のユーザーだけに Kando をインストールします。アプリは~/.local/kando.appに、kandoコマンドは~/.local/binに置かれ、アプリケーションメニューにも項目が追加されます。署名の検証には OpenSSL 3.0 以降(Debian 12、Ubuntu 22.04、Fedora 36 以降)が必要です。それより古い OpenSSL ではスクリプトは何もダウンロードせず、その旨を表示します。その場合は、マシンに合った.tar.gzとinstall.shを同じリリースから同じフォルダに、ファイル名を変えずにダウンロードし、そこでsh install.shを実行してください。.tar.gzのパスを渡してsh install.sh <アーカイブ>と実行することもできます。どちらの場合も、そのアーカイブを署名の検証なしでインストールします。スクリプトをもう一度実行すると新しいバージョンで上書きインストールし、sh install.sh --uninstallは設定とライブラリを残して Kando を削除します。
リリースにあるその他のファイルはインストール用ではありません。checksums.txt は各ファイルの SHA-256 の一覧で、update-*.json マニフェスト、.delta ファイル、darwin と windows のアーカイブは、インストール済みの Kando が自動アップデートでダウンロードするものです(アップデートを参照)。
0.5.1 より後のリリースの macOS 用ディスクイメージは YLDM の Developer ID で署名され、Apple の公証を受けているため、macOS は警告なしで Kando を開きます。
アップデート
Kando は GitHub にある署名済みのリリースから自分自身をアップデートします。起動から 10 秒後にバックグラウンドで確認し、その後は 1 日に 1 回確認します。新しいバージョンがあると、そのリリースノートを表示するウィンドウが開き、「アップデートをインストール」「後で通知」「このバージョンをスキップ」を選べます。「アップデートをインストール」は新しいバージョンをダウンロードして署名を検証し、Kando を再起動して新しいバージョンに切り替えるか尋ねます。再起動しなければ、次に Kando を起動したときに新しいバージョンになります。スキップしたバージョンはバックグラウンドの確認では再び表示されませんが、その次のバージョンは表示されます。
すぐに確認するには、macOS ではメニューバーの「Kando」›「アップデートを確認…」を選びます。メニューバーのない Linux と Windows では、コマンドパレット(Ctrl+K)で「アップデートを確認…」を選びます。「設定」›「一般」の「バージョン」の横にも「アップデートを確認…」ボタンがあり、その下に前回の確認で見つかった新しいバージョンか、前回確認した日時が表示されます。「アップデートを自動的に確認」と「アップデートを自動的にダウンロードしてインストール」のスイッチも「設定」›「一般」にあります。アップデートをダウンロードするのはバックグラウンドの確認だけなので、後者は前者がオンのときだけ表示されます。後者をオンにすると、バックグラウンドの確認で見つかった新しいバージョンを確認なしでインストールし、次に Kando を起動したときに切り替わります。
自分のファイルを置き換えられない Kando は自動アップデートしません。.deb と PKGBUILD がこれにあたります。どちらもパッケージマネージャーが管理する /opt/kando に Kando をインストールし、Kando には apt リポジトリがないため、アップデートするには新しい .deb をリリースからダウンロードして同じ方法でインストールするか、上のインストールスクリプトに切り替えてください。スクリプトが ~/.local/kando.app にインストールした Kando は自動アップデートします。このようにインストールした Kando では「設定」›「一般」にスイッチが表示されず、「アップデートを確認…」はアップデートできない理由を示すウィンドウを開きます。
ソースからビルド
Go 1.27.4 以降を用意して、次を実行します。
git clone https://github.com/yldm-tech/Kando.git
cd Kando
make build
make build は現在のプラットフォーム向けに go tool mygo build apps/kando を実行し、結果を apps/kando/build/<os>-<arch>/ に書き出します。macOS ではアドホック署名された Kando.app と .dmg、その他のプラットフォームでは実行ファイルが作られます(Linux ではさらに .deb、インストールスクリプト付きの .tar.gz、PKGBUILD が、Windows では NSIS で作るインストーラーも作られます。NSIS がインストールされていなければ mygo がダウンロードします)。標準の Windows のように make がない環境では、リポジトリのルートで go tool mygo build apps/kando を直接実行してください。
動作要件
Kando は yt-dlp、ffmpeg、whisper-cli(whisper.cpp)を実行します。macOS と Linux では自分でインストールする必要はありません。Kando を開いたときに足りないものがあれば自動でダウンロードし、はじめにガイドに進み具合が表示されます。すでにインストールされているもの(Homebrew で入れたものなど)はそのまま使います。
| プログラム | 用途 | Kando がダウンロードするもの |
|---|---|---|
yt-dlp |
オンライン動画のダウンロード。ローカルファイルを含め、すべてのジョブで Kando はこれを必要とします。 | yt-dlp の公式リリースの単体ファイル版。 |
ffmpeg |
音声の抽出、カバー画像の取得、プレーヤーでの映像と音声のデコード。プレーヤーは macOS、Linux、Windows のいずれでもシステムのオーディオ出力で音声を再生します。 | FFmpeg 9.0.2(macOS 版は ffplay 付き)。このリポジトリの tools リリースから。 |
whisper-cli(whisper.cpp) |
音声認識。 | whisper.cpp 1.9.5(macOS 版は Metal 対応)。同じリリースから。 |
| whisper.cpp の ggml モデル | はじめにガイドか「設定」›「音声認識」でダウンロードするか、KANDO_WHISPER_MODEL でモデルファイルを指定します。 |
tools リリースは Tools ワークフロー(.github/workflows/tools.yml)が .github/tools.env で固定したソースからビルドし、Kando はダウンロードしたものをアプリに組み込んだ SHA-256 で検証してから使います。ダウンロードしたプログラムは settings.json の隣の tools フォルダ(macOS では ~/Library/Application Support/Kando/tools、Linux では ~/.config/Kando/tools)に置かれます。Kando はまずここを探し、次に PATH と /opt/homebrew/bin、/usr/local/bin、/home/linuxbrew/.linuxbrew/bin を探します。Finder やデスクトップのランチャーから開いたアプリには最小限の PATH しか渡されないためです。「設定」›「一般」には使っているプログラムが表示され、足りないものは「ダウンロード」か「再試行」で取得でき、「再検出」で探し直します。yt-dlp が古いためにダウンロードに失敗した場合は「アップデートして再試行」が表示され、インストールしたときと同じ方法で更新して再試行します。
Windows ではまだ自動でダウンロードしません。同じプログラムをパッケージマネージャーでインストールし、PATH に含まれていることを確認してください。
使い方
- Kando を開きます。ライブラリがまだない場合は、「新規ライブラリ…」と「既存のライブラリを開く…」が表示されます。新しいライブラリは、変更しなければ macOS では
~/Movies、それ以外では~/Videosに「動画ライブラリ」という名前で作られます。 - 足りない
ffmpeg、yt-dlp、whisper-cliははじめにガイドが自動でダウンロードします。「設定」(⌘,)の「一般」に、それぞれのバージョンとともに表示されます。 - 「音声認識」で、whisper モデルの横にある「ダウンロード」をクリックします。ダウンロードが終わると Kando がそのモデルを選択します。「おすすめ」の印が付いているのは「Large v3 Turbo(圧縮版)」で、574 MB です。Vimpo や hyperframes がすでにダウンロードしたモデルは、コピーせずに選択できます。
- 「AI サービス」で翻訳を設定します。
- EveryAPI(デフォルト): EveryAPI の CLI で一度
everyapi auth loginを実行してサインインします。Kando は CLI にキーを問い合わせる(everyapi auth credential)ため、CLI と同じログイン、ゲートウェイのリージョン、キーの更新をそのまま使い、トークンを貼り付ける必要はありません。デフォルトのモデルはclaude-haiku-5-5で、ほかのモデルはeveryapi models listで確認できます。代わりに EveryAPI のキーを「API Key」欄に貼り付けることもできます。 - ほかのプロバイダー: 「サービス」で選ぶか、「OpenAI 互換」を選んで Base URL を入力し、「モデル」と「API Key」を設定します(Ollama や LM Studio などのローカルサーバーにはキーは不要です)。「接続をテスト」を押すと、短いリクエストを送って設定を確認します。
- EveryAPI(デフォルト): EveryAPI の CLI で一度
- 「翻訳」で、デフォルトの翻訳先言語を選びます: 簡体字中国語(デフォルト)、繁体字中国語、英語、日本語、韓国語、スペイン語、フランス語、ドイツ語。
- ウィンドウに戻り、上部のバーにリンクを貼り付けて「処理を開始」をクリックするか、「ローカル動画」をクリックするか、動画をウィンドウにドラッグします。サイドバー下部のステータス行は、ジョブに必要なものがすべてそろうと「準備ができました。処理を開始できます」と表示し、そうでない場合は足りないものを示します。
翻訳プロバイダーがレート制限やサーバーエラーを返した場合は、リクエストを送り直します(最初の送信を含めて最大 3 回)。


コマンドラインと MCP
Kando のプログラムは、コマンドライン kando と、AI エージェント向けの MCP サーバーも兼ねています。下の表のコマンドを付けて実行すると Kando アプリを操作し、コマンドなしで実行するといつもどおりウィンドウを開きます。
kando コマンドを使えるようにするには:
- macOS: Kando を「アプリケーション」フォルダに移動してから、「設定」›「一般」で「コマンドラインツール」の横にある「インストール」をクリックします。
/usr/local/bin、/opt/homebrew/bin、~/.local/binのうち最初に書き込めるフォルダに、Kando を指すkandoのリンクを作ります。管理者パスワードは求めず、ほかのプログラムのkandoを置き換えることもありません。ディスクイメージから直接開いたときや、ダウンロード後に macOS が一時的な場所に移して実行しているとき(App Translocation)は、Kando のパスがすぐに使えなくなるため、カードはリンクを作らずに先に Kando を移動するよう案内します。自分でリンクを作ることもできます:sudo ln -s /Applications/Kando.app/Contents/MacOS/Kando /usr/local/bin/kando。 - Linux:
.debとPKGBUILDはアプリを/opt/kandoにインストールし、/opt/kando/kandoを指すリンク/usr/bin/kandoを追加します。インストールスクリプト(ダウンロードを参照)はアプリを~/.local/kando.appにインストールし、それを指す~/.local/bin/kandoを作ります。そこに自分で作ったものではないkandoがあれば、そのまま残します。シェルのPATHに~/.local/binがなければ追加してください。 - Windows: Windows でリンクを作るには管理者権限か開発者モードが必要なため、Kando はコマンドをインストールできません。「設定」›「一般」の「コマンドラインツール」に
Kando.exeがあるフォルダが表示されるので、そのフォルダをPATHに追加してください。Windows はファイル名の大文字と小文字を区別しないため、ターミナルでkandoと入力すると Kando が実行されます。
| コマンド | 内容 |
|---|---|
kando status |
開いているライブラリ、使用中のプログラムとモデル、ジョブを開始できるかどうかを表示します。開始できない場合は足りないものを示します。 |
kando list [--source S] [query] |
ライブラリの動画を新しい順に ID 付きで一覧表示します。--source は 1 つのソース(youtube、bilibili、local、またはほかのサイトの名前)に絞り込み、query はタイトルにその文字列を含む動画に絞り込みます。 |
kando show <film-id> |
1 本の動画を表示します: ソース、ステージ、動画と字幕のパス。 |
kando subtitles <film-id> [--format srt|text|json] [--original|--translation] |
動画の字幕を SubRip(デフォルト)、1 行 1 字幕のテキスト(text)、または JSON で出力します。両方の言語か、片方だけを選べます。 |
kando jobs |
ジョブを一覧表示します: 実行中のもの、待機中のもの、終わったものの順です。 |
kando add <link-or-file>... [--wait] |
「処理を開始」と同じようにリンクやローカルの動画ファイルをキューに追加し、各ジョブの ID を出力します。相対パスは現在のディレクトリから解釈されます。 |
kando cancel <job-id> |
実行中のジョブを止めるか、待機中のジョブをキューから外します。 |
kando retry <job-id> [--wait] |
「再試行」や「再処理」と同じように、失敗した、キャンセルされた、または完了したジョブを同じ ID のままもう一度キューに追加します。ウインドウの表示は変えません。実行中や待機中のジョブは受け付けません。 |
kando remove <job-id> |
「取り除く」と同じようにジョブをライブラリから取り除きます。実行中のジョブは先に止めます。ファイルはディスクに残ります。 |
kando sites [query] [--limit N] |
Kando がダウンロードできるサイトを、名前、ドメイン、または動画のリンクで検索します。 |
kando open [film-id] |
Kando を最前面に出し、指定した動画を表示します。ID を省くとライブラリを表示します。 |
kando mcp |
標準入出力で MCP サーバーとして動きます(後述)。 |
kando version |
バージョンを出力します。 |
kando help [command] |
コマンドの一覧、または 1 つのコマンドの使い方とフラグを表示します。 |
アプリを必要とするコマンドは、settings.json と同じフォルダにあるソケット kando.sock(macOS では ~/Library/Application Support/Kando/kando.sock、Linux では ~/.config/Kando/kando.sock、Windows では %AppData%\Kando\kando.sock)を通じてアプリとやり取りします。KANDO_SOCKET で別のパスを指定できます。2 つ目の Kando を動かすときもこれが必要で、さらに専用の HOME も要ります(設定項目を参照)。Kando が起動していないときは、コマンドがバックグラウンドで起動し、標準エラー出力に Starting Kando… と表示して最大 30 秒待ちます。動画の追加には「処理を開始」と同じもの(開いているライブラリ、プログラム、whisper モデルなど)が必要で、足りないものがあると kando add はウィンドウに表示されるのと同じメッセージで失敗します。
アプリとやり取りするコマンドはすべて --json を受け付け、アプリの応答をテキストではなく JSON で出力します。追加できなかったソースがあると、kando add は終了コード 1 で終わります。--wait を付けると、追加したジョブがすべて完了または失敗するまで待ち、ジョブのステージや進捗が変わるたびに 1 行出力し、失敗したジョブが 1 つでもあれば同じく終了コード 1 で終わります。--json を付けると、進捗は標準エラー出力に、終了時のジョブは標準出力に出力されます。kando retry --wait も、もう一度キューに追加したジョブを同じように待ちます。終了コードは、成功が 0、失敗が 1、コマンドの使い方の誤りが 2 です。
kando mcp は標準入出力で動く MCP サーバーです。Kando が起動していないときは、ツールが同じように Kando を起動します。
| ツール | 内容 |
|---|---|
kando_status |
アプリのバージョン、開いているライブラリ、ジョブを開始できるかどうかと足りないもの、プログラム、音声認識と翻訳のモデル、翻訳先言語、実行中と待機中のジョブ。 |
kando_list_films |
開いているライブラリの動画を新しい順に返します。source やタイトル中の語(query)で絞り込めます。 |
kando_get_film |
ID で指定した 1 本の動画: ステージ、翻訳先言語、動画と字幕のパス。 |
kando_get_subtitles |
処理が終わった動画のタイムスタンプ付き字幕。両方の言語か片方だけ(which)、簡潔なテキストか SRT(format)を選べ、max_cues を指定すると先頭のその行数だけを返します。 |
kando_add_videos |
リンクやローカルの動画ファイルをキューに追加し、ジョブと、追加できなかったソースごとにスキップした理由を返します。 |
kando_list_jobs |
ジョブのステージ、進捗、ステータス、エラー、完了後は動画の ID とファイルのパス。 |
kando_cancel_job |
実行中のジョブを止めるか、待機中のジョブをキューから外します。 |
kando_retry_job |
失敗した、キャンセルされた、または完了したジョブを同じ ID のままもう一度キューに追加し、そのジョブを返します。 |
kando_remove_job |
ジョブをライブラリから取り除きます。実行中のジョブは先に止めます。ファイルはディスクに残ります。 |
kando_search_sites |
Kando がダウンロードできるサイトを、名前、ドメイン、または動画のリンクで検索します(limit を指定しなければ 20 件)。 |
kando_open |
Kando のウィンドウを最前面に出し、動画またはライブラリを表示します。 |
Claude Code にはプログラムのパスを指定して追加します。kando が PATH にあれば kando だけで構いません。
claude mcp add kando -- /Applications/Kando.app/Contents/MacOS/Kando mcp
ほかの MCP クライアントでは、mcpServers の設定に同じコマンドを書きます。
{
"mcpServers": {
"kando": {
"command": "/Applications/Kando.app/Contents/MacOS/Kando",
"args": ["mcp"]
}
}
}
WebMCP に対応したブラウザでは、ランディングページ kando.yldm.ai がブラウザのエージェントに WebMCP ツールを提供します: search_supported_sites は Kando があるサイトからダウンロードできるかを調べ、get_download はシステムに合ったダウンロードリンクを返し、get_started は使い始めるまでの手順を返し、list_features は Kando の機能を一覧にします。
設定項目
以下の項目は、Google のクライアント ID とシークレット、KANDO_SOCKET を除き、すべてアプリ内でも設定できます(ライブラリはサイドバーから、それ以外は「設定」から)。環境変数を設定すると、アプリに保存された値の代わりにその値が使われます。
| 変数 | デフォルト | 説明 |
|---|---|---|
KANDO_WHISPER_MODEL |
「設定」›「音声認識」で選んだモデル | whisper.cpp の ggml モデルファイルのパス。例: ggml-small.bin。 |
KANDO_LLM_BASE_URL |
EveryAPI、https://api.everyapi.ai/v1 |
OpenAI 互換プロバイダーの Base URL。例: https://api.openai.com/v1、Ollama なら http://localhost:11434/v1。設定すると、サインイン中の EveryAPI アカウントは使われません。 |
KANDO_LLM_MODEL |
EveryAPI では claude-haiku-5-5 |
翻訳モデル。カスタムプロバイダーにはデフォルトがないため、ここか「設定」›「AI サービス」で指定します。 |
KANDO_LLM_API_KEY |
なし | 翻訳プロバイダー用の Bearer トークン。サインイン中の EveryAPI アカウントより優先されます。 |
EVERYAPI_API_KEY |
なし | EveryAPI のキー。KANDO_LLM_BASE_URL が未設定で KANDO_LLM_API_KEY が空のとき、CLI のログインの代わりに使われます。 |
KANDO_OUTPUT_DIR |
最後に開いたライブラリ | 起動時に開くライブラリのフォルダ。新しい動画と字幕はここに保存されます。 |
KANDO_SOCKET |
settings.json と同じフォルダの kando.sock |
アプリが待ち受け、kando コマンドラインと kando mcp が接続するソケットのパス。アプリとコマンドの両方に同じパスを設定します。Kando は 1 人のユーザーにつき 1 つだけ動き、もう一度起動すると最初の Kando が前面に出ます。KANDO_SOCKET を設定して起動したものは開発用などの意図した 2 つ目の Kando で、自分のライブラリと設定を使うよう専用の HOME も必要です。コマンドラインと MCP を参照してください。 |
KANDO_GOOGLE_CLIENT_ID |
なし | 「設定」›「アカウントとアップロード」で Google にサインインするための OAuth クライアント ID。未設定の場合、サインインボタンは無効になります。設定ファイルには保存されません。 |
KANDO_GOOGLE_CLIENT_SECRET |
なし | 同じ OAuth クライアントのクライアントシークレット(省略可)。 |
KANDO_STORAGE |
r2 |
アップロード先: r2、s3(または aws)、oss(または aliyun)、cos(または tencent)、compat(または s3compat)。それ以外の値は R2 として扱われます。 |
KANDO_R2_ENDPOINT |
なし | Cloudflare R2: アカウント ID、または https:// で始まる完全なエンドポイント。 |
KANDO_R2_BUCKET、KANDO_R2_ACCESS_KEY、KANDO_R2_SECRET |
なし | Cloudflare R2 のバケットとキー。 |
KANDO_S3_REGION |
なし | Amazon S3 のリージョン名。例: ap-northeast-1。 |
KANDO_S3_BUCKET、KANDO_S3_ACCESS_KEY、KANDO_S3_SECRET |
なし | Amazon S3 のバケットとキー。 |
KANDO_OSS_REGION |
なし | Alibaba Cloud OSS のリージョン名。例: cn-hangzhou(内部ネットワークでは cn-hangzhou-internal)。 |
KANDO_OSS_BUCKET、KANDO_OSS_ACCESS_KEY、KANDO_OSS_SECRET |
なし | Alibaba Cloud OSS のバケットとキー。 |
KANDO_COS_REGION |
なし | Tencent Cloud COS のリージョン名。例: ap-guangzhou。 |
KANDO_COS_BUCKET、KANDO_COS_ACCESS_KEY、KANDO_COS_SECRET |
なし | Tencent Cloud COS のバケット(名前に APPID を含みます。例: video-1250000000)、SecretId、SecretKey。 |
KANDO_S3COMPAT_ENDPOINT |
なし | ほかの S3 互換ストレージの、https:// で始まる完全なエンドポイント。 |
KANDO_S3COMPAT_REGION |
なし | そのストレージの署名用リージョン。MinIO では通常 us-east-1 です。 |
KANDO_S3COMPAT_BUCKET、KANDO_S3COMPAT_ACCESS_KEY、KANDO_S3COMPAT_SECRET |
なし | そのストレージのバケットとキー。 |
KANDO_S3COMPAT_PATH_STYLE |
オフ | 1、true、yes、on でパス形式のアドレス指定を有効にします(MinIO では必要です)。0、false、no、off で無効にします。 |
アップロードは手動です。動画を開き、プレーヤーで「R2 にアップロード」(ほかのストレージを選んだ場合はその名前)をクリックします。Kando は動画とその二言語字幕を <Google アカウントのメールアドレス>/<ライブラリ>/<動画フォルダ>/<ファイル> の下にアップロードします。サインインは誰がアップロードしたかを示すためだけのものです。動画が自動でアップロードされることはありません。
ライブラリと設定
ライブラリは、名前が .kando で終わるフォルダです。ダウンロードした動画はそれぞれ、その中に専用のフォルダ <title> [<video id>]/ を持ち、そこに video.mp4、cover.jpg、video.srt、video.bilingual.srt が入ります。これらは通常のファイルです。Kando はライブラリのフォルダを監視しているため、Finder やファイルマネージャーで追加・削除した動画はライブラリに反映されます。macOS では、.kando フォルダは Finder で Kando のマーク入りのフォルダアイコンで表示されます。
動画をライブラリから削除すると、その動画のフォルダがゴミ箱に移動します。ただし、そのフォルダにほかの動画やフォルダも入っている場合は、その動画と字幕だけが移動します。ライブラリのフォルダの外にあるローカル動画はその場所に残り、一覧から消えるだけです。ライブラリを一覧から削除しても、そのフォルダはディスクに残ります。
Kando は自身のファイルをユーザー設定ディレクトリに保存します。macOS では ~/Library/Application Support/Kando、Windows では %AppData%\Kando、Linux では ~/.config/Kando です。
library.json: 完了済みと処理中のジョブ、および各動画の再生を止めた位置。settings.json: 設定。API キー、オブジェクトストレージのキー、Google のリフレッシュトークンも平文で含まれます。このファイルは現在のユーザーアカウントだけが読み取れます。window-state.json: ウィンドウのサイズと位置。updater.json: アップデートについての選択(「設定」›「一般」の 2 つのスイッチ、スキップしたバージョン)と、Kando が前回アップデートを確認した日時。models/: 「設定」›「音声認識」でダウンロードした whisper モデル。
video.* という名前ではない動画のカバー画像は、macOS では ~/Library/Caches/Kando/posters、Windows では %LocalAppData%\Kando\posters、Linux では ~/.cache/Kando/posters にキャッシュされます。
LingoCut からのアップグレード
Kando は以前 LingoCut という名前でしたが、旧名のファイルや変数を読み込む処理はありません。ライブラリと設定を引き継ぐには、次の手順を行います。
- アプリを終了します。
- 設定フォルダの名前を
LingoCutからKandoに変更します。macOS では~/Library/Application Support/LingoCut、Windows では%AppData%\LingoCut、Linux では~/.config/LingoCutです。このフォルダにはlibrary.json、settings.json、window-state.jsonとダウンロード済みのモデルが入っています。 - 設定フォルダの名前を変えたあと、起動する前に、各ライブラリの名前を
X.lingocutからX.kandoに変更します。macOS と Linux では、保存された inode をもとに、名前を変えたライブラリをアプリがすべて追跡します。Windows では、見つからないライブラリ 1 つを同じ親フォルダ内の新しい.kandoフォルダ 1 つにしか対応付けられないため、フォルダごとに 1 つずつライブラリの名前を変え、変えるたびにアプリを一度起動してください。 - 環境変数の名前を
LINGOCUT_*からKANDO_*に変更します。 - Kando を起動し、「設定」›「音声認識」で音声認識モデルを選び直します。モデルファイルはフォルダと一緒に移動しているので「ダウンロード済み」と表示されますが、保存された選択はまだ古いパスを指しています。
- 旧名の残りを削除します:
lingocut.appとlingocut Dev.app、カバー画像のキャッシュ~/Library/Caches/LingoCut(Windows では%LocalAppData%\LingoCut、Linux では~/.cache/LingoCut)、Linux では小文字の~/.config/lingocut、そしてmake devを実行したことがあれば~/Library/Application Support/lingocut Dev。
開発
Go 1.27.4 以降が必要です。
make test # go test for packages/core, packages/media and apps/kando
make dev # run the app with live reload
make build # build the app for this platform into apps/kando/build
make dev は、MyGo の mygo dev に tools/mygo-dev のパッチを当てたものを実行します。macOS では、リロード時に実行中のウィンドウを先に閉じず、新しいビルドが自身のウィンドウを表示するまで残すため、変更を保存してもアプリが終了したようには見えません。MyGo のアップグレード後にパッチが当たらなくなった場合は警告を出し、標準の go tool mygo dev にフォールバックします。その場合は、新しい cmd/mygo/dev.go に合わせて tools/mygo-dev/dev.go.patch を更新してください。この処理を行う tools/mygo-dev/dev.sh は POSIX シェルスクリプトです。
スクリーンショットテストは、固定のデモライブラリから主要な画面を PNG ファイルに描画します。空のダミーのホームフォルダと、ダミーの ffmpeg、yt-dlp、whisper-cli を使うため、ユーザー自身の設定、ライブラリ、ツールは読み込みません。
KANDO_SCREENSHOTS=/tmp/kando-shots go test ./apps/kando/... -run TestScreenshots
KANDO_SCREENSHOTS_LANG(en、zh-Hans、zh-Hant、ja、ko)を指定すると、そのインターフェース言語で描画し、デモ用ライブラリもその言語の読者向けの内容になります。-run TestScreenshotsReadme は各言語の README で使う 4 枚の画像を描画します。画像は docs/assets/<言語>/ にあります。
リポジトリの構成:
apps/kando: アプリ本体。画面ごとに専用のディレクトリ(sidebar/、films/、film/、settings/、account/、cheatsheet/)があり、view.goがウィンドウとそれらをつなぎます。shelf/はジョブの記録、cloud/は Google サインインとオブジェクトストレージへのアップロード、brand/はライブラリの Finder アイコンです。packages/core: プラットフォームに依存しないジョブ、ステージ、リンクの解析。packages/media: メディア処理のパイプライン。ダウンロード、文字起こし、翻訳、字幕の書き出し、カバー画像、ライブラリ。tools/mygo-dev:make devが使う、パッチを当てたmygo dev。
AGENTS.md には、インターフェースをどのようにコンポーネントに分けているかと、各領域が従うルールが書かれています。UI を変更する前に読んでください。
CI とリリース
CI ワークフローは、プルリクエストと main をビルドしてテストします。Release ワークフローは、main で CI が成功したあと、または手動で実行されます。前回のタグ以降の Conventional Commits から次のバージョンを決め、chore(release) として main にコミットしてタグを付け、Developer ID やコード署名証明書なしで macOS、Windows、Linux 向けのパッケージをビルドし、インストール済みの Kando がダウンロードするアップデートに署名して、パッケージにチェックサムを添えて GitHub のリリースを公開します。