A lightweight, minimal desktop client for Jellyfin media servers built with Flutter. This application provides a clean, frameless window that displays your Jellyfin server's web interface with enhanced desktop integration.
- Minimal Design: Clean, frameless window interface that focuses on your media content
- Desktop Integration: Native window controls (minimize, maximize, close) with hover effects
- WebView2 Integration: Uses Microsoft WebView2 for optimal web content rendering on Windows
- Persistent Settings: Remembers your server configuration between sessions
This application is specifically designed with OLED display users in mind:
- Seamless Ultrawide Experience: The frameless design eliminates window borders, creating a clean viewing experience perfect for ultrawide OLED monitors
- Side-by-Side Productivity: Work alongside your media consumption without caring about burn-in concerns, as the minimal interface does not leave persistent window borders
- Immersive Media Viewing: The minimal interface disappears into the background, letting your OLED display showcase content without interference
- Windows 10/11 (WebView2 Runtime required)
- Flutter 3.0 or higher
- A running Jellyfin server
- Ensure you have WebView2 Runtime installed on your system. Most modern Windows installations include this by default.
- Have a Jellyfin server running and accessible on your network.
-
Clone the repository:
git clone <repository-url> cd minimal_fin
-
Install Flutter dependencies:
flutter pub get
-
Build the application:
flutter build windows
-
Run the application:
flutter run -d windows
- Launch the application
- You'll be automatically redirected to the settings page
- Enter your Jellyfin server URL (e.g.,
http://192.168.1.100:8096orhttps://jellyfin.example.com) - Click "Save and Connect"
- The application will load your Jellyfin web interface
- Settings: Hover over the top of the window and click the settings icon to change your server URL
- Window Controls: Use the minimize, maximize, and close buttons that appear when hovering over the top-right area
- Fullscreen: The application intercepts Jellyfin's fullscreen button to provide native window maximization
The application stores your server URL locally using Hive database. Your settings persist between application restarts.
lib/
├── main.dart # Application entry point and initialization
├── model/
│ ├── constants.dart # Global constants and WebView environment
│ └── settings_storage.dart # Settings persistence using Hive
└── view/
├── routing/
│ └── app_routes.dart # Application routing configuration
├── screens/
│ ├── settings_page.dart # Server configuration screen
│ └── web_view_page.dart # Main Jellyfin web interface
└── widgets/
├── page_wrapper.dart # Common page layout wrapper
└── top_buttons_bar.dart # Window controls and navigation
- Flutter Framework: Cross-platform UI toolkit
- WebView Integration: Uses
flutter_inappwebviewfor web content rendering - State Management: Built-in Flutter state management with StatefulWidget
- Routing: Go Router for declarative navigation
- Storage: Hive for lightweight local data persistence
- Window Management: Custom window controls using
window_manager
- WebViewButtonModifications: JavaScript injection system for customizing Jellyfin's web interface
- PageWrapper: Consistent layout wrapper with drag-to-resize functionality
- TopButtonsBar: Hover-activated window controls with smooth animations
- Settings Validation: URL validation with user-friendly error messages
- Fork the repository
- Create a feature branch (
git checkout -b feature/amazing-feature) - Commit your changes (
git commit -m 'Add some amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
- Follow Flutter/Dart coding conventions
- Add documentation for new classes and methods
- Test your changes thoroughly
- Update this README if you add new features
This project is open source. Please check the LICENSE file for details.
If you encounter WebView2 related errors, ensure you have the WebView2 Runtime installed:
- Download from Microsoft WebView2
- Verify your Jellyfin server is running and accessible
- Check that the URL includes the protocol (http:// or https://)
- Ensure there are no firewall restrictions blocking the connection