Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/coah80/yoink/llms.txt

Use this file to discover all available pages before exploring further.

Yoink is an all-in-one media tool you host yourself. Paste a link from YouTube, TikTok, Twitter, Reddit, or 1000+ other sites and Yoink handles the rest — downloading videos and audio, pulling entire playlists as a zip, converting between formats, compressing files for Discord, and even picking out GIFs. There are no ads, no trackers, and no upload limits enforced by a third party because the server runs on your own hardware. A Svelte 5 PWA frontend means you can install it as a home-screen app and share links directly from your phone.

Key Features

Download

Grab videos and audio from 1000+ sites including YouTube, TikTok, Twitter, and Reddit via yt-dlp and the Cobalt API fast path.

Playlists

Download entire YouTube playlists and receive them as a single zip archive, up to 1000 videos per playlist.

Images & Galleries

Pull image galleries from supported sites using gallery-dl, keeping originals at full resolution.

Convert

Re-encode media between video containers (mp4, webm, mkv, mov) and audio formats (mp3, m4a, opus, wav, flac) with configurable codecs.

Compress

Target a specific file size for Discord uploads using ffmpeg presets (fast, balanced, quality) with optional denoising.

Clips & GIFs

Download YouTube clips at specific timestamps and auto-detect Twitter/X posts that should be saved as GIFs.

PWA

Install the frontend as a Progressive Web App on iOS or Android and share links to Yoink directly from the share sheet.

Discord Bot

Run the optional companion bot to use /yoink, /convert, and /compress slash commands inside any Discord server.

Tech Stack

Yoink is built from two compiled Go binaries and a statically-bundled Svelte frontend — no Node.js runtime required in production.
LayerTechnology
BackendGo with chi router — single binary serves API and frontend
FrontendSvelte 5 SPA built with Vite, bundled into a public/ directory
Discord BotGo with discordgo — separate yoink-bot binary
Media Toolsyt-dlp, ffmpeg, gallery-dl, Cobalt API
The server and Discord bot are compiled independently. You can run just the server without the bot, or deploy the bot separately if you want to keep your media server isolated.

Explore the Docs

Quickstart

Install dependencies, build the binary, and have Yoink running in minutes.

Configuration

Full reference for every environment variable and compiled-in constant.

Downloading

Learn how the download pipeline works and which options are available.

Discord Bot

Set up and configure the companion bot for slash command support.

Self-Hosting

System requirements, reverse proxy setup, and production deployment tips.

API Reference

Explore the REST API endpoints exposed by the Yoink server.

Build docs developers (and LLMs) love