Installation

Installation Guide

Getting RoK-Tracker running is easier than ever. Follow these steps to install the application on your Windows 10/11 machine.

Prerequisites

• OS: Windows 10 or 11 (64-bit)
• Emulator: Bluestacks 5 (Recommended) or LD Player.

---

Simple Installation (Recommended)

You do not need to install Python or Node.js to use this tool! Just follow these steps:

1. Install the App

1. Download the latest release from the Releases page.
2. Choose the RoK-Tracker-Suite-setup.exe file.
3. Run the installer and follow the setup wizard.
4. Launch the app once. This will automatically create a deps/ folder next to your installed app.

2. Install Dependencies

You need two external dependencies for OCR (Optical Character Recognition) and ADB (Android Debug Bridge).

1. ADB Platform Tools:
   • Download ADB.
   • Extract the contents into the deps/platform-tools/ folder.
2. Tesseract OCR Data:
   • Download Tesseract Trained Data (you must download at least eng.traineddata).
   • Place the file(s) into the deps/tessdata/ folder.

Windows Defender Warning: The installer bundles a heavily compressed Python executable for the scanning engine. Windows Defender may falsely flag it as malware. If the app gets stuck on "Initializing Sidecar", check Windows Security -> Protection History, select Restore / Allow on device, and restart the app.

---

Advanced Installation (Build from Source)

For developers who want to modify the code.

1. Clone the repository:

   git clone https://github.com/Nexor255/RoK-Tracker.git

2. Install Python dependencies:

   python -m venv venv
   ./venv/Scripts/activate
   pip install -r requirements_win64.txt

3. Install frontend dependencies:

   cd gui_frontend
   pnpm install

4. Place ADB and OCR data in the deps/ folder as described above.
5. Run the app in development mode:

   npx --prefix gui_frontend tauri dev