Containerized Movie & Series Streaming Platform for Fire TV & Google TV
FireGeek is a premium, fully dockerized streaming application optimized for Fire TV & Google TV. It offers a Netflix-like experience with spatial navigation, smart recommendations, and a vast library of movies and series.
- 📺 Fire TV & Google TV Optimized: Large touch targets, spatial navigation (D-Pad support), and high contrast UI.
- 🎥 Smart Browsing: Explore collections sorted by genre, release date, or popularity.
- 🔍 Unified Search: Instantly find both Movies and TV Series with smart filtering.
- 🧠 Recommendation Engine: Personalized suggestions tailored to your viewing history.
- 🐳 Pure Docker: Zero-dependency architecture; runs entirely in containers.
- 🎨 Responsive UI: Seamless viewing experience across TV and large screens.
- Docker Desktop: Ensure Docker is installed and running.
- Git: To clone the repository.
- Note: No Node.js or npm is required on your host machine.
-
Clone the repository and navigate to the root:
git clone https://github.com/dragonpilee/firegeek.git cd FireGeek -
Configure your environment variables: Create a
.envfile in the root directory with your TMDb API Key:TMDB_API_KEY=your_api_key_here
-
Build and launch the container:
docker-compose up -d --build
-
Open your browser (or Amazon Silk) and visit: http://localhost:3000
| Component | Technology |
|---|---|
| Core Framework | Next.js (React) |
| Language | TypeScript |
| Styling | Tailwind CSS |
| Data Sources | TMDb API, vidsrc |
| Infrastructure | Docker, Docker Compose |
Important: This project enforces a strict Docker-only workflow.
- Fork & Branch: Create a new branch for your feature.
- Develop: Test all changes inside the container (
docker-compose up). - Commit & Push: Submit your changes via Pull Request.
Developed with ❤️ by Cinegeek
Optimized for Fire TV & Google TV
Optimized for Fire TV & Google TV