Skip to content

Latest commit

ย 

History

35 Commits

Folders and files

NameName
Last commit message
Last commit date
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

RHODIUM Browser

RHODIUM

โœจ A sleek, lightning-fast web browser built with Python & PyQt6 WebEngine

Python PyQt6 Platform License Status


๐ŸŽฏ What is RHODIUM?

RHODIUM Browser is a blazing-fast, feature-rich desktop web browser built entirely from scratch using Python and the Chromium-powered PyQt6 WebEngine. No external dependencies, no bloatโ€”just pure browsing power with a beautiful, custom-built interface.

Whether you're a developer, power user, or privacy enthusiast, RHODIUM delivers a modern browsing experience with cutting-edge features wrapped in an elegant UI.


โšก Key Features

RHODIUM

๐Ÿ—‚๏ธ Tabbed Browsing

  • Multi-tab support with drag-to-reorder functionality
  • Pin important tabs for quick access
  • Close tabs individually or in bulk (close-others, close-right)
  • "All tabs" overview for easy navigation

๐Ÿ  Speed-Dial Home Page

  • Fully customizable shortcut tiles with live favicons
  • One-click add/edit/delete interface
  • Organize your favorite sites for instant access
  • Beautiful grid layout that adapts to your workflow

๐Ÿ”– Bookmarks System

  • Save your favorite pages with a single click
  • Smart bookmark management with search capability
  • Visual indicators (filled/empty) for organized browsing
  • Export/import bookmarks for data portability

๐Ÿ“œ History Management

  • Persistent SQLite-backed browsing history
  • Dedicated rhodium://history page with advanced features:
    • Group history by date (Today, Yesterday, Last 7 days, etc.)
    • Full-text search across your history
    • Delete individual items or date ranges
    • Privacy controls to clear sensitive browsing data

โฌ‡๏ธ Advanced Downloads Manager

  • Real-time download progress tracking
  • Pause/resume/cancel downloads mid-flight
  • File-type identification with smart icons
  • Persistent download history
  • One-click access to downloaded files
  • Resume capability for interrupted downloads

๐Ÿ” Intelligent Find in Page

  • Lightning-fast in-page search
  • Next/previous navigation
  • Highlight all matches
  • Case-sensitive search toggle
  • Clean, minimalist find bar

๐ŸŽฏ Address Bar Suggestions

  • Real-time URL suggestions as you type
  • Bookmark + History integration
  • Smart search suggestions
  • One-click autocomplete
  • Fuzzy matching for better results

๐Ÿ” Security Indicator

  • Visual HTTPS/SSL status badge
  • Secure/warning indicators
  • Mixed content warnings
  • Certificate information at a glance

๐Ÿ› ๏ธ Developer Tools

  • Inspect page information
  • Access native developer tools
  • Debug JavaScript and CSS
  • Analyze network activity

โš™๏ธ Customizable Settings

  • User-friendly settings dialog
  • Per-profile configuration
  • Persistent storage of preferences
  • Dark/light theme support
  • Keyboard shortcut customization

๐Ÿ” Zoom Control

  • Per-tab zoom in/out
  • Reset to default zoom level
  • Persistent zoom per domain
  • Smooth zoom transitions

๐Ÿ–ฅ๏ธ Custom Window Frame

  • Native Windows window controls
  • Minimize/maximize/restore/close buttons
  • Smooth scrolling throughout the UI
  • Frameless custom chrome

๐Ÿ’พ Local Database

  • SQLite-backed storage
  • Privacy-focused local storage
  • No cloud tracking
  • Encrypted sensitive data
  • Automatic backups

๐Ÿš€ Getting Started

Prerequisites

Before installing RHODIUM, make sure you have:

  • Python 3.11 or newer (Download)
  • Windows 10/11 (custom window controls optimized for Windows)
  • pip (included with Python)
  • At least 200MB free disk space

Installation

Step 1: Clone the repository

git clone https://github.com/sanath-kumar-s/Rhodium-Browser.git RhodiumBrowser
cd RhodiumBrowser

Step 2: Create a virtual environment (recommended)

python -m venv .venv
.venv\Scripts\activate

Step 3: Install dependencies

pip install -r requirements.txt

Step 4: Run RHODIUM

python main.py

โœ… That's it! RHODIUM Browser should launch in seconds.

๐Ÿ“ฆ Dependencies

All dependencies are stable, actively maintained, and carefully selected for performance:

Package Version Purpose
PyQt6 6.6.1 GUI framework
PyQt6-WebEngine 6.6.0 Web rendering (Chromium-based)
PyQtWebEngine 5.15.6 Additional WebEngine utilities

Total package size: ~500MB


โŒจ๏ธ Keyboard Shortcuts

Master RHODIUM with these essential shortcuts:

Shortcut Action
Ctrl + T New Tab
Ctrl + W Close Tab
Ctrl + Tab Next Tab
Ctrl + Shift + Tab Previous Tab
Ctrl + L Focus Address Bar
Ctrl + F Find in Page
Ctrl + H Open History
Ctrl + B Toggle Bookmarks
Ctrl + D Bookmark Current Page
Ctrl + J Open Downloads
Ctrl + + Zoom In
Ctrl + - Zoom Out
Ctrl + 0 Reset Zoom
Ctrl + R Reload Page
Ctrl + Shift + R Hard Reload
Alt + Left Go Back
Alt + Right Go Forward
F11 Full Screen
F12 Developer Tools

๐Ÿ“– View all shortcuts: Help โ†’ Keyboard Shortcuts (inside the application)


๐ŸŽจ Screenshots & Demos

๐Ÿ–ผ๏ธ Coming Soon! Screenshots showcasing:

  • Main browser window with multiple tabs
  • Speed-dial home page with customizable tiles
  • History page with advanced search
  • Downloads manager in action
  • Settings dialog
  • Dark/Light theme comparison

๐Ÿงช Development & Testing

Running Tests

# Run all tests
python -m pytest tests/

# Run with coverage
python -m pytest --cov=rhodium tests/

# Run specific test file
python -m pytest tests/test_database.py

Building Documentation

# Generate docs (requires sphinx)
cd docs/
make html

Debug Mode

# Run with verbose logging
python main.py --debug

# Log to file
python main.py --log=debug.log

๐Ÿ” Security & Privacy

โœ… What RHODIUM does RIGHT:

  • โœจ Local-first: All data stored locally on your machine
  • ๐Ÿ”’ No tracking: Zero telemetry or analytics
  • ๐Ÿ›ก๏ธ Open source: Full transparencyโ€”audit the code
  • ๐Ÿšซ No ads: No advertisements or sponsored content
  • ๐Ÿ”‘ Your data, your keys: Complete ownership of your browsing data

๐Ÿ“‹ Best Practices:

  • Regularly update Python and dependencies
  • Review the security policy in SECURITY.md
  • Report vulnerabilities responsibly

๐Ÿ› Troubleshooting

Common Issues

โŒ "PyQt6 not found"

pip install --upgrade PyQt6 PyQt6-WebEngine

โŒ "WebEngine crashed"

  • Update to Python 3.11+
  • Reinstall WebEngine: pip install --force-reinstall PyQt6-WebEngine

โŒ "Window won't open"

  • Try: python main.py --safe-mode
  • Check Windows version (requires Windows 10/11)

โŒ "Slow performance"

  • Clear history: Settings โ†’ Privacy โ†’ Clear Browsing Data
  • Disable extensions (if applicable)
  • Update your GPU drivers

๐Ÿ“š More help: Check Issues or open a new one


๐Ÿค Contributing

Love RHODIUM? Help make it even better!

How to Contribute

  1. Fork the repository
  2. Create a feature branch:
    git checkout -b feature/amazing-feature
  3. Make your changes with descriptive commits
  4. Test thoroughly before pushing
  5. Push to your branch:
    git push origin feature/amazing-feature
  6. Open a Pull Request with a clear description

Areas We Need Help With

  • ๐ŸŽจ UI/UX improvements: Design enhancements, theme support
  • ๐Ÿ› Bug fixes: Report and fix issues
  • ๐Ÿ“š Documentation: Improve guides and tutorials
  • ๐ŸŒ Translations: Help localize RHODIUM for other languages
  • โšก Performance: Optimize rendering and memory usage
  • ๐Ÿงช Testing: Expand test coverage

Code Style

  • Follow PEP 8 guidelines
  • Use meaningful variable names
  • Add docstrings to functions
  • Write unit tests for new features

๐Ÿ“‹ Roadmap

๐Ÿ”œ Planned Features (Upcoming)

Feature Status Timeline
๐ŸŒ Multi-language support Planned Q4 2024
๐ŸŽจ Custom themes In Progress Q3 2024
๐Ÿ”Œ Extensions API Planned Q1 2025
๐Ÿ“ฑ Mobile sync Researching Q2 2025
๐Ÿค– AI-powered features Concept 2025+
๐Ÿ” Password manager Planned Q3 2024
๐Ÿ‘ฅ Multi-profile support In Progress Q4 2024

Here is the progress of our Roadmap

Have a feature request? Open an issue or join our discussions!


๐Ÿ“Š Statistics

  • โญ Lines of Code: ~5,000+
  • ๐Ÿ“ฆ File Count: 15+ core modules
  • ๐Ÿš€ Startup Time: <2 seconds
  • ๐Ÿ’พ Memory Footprint: ~150MB average
  • ๐ŸŒŸ Built With: Pure Python + PyQt6

๐Ÿ’ฌ Community


๐Ÿ“„ License

Distributed under the MIT License. See LICENSE for more details.

This means you can use, modify, and distribute RHODIUM freely in personal or commercial projects. Just give credit! ๐Ÿ™Œ


๐Ÿ™ Acknowledgments

  • PyQt6 Team for the amazing GUI framework
  • Chromium Project for the WebEngine
  • Contributors who make this project possible
  • You for using RHODIUM Browser! โค๏ธ

๐Ÿ“ž Support

Enjoying RHODIUM? Here's how you can help:

  • โญ Star the repository to show your support
  • ๐Ÿ“ข Share with friends and colleagues
  • ๐Ÿ› Report bugs to help us improve
  • ๐Ÿ’ก Suggest features for future updates
  • ๐Ÿ’ฌ Leave feedback in discussions

Made with โค๏ธ and PyQt6
๐Ÿ”ท RHODIUM Browser
Fast. Secure. Beautiful.

GitHub โ€ข Download โ€ข Wiki โ€ข Issues


Last updated: August 2024 | Version: 1.0.0

About

A modern, lightweight desktop web browser built with Python and PyQt6, featuring a custom UI, tab management, downloads, offline handling, and Chromium-based web browsing.

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages