Filim: Full-Stack Streaming Platform by Vince SwuFilim: Full-Stack Streaming Platform by Vince Swu

Filim: Full-Stack Streaming Platform

Vince Swu

Vince Swu

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.js

Installation

Clone the repository
git clone https://github.com/ecnivs/filim.git
cd filim
Install backend dependencies (from the backend folder; this creates a virtual environment and installs the API)
cd backend
uv sync
Install frontend dependencies
cd ../frontend
npm install

Running Filim

Start the API (leave this terminal open):
cd backend
uv run uvicorn app.main:app --host 0.0.0.0 --port 8000
Start the web app (use a second terminal):
cd frontend
npm run dev
Like this project

Posted 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.