Skip to content

aalejandrofer/arcoverlay

 
 

Repository files navigation

Arc Overlay

Arc Overlay Logo

Arc Overlay is a powerful, real-time overlay tool designed to enhance your gaming experience. By utilizing advanced OCR (Optical Character Recognition) and screen scanning technologies, it provides instant information about items, quests, and progression without requiring you to leave the game.

Version License

Important

This project is a modified version based on Git: ArcCompanion.

Special thanks to RaidTheory/arcraiders-data for providing the essential game data.

✨ Key Features

  • 🔍 Smart Item Overlay: Instantly scan items on your screen to see their rarity, market value, and utility in quests or projects.
  • 📜 Quest Tracker: Keep your active objectives in view with a customizable overlay. Never lose track of what you need to collect.
  • 🎟️ Event Tracker: Keep track of current map events and upcoming ones.
  • 🏠 Hideout & Project Management: Track your base progression and crafting requirements in a centralized "Progress Hub."
  • 🌍 Multi-Language OCR: Supports 14+ languages (English, German, French, Spanish, Russian, Chinese, Japanese, and more).
  • ⚡ High Performance: Fast scanning powered by OpenCV and MSS for minimal impact on game performance.
  • 📝 Patch Notes: Check out the latest updates in Patchnotes.md.

⌨️ Default Hotkeys

Customizable in the settings:

  • Ctrl + F: Trigger Item Scan (OCR).
  • Ctrl + E: Toggle Quest Log Overlay.
  • Ctrl + H: Open the Progress Hub (Main Window).
  • Ctrl + G: Toggle Event Log Overlay.

🚀 Getting Started

Prerequisites

  • Windows (10/11 recommended).
  • Tesseract-OCR (usually bundled with the installer).

Installation

  1. Download the latest version from the Releases page.
  2. Install and run ArcOverlay.exe.
  3. The app will minimize to the system tray. Use the hotkeys or right-click the tray icon to access features.

For Developers

If you want to run from source:

  1. Clone the repository.

  2. Install dependencies:

    pip install -r requirements.txt

    or

    uv run arcoverlay.py
  3. Ensure Tesseract-OCR is installed and accessible (bundled with git clone).

  4. Run the application:

    python arcoverlay.py

🏗️ Building (Windows 11)

To build the native Windows MSI installer, you must run the following command from a Windows terminal (not WSL):

python buildtools/msi_setup.py bdist_msi

The installer will be generated in the dist/ directory.

🛠️ Built With

  • Python: Core application logic.
  • PyQt6: Modern GUI framework.
  • OpenCV: Image processing for OCR preparation.
  • Tesseract-OCR: Optical Character Recognition engine.
  • MSS: Ultra-fast screen capturing.

📄 License

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

🤖 AI Development

This project has been developed with the assistance of AI tools, specifically models like Gemini 3 Pro and Gemini 3 Flash in combination with Antigravity IDE.

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages

  • Python 53.6%
  • HTML 46.3%
  • Inno Setup 0.1%