Show HN: Hermes – Self-hosted video downloader

🎥 Download videos from YouTube and 1000+ sites with a robust API and beautiful, modern interface

Hermes is a self-hosted video downloader built on yt-dlp.

This tool is designed for content creators who wish to lawfully use freely available media under fair use (best explained by Tom Scott). Hermes does not endorse piracy, freebooting, or using downloads to bypass advertising.

• 🎥 Universal Support - Download from YouTube, Vimeo, TikTok, and 1000+ sites
• ⚡ Background Processing - Queue downloads and process them asynchronously
• 🔒 Secure Authentication - JWT tokens with API key management
• 🐳 Docker Ready - One-command deployment with Docker Compose

That's it! 🎉 Your Hermes instance will be available at:

• Web App: http://localhost:3000
• API Docs: http://localhost:3000/api/v1/docs (via proxy)

For development with hot reload:

• Dev Server: http://localhost:5173 (Vite with hot reload)
• API: http://localhost:8000 (direct access)

The default setup uses Caddy as a reverse proxy. You can customize it by editing the Caddyfile:

See our Reverse Proxy Guide for integrating with existing setups (Traefik, nginx, etc.).

If you run into problems, please use our issue templates instead of generic issues:

• 🐛 Bug Report - For unexpected behavior
• 🔧 API Issues - Backend problems
• 🎨 Frontend Issues - UI/UX problems
• 🐳 DevOps Issues - Docker/deployment issues

These templates help us help you faster! 🚀

• Configuration Guide - Complete environment variables and settings reference
• Deployment Guide - Docker volumes, production deployment, and troubleshooting
• Contributing Guide - How to contribute code, tests, and documentation
• API Documentation - Complete API reference and examples
• Frontend Guide - React app development guide
• Interactive API Docs - Live Swagger documentation

We welcome contributions! Here's how to get involved:

Use our issue templates to report bugs and request features:

• 🐛 Bug Report - Report bugs and unexpected behavior
• ✨ Feature Request - Suggest new features
• 🔧 API Issues - Backend/API specific issues
• 🎨 Frontend Issues - UI/UX and frontend issues
• 🐳 DevOps Issues - Docker/deployment issues
• 📚 Documentation - Documentation improvements

See our contribution guidelines for development setup, testing, and code standards.

See LICENSE for details.

This could be you! Bring Hermes to the world by hosting a public instance and getting featured here!