yoinks README

The project's README from github.com/pablostanley/yoinks. As one markdown file: README.md.

yoinks

yoinks

yoink any video. paste. yoink. done.

Download videos from YouTube, X/Twitter, Instagram, Threads, TikTok and 1,800+ other sites — right from your terminal. Paste a url, pick a resolution (or audio-only mp3), done. No popups, no fake download buttons, no sketchy redirects.

yoinks home screen — paste a link and hit yoink

Install

npm install -g yoinks

Or try it without installing anything:

npx yoinks

Requires Node 18+. Everything else (yt-dlp, ffmpeg) is fetched or bundled automatically.

Usage

$ yoinks https://youtu.be/dQw4w9WgXcQ    # straight to the format picker
$ yoinks                                 # prompts for a url
$ yoinks --theme light                   # force the light palette

yoinks takes over the terminal (full-screen, centered — and restores your scrollback on exit). Pick a format with ↑/↓ (or j/k, or number keys) and hit enter. esc goes back, ^c quits. Or just use the mouse — the yoink button, the format list and the footer hints are all clickable, and clicking the logo takes you back home. Files are saved to ~/Downloads, and the file path is printed to your terminal when you're done.

The default auto theme uses your terminal's own foreground and background, so it follows light and dark terminal themes without guessing. Press ^t or click the theme control in the footer to cycle through auto, light, and dark for the current session. Use --theme auto, --theme light, or --theme dark to choose the starting theme for one launch.

yoinks format picker — resolutions with estimated file sizes, plus audio-only mp3

How it works

Development

npm install
npm run build        # bundle to dist/ with tsup
npm run dev          # rebuild on change
node dist/cli.js <url>
npm run typecheck

To try it as a global command without publishing: npm link, then run yoinks anywhere.

Roadmap

A note on fair use

yoinks is a personal-archiving tool. Downloading content may violate a platform's terms of service — only download what you have the right to keep, and be excellent to creators.

License

MIT

yoinks (pablostanley/yoinks)

Searching Database…

Что это?yoinks — терминальная утилита, которая скачивает видео с YouTube, X/Twitter, Instagram, Threads, TikTok и более 1800 других сайтов — просто вставьте url и выберите разрешение или mp3 только со звуком.
Это CLI-скрипт или у него есть UI?Это полноэкранный терминальный UI (TUI) на Ink (React для терминала) — управление стрелками, клавишами j/k, цифрами или мышью.
Как его установить и запустить?Установите глобально командой npm i -g yoinks и запускайте yoinks или попробуйте сразу через npx yoinks — кроме Node ничего настраивать не нужно.
Нужны ли заранее установленные Python или ffmpeg?Нужен только Node 18+; yt-dlp и ffmpeg скачиваются или поставляются в комплекте автоматически при первом запуске, Python не требуется.
Поддерживает ли он уже пакетную загрузку или плейлисты?Пока нет — поддержка плейлистов и тредов с несколькими видео, скриптуемые флаги --best/--mp3 и установщик через curl всё ещё в роадмапе как невыполненные пункты.
Куда сохраняются скачанные файлы?Файлы сохраняются в локальную папку ~/Downloads, а путь выводится в терминале по завершении.
Есть ли юридические подводные камни в использовании?Он под лицензией MIT, но автор подаёт его как инструмент личного архива и предупреждает, что скачивание контента может нарушать условия обслуживания платформы.
Можно выбрать тему или она следует за моим терминалом?По умолчанию он автоматически определяет цвета переднего/заднего плана терминала; переключать auto/light/dark можно клавишей ^t или задать стартовую тему через --theme auto/light/dark.
Как устанавливается бинарник yt-dlp?При первом запуске yoinks скачивает автономный бинарник yt-dlp в ~/.yoinks/bin (Python не нужен) или использует ваш yt-dlp, если он уже установлен.
Можно попробовать без установки чего-либо?Да — выполните npx yoinks, чтобы попробовать без постоянной глобальной установки.
Size
0.3 MB
Stars
6K
Updated
CommitJul 17
Age
3mo
Commits · 90 Days