3f611849af
Prose + commands updated to the new name: brand reads "Catacomb", while binary/path/package references are the lowercase `catacomb` (commands, deb/rpm names, ~/.local/share/catacomb, catacomb.db, catacomb.desktop). Codeberg repo URLs left pointing at the existing repo. Also folds in the pending doc edits from earlier in the session. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
1.6 KiB
Catacomb
A self-hosted media archive for YouTube and friends. Paste any URL, it routes the download to the right folder by source, tracks what you've watched, and plays everything back from a desktop GUI or a browser — even offline, or after the source video is taken down.
Built on yt-dlp; written in Rust as a single binary that is both a desktop app and a headless web server.
What it backs up
| Platform | Channels | Playlists | Single videos |
|---|---|---|---|
| YouTube | ✅ | ✅ | ✅ |
| TikTok | ✅ | — | ✅ |
| Twitch (VODs + clips) | ✅ | — | ✅ |
| Vimeo | ✅ | ✅ | ✅ |
| Bandcamp | ✅ (artist) | ✅ (albums) | ✅ (tracks) |
| SoundCloud | ✅ | ✅ (sets) | ✅ |
| Odysee | ✅ | — | ✅ |
| Anything else yt-dlp accepts | other/ |
other/ |
other/ |
Why it exists
Tartube is the mature open-source yt-dlp GUI and the benchmark in this space. catacomb matches its feature set while adding things Tartube doesn't have: a real web UI reachable from any device, a single-binary distribution with a bundled toolchain, a modern security model (password-gated UI, Argon2, rate-limited login), a built-in anti-bot stack (TLS impersonation + Proof-of-Origin tokens), and one-click post-download format conversion.
How to read these docs
- New here? Installation → First run → Downloading.
- Hitting captchas or "Video unavailable"? Go straight to Anti-bot and Troubleshooting.
- Hacking on it? Architecture.