Arduino-VG

Türkçe · English

YouTube videosu / YouTube video: Valorant + Arduino system

İletişim / Contact: discord.gg/ytpavlov

Bu depo YouTube videosunda gösterilen projenin kaynak kodunu paylaşmak için hazırlanmıştır.

This repository publishes the source code of the project demonstrated in the YouTube video above.

---

Türkçe

Proje hakkında

Arduino-VG; Windows üzerinde çalışan YOLO tabanlı ekran analizi, kontrol paneli ve Arduino Pro Micro/ATmega32U4 kartını seri port üzerinden USB HID mouse köprüsü olarak kullanan deneysel bir projedir.

Bu proje Riot Games ile bağlantılı değildir ve Riot Games tarafından desteklenmez. Yalnızca sahibi olduğunuz veya açıkça test izni aldığınız ortamlarda kullanın. İlgili hizmet koşullarına uymak kullanıcının sorumluluğundadır.

Donanım

• Arduino Pro Micro veya uyumlu ATmega32U4 kart
• Veri aktarımını destekleyen USB kablosu
• Windows 10/11 bilgisayar
• İsteğe bağlı NVIDIA GPU

1. Arduino kartını hazırlama

1. Arduino IDE 2 uygulamasını kurun.

2. SparkFun Pro Micro kullanıyorsanız Arduino IDE ayarlarında Additional Boards Manager URLs alanına şu adresi ekleyin:

   https://raw.githubusercontent.com/sparkfun/Arduino_Boards/main/IDE_Board_Manager/package_sparkfun_index.json
   

3. Boards Manager içinde SparkFun AVR Boards paketini kurun.

4. arduino/pavlov_mouse/pavlov_mouse.ino dosyasını Arduino IDE ile açın.

5. Kartınıza uygun Pro Micro kartını ve doğru işlemci hızını (5V/16 MHz veya 3.3V/8 MHz) seçin. Uyumlu bir klon kullanıyorsanız kart üreticisinin yönergesini izleyin.

6. Tools > Port menüsünden doğru COM portunu seçip Upload düğmesine basın.

Seri protokol testi için Serial Monitor hızını 115200 yapın. Her komut ! ile bitmelidir:

ping!
coords:20,0!
click:left!

coords ve click komutları gerçek mouse hareketi/tıklaması üretir; test öncesinde açık belgelerinizi kaydedin.

2. Windows/Python kurulumu

PyTorch'un Windows desteğiyle uyumlu Python 3.10, 3.11 veya 3.12 kurulmalıdır.

.\INSTALL.bat

Kurulum .venv adlı yerel bir sanal ortam oluşturur, Python bağımlılıklarını kurar ve varsayılan yolov8n.pt modelini Ultralytics üzerinden indirir.

NVIDIA GPU hızlandırması kullanacaksanız, ekran kartınız ve sürücünüz için doğru komutu PyTorch kurulum seçicisinden alın ve komuttaki python -m pip bölümünü .\.venv\Scripts\python.exe -m pip olarak çalıştırın.

3. Test ve çalıştırma

Önce ayrı ayrı test edin:

.\TEST_YOLO.bat
.\TEST_ARDUINO.bat

TEST_ARDUINO.bat mouse'u hareket ettirir ve tıklama yapar. Ana uygulama:

.\BASLAT.bat

Mouse aygıtı geçici olarak devre dışı bırakılabildiği için BASLAT.bat yönetici yetkisi ister. Mevcut kodun aygıt değiştirme bölümü Logitech G102 PID_C08B için hazırlanmıştır; başka bir mouse kullanıyorsanız mouse_switch.py dosyasını kendi donanımınıza göre incelemeden bu özelliği kullanmayın.

Acil mouse kurtarma

Program kapanır ve ana mouse geri gelmezse klavye ile bu dosyaya gidip yönetici olarak çalıştırın:

.\FARE_KURTARMA.bat

Modeller

Model ağırlıkları büyük ve lisansları kaynağa göre değişebildiği için depoya eklenmez. Ultralytics varsayılan modeli ilk kurulumda indirir. Kendi modelinizi yalnızca dağıtım hakkınız varsa şu adlardan biriyle proje köküne koyabilirsiniz:

• valorant_best.pt
• best.pt
• valorant.pt

---

English

About

Arduino-VG is an experimental Windows project combining YOLO-based screen analysis, a control panel, and an Arduino Pro Micro/ATmega32U4 used as a USB HID mouse bridge over a serial connection.

This project is not affiliated with or endorsed by Riot Games. Use it only in environments you own or are explicitly authorized to test. You are responsible for complying with the applicable terms of service.

Hardware

• Arduino Pro Micro or a compatible ATmega32U4 board
• USB cable with data support
• Windows 10/11 PC
• Optional NVIDIA GPU

1. Prepare the Arduino

1. Install Arduino IDE 2.

2. For a SparkFun Pro Micro, add this URL to Additional Boards Manager URLs:

   https://raw.githubusercontent.com/sparkfun/Arduino_Boards/main/IDE_Board_Manager/package_sparkfun_index.json
   

3. Install SparkFun AVR Boards from Boards Manager.

4. Open arduino/pavlov_mouse/pavlov_mouse.ino.

5. Select the correct Pro Micro board and processor speed (5V/16 MHz or 3.3V/8 MHz). For a compatible clone, follow its manufacturer's board instructions.

6. Select the correct COM port under Tools > Port, then choose Upload.

For a serial test, set Serial Monitor to 115200. Every command must end in !:

ping!
coords:20,0!
click:left!

The coords and click commands generate real mouse input. Save open work before testing.

2. Windows/Python setup

Install Python 3.10, 3.11, or 3.12, then run:

.\INSTALL.bat

The installer creates a local .venv, installs the Python dependencies, and downloads the default yolov8n.pt model through Ultralytics.

For NVIDIA GPU acceleration, use the command generated by the PyTorch installation selector for your GPU and driver. Run its python -m pip portion with .\.venv\Scripts\python.exe -m pip.

3. Test and run

Test the model and board separately:

.\TEST_YOLO.bat
.\TEST_ARDUINO.bat

TEST_ARDUINO.bat moves the mouse and performs a click. Start the main application with:

.\BASLAT.bat

The launcher requests administrator privileges because the program can temporarily disable a mouse device. The current device-switching code targets a Logitech G102 with PID_C08B. Review and adapt mouse_switch.py before using that feature with different hardware.

Emergency mouse recovery

If the program exits and the main mouse does not return, run this file as administrator using the keyboard:

.\FARE_KURTARMA.bat

Models

Model weights are not committed because they are large and may have separate license terms. The default Ultralytics model downloads during setup. You may place your own redistributable model in the project root as:

• valorant_best.pt
• best.pt
• valorant.pt

License

Released under the MIT License. Model weights and third-party packages remain under their respective licenses.