yt-dlf/INSTALL.md

Deployment

What's in the package

build/                    ← compiled SvelteKit server (self-contained, no npm needed)
scripts/
  subtitle_to_markdown.py ← standalone subtitle converter CLI
  create_zip.py           ← ZIP creation helper (used internally by the server)
  add_user.py             ← user management CLI
start.sh                  ← startup script
users.txt                 ← user database (hashed passwords)
ads-left.html             ← ad content for the left column (edit freely)
ads-right.html            ← ad content for the right column (edit freely)
README.md
INSTALL.md

Prerequisites on the Linux server

Node.js 18 or newer, Python 3, yt-dlp, and ffmpeg must be installed.

# ffmpeg, Node.js, and Python via apt
sudo apt install ffmpeg nodejs python3

# yt-dlp (latest release)
sudo curl -L https://github.com/yt-dlp/yt-dlp/releases/latest/download/yt-dlp \
  -o /usr/local/bin/yt-dlp
sudo chmod +x /usr/local/bin/yt-dlp

Installation

tar -xzf yt-dlf.tar.gz
cd yt-dlf

User management

Unauthenticated visitors see the app with ad columns. Logged-in users see no ads. The login page is at /login (not linked from the main page).

Add or update a user:

python3 scripts/add_user.py <username> <password>

Users are stored in users.txt (one entry per line, scrypt-hashed passwords). Sessions are held in memory — they reset when the server restarts.

Ad content

Edit ads-left.html and ads-right.html to replace the placeholder content with real ads. The server caches these files at startup — restart the server after editing them.

Running

./start.sh

The server listens on port 3000 by default. Open http://your-server:3000 in a browser.

Environment variables

Edit start.sh to configure the variables below, or pass them directly on the command line.

General

Variable	Default	Purpose
PORT	3000	Port to listen on
ORIGIN	http://localhost:PORT	Public URL of the server — set this in production
YTDLP_PATH	yt-dlp	Full path to yt-dlp binary if not on PATH
FFMPEG_PATH	ffmpeg	Full path to ffmpeg binary if not on PATH
DOWNLOAD_DIR	~/YouTube	Directory where downloaded files are stored on the server
USERS_FILE	users.txt next to start.sh	Path to the user database file
ADS_DIR	same directory as start.sh	Directory containing ads-left.html and ads-right.html

ZIP & Send mode

When ZIP_AND_SEND=true, all downloaded files are packed into a ZIP and offered as a browser download instead of (only) being saved on the server. A random prefix is added to the temporary directory name to avoid collisions when multiple users download the same video simultaneously.

Variable	Default	Purpose
ZIP_AND_SEND	false	Enable ZIP & Send mode
ZIP_EXTRA_DIR	(none)	Optional directory whose files are added to every ZIP alongside the downloaded files. Subdirectory structure is preserved.
DELETE_AFTER_SEND	false	Delete files from the server after the ZIP has been sent to the browser
DELETE_DELAY	0	Seconds to wait before deleting files after the ZIP has been sent

Examples

Custom port and public URL:

PORT=8080 ORIGIN=http://myserver:8080 ./start.sh

ZIP & Send with cleanup after 60 seconds:

ZIP_AND_SEND=true DELETE_AFTER_SEND=true DELETE_DELAY=60 ./start.sh

ZIP & Send with extra files bundled into every download:

ZIP_AND_SEND=true ZIP_EXTRA_DIR=/opt/yt-dlf/extras ./start.sh