Transform your media collection into a professional streaming platform! HomeFlix is a full-featured streaming platform that automatically organizes and streams your movies and TV shows with a beautiful, responsive interface. Search movies from directly TMDB and get updated on new movies or tv shows, trailers.
Watch Demo on Youtube!
- Native TV Application: Dedicated TV app for the best big-screen experience
- Repository: https://github.com/azad25/homeflix-tv-app
- Features: TV-optimized interface to stream Media on HomeFlix, remote control D-PAD support, and enhanced movies/TV-Series browsing
- Platform: Built for Android TVs and TV boxes with seamless HomeFlix integration
** Please give a star on this repo if you like it and want more updates!
Netflix-quality live notification system with dynamic tile rotation! HomeFlix now features a professional notification feed with auto-playing trailers, smart content rotation, and beautiful gradient designs that showcase trending content, new releases, and personalized recommendations.
Complete customizable widget ecosystem with Netflix-style interface! HomeFlix features a professional widget management system with drag-and-drop configuration, performance monitoring, and beautiful glassmorphism design.
Complete subtitle ecosystem with OpenSubtitles integration! HomeFlix features professional subtitle management with automatic downloads, multi-language support, and seamless integration with the world's largest subtitle database.
Download movies directly from TMDB pages with one click! HomeFlix includes a complete torrent download system with real-time progress tracking, automatic library integration, and professional UI.
- Live Activity Feed: Real-time notification tiles with dynamic content rotation
- Netflix-Style Design: Cinematic tile layouts with auto-playing trailers and smooth animations
- Smart Rotation: Tiles automatically rotate every 5 seconds showing fresh content
- 16 Notification Types: Trending, Now Playing, Coming Soon, Continue Watching, and more
- Intelligent Caching: Instant page loads with localStorage caching and background updates
- Auto-Playing Trailers: Hero and large tiles feature YouTube trailers with audio controls
- Gradient Backgrounds: Beautiful genre-based color schemes with smooth transitions
- Poster Integration: TMDB poster URLs with intelligent fallback to gradients
- Progress Tracking: Continue watching tiles show completion percentage and time remaining
- Multi-Item Display: Grid layouts showing multiple movies in single notifications
- Instant Loading: <100ms page load with aggressive caching (previously 2-5 seconds)
- Zero 404 Errors: Strict URL validation prevents broken image requests
- Smart Refresh: Auto-refresh every 10 seconds for new notifications
- Concurrent Generation: Backend generates notifications every 15 seconds
- 100 Notification Pool: Large variety pool ensures unique content rotation
- Continue Watching: Resume partially watched content with progress bars
- TMDB Trending: Worldwide trending movies and TV shows with trailers
- Now Playing: Currently in theaters with high-quality trailers
- Coming Soon: Future releases with countdown timers
- Recently Added: Newly added local content
- Local Trending: Popular content in your library
- Genre-Based: Personalized recommendations by favorite genres
- Now Airing TV: Currently airing TV series episodes
- Upcoming TV: New TV episodes coming soon
- Single Suggestions: Curated individual movie recommendations
- Glassmorphism Effects: Modern glass-like design with backdrop blur
- Genre Color Themes: Dynamic color palettes based on content genres
- Smooth Animations: Framer Motion animations for all tile transitions
- Priority Badges: "HOT" indicators for high-priority content
- Responsive Grid: Perfect tile arrangement on all screen sizes
- Breathing Effects: Subtle animations for high-priority notifications
- Click Navigation: Tiles navigate to movie/TMDB detail pages
- Trailer Controls: Unmute buttons for hero tile trailers
- Unique Content: No duplicate tiles, each notification shown once
- Size Matching: Smart rotation maintains layout stability
- Trailer Protection: Tiles with playing trailers don't rotate
- Background Updates: Notifications refresh without page reload
- Dynamic Tile System: Mosaic-style notification tiles with automatic layout optimization
- Real-Time Updates: Live content feed that refreshes every 10 seconds with new recommendations
- Smart Rotation: Tiles automatically rotate every 5 seconds showing diverse content
- Instant Loading: localStorage caching provides <100ms page load times
- Zero Duplicates: Intelligent deduplication ensures unique content display
- Full Viewport Coverage: 95%+ screen coverage with optimized tile placement
- Continue Watching: Resume content with progress bars and time remaining
- TMDB Trending: Worldwide trending movies and TV shows with trailers
- Now Playing: Movies currently in theaters with release information
- Coming Soon: Upcoming releases with countdow Recently Added: Latest additions to your local lib
- Genre-Based: Personalized recommendations based on viewing history
- Local Trending: Popular content in your col Featured Banner: Hero-style banners with auto-playing trailers and metadata
- Trending Slideshow: Netflix-style carousels with ranking numbers and hover effects
- New Episodes: TV series updates with episode information
- Gradient Backgrounds: Genre-based color schemes and visual themes
- Auto-Playing Trailers: YouTube trailer integration for hero tiles
- Poster Display: High-quality movie posters with fallback handling
- Quality Badges: HD/4K indicators and rating displays
- Progress Tracking: Visual progress bars for continue watching
- Smooth Animations: Framer Motion animations for tile transitions
- Aggressive Caching: 5-minute localStorage cache with background updates
- Concurrent Loading: Parallel notification fetching for faster load times
- Smart Deduplication: Prevents duplicate content across all notification types
- Optimized Rendering: Only renders visible tiles with lazy loading
- Memory Management: Efficient cleanup and garbage collection
- Click Navigation: Tiles navigate to movie/TV detail pages
- Trailer Playback: Watch trailers directly in notification tiles
- Audio Controls: Unmute buttons for trailer audio
- Hover Effects: Netflix-style hover animations and previews
- Responsive Layout: Perfect display on desktop, tablet, and mobile
- Drag-and-Drop Configuration: Visual widget editor with real-time preview
- Netflix-Style Design: Glassmorphism interface with backdrop blur effects
- Performance Dashboard: Real-time widget performance monitoring and optimization
- Custom Layouts: Full-width, half-width, and third-width widget arrangements
- Smart Positioning: Intelligent widget placement that doesn't interfere with hero content*Movie Grid**: Responsive grid layouts with poster displays and action buttons
- Backdrop Slideshow: Cinematic backdrop rotations with smooth transitions
- Trailer Widget: YouTube trailer integration with auto-play and controls
- Genre-Based Widgets: Dynamic content filtering by movie/TV genres
- Recently Watched: Personal viewing history with continue watching functionality
- Coming Soon: Upcoming releases with release date countdowns
- Notification Widget: System alerts and updates with dismissible interface
- Async Loading: Non-blocking widget loading with skeleton placeholders
- Smart Caching: 5-minute TTL cache with automatic invalidation
- Concurrent Data Fetching: Parallel data loading using goroutines for 70% faster performance
- Error Boundaries: Graceful error handling that doesn't break the entire page
- Performance Monitoring: Real-time metrics tracking load times and render performance
- Content Source Flexibility: Mix local media with TMDB content in any widget
- Visual Editor: Point-and-click widget configuration with live preview
- Content Selectors: Choose specific movies, genres, or data sources per widget
- Layout Controls: Adjust widget sizes, positions, and visual themes
- Page Management: Add widgets to any page (Home, Movies, TV Shows, My List)
- Template System: Pre-built widget configurations for quick setup
- Export/Import: Save and share widget configurations
- Load Time Optimization: Widget pages now load in under 500ms (previously several seconds)
- Memory Management: Efficient component lifecycle with automatic cleanup
- Render Optimization: Smart re-rendering only when data changes
- Performance Reports: Detailed analytics on widget performance and user engagement
- Error Tracking: Comprehensive error logging and recovery mechanisms
- Cache Analytics: Cache hit rates and optimization recommendations
- Glassmorphism Effects: Modern glass-like design with backdrop blur
- Smooth Animations: Framer Motion animations for all interactions
- Responsive Layouts: Perfect display on desktop, tablet, and mobile
- Dynamic Theming: Genre-based color schemes and visual themes
- Quality Badges: HD/4K indicators and rating displays
- Logo Integration: Movie/TV show logos with intelligent fallbacks
- World's Largest Database: Access to millions of subtitles from OpenSubtitles.com
- Automatic Search: Find subtitles by movie title, year, IMDB ID, or TMDB ID
- Smart Matching: Intelligent subtitle matching with quality scoring
- Multi-Language Support: 20+ languages including English, Spanish, French, German, and more
- Professional API: Robust integration with retry logic and error handling
- Real-time Search: Instant subtitle search with live results
- Quality Indicators: Download count, ratings, and user votes for each subtitle
- Release Matching: Find subtitles matching your specific movie release
- Hearing Impaired Support: Dedicated subtitles for accessibility
- HD Quality Filtering: Filter subtitles optimized for HD content
- Direct Integration: Download button on every movie page
- Automatic Extraction: Smart ZIP file extraction and format detection
- Instant Availability: Downloaded subtitles immediately available in player
- Format Support: SRT, VTT, ASS, SSA, and more subtitle formats
- File Management: Automatic organization and cleanup of subtitle files
- Language Detection: Automatic language detection from filenames
- Duplicate Prevention: Prevents downloading existing subtitles
- Quality Scoring: Ranks subtitles by downloads, ratings, and trust level
- Uploader Information: Shows uploader reputation and rank
- Release Comments: View subtitle comments and release information
- Upload Support: Upload your own subtitle files (.srt, .vtt, .ass, .ssa)
- Track Management: Complete subtitle track system with metadata
- External/Internal: Support for both embedded and external subtitles
- Testing Tools: Built-in subtitle validation and testing endpoints
- Legacy Compatibility: Maintains backward compatibility with existing subtitles
- API Key Management: Secure OpenSubtitles API key configuration
- Rate Limiting: Built-in rate limiting with exponential backoff
- Error Recovery: Robust error handling with automatic retries
- Download Quotas: Tracks daily download limits and remaining quota
- Authentication: Secure login system for OpenSubtitles accounts
- RESTful API: Complete subtitle API with search, download, and management
- Standalone Endpoints: Search subtitles without requiring media items
- Direct Downloads: Download subtitles as files without saving to library
- Validation Tools: File ID validation and debugging information
- Language Support: Comprehensive language code mapping and detection
- Direct TMDB Integration: Download button on every movie page
- Automatic Search: Finds best torrents from multiple sources
- Real-time Progress: Live download progress with speed, ETA, and completion percentage
- Smart Quality Selection: Automatically picks best quality based on seeders
- Seamless Integration: Downloaded movies automatically appear in your library
- Professional UI: Netflix-style interface with dark theme
- Multi-Source Search: Integrates with Jackett for 600+ torrent sites
- Quality Filtering: Filter by 4K, 1080p, 720p, 480p
- Download Management: Pause, resume, and delete downloads
- Progress Tracking: Real-time statistics with seeders, peers, and transfer rates
- Jackett Integration: Professional torrent indexer with Cloudflare bypass
- Flexible Setup: Docker or native installation options
- Custom Download Paths: Save to local drives or external storage
- Quality Preferences: Set preferred resolution and minimum seeders
- Bandwidth Control: Limit concurrent downloads and transfer rates
- Automatic Library Scanning: Downloaded content instantly available
- Duplicate Detection: Prevents downloading existing movies
- Resume Support: Continue interrupted downloads
- Error Handling: Robust error recovery and user feedback
- Legal Compliance: Built-in reminders for legal content only
- One-Click Workflow: Movie page → Download button → Automatic download
- Visual Progress: Progress bars and status indicators throughout UI
- Mobile Responsive: Full torrent management on mobile devices
- Notification System: Success/error messages and download completion alerts
- Settings Integration: Torrent configuration in main settings panel
- Automatic Scanning: Detects and organizes movies/TV shows from your drives
- Intelligent Metadata: Auto-fetches movie info, posters, and descriptions from TMDB
- Genre Classification: Automatically categorizes content by genre
- Series Organization: Groups TV episodes by seasons and series
- 🆕 Live Notification Feed: Netflix-quality notification system with dynamic tile rotation
- 🆕 Smart Content Discovery: 16 notification types showcasing trending, new, and personalized content
- 🆕 Auto-Playing Trailers: Hero tiles feature YouTube trailers with audio controls
- Advanced Widget System: Customizable Netflix-style interface with drag-and-drop configuration
- Performance Monitoring: Real-time widget analytics and optimization tools
- Visual Editor: Point-and-click widget management with live preview
- Torrent Downloads: One-click downloads directly from TMDB movie pages
- Real-time Progress: Live download tracking with speed and ETA
- Automatic Integration: Downloaded content instantly appears in library
- Hero Sections: Dynamic featured content with trailers
- 🆕 Advanced Widget System: Customizable widget layouts with glassmorphism design
- 🆕 Drag-and-Drop Configuration: Visual widget editor with real-time preview
- 🆕 Performance Dashboard: Widget analytics and optimization tools
- Smooth Carousels: Browse content with Netflix-style scrolling
- Responsive Design: Perfect on desktop, tablet, and mobile
- Dark Theme: Beautiful dark interface optimized for viewing
- High-Quality Playback: Supports 4K, 1080p, and adaptive streaming
- Multiple Formats: Plays MP4, MKV, AVI, and more
- ALAC Audio: High-quality lossless audio support
- Auto-Transcoding: Converts incompatible formats on-the-fly
- Preview Clips: Hover previews like Netflix
- TMDB Integration: Search millions of movies and TV shows from The Movie Database
- Real-time Search: Instant search suggestions with movie posters and details
- Advanced Search: Find content by title, actor, director, genre
- Smart Recommendations: AI-powered content suggestions based on TMDB data
- Continue Watching: Resume where you left off
- My List: Personal watchlist management with TMDB content
- Recently Added: See your newest content first
- Trending Content: Discover what's popular on TMDB
- 🆕 Torrent Search: Multi-source torrent search with quality filtering
- 🆕 Download Dashboard: Professional torrent management interface
- 🆕 Progress Tracking: Real-time download monitoring and statistics
- Home: Featured content and personalized recommendations with customizable widgets
- Movies: Browse your entire movie collection + TMDB movie database
- TV Shows: Organized series with season/episode navigation + TMDB TV shows
- My List: Your personal watchlist with both local and TMDB content
- Search: Advanced search with real-time TMDB suggestions and filters
- 🆕 Notifications: Live activity feed with dynamic tile system and real-time updates
- Now Playing: Live TV-style channel with previews
- New & Popular: Latest additions and trending content from TMDB
- TMDB Movie Pages: Detailed movie/TV show pages with trailers, cast, and crew info
- Widget Management: Professional widget configuration with visual editor
- Performance Analytics: Real-time widget performance monitoring and optimization
- Torrent Dashboard: Complete download management with search, progress, and settings
- Download Progress: Real-time tracking on movie pages and dedicated dashboard
- Settings Panel: Torrent configuration with Jackett integration
- Auto Thumbnails: Generated from video content
- Movie Posters: Downloaded from TMDB database for both local and online content
- TMDB Trailers: High-quality YouTube trailers embedded with auto-play
- Cast & Crew Info: Complete filmography data from TMDB
- Preview Videos: Short clips for quick browsing
- 🆕 Professional Subtitles: OpenSubtitles integration with millions of subtitles
- 🆕 Multi-Language Support: 20+ languages with automatic detection
- 🆕 One-Click Downloads: Instant subtitle downloads from movie pages
- Backdrop Images: High-resolution backdrop images from TMDB
- Movie Metadata: Comprehensive movie details including ratings, runtime, budget, and more
- Global Movie Search: Access to millions of movies and TV shows from TMDB
- Real-time Search Suggestions: Instant search with movie posters and details
- Detailed Movie Pages: Complete movie information including:
- High-quality trailers with auto-play functionality
- Full cast and crew information with photos
- Movie ratings, runtime, budget, and box office data
- Production companies and countries
- Spoken languages and release dates
- Movie genres and tags
- TV Show Support: Complete TV series information with seasons and episodes
- Trending Content: Discover what's popular and trending
- My List Integration: Add TMDB movies to your personal watchlist
- Netflix-style Interface: Beautiful movie detail pages with video backgrounds
- OpenSubtitles Integration: Access to millions of subtitles from the world's largest database
- Smart Search: Find subtitles by title, year, IMDB/TMDB ID with quality scoring
- Multi-Language Support: 20+ languages including English, Spanish, French, German, Italian, Portuguese, Russian, Japanese, Korean, Chinese, Arabic, and more
- One-Click Downloads: Instant subtitle downloads directly from movie pages
- Format Support: SRT, VTT, ASS, SSA, SUB, SBV subtitle formats
- Upload System: Upload your own subtitle files with automatic organization
- Quality Indicators: Download counts, ratings, votes, and uploader reputation
- Hearing Impaired: Dedicated accessibility subtitles with CC/SDH support
- Release Matching: Find subtitles matching your specific movie release
- Automatic Extraction: Smart ZIP file handling and format detection
- Watch History: Track viewing progress and history
- Playback Resume: Continue from where you stopped
- View Statistics: See your watching patterns
- Recommendation Engine: Learns from your preferences and TMDB data
# Quick start with automatic permissions
./quick-start.shOr full installation with setup wizard:
./install.shOr download and run:
curl -fsSL https://raw.githubusercontent.com/your-username/homeflix/main/install.sh | bashAll permissions are automatically configured - no manual chmod commands needed!
This will:
- ✅ Automatically fix all script permissions
- ✅ Check system requirements
- 📁 Set up directory structure with correct permissions
- 🐳 Build Docker containers
- 🌐 Start the setup wizard at
http://localhost:3009
- Go 1.21+ - Download here
- Node.js 18+ - Download here
- FFmpeg - For video processing
- Redis - For caching (optional but recommended)
- 🆕 Docker - For Jackett torrent indexer (optional but recommended)
- 🆕 Jackett - Torrent indexer for download functionality
- 🆕 OpenSubtitles Account - For subtitle downloads (free registration at opensubtitles.com)
# Ubuntu/Debian
sudo apt update
sudo apt install golang-go nodejs npm ffmpeg redis-server docker.io docker-compose
# macOS (with Homebrew)
brew install go node ffmpeg redis docker docker-compose
# Arch Linux
sudo pacman -S go nodejs npm ffmpeg redis docker docker-compose# 1. Install backend dependencies
cd backend
go mod tidy
# 2. Install frontend dependencies
cd ../frontend
npm install
# 3. Create required directories
mkdir -p thumbnails posters previews subtitles optimizedPlace your movies and TV shows in /media/azad/Movies1 (or update the path in the configuration)
./start.shUse the service scripts in scripts/ so HomeFlix starts automatically on boot and runs in the background.
cd /home/azad/homeflix-local/homeflix-wifi
chmod +x scripts/start-service.sh scripts/stop-service.shCreate /etc/systemd/system/homeflix.service:
[Unit]
Description=HomeFlix
After=network-online.target redis.service
Wants=network-online.target
[Service]
Type=simple
User=azad
Group=azad
WorkingDirectory=/home/azad/homeflix-local/homeflix-wifi
ExecStart=/home/azad/homeflix-local/homeflix-wifi/scripts/start-service.sh
ExecStop=/home/azad/homeflix-local/homeflix-wifi/scripts/stop-service.sh
Restart=always
RestartSec=10
Environment=NODE_ENV=production
Environment=PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin:/usr/local/go/bin
Environment=NODE_OPTIONS=--max-old-space-size=2048
[Install]
WantedBy=multi-user.targetSet User, Group, and absolute paths to match your Linux account and install location.
Enable and start the service:
sudo systemctl daemon-reload
sudo systemctl enable homeflix
sudo systemctl start homeflixUseful service commands:
sudo systemctl status homeflix
sudo systemctl restart homeflix
sudo systemctl stop homeflix
sudo journalctl -u homeflix -f
tail -f /home/azad/homeflix-local/homeflix-wifi/startup.log- Web Interface: http://localhost:3008
- Network Access: http://YOUR_IP:3008 (for other devices)
- API: http://localhost:8252
- The system will automatically scan your media directory
- Thumbnails and posters will be generated in the background
- TMDB integration provides instant access to millions of movies and TV shows
- Use the search bar to discover new content from The Movie Database
- Browse to http://localhost:3008 and enjoy!
# Quick setup with Docker (recommended)
./setup-jackett.sh
# Then configure in HomeFlix:
# 1. Go to Settings → Torrents
# 2. Enter Jackett URL: http://localhost:9117
# 3. Get API key from Jackett dashboard
# 4. Configure download preferences
# 5. Start downloading movies with one click!# Configure environment variables
export OPENSUB_API_KEY="your_api_key_here"
export OPENSUB_USERNAME="your_username"
export OPENSUB_PASSWORD="your_password"
# Or add to .env file:
echo "OPENSUB_API_KEY=your_api_key_here" >> .env
echo "OPENSUB_USERNAME=your_username" >> .env
echo "OPENSUB_PASSWORD=your_password" >> .envSetup Steps:
- Register free account at opensubtitles.com
- Get your API key from the developer section
- Add credentials to environment variables or .env file
- Restart HomeFlix to enable subtitle downloads
- Click subtitle button on any movie page to search and download!
See Complete Torrent Setup Guide for detailed instructions.
HomeFlix 2.0 introduces seamless torrent downloads directly from TMDB movie pages:
- Red Download Button: Appears on every movie page for instant downloads
- Automatic Search: Finds best torrents from multiple sources automatically
- Smart Selection: Picks highest quality with most seeders
- Real-time Progress: Live updates with speed, ETA, and completion percentage
- Instant Integration: Downloaded movies appear in your library immediately
Access via Settings → Torrents for complete download management:
- Search Tab: Browse torrents from 600+ sites with quality filtering
- Downloads Tab: Monitor active downloads with pause/resume/delete controls
- Settings Tab: Configure Jackett, download paths, and quality preferences
Powered by Jackett for reliable torrent searching:
- Multi-Source: Searches 1337x, YTS, EZTV, TorrentGalaxy, and more
- Cloudflare Bypass: Professional indexer handles site protection
- Quality Filtering: Filter by 4K, 1080p, 720p, 480p
- Seeder Sorting: Automatically picks torrents with most seeders
- Progress Tracking: Real-time speed, ETA, and completion status
- Queue Management: Pause, resume, and delete downloads
- Automatic Cleanup: Removes completed torrents and manages files
- Error Recovery: Robust handling of network issues and failures
- Mobile Support: Full torrent management on mobile devices
- Demo Mode: Works immediately with mock data for testing
- Docker Setup: One-command Jackett installation with
./setup-jackett.sh - Native Setup: Manual Jackett installation for advanced users
See Complete Setup Guide for detailed instructions.
HomeFlix 2.5 introduces comprehensive subtitle management with OpenSubtitles.com integration:
- Subtitle Search Button: Appears on every movie page for instant subtitle search
- Smart Matching: Automatically searches by movie title, year, and IMDB/TMDB ID
- Quality Scoring: Ranks subtitles by downloads, ratings, and uploader reputation
- Multi-Language: Support for 20+ languages with automatic detection
- One-Click Download: Download and integrate subtitles with a single click
Complete subtitle management system:
- Search Interface: Browse millions of subtitles with advanced filtering
- Quality Indicators: View download counts, ratings, votes, and uploader ranks
- Language Selection: Filter by specific languages or search all available
- Release Matching: Find subtitles matching your specific movie release
- Format Support: Handles SRT, VTT, ASS, SSA, SUB, and SBV formats
- Automatic Extraction: Smart ZIP file handling and format detection
- Upload System: Upload your own subtitle files with drag-and-drop
- Track Management: Complete subtitle track system with metadata
- Hearing Impaired: Dedicated CC/SDH subtitles for accessibility
- Testing Tools: Built-in validation and subtitle testing endpoints
- API Integration: RESTful API for developers and third-party tools
- Free Account: Register at opensubtitles.com
- API Key: Get your developer API key from account settings
- Configuration: Add credentials to .env file or environment variables
- Rate Limits: Respects OpenSubtitles rate limits with smart retry logic
HomeFlix features an intelligent search system that provides:
- Real-time Suggestions: As you type, get instant movie and TV show suggestions
- Rich Previews: See movie posters, ratings, and descriptions in search results
- Media Type Indicators: Clear icons distinguish between movies and TV shows
- Direct Navigation: Click any suggestion to go directly to the detailed movie page
Each TMDB movie or TV show has a dedicated page featuring:
- Auto-playing Trailers: High-quality YouTube trailers with sound controls
- Complete Cast Information: Photos and character details for all actors
- Crew Details: Directors, writers, and production team information
- Technical Details: Runtime, budget, box office, release dates
- My List Integration: Add movies to your personal watchlist
- Related Content: Discover similar movies and trending content
- Search for any movie or TV show title
- Results include both popular and obscure content
- Use the "See all results" option for comprehensive search results
- Browse trending and popular content sections for discovery
Update your media path in the startup script or environment variables:
export MEDIA_PATH="/path/to/your/media"HomeFlix automatically detects your local IP for network access. Other devices on your WiFi can access it using your computer's IP address.
- Redis: Enable Redis for faster asset loading
- SSD Storage: Store thumbnails/posters on SSD for better performance
- Hardware Acceleration: FFmpeg can use GPU acceleration for transcoding
homeflix/
├── backend/ # Go API server
├── frontend/ # Next.js web interface
├── thumbnails/ # Auto-generated thumbnails
├── posters/ # Movie/show posters
├── previews/ # Preview video clips
├── subtitles/ # Subtitle files
└── optimized/ # Transcoded media files
- WiFi Streaming: Access from any device on your network
- Mobile Responsive: Full mobile and tablet support with TMDB search
- Chromecast Ready: Cast to your TV (coming soon)
- Multi-Device Sync: Continue watching across devices
- Cross-Platform Search: TMDB search works seamlessly on all devices
- Offline Capability: Local media works without internet, TMDB requir
- Batch Processing: Bulk thumbnail and poster generation
- Auto-Cleanup: Removes orphaned files and invalid entries
- Health Monitoring: System status and performance metrics
- Backup System: Automatic database backups
- TMDB API Integration: Seamless integration with The Movie Database
- Hybrid Content: Mix local media with online TMDB content discovery
- Smart Caching: Efficient caching of TMDB data for better performance
- 🆕 Advanced Widget System: Professional widget management with drag-and-drop configuration
- 🆕 Performance Analytics: Real-time widget performance monitoring and optimization
- 🆕 Visual Widget Editor: Point-and-click widget configuration with live preview
- 🆕 Glassmorphism Design: Modern Netflix-style interface with backdrop blur effects
- 🆕 Async Widget Loading: Non-blocking widget loading with skeleton placeholders
- 🆕 Smart Widget Caching: 5-minute TTL cache with automatic invalidation for 70% faster performance
- Torrent Management: Complete download system with pause/resume/delete
- Multi-Source Search: Jackett integration with 600+ torrent sites
- Quality Control: Automatic quality selection and seeder filtering
- Progress Tracking: Real-time download statistics and ETA
- Automatic Integration: Downloaded content instantly available in library
- Video: MP4, MKV, AVI, MOV, WMV, FLV
- Audio: AAC, MP3, FLAC, ALAC, DTS, AC3
- 🆕 Subtitles: SRT, VTT, ASS, SSA, SUB, SBV (with OpenSubtitles integration)
- 🆕 Subtitle Languages: English, Spanish, French, German, Italian, Portuguese, Russian, Japanese, Korean, Chinese, Arabic, Dutch, Swedish, Norwegian, Danish, Finnish, Polish, Turkish, Hebrew, Thai, Vietnamese
- Local Media Protection: Your personal media never leaves your network
- TMDB Integration: Uses official TMDB API for movie data (requires internet)
- Hybrid Approach: Local media works offline, TMDB features require connection
- Privacy First: No personal data tracking or collection
- Secure API Usage: TMDB integration follows best security practices
- 🆕 Torrent Privacy: Optional VPN integration and proxy support
- 🆕 Legal Compliance: Built-in reminders for legal content only
- 🆕 Local Processing: All torrent management happens on your device
- 🆕 Subtitle Privacy: OpenSubtitles integration with secure API authentication
- 🆕 Rate Limiting: Respects service limits with intelligent retry mechanisms
- Check the logs in
homeflix.logfor troubleshooting - Ensure all dependencies are installed correctly
- Verify your media directory permissions
- Make sure ports 3008 and 8252 are available
- 🆕 Torrent Issues: See Torrent Setup Guide for troubleshooting
- 🆕 Subtitle Issues: Check OpenSubtitles API key and account credentials in .env file
Enjoy your personal Netflix experience with advanced widget system, professional subtitles, and one-click downloads! 🍿🎬📝🎨
Version 3.0-Stable brings a complete widget management system with Netflix-style design, drag-and-drop configuration, and real-time performance monitoring!
- AI-powered widget recommendations
- Advanced widget templates and themes
- Widget marketplace for community sharing
- Enhanced performance analytics
- Custom widget development tools