Epithium
/
vidrip
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
11 Commits 3 Branches 0 Tags 273 KiB
TypeScript 90.4%
Shell 8.4%
HTML 0.6%
CSS 0.4%
JavaScript 0.2%
Go to file
Ryan Whytsell e16d95eacd
Use downloads path rather than direct webdav 		2025-10-21 19:54:57 -04:00
backend Use downloads path rather than direct webdav 2025-10-21 19:54:57 -04:00
frontend Use downloads path rather than direct webdav 2025-10-21 19:54:57 -04:00
.gitignore Initial commit 2025-10-18 12:28:40 -04:00
CLAUDE.md QoL features 2025-10-21 11:01:03 -04:00
Caddyfile Caddyfile deployment improvements 2025-10-21 19:46:35 -04:00
DEPLOYMENT.md Caddyfile deployment improvements 2025-10-21 19:46:35 -04:00
PROJECT_CONTEXT.md Initial commit 2025-10-18 12:28:40 -04:00
README.md Initial commit 2025-10-18 12:28:40 -04:00
package-lock.json Initial commit 2025-10-18 12:28:40 -04:00
package.json Initial commit 2025-10-18 12:28:40 -04:00
start-production.sh Missing $ 2025-10-21 19:48:42 -04:00
stop-production.sh Reset error message and create deployment scrips 2025-10-18 15:00:04 -04:00
vidrip.service Reset error message and create deployment scrips 2025-10-18 15:00:04 -04:00

README.md

VidRip

A respectful YouTube video drip downloader that slowly and gradually downloads videos from channels over time.

Features

  • Add YouTube channels or individual videos
  • Configurable download intervals (default: every few hours)
  • Configurable variance to avoid predictable patterns
  • Watch downloaded videos in the browser
  • Track download progress and status
  • Lightweight SQLite database

Tech Stack

Backend:

  • Node.js + Express + TypeScript
  • SQLite (better-sqlite3)
  • yt-dlp for downloading
  • node-cron for scheduling

Frontend:

  • React + TypeScript
  • Vite
  • Tailwind CSS
  • React Router

Setup

Prerequisites

  • Node.js 18+
  • yt-dlp installed and available in PATH

Installation

  1. Install yt-dlp:
# On Linux/Mac
pip install yt-dlp
# or
brew install yt-dlp

# On Windows
# Download from https://github.com/yt-dlp/yt-dlp/releases
  1. Install backend dependencies:
cd backend
npm install
  1. Install frontend dependencies:
cd frontend
npm install

Running

  1. Start the backend:
cd backend
npm run dev
  1. Start the frontend:
cd frontend
npm run dev
  1. Open http://localhost:3000

Configuration

Default settings:

  • Download interval: 3 hours
  • Time variance: ±30 minutes
  • Storage location: backend/downloads/

These can be configured in the UI settings page.