Frames is a modern, self-hosted SVOD streaming service designed for users who want to organize and stream their personal media collection from various cloud storage providers or local files. It offers a feature-rich, visually appealing interface with advanced playback, media enrichment, and social viewing capabilities, aiming to be a free alternative to proprietary platforms like Plex.

How It Works

Frames utilizes a React frontend and a NestJS backend, connecting to diverse media sources including local storage, S3, Dropbox, and Google Drive. It automatically enriches media with metadata from TMDB and Fanart, and employs OpenAI embeddings for smart content recommendations. Playback is handled by an advanced player with broad subtitle support, and a GroupWatch feature enables synchronized viewing sessions.

Quick Start & Requirements

• Install/Run: Docker (recommended) or Docker Compose.
• Prerequisites: PostgreSQL, Redis, TMDB API key, FanArt API key, OpenAI API key (required for full functionality).
• Setup: Docker Compose setup with PostgreSQL and Redis is provided.
• Docs: API documentation available at /swagger endpoint.

Highlighted Details

• Universal media support from local storage and multiple cloud providers.
• AI-powered content recommendations via OpenAI embeddings.
• GroupWatch feature for synchronized viewing with friends.
• Comprehensive media organization and playlist creation/sharing.

Maintenance & Community

• Project is actively developed with community contributions welcomed.
• Links to GitHub issues and repository for support.

Licensing & Compatibility

• The README does not explicitly state a license. Compatibility for commercial use or closed-source linking is not specified.

Limitations & Caveats

• Optional environment variables (TMDB, FanArt, OpenAI API keys) are stated as required for proper application function.
• Chromecast support is listed as "coming soon" and currently being redeveloped.
• A granular permissions system is also listed as "coming soon."