A minimal, privacy-first Chromium-based web browser built with Python, PySide6, and QtWebEngine.
Important
Minium is a privacy oriented browser. No user data is saved after closing, everything remains in RAM.
Please make sure you save your important work before quitting the browser. Minium shall not be held responsible for data loss.
Also as a side note, you should update Minium frequently through Menu > Update Minium.
Warning
Windows support is experimental and not tested yet.
Wish to test? Report your findings in the Issues tab. Thank you.
Important
If you update minium, it is recommended to delete your cache folder to refresh the adblock cache.
To report problems or ask questions, please use GitHub Issues on this repository.
And for contributions, use GitHub Pull Requests.
All third-party resources such as the font, icons and blocklists used retain the copyrights and licenses of their respective owners.
- 🛡️ Privacy & Security First: Built-in multi-source ad blocker (HaGeZi Ultimate & TIF Medium, AdGuard, StevenBlack, etc.) and real-time Phishing protection via Cisco Talos PhishTank, getting a perfect score on
adblock-tester.com. - ⚡ Ephemeral & Lightweight: Your session is never saved to disk. Includes a "Burn All Data" option (
Menu > Burn All Data) to wipe cache, history, and active sessions instantly. - 🪟 Modern UI: Rounded window borders, drag zones, hide-able tabs, toast messages,
-lor--lessmode and more. - 🔍 Power-User Ergonomics: In-page find utility, audio indicators, tab pinning, tab unloading (to save RAM), and a Minium Dev Tools side pane (
F12orCtrl+Shift+I). - 🎥 Picture-in-Picture [BETA]: Floating video player compatible with (atleast) standard HTML5
<video>tags. - 🔄 Installer & Updater: Rootless user-space setup (
--install,--uninstall,--update) with automatic GitHub raw patching.
Ensure your system has Python 3.10+ and the Qt6 system dependencies installed.
sudo dnf install python3 python3-pip qt6-qtwebengine-devtoolssudo apt update
sudo apt install python3 python3-pip qt6-webengine-dev-tools-
Clone or download the Minium repository to your local machine:
git clone https://github.com/SubhrajitSain/Minium.git cd Minium -
Run
install.sh
./install.sh-
Clone or download the Minium repository to your local machine:
git clone https://github.com/SubhrajitSain/Minium.git cd Minium -
Install Python dependencies:
pip install -r requirements.txt
-
Run the built-in installer script to register Minium to your user environment (creates the binary launcher at
~/.local/bin/minium, creates the XDG desktop entry, and registers MIME protocols):python3 minium.py --install
You can now launch Minium directly from your desktop application launcher or type minium in your terminal!
If you prefer running it directly from the source directory without installing it to your PATH:
python3 minium.py-
Run in minimal viewport-only mode (hiding tabs/nav bars):
python3 minium.py --less
-
Open a starting URL immediately:
python3 minium.py https://example.com
-
Check for updates and update manually via CLI:
python3 minium.py --update
To completely remove Minium, its desktop launchers, and environment links from your user space, run:
python3 minium.py --uninstall...or...
minium --uninstallTo remove all data, simply remove the Minium source folder that you downloaded.
| Shortcut | Action |
|---|---|
| Ctrl + T | Open New Tab |
| Ctrl + W | Close Current Tab |
| Ctrl + N | Open New Window (Same Session) |
| Ctrl + Shift + N | Open New Burnt Window (New Session) |
| Ctrl + Shift + T | Reopen Last Closed Tab |
| Ctrl + Tab / Ctrl + PgDn | Switch to Next Tab |
| Ctrl + Shift + Tab | Switch to Previous Tab |
| Ctrl + 1 to 9 | Jump to Tab 1–9 |
| Ctrl + L or Alt + D | Focus Address Bar |
| Ctrl + F | Find In Page |
| F12 or Ctrl + Shift + I | Toggle Developer Tools Pane |
| Alt + P | Open Video in Picture-in-Picture |
| F11 | Toggle Fullscreen Mode |
| Ctrl + R or F5 | Reload Page |
| Ctrl + Shift + R | Hard Reload (Bypass Cache) |
| Ctrl + + (or =) / - / 0 | Zoom In / Out / Reset |
| Ctrl + Q | Exit Browser |
Drop any custom .user.js (Greasemonkey-style scripts) or .user.css file into the ./userscripts/ directory. Minium automatically detects, loads, and injects them into web pages on startup.
Enable this option in the settings to make all your browsing persist when you reopen Minium. All data is saved in the ./data/ directory.
Save the pages you visit frequently in the Bookmarks list, so that it becomes easier and faster to revisit them.
Keep your passwords stored here in an encrypted vault where only you can access them. Open it from the Settings.
Resources used in the making:
- Google Sans Flex font for the entire app.
- Google Material Icons as icons for buttons and actions.
- DuckDuckGo as the search engine.
- Python, PySide6 + Qt for the heavy lifting.
- Phishtank by Cisco Talos for phishting threat protection.
- HaGeZi for the Ultimate DNS Blocklist and TIF Medium.
- StevenBlack for Unified Hosts blocklist.
- AdGuard's DNS Filter.
- AdAway's official blocklist.
- d3ward for the Toolz Blacklist.
- Peter Lowe's Adservers (Yoyo).
- AnudeepND for the Adservers Blacklist.
- EasyList, EasyPrivacy, EasyCookies, Fanboy's Annoyances and EasyList Anti-AdBlock for their amazing lists.
© 2026 Minium by Subhrajit Sain. All rights reserved.
Minium is licensed under the MIT License.