GameFlex-Controller

GameFlex-Controller is a flexible system that allows you to control driving games and vehicle simulators using:

• An Android application (your phone as a steering wheel/controller),
• A Raspberry Pi Pico (PicoETF) joystick running MicroPython,
• A Python bridge script that connects inputs to vJoy on Windows via MQTT.

This project was originally developed as part of an Embedded Systems course.

---

Features

• Control any vehicle-based game (e.g. ETS2, Assetto Corsa, BeamNG.drive, Farming Simulator, etc.).
• Use your Android phone as a steering wheel and controller.
• Use a PicoETF joystick for a more embedded hardware solution.
• Inputs are transmitted via MQTT messages.
• The Python bridge converts MQTT messages into virtual joystick inputs (vJoy).
• Modular: use phone, PicoETF, or both at the same time.

---

Repository Structure

• android-app/ → Android application source code (Kotlin).
• scripts/ →
  • picoscript.py → MicroPython script for PicoETF joystick.
  • bridgescript.py → Python MQTT → vJoy bridge script.
• docs-bs/ → Full documentation in Bosnian language (specifications, implementation details, setup guides, and demo).

---

Requirements

1. A driving or vehicle simulator game on Windows that supports joystick input.
2. vJoy virtual joystick driver → Download here.
3. MQTT broker (tested with MQTTX or Mosquitto).
4. Python 3.10+.
5. (Optional) Android Studio if you want to build or modify the Android app yourself.

---

Download APK

The Android app has been built and published as an APK in the Releases section.
You can download the latest version (GameFlex-Controller.apk) directly to your phone and install it.

⚠️ Note: This is the first release (pre-release) — mainly a working version with a basic UI. Future updates will bring improvements and new features.