{"id":29992905,"url":"https://github.com/codingfries/frameless_browser_flutter","last_synced_at":"2026-05-15T12:07:55.929Z","repository":{"id":307175982,"uuid":"1027945752","full_name":"CodingFries/frameless_browser_flutter","owner":"CodingFries","description":"Minimal Browser without any borders for OLED Monitors (Mainly for Watching Movies or Full Screen YT videos on a side without borders)","archived":false,"fork":false,"pushed_at":"2025-07-29T20:26:08.000Z","size":116,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-08-05T00:44:57.564Z","etag":null,"topics":["browser","flutter","minimal"],"latest_commit_sha":null,"homepage":"https://github.com/CodingFries/frameless_browser","language":"Dart","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/CodingFries.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-07-28T19:19:35.000Z","updated_at":"2025-08-02T18:32:53.000Z","dependencies_parsed_at":"2025-07-29T22:05:25.616Z","dependency_job_id":"7bef74bf-5957-461c-a604-861c6e82e417","html_url":"https://github.com/CodingFries/frameless_browser_flutter","commit_stats":null,"previous_names":["codingfries/frameless_browser","codingfries/frameless_browser_flutter"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/CodingFries/frameless_browser_flutter","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CodingFries%2Fframeless_browser_flutter","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CodingFries%2Fframeless_browser_flutter/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CodingFries%2Fframeless_browser_flutter/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CodingFries%2Fframeless_browser_flutter/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/CodingFries","download_url":"https://codeload.github.com/CodingFries/frameless_browser_flutter/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CodingFries%2Fframeless_browser_flutter/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33066173,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-15T11:35:32.926Z","status":"ssl_error","status_checked_at":"2026-05-15T11:35:31.362Z","response_time":103,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["browser","flutter","minimal"],"created_at":"2025-08-05T00:14:58.931Z","updated_at":"2026-05-15T12:07:55.922Z","avatar_url":"https://github.com/CodingFries.png","language":"Dart","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Frameless Browser\n\nA modern, minimalist desktop web browser built with Flutter that features a frameless window design with customizable homepage and enhanced navigation controls.\n\n## Overview\n\nFrameless Browser is a lightweight desktop web browser application specifically designed for **Wide OLED Screens** where you want to watch videos on YouTube or other streaming platforms in full screen on the side without annoying window borders and risk of OLED burn-in. Built using Flutter and WebView2 technology, it offers a frameless window interface with hover-activated controls and customizable settings.\n\n### Perfect for OLED Displays\n\nThis browser is particularly valuable for users with wide OLED monitors who want to:\n- **Watch videos in full screen** without traditional window borders that can cause burn-in\n- **Eliminate static UI elements** that could permanently damage OLED pixels over time\n- **Enjoy content on the side** of their wide screen while working on other tasks\n- **Prevent burn-in risks** from persistent browser chrome and window decorations\n\n## Features\n\n### Core Browser Functionality\n- **WebView2 Integration**: Optimal web content rendering using Microsoft's WebView2 engine\n- **Frameless Window Design**: Clean, minimal interface without traditional window borders\n- **Enhanced Navigation Controls**: Intuitive browser controls with URL entry and navigation buttons\n- **Progress Indication**: Visual feedback during page loading\n- **URL Validation**: Smart URL handling with automatic protocol detection\n\n### Customization \u0026 Settings\n- **Customizable Homepage**: Set and save your preferred homepage URL\n- **Real-time URL Validation**: Instant feedback on URL format and validity\n- **Persistent Settings**: Your preferences are saved using local storage\n- **Reset to Defaults**: Easy option to restore default settings\n\n### Media \u0026 Web Standards Support\n- **Automatic Media Playback**: No user gesture required for media content\n- **Inline Media Support**: Seamless video and audio playback\n- **Fullscreen Support**: Full iframe and video fullscreen capabilities\n- **JavaScript Enabled**: Full support for modern web applications\n- **DOM Storage \u0026 Database**: Complete web storage API support\n- **Zoom Controls**: Built-in zoom functionality for better accessibility\n\n### Technical Features\n- **Dark Theme**: Modern Material 3 dark theme design\n- **External URL Handling**: Smart handling of non-web content\n- **Cache Management**: Intelligent caching for improved performance\n- **Debug Inspector**: Development tools available in debug mode\n\n## System Requirements\n\n### Prerequisites\n- **Windows 10/11**: Required for WebView2 support\n- **WebView2 Runtime**: Must be installed (usually included with modern Windows)\n- **Flutter SDK**: Version 3.8.1 or higher\n- **Dart SDK**: Compatible version with Flutter\n\n### Hardware Requirements\n- **RAM**: Minimum 4GB recommended\n- **Storage**: At least 100MB free space\n- **Display**: 1920x1080 recommended (default window size)\n\n## Installation\n\n### Option 1: Download Pre-built Release\n1. Download the latest release from the releases page\n2. Run the installer (if available) or extract the executable\n3. Ensure WebView2 Runtime is installed on your system\n4. Launch the application\n\n### Option 2: Build from Source\n\n#### Prerequisites\n```bash\n# Install Flutter SDK (if not already installed)\n# Download from: https://flutter.dev/docs/get-started/install\n\n# Verify Flutter installation\nflutter doctor\n```\n\n#### Clone and Build\n```bash\n# Clone the repository\ngit clone \u003crepository-url\u003e\ncd frameless_browser\n\n# Get dependencies\nflutter pub get\n\n# Build for Windows\nflutter build windows --release\n```\n\n#### Create Installer (Optional)\nIf you have Inno Setup installed:\n```bash\n# After building, use the Inno Setup script\n# Open inno/script.iss in Inno Setup Compiler\n# Compile to create an installer\n```\n\n## Usage\n\n### First Launch\n1. Launch the Frameless Browser application\n2. The browser will open with the default homepage\n3. Use the top navigation bar to enter URLs or navigate\n\n### Navigation\n- **URL Bar**: Click the address bar to enter a new URL\n- **Back/Forward**: Use navigation buttons to move through history\n- **Refresh**: Reload the current page\n- **Settings**: Access settings to customize your homepage\n\n### Customizing Homepage\n1. Click the settings button (gear icon) in the top bar\n2. Enter your preferred homepage URL\n3. Ensure the URL includes `http://` or `https://`\n4. Click \"Save\" to apply changes\n5. Use \"Reset to Default\" to restore the original homepage\n\n### Keyboard Shortcuts\n- **Ctrl+R**: Refresh current page\n- **Alt+Left**: Go back\n- **Alt+Right**: Go forward\n- **Ctrl+L**: Focus URL bar\n\n## Configuration\n\n### Settings Storage\nSettings are automatically saved to:\n```\n%USERPROFILE%\\Documents\\FramelessBrowser\\\n```\n\n### Default Configuration\n- **Default Homepage**: Can be customized in settings\n- **Window Size**: 1920x1080 pixels\n- **Theme**: Dark mode with Material 3 design\n- **Cache**: Enabled for better performance\n\n## Development\n\n### Project Structure\n```\nlib/\n├── main.dart                 # Application entry point\n├── model/\n│   ├── constants.dart        # App constants and configuration\n│   └── settings_storage.dart # Settings persistence\n└── view/\n    ├── routing/\n    │   └── app_routes.dart   # Navigation routing\n    ├── screens/\n    │   ├── browser_page.dart # Main browser interface\n    │   └── settings_page.dart# Settings configuration\n    └── widgets/\n        └── browser_top_bar.dart # Navigation controls\n```\n\n### Key Dependencies\n- **flutter_inappwebview**: WebView functionality\n- **window_manager**: Frameless window management\n- **go_router**: Navigation and routing\n- **hive_ce**: Local storage for settings\n- **path_provider**: File system access\n- **url_launcher**: External URL handling\n\n### Building for Development\n```bash\n# Run in debug mode\nflutter run -d windows\n\n# Run tests\nflutter test\n\n# Analyze code\nflutter analyze\n```\n\n## Troubleshooting\n\n### Common Issues\n\n**WebView2 Runtime Not Found**\n- Download and install WebView2 Runtime from Microsoft\n- Restart the application after installation\n\n**Application Won't Start**\n- Ensure Flutter is properly installed\n- Check that all dependencies are available\n- Verify Windows version compatibility\n\n**Settings Not Saving**\n- Check write permissions to Documents folder\n- Ensure the application has proper file system access\n\n**Performance Issues**\n- Clear browser cache through settings\n- Restart the application\n- Check available system memory\n\n## Contributing\n\n1. Fork the repository\n2. Create a feature branch\n3. Make your changes\n4. Test thoroughly\n5. Submit a pull request\n\n## License\n\nThis project is licensed under the MIT License - see the LICENSE file for details.\n\n## Acknowledgments\n\n- Built with [Flutter](https://flutter.dev/)\n- Uses [WebView2](https://developer.microsoft.com/en-us/microsoft-edge/webview2/) for web rendering\n- Material Design 3 theming\n- Thanks to the Flutter community for excellent packages and support\n\n## Version History\n\n- **v1.0.0**: Initial release with core browser functionality\n  - Frameless window design\n  - WebView2 integration\n  - Customizable homepage\n  - Settings persistence\n  - Enhanced navigation controls\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcodingfries%2Fframeless_browser_flutter","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcodingfries%2Fframeless_browser_flutter","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcodingfries%2Fframeless_browser_flutter/lists"}