A big thanks to Pabosik for creating the original PabsArcTooltip that this project is built on. The core idea - an OCR-based screen overlay that reads item tooltips and tells you what to do with them - is entirely his. ARLO just builds on that foundation with some extra features.
A screen overlay tool for Arc Raiders that detects items in your inventory and displays recommended actions (keep, recycle, sell) along with sell prices, stack sizes, and crafting details. The item database auto-syncs from the Arc Raiders Wiki on every launch.
- Auto-sync on launch - The item database updates from the wiki every time you start the app (throttled to once per 24 hours). No manual steps needed.
- Sell price & stack size on the overlay - See at a glance what an item sells for and how high it stacks
- 300+ items - Expanded coverage including keys, mods, augments, shields, ammo, and consumables
- Smart action generation - Items are auto-categorized (keep materials, sell trinkets, recycle junk) based on wiki data
- Merge mode - New items from the wiki are added without overwriting your manual action overrides
- GitHub Actions - Optional scheduled workflow that auto-updates the database weekly
The tool runs two detection phases while you play:
- Trigger Detection (every 500ms) - Scans for the word "INVENTORY" on screen to know when your inventory is open
- Tooltip Detection (every 300ms) - When inventory is open, captures the area around your cursor, reads the item name via OCR, looks it up in the database, and shows an overlay
The overlay popup displays:
+--------------------------------------+
| ARC Alloy |
| -> Keep |
| Sell: 200 Stack: 15 |
| For: Workshop Explosives Station 1 |
+--------------------------------------+
- Item name at the top
- Action color-coded (green = keep, gold = sell, turquoise = recycle, pink = use)
- Sell price and stack size on the info line
- Details - what it recycles into, or why you're keeping it
- Coming soon
- Windows 10/11
- Arc Raiders running in borderless windowed or windowed mode (not exclusive fullscreen)
- Windows 10/11
- Python 3.11+
- uv package manager
- Tesseract OCR
- Download the latest release from the Releases page
- Extract the zip to a folder of your choice
- Run
ARLO.exe
The release includes all dependencies, including Tesseract OCR. The item database updates automatically from the wiki on launch, no more than once per 24 hours.
-
Clone the repository:
git clone https://github.com/Soygen/ARLO.git cd ARLO -
Install dependencies:
uv sync --all-extras -
Install Tesseract OCR to
C:\Program Files\Tesseract-OCR\(or setTESSERACT_PATHin.envif installed elsewhere) -
Copy the example config:
copy .env.example .env -
Launch the app:
uv run arc-helper
The item database updates automatically from the wiki on first launch. No separate step needed.
The app checks the Arc Raiders Wiki loot table for updates every time it starts, throttled to once per 24 hours. This happens silently in the background using merge mode, so any manual action overrides you've made are preserved and new items are added automatically.
If the wiki is unreachable (no internet, site down, etc.), the app continues normally with whatever database it already has.
You can also trigger a database update manually from the command line:
uv run python update_db.py # Full update from wiki
uv run python update_db.py --merge # Keep your manual overrides
uv run python update_db.py --dry-run # Preview changes without writing
Or use the makefile shortcuts:
make update-db # Full update
make update-db-merge # Merge mode
make update-db-dry # Dry run preview
The included workflow at .github/workflows/update-db.yml can also sync the database automatically:
- Runs weekly on Mondays at 6:00 UTC in merge mode
- Auto-commits updated
items.csvanditems.dbif changes are detected - Can be triggered manually from the Actions tab on GitHub
No secrets or extra configuration needed.
For more details on how the scraper works, CSV format, and manual database management, see docs/ITEMS.md.
To produce a distributable package with everything bundled:
uv sync --all-extras
uv run python build.py
Output lands in dist/ARLO/ containing the exe, calibration tool, bundled Tesseract, config files, item database, and the wiki updater script. Zip that folder to share with anyone - no Python install needed on their end.
See docs/BUILD.md for full build details.
On first launch the app detects your screen resolution and loads a matching profile if one exists:
| Resolution | Aspect Ratio | Status |
|---|---|---|
| 5120x2160 | 21:9 DQHD Ultrawide | ✅ Configured |
| 3840x2160 | 16:9 4K UHD | ✅ Configured |
| 3440x1440 | 21:9 Ultrawide QHD | ✅ Configured |
| 2560x1440 | 16:9 QHD | ✅ Configured |
| 2560x1080 | 21:9 Ultrawide FHD | ✅ Configured |
| 1920x1080 | 16:9 Full HD | ✅ Configured |
If your resolution isn't listed, run the Calibration tool:
uv run arc-calibrate
All settings live in the .env file. See docs/CONFIGURATION.md for details on scan regions, overlay position, display time, and debug mode.
ARLO/
├── update_db.py # Wiki scraper & DB updater
├── items.csv # Item data (auto-generated or hand-edited)
├── items.db # SQLite database (built from CSV)
├── pyproject.toml # Package config & dependencies
├── makefile # Convenience targets
├── build.py # PyInstaller build script
├── .env.example # Configuration template
├── .github/workflows/
│ └── update-db.yml # Scheduled wiki sync
├── src/arc_helper/
│ ├── main.py # Main app entry point
│ ├── config.py # Settings & logging
│ ├── database.py # SQLite + CSV import + fuzzy matching
│ ├── ocr.py # Screen capture & Tesseract OCR
│ ├── overlay.py # Tkinter overlay (action + price + stack)
│ ├── calibrate.py # GUI calibration tool
│ ├── resolution_profiles.py # Resolution presets
│ └── resolutions.json # Pre-configured resolution profiles
├── docs/
│ ├── ITEMS.md # Item database & wiki sync docs
│ ├── CALIBRATION.md # Calibration guide
│ ├── CONFIGURATION.md # Settings reference
│ ├── BUILD.md # Build instructions
│ ├── TROUBLESHOOTING.md # Common issues
│ └── CHANGELOG.md # Version history
└── static/ # Screenshots
Run uv run python update_db.py --dry-run to preview the wiki data. If you spot incorrect auto-generated actions, edit items.csv directly and use --merge on future updates to preserve your fixes.
If you calibrate for a resolution that isn't pre-configured, add it to resolutions.json and submit a PR.
Please include your screen resolution, debug images from the debug/ folder (enable DEBUG_MODE=true in .env), and arc_helper.log.
- PabsArcTooltip - Original project by Pabosik
- Arc Raiders Wiki - Community wiki used as the item data source
- Tesseract OCR - Text recognition engine
- PyInstaller - Executable packaging
MIT License - Free to use and modify.