VaultTube — Local YouTube Video Library

A self-hosted app to download YouTube videos and play them in a gallery.

---

Requirements

• Python 3.8+
• pip

---

Setup

1. Install dependencies

pip install -r requirements.txt

Or manually:

pip install flask flask-cors yt-dlp

2. Run the server

python app.py

3. Open in browser

Navigate to: http://localhost:5000

---

Usage

1. Paste any YouTube URL into the input at the top
2. Click Download — the video is saved to a videos/ folder
3. Once downloaded, it appears as a card in the gallery
4. Click any card to play the video in a popup player
5. Click the trash icon on a card to delete it

---

Notes

• Videos are downloaded in MP4 format (up to 720p for efficiency)
• Thumbnails are automatically saved alongside the video
• All video metadata (title, duration, uploader) is stored in videos/metadata.json
• Downloads may take a minute depending on video length and your connection

---

Folder structure

app.py               ← Flask backend
requirements.txt     ← Python dependencies
static/
  index.html         ← Frontend UI
videos/
  <id>.mp4           ← Downloaded videos
  <id>.jpg           ← Thumbnails
  metadata.json      ← Video metadata

---

License

This project is licensed under the GNU General Public License v3.0.