Localization Tools - Rust Desktop Application & CLI
===================================================

Built from commit: 2c825a4734479aadce1db6f408c8be5649cdeb07
Build date: 2026-03-03

PLATFORMS:

Linux x64 (Ubuntu 20.04+, Fedora 34+)
- localization_gui-linux-x64.tar.gz: Desktop GUI application
- localization_cli-linux-x64.tar.gz: Headless CLI tool (perfect for SBCs)

macOS ARM64 (Apple Silicon, macOS 11+)
- Localization GUI-macos.dmg: Signed and notarized GUI app bundle
- Localization-GUI-macos-arm64.zip: Alternative GUI packaging
- localization_cli-macos-arm64.tar.gz: Headless CLI tool

INSTALLATION:

Linux GUI:
1. Download: wget <URL>/localization_gui-linux-x64.tar.gz
2. Extract: tar -xzf localization_gui-linux-x64.tar.gz
3. Run: ./localization_gui

Linux CLI:
1. Download: wget <URL>/localization_cli-linux-x64.tar.gz
2. Extract: tar -xzf localization_cli-linux-x64.tar.gz
3. Run: ./localization_cli --help

macOS GUI:
1. Download the .dmg file
2. If you see a "damaged" warning:
   - Right-click the DMG → Open, or
   - Run in Terminal: xattr -cr ~/Downloads/Localization\ GUI-*.dmg
3. Double-click to mount the DMG
4. Drag "Localization GUI.app" to Applications folder
5. Launch from Applications
6. Note: CI builds are unsigned (no Developer ID cert in CI)
   To avoid warnings, build locally with a Developer ID certificate.

macOS CLI:
1. Download: curl -O <URL>/localization_cli-macos-arm64.tar.gz
2. Extract: tar -xzf localization_cli-macos-arm64.tar.gz
3. Run: ./localization_cli --help

REQUIREMENTS:

Linux:
- No dependencies required (statically linked binaries)
- GUI: X11 or Wayland display server
- CLI: No display server required (headless)

macOS:
- macOS 11.0 (Big Sur) or later
- GUI: No additional dependencies
- CLI: No additional dependencies

FEATURES:

GUI Application:
- Multi-modal localization (Visual, RF, Magnetic sensors)
- Modern egui-based desktop interface with modular architecture
- Real-time pose estimation
- Map-based localization
- Professional macOS app packaging
- Dark/light mode support
- Advanced image preview with zoom/pan
- Component-based UI architecture

CLI Tool:
- Headless operation (perfect for SBCs and automation)
- JSON configuration file support
- Batch processing capabilities
- No GUI dependencies (lightweight)
- Command-line interface for all localization features

ARCHITECTURE:

The codebase uses a modular Rust architecture:
- Core library (rust_core): Localization algorithms (shared)
- GUI module (src/gui/): Desktop application
- CLI module (src/bin/localization_cli.rs): Headless command-line tool
- Views: UI panels (inputs, preview, results)
- Widgets: Reusable components (image viewer, quality badges, etc.)
- Theme system: Light/dark mode support (GUI only)

For more information:
https://github.com/righteousgambit/phd-research