Mediafish

                O  o
          _\_    o
>('>   \\/  o\ .
       //\___=
          ''

Cast a link. Land the media.

Mediafish is a clean terminal downloader for video and audio from YouTube, TikTok, Instagram, X, Threads, SoundCloud, and 1,000+ sites supported by yt-dlp.

export-1785795782006.mp4

Why Mediafish?

• Download video or extract audio in multiple formats.
• Review the title, artist or creator, source, and file metadata before confirming.
• Follow organized progress instead of noisy downloader logs.
• Handle individual links, playlists, and authenticated media you can access.
• Run from npm on Windows, macOS, and Linux.

Install

Requires Node.js 18+. macOS and Linux also require uv.

npm install -g github:zanesense/mediafish
mediafish

FFmpeg is required for format conversion. The Windows launcher provisions missing tools on first run.

Use

Start the guided workflow:

mediafish

Or pass links directly:

mediafish "https://example.com/video"
mediafish URL --format mp4
mediafish URL -f mp3 -o downloads
mediafish URL -f mp4 -f flac
mediafish PRIVATE_URL --cookies-from-browser firefox

Formats: best, avi, flv, gif, mkv, mov, mp4, webm, aac, alac, flac, m4a, mp3, opus, vorbis, and wav.

Develop

uv sync
npm test
npm run lint

Legal

Download only media you own or have permission to save. Mediafish does not bypass DRM or grant rights to third-party content.

MIT licensed. See LICENSE.