omni-browser

REBEL-ROOTGPL-3.0活跃维护

基于 Mozilla GeckoView 的 Android 开源浏览器,支持原生 WebExtension、媒体流拦截、加密私密保险箱和端侧机器学习,适合需要广告拦截与隐私保护的用户。

Omni Browser is a secure, open-source Android browser by RebelRoot. Built on Mozilla GeckoView, it features native WebExtension support, aggressive media stream interception, a private encrypted locker, and on-device machine learning tools.

v1.3.6.1发布于 2026-11-09 19:01 UTC396star +2 / 7 天23fork同步于 2026-11-10 23:58 UTC

怎么上手

由 README 提炼,执行前请确认
git clone https://github.com/REBEL-ROOT/omni-browser.git
cd omni-browser
./gradlew assembleDebug
硬件要求按 README 说明

README 未说明具体硬件要求;为 Android 应用,需在 Android 设备上运行,构建产物分 arm 与 aarch64 两个架构。

下载:源码 zip·GitHub Releases(安装包)本站不镜像安装包

项目说明

由 README 自动翻译提炼

基于 GeckoView 的开源 Android 隐私浏览器,支持原生 WebExtension 与加密保险箱

基于 Mozilla GeckoView 的 Android 开源浏览器,支持原生 WebExtension、媒体流拦截、加密私密保险箱和端侧机器学习,适合需要广告拦截与隐私保护的用户。

核心能力

  • 基于 Mozilla GeckoView 引擎渲染网页
  • 原生支持安装 Firefox Android .xpi 扩展
  • 内置基于 hosts 的广告与追踪器拦截
  • AES-256 生物识别加密保险箱存私密文件
  • 嗅探 HLS/DASH/MP4 流并用 ExoPlayer 播放

容易踩的坑

项目处于实验阶段,README 明确不建议作为主力浏览器且可能崩溃;扩展需从 addons.mozilla.org 安装 .xpi,并非内置;构建产物分 arm 与 aarch64 两个架构,需选对应 APK。

内容由模型根据 README 生成,可能不完整或不准确,以官方文档为准。看原文 README

最近发版

5 个版本v1.3.6.1
  1. v1.3.6.1Omni Browser v1.3.6.1最新正式版2026-11-09 · 2026-11-09 19:01 UTC

    Omni Browser v1.3.6.1

    🚀 Highlights in this release

    • UI & Buttons Layout Customization: Separated appearance settings and introduced a dedicated Buttons Layout customization screen for tailoring toolbar actions.
    • Enhanced Privacy & Deep Burn: Fire button & "Burn all data" now atomic and thorough—wiping site permissions, all Gecko profile disk caches, shader/thumbnail caches, and background session states (#140).
    • Calendar (.ics) & Webcal Downloads: Native handling and download support for .ics, .ical, .ifb calendar files and webcal:// links without blanket spam blocks (#141).
    • Text Scaling & Accessibility Fixes: Improved layout robustness and text scaling across preferences and bottom menu sheets.

    🛠️ What's New in v1.3.6.1 (since v1.3.5.1)

    🎨 UI & Customization

    • Dedicated Buttons Layout Screen: Configurable toolbar action placements and cleaner separation between theme appearance and toolbar buttons.
    • Menu Sheet Polish: Cleaned up bottom menu sheet layout for faster navigation and smoother interaction.
    • Accessibility & Font Scaling: Fixed text scaling issues across settings, appearance, and dialog sheets.

    🔒 Privacy & Data Clearing (#140)

    • Atomic Burn All Data: Immediately terminates active Gecko sessions prior to wiping to prevent background tabs from rewriting cache.
    • Comprehensive Cache Purge: Clears Gecko profile disk caches (cache2, startupCache, jumpListCache, shader-cache, thumbnails), codeCacheDir, and external cache directories.
    • Site Permissions Reset: Guarantees browser_site_permissions.json and in-memory permissions state are fully erased upon burning data.

    📅 Calendar & Download Engine (#141)

    • iCalendar (.ics / .ical / .ifb) Support: Legitimate calendar files and webcal:// subscriptions download seamlessly via browser download manager.
    • Smart Spam Filtering: Eliminated blanket calendar blocking while retaining strict safety checks.
    • Calendar Download Dialog: Visual DateRange icon and dedicated MIME type recognition in StreamDownloadEngine and DownloadManagerScreen.

    📦 Installation Requirements

    • Android 8.0+ (API 26) is required.
    • If you are not sure which build to choose, download the universal APK (omni-browser-v1.3.6.1-universal.apk).
  2. v1.3.5.1Omni Browser v1.3.5.12026-10-15 · 2026-10-15 04:40 UTC
    查看更新说明

    Omni Browser v1.3.5.1

    🚀 Highlights in this release

    • Manga & Manwha Reader Fixes: Strict referrer policies and ContentBlocking anti-tracking fixes to restore image loading on sites like MangaFire.
    • Universal Document Downloads: Full support for downloading and streaming documents, PDFs, spreadsheets, presentations, and eBooks, with authenticated Necko handling for Google Drive and cloud storage.
    • Native PDF Printing: Native Android print adapter integration (saveAsPdf and system PrintManager) with preview lifecycle stability and wake-lock management.
    • Web Apps & PWAs Hub: Complete Web Apps catalog, repository, sharing intents, and floating text action support (#133).
    • Home Screen Extension Pinning: Pin your favorite extensions directly to your device launcher home screen.

    🛠️ What's New in v1.3.5.1 (since v1.3.4.1)

    🖼️ Manga & Manwha Image Loading

    • Strict Referrer & Origin Policies: Configured network.http.referer.defaultPolicy = 2 (strict-origin-when-cross-origin), trimmingPolicy = 0, XOriginPolicy = 0, XOriginTrimmingPolicy = 2, and sendRefererHeader = 2.
    • Anti-Tracking CDN Bypass: Adjusted GeckoView ContentBlocking anti-tracking policy to allow anti-hotlink image CDNs on MangaFire and similar sites to receive valid referrer origins without being blocked.

    📥 Universal Document & Stream Download Engine

    • Exhaustive Document MIME & Extension Mappings: Support for pdf, doc, docx, odt, rtf, pages, xls, xlsx, ods, csv, tsv, numbers, ppt, pptx, odp, key, epub, mobi, azw, azw3, cbr, cbz, apk, xapk, apks, archives, and media.
    • Direct Stream Downloads: New streaming download handler (startGenericFileDownloadFromStream) with modern browser headers (User-Agent, Accept, Sec-Fetch-*) and cookie preservation across redirects.
    • Necko Engine Passthrough: Authenticated downloads (Google Drive, cloud storage) are initiated directly through GeckoView's Necko stack with full session cookies; dangling popup tabs are cleanly closed.
    • Download Modal Updates: Modern file type icon mappings and clean dismiss/cancellation handling.

    🖨️ Native PDF Print Support

    • PdfPrintDocumentAdapter: Custom print document adapter preventing print preview cancellation freezes and managing wake-locks.
    • GeckoView Print Delegate: Connected tab.session.printDelegate with native Android PrintManager and added android.permission.WAKE_LOCK.

    📱 Web Apps & PWAs Hub (#133)

    • Web Apps & PWAs Hub: Dedicated catalog, database, repository, and management screen for progressive web apps.
    • System Share Menu Integration: Added Omni Browser to Android system link sharing menu (ACTION_SEND with text/plain).
    • Floating Selection Menu: Support for ACTION_PROCESS_TEXT and enhanced link parsing via IntentUrlParser.

    🧩 UI & Extension Polish

    • Launcher Shortcut Pinning: Pin WebExtensions directly to the device launcher home screen (EXTRA_EXTENSION_SHORTCUT).
    • Nav Bar Icon Sizing: Unified navigation action icons to dynamic navIconSize.
    • API 28 Compatibility: Fixed dropdown menu white splash and layout failure on Android 9 by using API-safe Popup.
    • Localization: Added missing navigation and tool strings across all 13 supported languages.

    📦 Installation Requirements

    • Android 8.0+ (API 26) is required.
    • If you are not sure which build to choose, download the universal APK (omni-browser-v1.3.5.1-universal.apk).
  3. v1.3.4.1Omni Browser v1.3.4.12026-10-01 · 2026-10-01 13:02 UTC
    查看更新说明

    Omni Browser v1.3.4.1

    ⚠️ Customization Notice & Known Considerations This release introduces extensive interface personalization through the new Chrome Drag Layout Editor (custom bottom navigation bars, address bar action clusters, and draggable home screen sections). Because this involves major UI architecture changes, it may introduce new bugs or edge cases in the customization area. If you encounter visual glitches or layout resets, please report them.

    🛠️ Previous Main Bugs Addressed All previous main known bugs have been touched and reworked in this release in order to thoroughly resolve them (including server redirect handling #132, privacy fingerprint timezone leaks #137, bookmark state desyncs, AMOLED theme leaks #118, OAuth popup session restores, and extension popup action reliability).

    Removed: Firefox Account Sync. Firefox Sync is end-to-end encrypted, and Mozilla issues the app credentials required to read or write synced data only to its own clients — not to third-party browsers. We explored a read-only integration too: because the data is encrypted end to end, decrypting it needs the same credentials, so that path isn't available either. The earlier Firefox Account sign-in could never complete against Mozilla's servers, so it's gone rather than left pretending. Use Omni Sync instead — it syncs bookmarks and open tabs, and transfers saved passwords, directly with your desktop browser over your own Wi-Fi.


    🚀 What's New in v1.3.4.1 (since v1.3.3.3-beta)

    🎨 Chrome Drag Layout Editor & Customization Overhaul

    https://github.com/user-attachments/assets/d042e4a0-3686-4549-bc93-e4d8552c4c1d

    • Interactive Drag-and-Drop Chrome Editor: Customize browser controls and UI layouts visually via Settings > Appearance (ChromeDragLayoutEditor.kt, ChromeLayoutEditor.kt, ChromeAction.kt).
    • Custom Navigation Bar Layouts: Independently customize and reorder action buttons on both the Home Bar and the active Page Bar (Back, Forward, Home, Tabs, Menu, Extensions, Bookmarks, Downloads, Clear Data, Desktop Mode, Reader Mode, and more).
    • All-in-One Address Bar Clusters: Customize leading and trailing button clusters flanking the omnibox address bar to suit your workflow.
    • Reorderable Home Screen Sections: Drag and reorder sections (Speed Dial, Recent Tabs, Bookmarks, Highlights) directly on the New Tab / Home Screen.
    • Home Search Bar Positioning: Added a setting toggle to place the Home Screen search bar at the bottom or top of the display.
    • Speed Dial Launcher Sheet: Floating action quick-launcher sheet for fast navigation and instant access to top tools.

    💾 Native Backup & Restore Engine

    https://github.com/user-attachments/assets/3950e59f-a914-41ce-95c5-862b49272496

    • Full Browser State Backup: Export your complete Omni configuration into a timestamped, integrity-verified .omni package (BackupEngine.kt).
    • Comprehensive Scope: Backs up and restores bookmarks, history, settings, user agent rules, visual element blocker rules, custom search engines, speed dial layouts, extensions state, and custom chrome button layouts.
    • Safe Import Preview: Inspect backup archive contents and manifests before committing restores (BackupScreen.kt).

    📁 Hierarchical Bookmark Manager & Netscape Import/Export

    • Folder-Based Bookmark Manager: Full tree hierarchy navigation with responsive breadcrumbs, cross-folder search, folder creation, editing, moving, and deletion (BookmarksScreen.kt, BookmarkTreeQueries.kt).
    • Cache Invalidation Fix: Fixed an issue where the "Clear all" action left the bookmark hierarchy tree in a stale UI state.
    • Netscape HTML Import & Export: Import and export browser bookmarks using standard Netscape bookmark HTML format while retaining folder hierarchies (BookmarkImportViewModelExt.kt).

    🔄 Two-Way Omni Sync (P2P / LAN) & Clean Architecture

    • *Two-Way Sync Outbox
  4. v1.3.3.3-betaOmni Browser v1.3.3.3-betapre-release2026-09-26 · 2026-09-26 16:19 UTC
    查看更新说明

    Omni Browser v1.3.3.3-beta (Pre-release)

    ⚡ Optimized R8 Minification Version with Highly Compressed Libraries This build is optimized utilizing aggressive R8 compiler shrinking, optimization, and resource minification alongside highly compressed runtime libraries, delivering maximum performance, enhanced security, and the smallest possible installation footprint.


    🚀 What's New in v1.3.3.3-beta

    🧭 Navigation & Session History

    • Long-Press Session History Menu: Long-pressing the Back or Forward navigation buttons now opens an interactive session history bottom sheet to jump directly to any previous or forward page in the tab's navigation stack (including the New Tab / Home Screen root).
    • Improved Back/Forward Navigation Stack: Refined tab navigation stack tracking and state restoration across web pages and home screen transitions.

    🎛️ Address Bar & Scroll Controls

    • Side Scroll Bar Toggle Fix: Properly disables the vertical fast-scroll side bar when the Side Scroll Bar toggle is turned off in Site Settings, and updated setting labels/descriptions for clarity.
    • Top Address Bar & Tablet Menu Enhancements: Restored the 3-dot dropdown menu (MoreVert) in Top Address Bar and Adaptive Tablet Chrome modes with full quick-action wiring (New Tab, Incognito, Burn Data, Find in Page, Extensions, and Settings), and kept the menu accessible while the address bar input is focused.

    🛡️ Privacy & Content Blocking Refinements

    • Total Cookie Protection (dFPI) & Cookie Behavior: Corrected GeckoView cookie behavior mappings and added Isolate third-party cookies (Total Cookie Protection) alongside tracker-blocking and strict cookie controls.
    • Stricter Social Tracker Filtering: Removed social media root domains from the filter-list immunity set so third-party social tracking subdomains (e.g., connect.facebook.net, platform.twitter.com) are never exempted from filter rules.

    ⚙️ Recent 1.3.3.x Improvements Included

    • omni:config Engine Flags & Small-Screen Layout: Added curated Gecko engine flags and fixed responsive layout and status bar padding on compact devices.
    • AMOLED Theme & Speed Dial: Fixed AMOLED theme leak (#118), updated Speed Dial to a 5-column layout, and added "Open in [App]" to the Omni menu sheet.

    Installation Requirements

    • Android 8.0+ (API 26) is required.
    • If you are not sure which build to choose, download the universal APK.
  5. v1.3.3.2Omni Browser v1.3.3.22026-09-14 · 2026-09-14 08:59 UTC
    查看更新说明

    Omni Browser v1.3.3.2

    ⚡ Optimized R8 Minification Version with Highly Compressed Libraries
    This build is optimized utilizing aggressive R8 compiler shrinking, optimization, and resource minification alongside highly compressed runtime libraries, delivering maximum performance, enhanced security, and the smallest possible installation footprint.


    🚀 What's New in v1.3.3.2

    📱 Tablet & Large-Screen Adaptive UI Overhaul (#71)
    • Dynamic Window Size Classes: Replaced hardcoded tablet branching with official Material Window Size Classes (Compact <600dp, Medium 600–839dp, Expanded 840–1199dp, Large 1200–1599dp, Extra-Large ≥1600dp). Screen rotation, split-screen multi-tasking, foldable unfold/fold, and freeform desktop windows now dynamically reflow in real time.
    • Adaptive Tab Strip: Desktop-style responsive tab strip with min/max tab widths, active tab auto-scroll-into-view, and full-height touch targets.
    • Unified Tablet Toolbar: Desktop-style toolbar consolidating Speed Dial, Site Info ("Tune"), Address Bar, and action buttons with deterministic collapse priority (#81).
    • Navigation Rail: Tablets and foldables (≥840dp) now feature a clean side Navigation Rail instead of a stretched bottom bar, yielding automatically during search and fullscreen browsing.
    • List-Detail Settings Shell: Two-pane master-detail layout on large screens, with centered width caps across settings and tool screens.
    • Anchor-Aware Dropdown Menus: Omni dropdown menus calculate anchor coordinates dynamically to prevent off-screen bottom clipping.
    ⚙️ Chrome & Brave Style Engine Flags (omni:config)
    • GeckoView Engine Flags: Introduced a power-user experiments page (omni:config / about:config) mapping popular Chromium and Brave flags directly to Firefox GeckoView engine preferences.
    • Curated Flags Suite: Parallel Downloading, Back-Forward Cache (BFCache), GPU Rasterization, Tracking Protection, Canvas Fingerprint Scrambling, WebGPU, DNS-over-HTTPS (DoH), and more.
    • Custom Pref Injector: Inject, toggle, and delete custom about:config strings, booleans, and integers with live persistence.
    • Responsive Small-Device Layout: Header adapts into dedicated rows on phones to eliminate text wrapping, with vertically centered search fields and category filtering chips.
    🎨 Visual & Theme Fixes
    • AMOLED to System Theme Visual Leak (#118): Resolved an issue where switching from AMOLED to System theme in light mode leaked pitch-black AMOLED surfaces into the UI. State is now purged at the DataStore, ViewModel, ThemeScreen, and Activity runtime levels.
    • 5-Column Speed Dial Grid: Speed Dial sheet now renders 5 columns across on mobile devices, matching the proportions of home screen shortcuts.
    • True Aura Light Design: Restored authentic black & white launcher foreground icons and theme tokens.
    • HTML <optgroup> Sub-Options: Fixed native <select> dropdowns failing to render grouped sub-options on web forms.
    ⚡ Keyboard & Input Experience
    • Keyboard IME Viewport Padding (#115): In edge-to-edge mode, web inputs (e.g. duck.ai, ChatGPT, web forms) are no longer obscured behind the soft keyboard. GeckoView host now applies IME insets so focused fields automatically scroll into view.
    • Keyboard Action Button (#121): Address bar keyboard action now correctly displays "Search" / "Go" instead of a generic "Enter" key.
    🔗 Deep-Link & External App Routing
    • Smart App Handoff Consent (#113): Standard https:// deep links (YouTube, Reddit, Twitter, etc.) now prompt with *"Open in [App]?

用户点评

登录用户的真实使用记录,可按版本和硬件筛选
共 0 条

    还没有人点评。第一个说出真实体验的人最有价值。

    README 原文

    未翻译


    [!CAUTION] 🧪 Experimental Software — Use With Caution

    Omni Browser is currently in active development and experimental phase. Features may be incomplete, unstable, or subject to significant change without notice. You may encounter bugs, crashes, or unexpected behaviour.

    • ⚠️ Not recommended as your sole/primary browser yet
    • 🐛 Bugs are expected — please report them
    • 🔄 APIs and features may change between releases
    • 💾 Back up any important data stored in the app (vault, notes)

    We appreciate your patience and feedback as we work toward a stable release. 🙏


    📸 Screenshots

    HomeQuick ToolsBrowser Menu
    ExtensionsSettingsSafe Locker

    ✨ Overview

    Omni Browser is a state-of-the-art mobile web browser built by RebelRoot — an independent development collective focused on privacy, performance, and open-source freedom.

    Powered by Mozilla GeckoView (the same engine behind Firefox), Omni delivers desktop-grade browsing, native Firefox WebExtension support, hardware-decoded media playback, and a built-in tools suite (QR tools, translator, developer console, PDF export) — all wrapped in a premium OLED-dark Jetpack Compose interface.


    ⚡ Features

    🏠 Home & Navigation

    FeatureDetails
    Smart Home ScreenSearch bar, quick-access site shortcuts, Discover news feed (Trending, World, Technology, Sports)
    Quick Access GridPinned shortcuts to RebelRoot, Twitter, Spotify, Amazon, Pinterest + Downloads, History, Bookmarks
    Incognito ShortcutOne-tap incognito launch directly from the home screen
    Multi-TabChrome-like tab strip with open tab count indicator

    🛡️ Privacy & Security

    FeatureDetails
    Built-in Ad BlockerHost-based ad, tracker & telemetry blocker with configurable filter lists (EasyList, uAssets, StevenBlack & more)
    Incognito ModeFully isolated private session — no history, cookies, or cache saved
    Extensions in IncognitoAll extensions work inside private tabs
    Burn DataOne-tap wipe of all history, cache, cookies, and session data
    Safe LockerBiometric AES-256 hardware-backed encrypted vault for private files

    🔌 Extensions

    ExtensionDetails
    uBlock OriginInstallable from AMO — efficient wide-spectrum content blocker, easy on CPU and memory
    Universal Text CopyBypass website restrictions to force-enable text selection & copying
    Aggressive Media GrabberSniff and capture HLS/DASH streams and dynamic segments
    AI BlockerBlock AI Overview summaries and assistant panels on search engines
    Install from StoreInstall any Firefox Android .xpi add-on from addons.mozilla.org

    🛠️ Quick Tools Panel

    ToolDetails
    QR ScannerScan QR codes and barcodes via camera
    TranslatorOnline translation via the Google Translate endpoint
    Edit PageInject custom JS/CSS to modify any web page live
    Save PDFExport any page as a PDF document
    Pin Web AppAdd any website to the home screen as a PWA-style shortcut
    Auto-ScrollHands-free automatic page scrolling
    QR Scan PageScan QR codes found on the current web page
    QR GeneratorGenerate QR codes from any text or URL
    Console LogLive JavaScript developer console REPL
    Dev NotesSecure offline scratchpad for developer notes
    Site StyleApply custom visual styles to any site

    🎥 Media

    FeatureDetails
    Stream SnifferCaptures HLS, DASH, MP4, and MSE streams automatically
    Omni PlayerExoPlayer with swipe gestures, speed control, PiP, background audio
    Player SettingsConfigurable player behavior from the browser menu

    ⚙️ Settings

    SettingDetails
    Dark ModeOLED-black dark theme across the entire app
    Accent ColorChoose from 5 accent colors (blue, red, green, orange, purple)
    PDF Export ThemeSystem Default / Light / Dark PDF rendering
    Native Video PlayerOpen videos in Omni Player with auto-download support
    Private BrowsingBlock all trackers and cookies globally
    AI BlockerBlock generative search summaries completely
    Default BrowserSet Omni as your system default browser
    App LanguageMulti-language support with global locale switching

    🔄 Omni Sync

    FeatureDetails
    Firefox Cloud SyncNot available. Mozilla grants Firefox Accounts OAuth and Sync access only on request and does not grant it to third-party browsers, so Omni cannot join Mozilla's cloud.
    Omni Sync MeshZero-cloud 100% E2EE local Wi-Fi sync between Omni and desktop Firefox (requires the desktop Omni Sync Extension)
    CRDT Conflict ResolutionBase-62 fractional indexing ensures tree invariant preservation and zero collisions
    Privacy IsolationIncognito tabs and private sessions are strictly excluded from all sync engines

    📐 Architecture

    Omni Browser uses a clean MVVM + Unidirectional Data Flow architecture, binding Jetpack Compose UI directly to GeckoView through a central BrowserViewModel.

    graph TD
        subgraph UI["UI Layer (Jetpack Compose)"]
            BS[BrowserScreen.kt]
            OS[OnboardingScreen.kt]
            SS[SettingsScreen.kt]
        end
    
        subgraph VM["ViewModel Layer"]
            BVM[BrowserViewModel.kt]
            STATE[TabState / UiState]
        end
    
        subgraph Engine["Engine Layer (GeckoView)"]
            GR[GeckoRuntime]
            GS[GeckoSession]
            GV[GeckoView]
            WEC[WebExtensionController]
        end
    
        subgraph Ext["Built-in Extensions"]
            MG[Aggressive Media Grabber]
            UC[Universal Copy]
            AIB[AI Blocker]
        end
    
        subgraph Svc["Services"]
            DL[Download Engine]
            TL["Translator (online)"]
            VPN[WireGuard VPN]
            VAULT[Biometric Vault]
            PDF[PDF Export]
        end
    
        BS -->|Events| BVM
        BVM -->|State| STATE
        STATE -->|Recompose| BS
        BVM --> GR
        GR --> GS
        GS --> GV
        GR --> WEC
        WEC --> MG & UC & AIB
        GS -->|Delegates| BVM
        BVM --> DL & TL & VPN & VAULT & PDF
    

    See docs/ARCHITECTURE.md for the full component breakdown.

    Repository Structure

    omni-browser/
    ├── app/src/main/
    │   ├── assets/web_extensions/        # Bundled WebExtensions (uBlock, Grabber, Copy, AI)
    │   ├── java/com/rebelroot/omni/
    │   │   ├── browser/                  # Core browser screen + ViewModel
    │   │   │   └── extensions/           # Extension manager classes
    │   │   ├── media/player/             # ExoPlayer + MSE stream interceptor
    │   │   ├── onboarding/               # Language selection & onboarding slides
    │   │   ├── privacy/                  # Biometric Locker vault
    │   │   ├── settings/                 # Settings screen composable
    │   │   ├── tools/                    # QR, Translator, PDF, Console, Dev Notes
    │   │   ├── ui/theme/                 # Colors, typography, shapes
    │   │   └── vpn/                      # WireGuard VPN manager
    ├── images/
    │   ├── screenshots/                  # 📸 App screenshots
    │   │   ├── home_v2.png
    │   │   ├── quick_tools.png
    │   │   ├── browser_menu.png
    │   │   ├── extensions_v2.png
    │   │   ├── settings.png
    │   │   └── safe_locker_v2.png
    │   └── demo.gif                      # 🎬 Screen recording demo
    ├── docs/
    │   ├── ARCHITECTURE.md
    │   └── SECURITY.md
    ├── CHANGELOG.md
    ├── CONTRIBUTING.md
    ├── PRIVACY_POLICY.md
    └── LICENSE
    

    🛠️ Build & Installation

    Prerequisites

    • Android Studio Ladybug or newer
    • JDK 17 (JAVA_HOME must be set)
    • Android SDK — Target API 35 (Android 15)
    • Device running Android 8.0+ (API 26+)

    Build Commands

    # Clone
    git clone https://github.com/REBEL-ROOT/omni-browser.git
    cd omni-browser
    
    # Compile check
    ./gradlew compileArmDebugKotlin compileAarch64DebugKotlin
    
    # Debug APK
    ./gradlew assembleDebug
    # → app/build/outputs/apk/arm/debug/app-arm-debug.apk
    # → app/build/outputs/apk/aarch64/debug/app-aarch64-debug.apk
    
    # Release bundle (AAB)
    ./gradlew bundleRelease
    # → app/build/outputs/bundle/release/app-release.aab
    

    Pre-built Releases

    Download the latest signed APK from our Releases Page.


    🤝 Contributing

    We welcome contributions from the open-source community! Please read CONTRIBUTING.md before submitting a PR.

    git checkout -b feature/your-feature
    # make changes
    git commit -m "Add: short description"
    git push origin feature/your-feature
    # open a Pull Request
    

    We especially need help with:

    • 🌐 Translations & localization
    • 🧪 Unit and UI test coverage
    • 📖 Documentation improvements
    • 🐛 Bug reports and fixes

    👥 Contributors

    Core Team

    Contributors

    Bug Hunters & QA Contributors

    Special thanks to the following community members who have helped debug the project, perform extensive testing, and present critical issues:

    RankContributorContribution Evidence
    1HikaruIchijyoClosed Issues (#23, #24, #25, #27, #28, #31, #37, #38, #40, #52, #53) — Very extensive testing and UI/UX feedback. #31 alone had multiple concrete improvements with reference screenshots, many of which were marked completed.
    2Tr4p-kunClosed Issues (#10, #11, #12, #13) — Multiple detailed bug reports, proper reproduction steps, device/version information, and screenshots/videos.
    3trinadhthatakulaClosed Issues (#34) — Exceptional technical investigation of the versionCode regression, including release-by-release analysis, affected users, reproduction, and a proposed fix.
    4abhishekjena601-sourceClosed Issues (#73, #77) — Repeated testing/feedback across media player, dark mode, pull-to-refresh, toolbar/UI, and other areas.
    5MalikSabahatAliClosed Issues (#61) — Excellent cross-site investigation of the .pk/.bin navigation bug, testing multiple domains and comparing behavior against Chrome.
    6jd0specClosed Issues (#51) — Detailed analysis of Omni's video-player architecture and playback continuity, with comparison against Quetta and a concrete technical direction.
    7DarkHorse313Closed Issues — Provided multiple valuable bug reports and detailed testing feedback on closed issues.
    8Sunnu126Closed Issues (#49) — Detailed extension toggle bug report on Samsung S20 FE 5G (Android 13).
    9Phinixprono123Closed Issues (#54) — Crucial compatibility bug report regarding settings crash on Vivo Y85 (Android 8.1 Oreo).
    10Atrium0495Closed Issues (#71) — Real tablet testing with screenshots identifying layout and accessibility problems.

    📺 Community Showcases & Reviews

    Special thanks to content creators who have featured, demonstrated, or reviewed Omni Browser:

    CreatorShowcase
    odorizzioficialYouTube Showcase Video — Detailed video demonstration and overview of Omni Browser's features.

    📄 License & Trademark

    This project is licensed under the GNU General Public License v3 (GPLv3).

    Omni Browser — Copyright (C) 2026 RebelRoot Ltd
    This is free software: you can redistribute it and/or modify it
    under the terms of the GPLv3. See LICENSE for details.
    

    [!IMPORTANT] Forking & Redistribution Terms: Pursuant to GPLv3 Section 7(b), any derivative works, forks, or hosted versions of this software must retain original author attribution and link back to this repository. You must also rebrand the application (use your own logo and name) to respect the Trademark & Attribution Policy.


    🔒 Security

    To report a vulnerability, use GitHub's private Security Advisory system — do not open a public issue. See docs/SECURITY.md.