About¶
Channel Vault NAS is a guarded, self-hosted console for archiving your own
YouTube channels with yt-dlp. It syncs channel metadata, stages only missing
videos, runs guarded download passes, and keeps a disk-aware library of what you
actually have on the NAS.
Personal archiving only
Archive channels you own or have the right to archive. You are responsible for complying with YouTube's Terms of Service and copyright law in your jurisdiction. See Use boundaries.
Images & releases¶
-
Docker Hub
-
GitHub Container Registry
-
Release
v0.2.0— versioned Docker Hub and GHCR images. -
Source
Deep documentation¶
These documents live in the repository and render on GitHub:
| Document | What it covers |
|---|---|
| Architecture | Backend/frontend/worker/scheduler structure. |
| Product brief | What the product is and who it's for. |
| Roadmap | Planned direction. |
| Deployment & security | Exposure model, tokens, reverse proxy. |
| Backup & restore | Protecting the metadata index. |
| Storage recovery | Reconciling drift and orphan sidecars. |
| Archive priorities | What to archive first. |
| Channel registration recommendations | Getting the source right. |
| NAS install notes | Extra Synology / QNAP detail. |
| Bring an existing archive | Reconcile NAS folders and archive.txt without starting over. |
| Is it for me? | A factual workflow comparison with other self-hosted archivers. |
Relationship to youtube-dl-nas¶
Channel Vault NAS is a modern, guarded successor in spirit to the classic
youtube-dl-nas workflow — the same "archive to my NAS" goal, rebuilt around a
FastAPI + React console, a disk-aware library, and safe-by-default download guards.
License & responsibility¶
The project is open source on GitHub. It is intended for archiving content you own or have the right to archive. Review the use boundaries before you begin.