Discover VidArch
Architecture
The components that make VidArch work.
VidArch combines a React interface and a Node.js API within a single service.
Components
| Component | Role |
|---|---|
| React Interface | navigation, search, library, player, and settings |
| Express API | authentication, channels, videos, downloads, and configuration |
| SQLite | metadata, subscriptions, history, playlists, and queue |
| yt-dlp | remote search, metadata, and download |
| ffmpeg / ffprobe | media processing and inspection |
| Local Storage | videos, thumbnails, metadata, and channel resources |
In production, the API also serves the compiled interface. The default public port is 2499. In development, Vite uses 2499 and the API uses 2498.
See Code Architecture for the repository structure.