Flixorui/flixor
Modern cross-platform Plex client
๐ฆ TvOS Alpha:
- TestFlight link is ACTIVE this is the link: https://testflight.apple.com/join/hwRWYxBs
- I am accepting few invite only signup for app testing (Limited to 100): you can sign up here: https://forms.gle/aHrSa9Kg54JvTYKB7
- Keep an eye on the testflight when apple completes it review it will get active
- This first ALPHA release of TvOS you will see many UI and Performance bugs. Not all features from Mobile and MacOS are there in this TvOS release.
- Please test everything, and report issue you are seeing in detail with screenshots preferably on Github issues
- Mobile and MacOS now has Stremio Addon support, you primary login of Plex is still required. The support is experimental please post and share how things are working on your end for this feature.
- tvOS Alpha
- The Apple TV app now has a real usable foundation with Home, Shows, Movies, My List, Search, New & Popular, and Settings.
- + 12 more
๐ฆ TvOS Alpha:
- TestFlight link is ACTIVE this is the link: https://testflight.apple.com/join/hwRWYxBs
- I am accepting few invite only signup for app testing (Limited to 100): you can sign up here: https://forms.gle/aHrSa9Kg54JvTYKB7
- This first ALPHA release of TvOS you will see many UI and Performance bugs. Not all features from Mobile and MacOS are there in this TvOS release.
- Web: docker pull [ghcr.io/flixorui/flixor:main](http://ghcr.io/flixorui/flixor:main)
- iOS TestFlight:ย [https://testflight.apple.com/join/dxMJNJQg](https://testflight.apple.com/join/dxMJNJQg)
- iOS IPA:ย [https://github.com/Flixorui/flixor/releases/tag/beta2.4.0](https://github.com/Flixorui/flixor/releases/tag/beta2.4.0)
- Android:ย [https://github.com/Flixorui/flixor/releases/tag/beta2.4.0](https://github.com/Flixorui/flixor/releases/tag/beta2.4.0)
- MacOS:ย [https://github.com/Flixorui/flixor/releases/tag/beta2.4.0](https://github.com/Flixorui/flixor/releases/tag/beta2.4.0)
๐ฆ We now have MPV player as the universal player
- Dolby Vision Profile 5 support on MacOS and Mobile
- Skip Intro and Skip Credits markers
- Auto-play next episode
- Improved player UI with better controls
- Fixed subtitle rendering for foreign languages
- Orientation lock and aspect ratio controls on mobile
๐ฆ Downloads (Alpha)
- You asked for it! Offline playback is here:
- Download movies and episodes for offline viewing
- Available on both Mobile and MacOS
- Note: This is an alpha feature - more improvements coming!
๐ฆ Multi-Profile Support
- Full Plex profile support with profile-based isolation
- Each profile maintains its own settings and preferences
- Easy profile switching
๐ฆ Collections as Rows
- Display collections as horizontal rows on home screen
- New customization settings for collection appearance
- Better organization for your media
๐ฆ Integrations
- You asked for it now all of them are live
- Overseerr:
- As you asked added Sign in with Plex on mobile
- Partial request support on MacOS (request specific seasons/episodes)
- Continue Watching:
- Fixed ordering issues
- Smarter cleanup - only shows what's actually visible
- Multi-edition movie identification
- + 7 more
๐ฆ UI/UX Improvements
- Mobile:
- Redesigned Details screen with UltraBlur colors
- Native iOS 26 bottom tab bar with liquid glass effect
- Improved back button navigation
- Title logos for TMDB-based content
- MacOS:
- Hero sections now fetch high-quality images from TMDB
- UltraBlur color extraction for beautiful backgrounds
- + 1 more
๐ Bug Fixes
- Fixed Plex watchlist details not rendering
- Fixed back navigation from details screen
- Fixed rating badges not showing
- Fixed player regression issues
- Fixed recommended/similar content navigation
- Web: docker pull ghcr.io/flixorui/flixor:main
- iOS TestFlight: https://testflight.apple.com/join/dxMJNJQg
- iOS IPA: https://github.com/Flixorui/flixor/releases/download/beta2.0.0/Flixor_beta2.0.0.ipa
- + 2 more
Beta 1.9.5 Release for Flixor Supporting Web, iOS, Android, and macOS We have a official site now https://flixor.xyz/ Also our subreddit: https://www.reddit.com/r/Flixor/ This is a Big update I would urge all user to upgrade. If you like my work, star the repo on GitHub. All Platforms have been updated to include various integrations 1. Overseerr is now integrated in to Flixor 2. You can now customize the app to your liking, there are extensive customization options allowing you to customize how the app looks and feel, you can customize if you want Landscape card or Poster view card, weather you want to show titles or not. 3. Details screen has been revamped to be more rich and elegant. You can also switch between Tabbed layout and Unified Details screen Layout. 4. MDBList integration has been added, if you have a API key just input that in and you are good to go. 5. Users can now customize home screen rows not intrested in Trakt or TMDB based rows you are in control. 6. Playback has been improved on all platform Episode will now auto play play, mobile now has full subtitle and audio track support, web has many bug fixes 7. Developer Stats for nerd is also included in the a player, for Mobile just go to setting during playing something you can visit info tab that will show you all the video playback stats 8. Many UI updates to all Platforms, On all platform almost all function that user can interact with are functional 9. iOS 26+ user you can now enjoy liquid glass. 10. OTA updates are now on for iOS and Android. Web: docker pull [ghcr.io/flixorui/flixor:main](http://ghcr.io/flixorui/flixor:main) iOS TestFlight: https://testflight.apple.com/join/dxMJNJQg iOS IPA: https://github.com/Flixorui/flixor/releases/download/beta1.9.5/Flixor_beta1.9.5.ipa Android: https://github.com/Flixorui/flixor/releases/download/beta1.9.5/Flixor_beta1.9.5.apk MacOS: https://github.com/Flixorui/flixor/releases/download/beta1.9.5/FlixorMac-beta1.9.5.dmg If you feel generous and like to support my development:ย https://ko-fi.com/flixor, this will help maintain and build Flixor for more platforms
Beta 1.3.5 Release for Flixor Supporting Android, iOS, and macOS macOS ships with the MPV player. Please switch to the MPV player from Settings. iOS TestFlight: https://testflight.apple.com/join/dxMJNJQg The next release will remove AVPlayer and make MPV the default. Reworked all apps to work without any backend hosted, We now have Android, iOS, and macOS (Supporting Dolby Vision, HDR, HLG) native applications of Flixor in Beta Mode For frontend you will still need backend + frontend Docker releases Backend: https://hub.docker.com/layers/flixorui/flixor_backend/beta-1.0/ Web Frontend: https://hub.docker.com/layers/flixorui/flixor_web/beta-1.0/
๐ฆ ๐ **Platforms**
- Web Application - Modern browser-based client (React + Vite)
- macOS Native App - Swift/SwiftUI desktop application with MPV player integration
- Mobile App (iOS/Android) - React Native + Expo cross-platform mobile application
- ---
๐ฆ **Authentication & Server Management**
- Plex.tv OAuth authentication flow
- Multiple Plex server support
- Server selection and switching
- Backend URL configuration for mobile/remote access
- Automatic session management and token refresh
- Secure token storage (AsyncStorage on mobile, localStorage on web)
๐ฆ **Home Screen**
- Netflix-style hero banner with automatic content rotation
- Randomly selected from trending or Plex library
- Auto-playing trailers (muted) from Plex extras or YouTube
- Backdrop images with title logos (TMDB sourced)
- Play, More Info, and Add to Watchlist quick actions
- Continue Watching - Resume in-progress movies and TV episodes
- Progress bars showing watch completion
- Smart episode thumbnails for TV shows
- + 10 more
๐ฆ **Library Management**
- Grid and list views with ultra-fast rendering
- Optimized for large libraries (1000+ items)
- FlashList on mobile for performance
- Smooth scrolling with image lazy-loading
- Advanced search and filtering:
- Full-text search across titles
- Filter by genre, year, rating, resolution
- Sort by title, release date, recently added, rating
- + 3 more
๐ฆ **Content Details Screen**
- Rich metadata display:
- High-resolution backdrop and poster images
- Title with logo overlay (TMDB sourced)
- Plot overview and synopsis
- Cast and crew with headshots
- Genres, release year, runtime, content rating
- IMDb and Rotten Tomatoes ratings
- Technical specifications (resolution, codec, audio, file size)
- + 23 more
๐ฆ **Video Player**
- Built-in browser playback:
- HLS.js and DASH.js streaming
- Direct stream and transcode support
- HTML5 video controls
- Fullscreen mode
- Picture-in-Picture (Element PiP) - Watch while browsing
- Subtitle support - Multiple subtitle tracks with selection
- Audio track selection - Switch between audio streams
- + 17 more
๐ฆ **Search**
- Global search across all content
- Real-time search as you type
- Search history with recent queries
- Type filtering - Search movies, shows, or both
- TMDB integration - Search external content beyond Plex library
โจ **New & Hot / Trending**
- Coming Soon - Upcoming movie releases
- Everyone's Watching - Trending content this week
- Top 10 Shows - Most popular TV shows
- Top 10 Movies - Most popular movies
- Custom tabs for content categories
- Backdrop previews for all content
๐ฆ **Watchlist Management**
- My List screen with all watchlisted content
- Plex.tv watchlist sync
- Trakt watchlist integration
- Add/remove from list on any content screen
- Grid view with progress indicators
๐ฆ **Settings & Configuration**
- Plex server management (add/remove/switch)
- TMDB API key configuration
- Trakt account linking
- Image quality preferences
- Backend URL configuration
- Server connection settings
- Backend URL configuration
- Playback preferences
- + 6 more
๐ฆ **Person/Cast Pages**
- Actor/Director profiles with biography
- Filmography - All movies and shows featuring the person
- TMDB sourced data
- Browse by person - Click cast member to see their content
๐ฆ **Browse/Explore Modals**
- Genre browsing - Deep dive into genre collections
- Plex directory navigation - Browse Plex folder structures
- Dynamic loading - Infinite scroll through large collections
- ---
โก **Performance Optimizations**
- Image optimization and caching:
- Sharp-based image proxy with WebP conversion
- Width/height parameters for responsive images
- CDN-style caching headers
- TMDB image CDN integration
- API request caching with 15-minute TTL
- Request deduplication - Prevent duplicate simultaneous requests
- Rate limiting on backend
- + 3 more
๐ฆ **Backend Architecture**
- Express.js REST API
- SQLite database with TypeORM
- Session management with connect-typeorm
- JWT authentication
- Image proxy service with transformation (sharp)
- Plex API aggregation - Single backend for multiple Plex servers
- CORS support for cross-origin requests
- Compression middleware for responses
- + 2 more
๐ฆ **External Integrations**
- TMDB (The Movie Database):
- Trending movies and TV shows
- Detailed metadata (cast, crew, synopsis)
- Recommendations and similar titles
- Images (backdrops, posters, logos)
- Trailers and videos
- External IDs (IMDb, TVDB)
- Trakt.tv:
- + 18 more
๐ฆ **Error Handling & Resilience**
- Retry logic with exponential backoff (mobile)
- Graceful degradation - App works with partial data
- Error boundaries - Prevent crashes from bad data
- Automatic logout on persistent backend failures (mobile)
- Fallback content - Placeholder images and data
- Connection timeout handling (10 seconds)
๐ฆ **Cross-Platform State Management**
- React Context for web
- Zustand-like stores for mobile (TopBarStore)
- AsyncStorage for mobile persistence
- localStorage for web persistence
- Shared API client architecture
- ---
๐ฆ **Design Language**
- Netflix-inspired interface with dark theme
- Gradient backgrounds (warm red + cool teal accents)
- Glass morphism effects on cards and modals
- Smooth animations and transitions
- Skeleton loaders for perceived performance
- Responsive layouts - Mobile, tablet, desktop
- Accessibility support - ARIA labels, keyboard navigation
๐ฆ **Navigation**
- React Router with browser history
- Deep linking support
- Back/forward navigation
- Native SwiftUI navigation
- Keyboard shortcuts (arrow keys, Esc, Space)
- Tab-based navigation
- React Navigation with native animations
- Bottom tab bar (Home, New & Hot, Library, My Netflix)
- + 2 more
๐ฆ **Interactive Elements**
- Hover effects on cards (web/macOS)
- Haptic feedback on interactions (mobile)
- Pull to refresh (mobile)
- Swipe gestures (mobile)
- Animated scroll headers - Collapse/expand on scroll
- Filter pills with smooth show/hide animations
๐ฆ **Content Cards**
- Landscape cards - Backdrop-style for rows
- Portrait cards - Poster-style for grids
- Progress overlays - Visual watch progress
- Quality badges - 4K, HDR, etc. overlays
- Availability indicators - Plex vs. external content
- Hover overlays with actions (web/macOS)
- ---
๐ฆ **Web Only**
- Docker containerization with docker-compose
- Responsive design (mobile browser support)
- Browser picture-in-picture
- Service worker (PWA potential)
- Keyboard shortcuts
- Mouse hover interactions
๐ฆ **macOS Only**
- Native menu bar
- MPV player with hardware acceleration
- Metal rendering pipeline
- macOS-native keyboard shortcuts
- Window management
- Spotlight integration potential
- Native notifications
๐ฆ **Mobile Only**
- Touch gesture controls
- Haptic feedback
- Screen orientation handling
- Safe area insets (notch support)
- Background audio playback
- ---
๐ฆ **Development Workflow**
- Hot module replacement (Vite + Expo)
- TypeScript throughout for type safety
- Concurrent development scripts (dev:all)
- Path aliases (@/components, @/services, etc.)
- ESLint and code formatting
- Git hooks potential (pre-commit, pre-push)
๐ฆ **Build & Deploy**
- Vite production builds with code splitting
- Expo EAS build for mobile apps
- Docker images for backend + frontend
- Environment variables for configuration
- Minification and optimization
- Source maps for debugging
๐ **Logging & Debugging**
- Console logging with prefixes ([Home], [Player], etc.)
- Winston backend logging with levels
- Request/response logging
- Error stack traces
- TMDB API debug logs
- ---
๐ฆ **Caching Strategy**
- In-memory cache (node-cache) - 15-minute TTL
- Browser cache for images
- API response caching with deduplication
- Prefetch likely next screens
๐ฆ **Database**
- SQLite with TypeORM
- User accounts table
- Server configurations table
- Session storage table
- Watchlist sync (future)
- Watch history (future)
๐ฆ **Session Management**
- Express sessions with SQLite store
- JWT tokens for API authentication
- Refresh token support (future)
- Multi-device session handling
- ---
โจ ๐ **Security Features**
- HTTPS enforcement (production)
- Secure token storage
- CORS policies with allowed origins
- Helmet security headers
- Rate limiting per IP
- SQL injection prevention (TypeORM parameterization)
- XSS protection via React/Vue escaping
- Session expiration and rotation
- + 2 more
๐ฆ **Video Codecs**
- H.264, H.265/HEVC
- VP9, AV1 (web browser dependent)
- MPEG-2, MPEG-4
- 4K, HDR, Dolby Vision (macOS MPV)
๐ฆ **Audio Codecs**
- AAC, MP3, Opus
- AC3, E-AC3 (Dolby Digital)
- TrueHD, Atmos (macOS passthrough)
- DTS, DTS-HD
๐ฆ **Containers**
- MP4, MKV, AVI
- WebM (web)
- MOV, M4V
๐ฆ **Subtitles**
- SRT, VTT (web)
- ASS, SSA (macOS MPV)
- Embedded and external subtitles
- Multiple subtitle track selection
๐ฆ **Streaming Protocols**
- HLS (HTTP Live Streaming)
- DASH (Dynamic Adaptive Streaming)
- Direct file streaming
- Plex transcode streams
- ---
๐ฆ ๐ **Future Enhancement Potential**
- Offline downloads (mobile)
- User profiles with separate watchlists
- Social features - Share watchlists, watch parties
- Smart recommendations - ML-based suggestions
- Parental controls - Content rating filters
- Multi-language support - i18n
- Advanced statistics - Watch time, most-watched genres
- Chromecast support
- + 5 more
๐ฆ ๐ **Why Choose Flixor?**
- โ Beautiful, familiar Netflix-style UI
- โ Works everywhere - Web, macOS, iOS, Android (TV coming soon)
- โ Blazing fast - Optimized rendering and caching
- โ Rich metadata - TMDB + Trakt + Plex integration
- โ Open source - Self-hosted, no subscriptions
- โ Privacy-focused - Your data stays on your server
- โ Active development - Regular updates and improvements
- </details>
