whatisgithub

What is snaffle?

krimdev/snaffle — explained in plain English

Analysis updated 2026-05-18

0TypeScriptAudience · generalComplexity · 2/5LicenseSetup · easy

In one sentence

A terminal app that downloads videos from popular sites and converts video, audio, and PDF files, all running locally on your own computer.

Mindmap

mindmap
  root((snaffle))
    What it does
      Grab videos from links
      Convert media files
      Offline PDF tools
    Tech stack
      Node.js
      TypeScript
      yt-dlp
      ffmpeg
      pdf-lib
    Use cases
      Save a video as MP3 or MP4
      Trim a clip
      Merge or split PDFs
    Audience
      Vibe coders
      General users

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Download a video or audio-only track from YouTube, TikTok, Instagram, or similar sites straight to your computer.

USE CASE 2

Convert a video or audio file into a different format like MP4, MP3, M4A, or WAV without any online converter.

USE CASE 3

Trim a section out of a video or audio clip by typing a start and end time.

USE CASE 4

Combine images into a PDF, merge PDFs together, or split specific pages out of a PDF.

What is it built with?

TypeScriptNode.jsyt-dlpffmpegpdf-lib

How does it compare?

krimdev/snaffle0xradioac7iv/tempfs7vignesh/pgpulse
Stars000
LanguageTypeScriptTypeScriptTypeScript
Setup difficultyeasymoderatemoderate
Complexity2/53/54/5
Audiencegeneraldeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

Just needs Node.js installed, snaffle downloads its own yt-dlp and ffmpeg binaries automatically.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

So what is it?

Snaffle is a terminal tool for grabbing videos from the web and converting media files, all without uploading anything to a server. Everything runs on your own machine, which avoids the sketchy download sites full of fake buttons and watermarks, and it avoids sending your private files to someone else's server just to convert them. To use it, you install Node.js and then run npx snaffle. The tool automatically fetches the yt-dlp and ffmpeg programs it needs the first time you run it, so there is nothing else to set up by hand. Finished files are saved into a Downloads/snaffle folder on your computer. The grab feature lets you paste a link from YouTube, TikTok, Facebook, Instagram, X, or over a thousand other sites supported by the underlying yt-dlp project, and choose to save it as an MP4 video at a chosen quality or as an MP3 audio file. The convert feature includes a built in file browser so you can point to any file on your computer, and it will only show formats that make sense for that file, such as turning a video into a smaller MP4, an MP3, an M4A, or a WAV. There is also a trim tool that cuts a section out of a video or audio clip by typing a start and end time, done quickly without re-encoding the whole file. A separate set of PDF tools works fully offline using a JavaScript library called pdf-lib. These let you turn a set of images into a single PDF, merge multiple PDFs together, or split specific pages out of a PDF using a simple page range. All of these jobs, whether downloads, conversions, or PDF tasks, run in a queue you can watch, showing progress, speed, and estimated time remaining. The project notes that downloading from a platform may be subject to that platform's terms of service and to copyright law, so it is meant for content you are actually allowed to save. The project is released under the MIT license.

Copy-paste prompts

Prompt 1
Show me how to run snaffle with npx and download a YouTube video as MP3.
Prompt 2
Explain how snaffle's file browser lets me convert a local video to a smaller MP4.
Prompt 3
Walk me through using snaffle's trim tool to cut a 30 second clip from a video.
Prompt 4
Help me use snaffle's PDF tools to merge several PDF files into one.

Frequently asked questions

What is snaffle?

A terminal app that downloads videos from popular sites and converts video, audio, and PDF files, all running locally on your own computer.

What language is snaffle written in?

Mainly TypeScript. The stack also includes TypeScript, Node.js, yt-dlp.

What license does snaffle use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is snaffle to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is snaffle for?

Mainly general.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.