pablostanley/yoinks

できること

• URL を貼ると、解像度ごとの推定ファイルサイズつきの形式一覧を出して選ばせる
• 音声だけの mp3 としても保存できる
• ↑/↓、j/k、数字キー、マウス操作に対応したフルスクリーンの TUI（終了時に scrollback を復元）
• --theme auto|light|dark で配色を選ぶ。auto は terminal の色に追従
• yt-dlp の単体バイナリを初回に ~/.yoinks/bin へ取得する（既存の yt-dlp があればそれを使う）。ffmpeg は PATH のものか同梱の ffmpeg-static を使う

使い方

npm install -g yoinks、または npx yoinks（Node 18 以上）。yoinks https://youtu.be/... で形式選択に進む。保存先は ~/Downloads で、現状は変えられない。

活用できそうな場面

• 手元の動画を個人用に保存する用途に使えそう
• yt-dlp のオプションを覚えなくても使える対話 UI として試せそう

向いている人

yt-dlp の引数を調べずに、terminal から手早く動画を保存したい人

似ているもの

• yt-dlp：実際の取得処理はこれ。yoinks はその対話式のラッパー
• youtube-dl：同系統の元祖

技術

TypeScript、Ink（terminal 向けの React）、tsup。Node 18 以上。MIT。内部で yt-dlp と ffmpeg を使う。

注意点

作られて間もない（2026年7月作成、v0.3.1）。README のロードマップでは、--best / --mp3 などのスクリプト向けフラグ、出力先の指定、playlist 対応が未実装なので、自動化には向かない。初回に外部から yt-dlp のバイナリを取得する。README にあるとおり、ダウンロードは各サイトの規約に反することがある。