How iv-org/invidious works
Invidious is a self-hostable alternative front end to YouTube. A visitor requests video, channel, search, or account features through the web application; the application presents results and can persist user data such as subscriptions and preferences. The README also documents comments, playlists, feeds and notifications, imports/exports, embedded playback, and a developer API. The tree identifies likely implementation areas, but the supplied source excerpts cover only a release script, so internal runtime calls and data flow cannot be verified; those relationships are omitted rather than inferred.
Main entry points: routes Web routes · user Accounts and preferences · jobs Background jobs · player.js Video player
Components 19
Web experience
- Web routes
src/invidious/routes - Page rendering
src/invidious/frontend - Page templates
src/invidious/views - Video player
assets/js/player.js
YouTube content
- Search
src/invidious/search - Video content
src/invidious/videos - YouTube access
src/invidious/yt_backend - Channels
src/invidious/channels - Comments
src/invidious/comments - Playlists
src/invidious/playlists
User data
- PostgreSQL
src/invidious/database - Accounts and preferences
src/invidious/user - Data import/export
src/invidious/user/imports.cr - Subscriptions
src/invidious/routes/subscriptions.cr
Feeds and API
- Background jobs
src/invidious/jobs - Feeds and notifications
src/invidious/feeds - Developer API
src/invidious/routes/api/v1
Other components
- Visitor
- YouTube
Connections 12
- Visitor → Web routes: requests pages
README.md - Web routes → YouTube: serves YouTube content
- Visitor → Developer API: uses API
README.md - Visitor → Video player: plays embedded video
README.md - Visitor → Accounts and preferences: manages preferences
README.md - Visitor → Subscriptions: subscribes to channels
README.md - Visitor → Data import/export: imports or exports data
README.md - Visitor → Comments: reads comments
README.md - Visitor → Search: searches videos
README.md - Visitor → Playlists: uses playlists
- Background jobs → Feeds and notifications: refreshes feeds
- Accounts and preferences → PostgreSQL: stores user data