Type_Browser

A minimalist browser designed for customization, privacy, and code-first exploration.

📖 Overview

Type_Browser is a lightweight, privacy-focused personal web browser built with Python and PyQt5. It offers a user-friendly interface with tabbed browsing, navigation features, and a customizable home page. This project focuses on simplicity and privacy, providing basic web browsing functionalities with minimal distractions.

🚀 Features

  • Modern and Clean UI: User-friendly interface with minimal distractions
  • Tabbed Browsing: Open multiple websites in separate tabs
  • Bookmarks Management: Save and organize your favorite websites
  • Browsing History: Track and access your browsing history
  • Download Manager: Handle file downloads efficiently
  • Settings and Preferences: Customize your browsing experience
  • Dark/Light Theme Support: Choose your preferred visual theme
  • Keyboard Shortcuts: Navigate efficiently with keyboard commands
  • Context Menu: Right-click functionality for enhanced interaction
  • Full-screen Mode: Immersive browsing experience
  • Zoom Controls: Adjust page zoom levels
  • Find in Page: Search for text within web pages
  • Save Page As: Save web pages locally
  • View Page Source: Access HTML source code
  • Inspect Element: Developer tools for web inspection

🛠️ Technologies Used

  • Backend: Python 3.x
  • GUI Framework: PyQt5
  • Web Engine: PyQtWebEngine
  • Architecture: Object-oriented design with modular components

📂 Project Structure

The project follows a clean, modular architecture designed for easy customization and extension.

/Type_Browser
│── TypeBrowser.py      # Main application entry point
│── requirements.txt    # Python dependencies
│── README.md          # Project documentation
│── LICENSE            # MIT License
│── .type_browser/     # User data storage (created on first run)

🔧 Installation & Setup

To run this application, you need Python 3.x and the following libraries:

  • PyQt5
  • PyQtWebEngine

Step-by-step installation:

Clone the repository:

git clone https://github.com/EriRJorge/Type_Browser.git
cd Type_Browser

Install the required dependencies:

pip install -r requirements.txt

Or install manually:

pip install PyQt5 PyQtWebEngine

🎯 Usage

Run the browser:

python TypeBrowser.py

Basic Navigation:

  • New Tab: Open a new tab using Ctrl+T
  • Close Tab: Close the current tab with Ctrl+W
  • Navigate: Type a URL in the address bar and press Enter
  • Back/Forward: Use the navigation buttons or Alt+Left/Right
  • Reload: Reload the current page using Ctrl+R

⌨️ Keyboard Shortcuts

Navigation

  • Ctrl+T: New tab
  • Ctrl+W: Close tab
  • Ctrl+R: Reload page
  • Ctrl+L: Focus URL bar
  • Alt+Left: Back
  • Alt+Right: Forward

Browser Features

  • Ctrl+B: Toggle bookmark
  • Ctrl+H: Show history
  • Ctrl+,: Show settings
  • Ctrl+F: Find in page
  • F11: Toggle fullscreen
  • Ctrl+N: New window

Zoom & View

  • Ctrl++: Zoom in
  • Ctrl+-: Zoom out
  • Ctrl+0: Reset zoom
  • Ctrl+S: Save page
  • Ctrl+Q: Exit browser

Edit Operations

  • Ctrl+Z: Undo
  • Ctrl+Y: Redo
  • Ctrl+X: Cut
  • Ctrl+C: Copy
  • Ctrl+V: Paste

💾 Data Storage

Browser data (bookmarks, history, settings) is stored in the following location:

  • Windows: %USERPROFILE%\.type_browser
  • Linux/Mac: ~/.type_browser

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request to help improve Type_Browser.

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.