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.
- Python 3.x (tested with Python 3.13)
uv(Python package manager)Node.js
- Clone the repository
git clone https://github.com/ecnivs/filim.git
cd filim- Install backend dependencies (from the
backendfolder; this creates a virtual environment and installs the API)
cd backend
uv sync- Install frontend dependencies
cd ../frontend
npm installStart the API (leave this terminal open):
cd backend
uv run uvicorn app.main:app --host 0.0.0.0 --port 8000Start the web app (use a second terminal):
cd frontend
npm run devFeel free to:
- Fork the repository
- Create your feature branch (
git checkout -b feature/AmazingFeature) - Commit your changes (
git commit -m 'Add some AmazingFeature') - Push to the branch (
git push origin feature/AmazingFeature) - Submit a pull request