Overview
Filim is a self-hosted Next.js frontend and FastAPI backend for browsing catalogs and playing streams in your browser (HLS in the client). It is an automation and convenience layer around content that is already published on the public internet: the app requests metadata and stream pointers from independent third-party sources and does not operate as a host or permanent archive of video files. Conceptually it is closer to a specialized browser than to a streaming service that stores or redistributes media.
Caution
Use at your own risk. Whether your use complies with local law and with the terms of any third-party site is entirely your responsibility. The authors do not control what those sources serve and are not responsible for your choice to access particular material.
Copyright and DMCA: Claims about infringing material should be directed to the sites or providers that actually host or deliver the content, not to this repository as a substitute. Tools in this space (for example ani-cli) document that notices for similar integrations may belong with providers such as allanime.to. Please do not use GitHub issues to harass maintainers about third-party media.
Prerequisites
Python 3.x (tested with Python 3.13)
uv (Python package manager)Node.jsInstallation
Clone the repository
Install backend dependencies (from the
backend folder; this creates a virtual environment and installs the API)Install frontend dependencies
Running Filim
Start the API (leave this terminal open):
Start the web app (use a second terminal):
2 likes · 17 views · Aug 9, 2026
Built a full-stack streaming platform with Next.js and FastAPI, including HLS playback, APIs, external integrations, and a self-hosted architecture.