gitea-mirror/swiftcontrol
1
0
Fork 0
mirror of https://github.com/jonasbark/swiftcontrol.git synced 2026-02-18 00:17:40 +01:00
Code Issues Packages Projects Releases Wiki Activity
Files
9de50dc6fcfb4fef4a29e38ddbc6aa0842e01c7f
swiftcontrol/README.md
Jonas Bark 6302091c54 improve handling of analog gamepad events
2025-12-07 10:41:21 +01:00

4.5 KiB
Raw Blame History

BikeControl (formerly SwiftControl)

BikeControl Logo

Description

With BikeControl you can control your favorite trainer app using your Zwift Click, Zwift Ride, Zwift Play, Shimano Di2, or other similar devices. Here's what you can do with it, depending on your configuration:

  • Virtual Gear shifting
  • Steering/turning
  • adjust workout intensity
  • control music on your device
  • more? If you can do it via keyboard, mouse, or touch, you can do it with BikeControl

https://github.com/user-attachments/assets/1f81b674-1628-4763-ad66-5f3ed7a3f159

Downloads

Best follow our landing page and the "Get Started" button: bikecontrol.app to understand on which platform you want to run BikeControl.

GetItOnGooglePlay_Badge_Web_color_English

App Store

Mac App Store

Microsoft Store

Supported Apps

  • MyWhoosh
  • Zwift
  • TrainingPeaks Virtual / indieVelo
  • Biketerra.com
  • Rouvy
  • OpenBikeControl compatible apps
  • any other!
    • You can add custom mapping and adjust touch points or keyboard shortcuts to your liking

Supported Devices

  • Zwift Click
  • Zwift Click v2 (mostly, see issue #68)
  • Zwift Ride
  • Zwift Play
  • Shimano Di2
    • Configure your levers to use D-Fly channels with Shimano E-Tube app
  • Wahoo Kickr Bike Shift
  • Wahoo Kickr Bike Pro
  • CYCPLUS BC2 Virtual Shifter
  • Elite Sterzo Smart (for steering support)
  • Elite Square Smart Frame (beta)
  • Gamepads
  • Cheap Bluetooth buttons such as these (beta)
    • BLE HID devices and classic Bluetooth HID devices are supported
    • works out of the box on Android
    • on Windows, iOS and macOS requires BikeControl to act as media player
  • We're working on creating an affordable alternative based on an open standard, supported by all major trainer apps
    • register your interest here

Support for other devices can be added; check the issues tab here on GitHub.

Supported Platforms

Follow the "Get Started" button over at bikecontrol.app to understand on which platform you want to run BikeControl. You can even try it out in your Browser, if it supports Bluetooth connections. No controlling possible, though.

Help

Check the troubleshooting guide here.

How does it work?

The app connects to your Controller devices (such as Zwift ones) automatically. BikeControl uses different methods of connecting to the trainer app, depending on the trainer app and operating system:

  • Connect to the trainer app on the same device or on another device using Network
    • available on Android, iOS, macOS, Windows
    • supported by e.g. MyWhoosh, Rouvy and Zwift
  • Connect to the trainer app on another device by simulating a Bluetooth device
    • available on Android, iOS, macOS, Windows
    • supported by e.g. Rouvy and Zwift
  • Directly control the trainer app via Accessibility features (simulating touch and keyboard input)
    • available on Android, macOS, Windows
    • supported by all trainer apps
  • Connect to supported trainer app using the OpenBikeControl protocol
    • available on Android, iOS, macOS, Windows

Alternatives

  • qdomyos-zwift directly controls the trainer (as opposed to controlling the trainer app). This can be useful if your trainer app does not support virtual shifting.

Donate

Please consider donating to support the development of this app :)