# iv-org/invidious

**Attribution required: if you use, quote, or summarise this content, you must credit and link back to [awesome-repositories.com](https://awesome-repositories.com/repository/iv-org-invidious).**

18,646 stars · 2,080 forks · Crystal · agpl-3.0

## Links

- GitHub: https://github.com/iv-org/invidious
- Homepage: https://invidious.io
- awesome-repositories: https://awesome-repositories.com/repository/iv-org-invidious.md

## Topics

`agplv3` `hacktoberfest` `invidious` `libre` `video` `watch` `youtube` `youtube-video`

## Description

Invidious is a privacy-focused, self-hosted alternative frontend for mainstream video platforms. It operates as a decentralized network of independent instances that provide a lightweight, ad-free interface for consuming media. By acting as a proxy between the user and the content provider, the platform prevents tracking and data collection while maintaining a familiar browsing experience.

The project distinguishes itself through its robust suite of network-level traffic management and anonymization tools. It employs techniques such as IP rotation, reverse proxy stream routing, and integration with anonymity networks to bypass regional restrictions and service-side blocks. Furthermore, it utilizes server-side adaptive stream re-muxing to deliver high-quality media without requiring client-side tracking dependencies.

Beyond its core proxy capabilities, the platform offers comprehensive tools for content discovery, subscription management, and playlist organization. It provides a structured API for programmatic access to metadata and community interactions, allowing for the development of external applications and custom integrations. Users can manage their viewing history and preferences locally, with support for importing existing subscription data from other platforms.

The software is designed for containerized deployment and includes administrative utilities for instance monitoring, database maintenance, and infrastructure scaling. Documentation and configuration files are provided to support consistent setup and management across distributed, self-hosted environments.

## Tags

### Web Development

- [Alternative Front-Ends](https://awesome-repositories.com/f/web-development/alternative-front-ends.md) — Functions as a privacy-focused alternative web interface for mainstream video platforms.
- [Privacy-Focused Redirections](https://awesome-repositories.com/f/web-development/http-redirects/privacy-focused-redirections.md) — Intercepts and reroutes mainstream video platform URLs to privacy-focused alternative interfaces. ([source](https://docs.invidious.io/redirector/))
- [Third-Party Media Player Integrations](https://awesome-repositories.com/f/web-development/third-party-api-integrations/third-party-media-player-integrations.md) — Connects external media players to video sources to stream content without proprietary tracking. ([source](https://docs.invidious.io/applications/))
- [API Interfaces](https://awesome-repositories.com/f/web-development/api-interfaces.md) — Exposes a structured API for programmatic access to platform information and user actions. ([source](https://docs.invidious.io/))
- [Cross-Platform Media Servers](https://awesome-repositories.com/f/web-development/cross-platform-media-servers.md) — Operates as a decentralized network of instances providing access to video feeds and metadata.
- [Comment Management APIs](https://awesome-repositories.com/f/web-development/comment-management-apis.md) — Provides programmatic access to video comment threads for external applications. ([source](https://docs.invidious.io/api/))
- [Third-Party API Clients](https://awesome-repositories.com/f/web-development/third-party-api-clients.md) — Exposes a structured API for programmatic access to video metadata and community interactions.
- [Trending Content APIs](https://awesome-repositories.com/f/web-development/trending-content-apis.md) — Aggregates popular videos and regional data to highlight trending content. ([source](https://docs.invidious.io/api/))

### Data & Databases

- [Privacy-Focused Video Aggregators](https://awesome-repositories.com/f/data-databases/search-result-aggregators/privacy-focused-video-aggregators.md) — Provides a privacy-focused interface that removes ads and prevents tracking by mainstream video platforms.
- [Subscription Feed Retrievers](https://awesome-repositories.com/f/data-databases/data-feeds/subscription-feed-retrievers.md) — Fetches recent videos and metadata from followed channels to populate subscription feeds. ([source](https://docs.invidious.io/api/authenticated-endpoints/))
- [Data Scraping Tools](https://awesome-repositories.com/f/data-databases/data-scraping-tools.md) — Parses raw platform responses into structured data to provide programmatic access without relying on official proprietary APIs.
- [User Playlist Managers](https://awesome-repositories.com/f/data-databases/user-data-management/user-playlist-managers.md) — Supports retrieving collections of saved videos and metadata to help users organize personal media libraries. ([source](https://docs.invidious.io/api/authenticated-endpoints/))
- [Channel Update Subscriptions](https://awesome-repositories.com/f/data-databases/record-updating/live-update-subscriptions/channel-update-subscriptions.md) — Provides real-time notifications for new uploads and metadata changes via event-based subscriptions. ([source](https://docs.invidious.io/api/authenticated-endpoints/))
- [Content Management Search](https://awesome-repositories.com/f/data-databases/search-indexing-technologies/search-domains/content-management-search.md) — Supports advanced media content search with filters for duration and upload date. ([source](https://docs.invidious.io/api/))
- [User Data Management](https://awesome-repositories.com/f/data-databases/user-data-management.md) — Manages user-specific subscription lists and channel data within the application. ([source](https://docs.invidious.io/api/authenticated-endpoints/))
- [Expired Record Purging](https://awesome-repositories.com/f/data-databases/database-record-management/expired-record-purging.md) — Performs database maintenance by purging stale records and expired security tokens to reclaim storage. ([source](https://docs.invidious.io/db-maintenance/))
- [Channel Metadata Retrievers](https://awesome-repositories.com/f/data-databases/retrieval-metadata/channel-metadata-retrievers.md) — Fetches comprehensive profile information and subscriber counts for creator channels. ([source](https://docs.invidious.io/api/channels_endpoint/))
- [Playlist Metadata Retrievers](https://awesome-repositories.com/f/data-databases/retrieval-metadata/playlist-metadata-retrievers.md) — Fetches organized collections of videos along with title and author details. ([source](https://docs.invidious.io/api/common_types/))

### Networking & Communication

- [Automatic Traffic Redirection Handlers](https://awesome-repositories.com/f/networking-communication/traffic-redirection-tools/automatic-traffic-redirection-handlers.md) — Intercepts mainstream video platform requests and reroutes them to privacy-focused alternatives. ([source](https://docs.invidious.io/applications/))
- [Stream Proxies](https://awesome-repositories.com/f/networking-communication/stream-proxies.md) — Proxies media streams to enhance privacy and bypass regional restrictions by providing location hints. ([source](https://docs.invidious.io/url-parameters/))
- [Geographic Restriction Bypasses](https://awesome-repositories.com/f/networking-communication/network-infrastructure-routing/network-infrastructure-configuration/network-management/proxy-tunneling-clients/geographic-restriction-bypasses.md) — Implements IP rotation and proxying to bypass regional restrictions and service-side blocks. ([source](https://docs.invidious.io/))
- [IPv6 Rotation Services](https://awesome-repositories.com/f/networking-communication/proxy-rotation-services/proxy-and-fingerprint-rotation/ipv6-rotation-services.md) — Performs IPv6 address rotation within defined subnets to bypass service-side request blocking. ([source](https://docs.invidious.io/ipv6-rotation-simple/))
- [Traffic Proxying](https://awesome-repositories.com/f/networking-communication/traffic-proxying.md) — Acts as a web traffic proxy to forward requests while preserving headers for privacy and content access. ([source](https://docs.invidious.io/apache2/))
- [Subscription Data Importers](https://awesome-repositories.com/f/networking-communication/data-import/subscription-data-importers.md) — Transfers existing channel subscriptions from third-party platforms by parsing exported data files. ([source](https://docs.invidious.io/export-youtube-subscriptions/))

### Graphics & Multimedia

- [Video Hosting Platforms](https://awesome-repositories.com/f/graphics-multimedia/media-production-suites/graphics-media-assets/media-assets/video-content/video-hosting-platforms.md) — Acts as a self-hosted proxy to route media streams, mask IP addresses, and bypass regional restrictions.
- [Server-Side Re-muxers](https://awesome-repositories.com/f/graphics-multimedia/media-processing-analysis/media-manipulation/media-processing/codec-encoding-utilities/video-muxing/server-side-re-muxers.md) — Combines separate audio and video tracks on the server side to enable high-quality playback without client-side tracking.
- [Video Metadata Extraction](https://awesome-repositories.com/f/graphics-multimedia/media-processing-analysis/media-manipulation/media-processing/video-analysis-processing/video-metadata-extraction.md) — Fetches detailed video metadata including duration, resolution, and caption availability. ([source](https://docs.invidious.io/api/))
- [Playlist Content Retrievers](https://awesome-repositories.com/f/graphics-multimedia/streaming-distribution/streaming-broadcasting/media-streaming/playlist-aggregators/playlist-content-retrievers.md) — Fetches full lists of videos and metadata for specific collections with pagination support. ([source](https://docs.invidious.io/api/))
- [Video Streaming](https://awesome-repositories.com/f/graphics-multimedia/streaming-distribution/streaming-broadcasting/media-streaming/video-streaming.md) — Delivers high-quality video by re-muxing streams to exceed standard playback limitations. ([source](https://docs.invidious.io/geoblocking/))

### DevOps & Infrastructure

- [Self-Hosted Deployment Platforms](https://awesome-repositories.com/f/devops-infrastructure/self-hosted-deployment-platforms.md) — Enables users to deploy independent, privacy-focused video frontend instances on their own infrastructure. ([source](https://docs.invidious.io/instances/))
- [Containerized Deployments](https://awesome-repositories.com/f/devops-infrastructure/containerized-deployments.md) — Supports containerized deployment to automate the setup of the application and its dependencies for consistent production environments. ([source](https://docs.invidious.io/installation/))
- [Decentralized Instance Architectures](https://awesome-repositories.com/f/devops-infrastructure/decentralized-instance-architectures.md) — Operates as a network of independent, self-hosted servers that provide a unified interface for accessing external media platforms.
- [Reverse Proxies](https://awesome-repositories.com/f/devops-infrastructure/reverse-proxies.md) — Routes media traffic through an intermediary server to mask client IP addresses and bypass regional content restrictions.
- [Self-Hosted Media Servers](https://awesome-repositories.com/f/devops-infrastructure/self-hosted-applications/self-hosted-media-servers.md) — Facilitates the deployment of independent servers for private, community-maintained access to video content.
- [SSL Termination Proxies](https://awesome-repositories.com/f/devops-infrastructure/sidecar-proxies/ssl-termination-proxies.md) — Handles SSL/TLS termination to secure incoming traffic before forwarding to the application backend. ([source](https://docs.invidious.io/caddy/))
- [Self-Hosted Infrastructure Management](https://awesome-repositories.com/f/devops-infrastructure/deployment-management/self-hosted-infrastructure-management.md) — Provides administrative tools for maintaining self-hosted server instances, including database and proxy configuration. ([source](https://docs.invidious.io/))

### Security & Cryptography

- [Anonymization Proxies](https://awesome-repositories.com/f/security-cryptography/anonymization-proxies.md) — Routes requests through proxies and anonymity networks to mask user identity and bypass restrictions.
- [Regional Bypass Rules](https://awesome-repositories.com/f/security-cryptography/domain-access-restrictions/regional-bypass-rules.md) — Bypasses regional content restrictions by routing video streams through geographically diverse proxy servers. ([source](https://docs.invidious.io/geoblocking/))
- [Privacy-Focused Browsing](https://awesome-repositories.com/f/security-cryptography/privacy-focused-browsing.md) — Enables browsing video content through an interface that eliminates advertisements and platform tracking. ([source](https://docs.invidious.io/))
- [Video Streaming Clients](https://awesome-repositories.com/f/security-cryptography/privacy-preserving-utilities/video-streaming-clients.md) — Provides a lightweight, privacy-preserving interface for streaming media without proprietary tracking.
- [Traffic Masking Tools](https://awesome-repositories.com/f/security-cryptography/traffic-masking-tools.md) — Routes outgoing requests through diverse IP addresses or anonymity networks to prevent service-side blocking and protect user privacy.
- [JWT Session Management](https://awesome-repositories.com/f/security-cryptography/identity-access-management/authentication-strategies/session-and-credential-handling/session-credential-management/jwt-session-management.md) — Manages session tokens to verify connection status and track user session history. ([source](https://docs.invidious.io/api/authenticated-endpoints/))
- [Credential-Based Access Controls](https://awesome-repositories.com/f/security-cryptography/identity-based-access-control/credential-based-access-controls.md) — Protects sensitive resources by requiring username and password verification for requests. ([source](https://docs.invidious.io/gitea/))
- [Content Filtering Rules](https://awesome-repositories.com/f/security-cryptography/content-filtering-rules.md) — Generates content blocking rules for browser extensions to ensure site functionality across privacy-focused instances. ([source](https://docs.invidious.io/umatrix/))
- [Stateful Session Persistence](https://awesome-repositories.com/f/security-cryptography/identity-access-management/session-management/stateful-session-persistence.md) — Maintains browser context and authentication state across multi-step web interactions using database persistence.
- [User Account Management](https://awesome-repositories.com/f/security-cryptography/user-account-management.md) — Supports user account registration on private instances by interacting with local services. ([source](https://docs.invidious.io/register-user/))

### Artificial Intelligence & ML

- [HTTP Authentication Middleware](https://awesome-repositories.com/f/artificial-intelligence-ml/agentic-systems-frameworks/agent-orchestration-multi-agent/security-and-auth/authentication-strategies/request-handling/http-authentication-middleware.md) — Enforces HTTP authentication requirements on incoming requests to the application interface. ([source](https://docs.invidious.io/apache2/))

### Content Management & Publishing

- [Syndication Feed Generators](https://awesome-repositories.com/f/content-management-publishing/content-aggregation-curation/syndication-feed-generators.md) — Maps internal platform URLs into standard syndication formats for external feed readers. ([source](https://docs.invidious.io/redirector/))
- [Community Content Feeds](https://awesome-repositories.com/f/content-management-publishing/community-content-feeds.md) — The platform supports community post retrieval including associated comment threads and metadata to display creator updates and audience responses. ([source](https://docs.invidious.io/api/channels_endpoint/))

### System Administration & Monitoring

- [Playback History Trackers](https://awesome-repositories.com/f/system-administration-monitoring/analytics-tracking/review-history-visualization/playback-history-trackers.md) — Maintains a chronological record of watched videos to facilitate activity monitoring and playback resumption. ([source](https://docs.invidious.io/api/authenticated-endpoints/))
- [Instance Operational Metrics](https://awesome-repositories.com/f/system-administration-monitoring/instance-administration-tools/instance-operational-metrics.md) — Reports operational statistics to assist administrators in monitoring service health. ([source](https://docs.invidious.io/api/))

### User Interface & Experience

- [Playback Controllers](https://awesome-repositories.com/f/user-interface-experience/playback-controllers.md) — Provides playback control to adjust player behavior including autoplay, looping, speed, volume, and timestamp management. ([source](https://docs.invidious.io/url-parameters/))
- [Interface Customizers](https://awesome-repositories.com/f/user-interface-experience/interface-customizers.md) — Supports interface experience customization by configuring visual themes and content display settings. ([source](https://docs.invidious.io/preferences/))
- [Media Player Interfaces](https://awesome-repositories.com/f/user-interface-experience/media-player-interfaces.md) — Allows player feature customization by toggling interface elements like comments and annotations or selecting specific quality settings. ([source](https://docs.invidious.io/url-parameters/))
- [Preference Enforcement Engines](https://awesome-repositories.com/f/user-interface-experience/user-preference-settings/preference-enforcement-engines.md) — Applies custom viewing settings across multiple instances without relying on local storage. ([source](https://docs.invidious.io/applications/))

### Business & Productivity Software

- [User Preference Management](https://awesome-repositories.com/f/business-productivity-software/user-preference-management.md) — Provides systems for storing and retrieving individual user settings and configuration preferences. ([source](https://docs.invidious.io/api/authenticated-endpoints/))

### Software Engineering & Architecture

- [Application Configuration](https://awesome-repositories.com/f/software-engineering-architecture/application-configuration.md) — Allows application configuration through centralized files to define operational parameters and environment overrides. ([source](https://docs.invidious.io/configuration/))
- [Stateless Architectures](https://awesome-repositories.com/f/software-engineering-architecture/stateless-architectures.md) — Defines application behavior through centralized files and environment variables to ensure consistent deployment across distributed server instances.
