Elafrý Browser

Elafrý (Greek for "Light") is a modern, lightweight, privacy-focused web browser for Windows built with Python and PyQt6.

Features

• Lightweight & Fast: Powered by QtWebEngine (Chromium).
• Privacy First: DuckDuckGo as the default search engine.
• Modern UI: Clean design with Dark and Light mode support.
• Customizable: Toggle themes instantly.

Installation

From Source

1. Clone the repository:

   git clone https://github.com/yourusername/elafry.git
   cd elafry

2. Create a virtual environment:

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

3. Install dependencies:

   pip install -r requirements.txt

4. Run the browser:

   python browser.py

Building the Executable

You can build a standalone executable for your current platform (Windows, macOS, or Linux).

1. Ensure dependencies are installed:

   pip install -r requirements.txt

2. Run the build script:

   python build_binaries.py

3. The executable will be found in the dist folder (e.g., dist/Elafrý.exe on Windows).

Note: On Windows, the script will automatically convert logo.png to logo.ico if you have Pillow installed.

Creating a Windows Installer (Optional)

If you want to create a professional setup.exe installer instead of just a standalone file:

1. Download and install Inno Setup.
2. Build the project executable first (see above).
3. Open setup.iss in Inno Setup.
4. Click Build > Compile.
5. The installer will be generated in the installer/ folder.

Cross-Platform Automated Builds

This project includes a GitHub Actions workflow that automatically builds binaries for Windows, macOS, and Linux whenever you push changes or create a release. Check the Actions tab or Releases page on GitHub to download the latest builds.

Documentation

• Contributing Guidelines
• Architecture Overview

License

MIT License. Free and Open Source.