PineFetch 🍍

A local-first macOS desktop app that wraps yt-dlp with a clean UI: paste links, pick a preset, queue downloads, and optionally export audio. Transparent, minimal, and built for everyday workflows.

PineFetch is designed for content you own or where you have explicit permission to download. Please respect platform Terms of Service and local laws.

Note: Please only download content you have the rights or permission to access.

Features

• Tauri app
• Minimal dark UI with split view
• Queue (FIFO), cancel, progress, ETA/speed
• yt-dlp spawned with argument array (no shell strings)
• Info fetch via --dump-json (title/uploader/duration/thumbnail)
• Persisted config (yt-dlp path + default output directory)

Install

brew install yt-dlp ffmpeg

npm install

Run (dev)

npm run dev

Build

npm run publish

Build Windows

Run this on Windows with the Rust MSVC toolchain, Node.js, ffmpeg/ffprobe, Deno, and Python 3.10+ installed:

npm run build:windows

yt-dlp location

• If yt-dlp is in your PATH, the app will find it automatically.
• Otherwise, set the full path in Settings → yt-dlp Pfad.
• PineFetch automatically tries to use ffmpeg/ffprobe from the same directory as yt-dlp.

Legal/Use-Case Notes

• This app is for legitimate usage only: your own uploads, Creative Commons/Public Domain, or content with explicit permission to download.
• No DRM or paywall circumvention is supported or promoted.

Local Link Dump API

PineFetch starts a local loopback server for browser extensions at:

http://127.0.0.1:2255

Create a connection secret in Settings → Link Dump Connections. Copy it immediately; PineFetch stores only a hash and will not show the secret again.

Links sent through Link Dump are queued with the currently selected PineFetch preset.

Single link:

curl -X POST http://127.0.0.1:2255/addYoutubeLinkToQueue/ \
  -H "Content-Type: application/json" \
  -d '{"url":"https://www.youtube.com/watch?v=abc123","secret":"pfld_REPLACE_ME"}'

Multiple links:

curl -X POST http://127.0.0.1:2255/addYoutubeLinksToQueue/ \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.youtube.com/watch?v=abc123","https://youtu.be/def456"],"secret":"pfld_REPLACE_ME"}'

Preflight:

curl -X OPTIONS http://127.0.0.1:2255/addYoutubeLinksToQueue/ -i

SQLite checks use the app data database, usually ~/Library/Application Support/PineFetch/pinefetch.sqlite on macOS:

sqlite3 "$HOME/Library/Application Support/PineFetch/pinefetch.sqlite" \
  "SELECT id, server_enabled, host, port FROM link_dump_settings;"
sqlite3 "$HOME/Library/Application Support/PineFetch/pinefetch.sqlite" \
  "SELECT id, name, created_at, last_used_at, revoked_at, deleted_at FROM link_dump_secrets;"

Features

• Queue-based downloads (multiple URLs, processed in order)
• Presets for common workflows (e.g. Best / Audio-only / Custom)
• Optional logs for transparency and troubleshooting
• Playlist support (where supported by yt-dlp)
• Local-first: no accounts, no cloud processing, files stay on your device

Other Menus

The Settings screen lets you tune PineFetch for everyday use: default preset, download location, and whether logs are visible.

History shows completed and failed jobs at a glance, including status and timestamp.

Credits

• yt-dlp: https://github.com/yt-dlp/yt-dlp
• ffmpeg: https://ffmpeg.org/

License

MIT