aimos/Documentation

aimos Documentation

Complete guide to setting up and using aimos for hardware-level cursor control.

Quick Start

1

Solder your Host Shield

Solder the following on Host Shield: 5V, 3.3V, 5V (image below) and then plug it in the Arduino.

2

Launch setup

Connect the Arduino to the PC and run our Setup tool. Once flashed, connect the mouse to the Host Shield.

3

Launch aimos

Run the launcher application and configure your settings. The software will automatically detect your Arduino.

Required Hardware

You need the following hardware components to use aimos. Click the buttons below to purchase from Amazon.

Arduino Leonardo

ATmega32u4 microcontroller with native USB HID support. Essential for hardware-level mouse emulation.

USB Host Shield

MAX3421E-based shield for connecting your mouse to the Arduino. Requires soldering (see below).

Important: Soldering Required

You must solder the USB Host Shield correctly as shown in the image below. The red circles indicate the solder points that must be connected. Without proper soldering, the mouse plugged into the host shield will not work.

Host Shield soldering points - red circles indicate where to solder

Also Required:

  • USB Cable (standard USB-A to Micro-USB)
  • Windows 10 or Windows 11
  • Your gaming mouse

Color Detection Setup

Aimos uses color-based vision detection to identify targets. Remember to configure your target colors the same as your game target color.

Color Range

Red
Purple
Yellow

Detection Zone

Set the screen region for detection. Smaller zones also improve performance and reduce false positives.

Movement Configuration

Smooth

Controls how fast the cursor moves to targets. Higher values create more natural and slow movements.

Range: 0.1 - 1.0

FOV

Adjust the FOV so that aimos detects more space in the middle of the screen.

Range: 0.5 - 3.0

Bone

You can change to Head, Neck and Body (crosshair going to whatever you configured). We always recommend using Neck.

Target color

You can select target color: Red, Yellow and Purple.

Best Practices

  • Use target colors that do not appear naturally in the environment, for example Purple (is recommended)
  • Start with lower smoothing values and gradually increase for comfort
  • *Do not* rage a lot, you can get manually banned (especially now with replays)
  • Configure hotkeys to quickly toggle the software on/off
  • Test your config in aim trainers (aimlabs) or The Range before competitive play