Qdomyos-Zwift (QZ) Application User Guide, Compatibility, Features, & FAQs

How to Connect a bike to the Peloton app using the QZ App

You can install both applications on one ios device but you won’t be able to sync cadence from the QZ to the Peloton app. So, you would have to track your stats on QZ on one side of the screen and the Peloton class on the other side of the screen.

You can also use an Android tablet or smart TV to install the Peloton application but you won’t be able to sync it with the QZ. It’s a good option for those who don’t want to sync data from the QZ to the Peloton.

However, if you want to sync all your stats from the bike to the QZ and from the QZ app to the Peloton app, you need the “two devices” solution (preferably two iOS devices/an iPhone and iPad).

Here is how you can connect your exercise bike to the Peloton application using the QZ application and “two devices”. For this example, we use an iPhone to install the QZ app and an iPad to install the Peloton app.

1. Install the QZ application
   
   Go to App Store, buy and install the QZ application on your iPhone. Scroll to the top of this article to find the link for the QZ on App Store.
   
2. Connect the HRM (optional)
   
   If you want to see your heart rate, you need to pair your ANT+ or Bluetooth HRM (Heart Rate Monitor) with the QZ. Instead of an HRM strap, you can also connect an Apple Watch to the QZ. Scroll down to see how to pair an Apple Watch with the QZ.
   
3. Connect the bike with the QZ app
   
   To wake up your bike’s Bluetooth, you need to plug it in and start pedaling. Open the QZ application on your device. It should automatically detect and connect to your bike and begin displaying metrics.
   
4. Install the Peloton application
   
   Go to App Store and install the Peloton application on your iPad. Note: If you want to see your heart rate and cadence on the Peloton Application, you need to install the app on an iPhone or iPad (preferably an iPad because of its bigger screen).
   
   You can NOT connect your heart rate or cadence on other OS/Operation Systems (Android, AppleTV, FireStick, etc.) or in the browser-based version of Peloton workouts.
   
5. Connect the Peloton app to the QZ app
   
   Open the Peloton Application on your iPad, log in to your Peloton account, and select and begin a workout. Tapping on the screen of your iPad will bring up a series of icons on the right side.
   
   Tap on the sensor icon (the second icon from the top on the right side of the screen). It will display a box called “Connected Devices”.
   
   You have two options, “Heart Rate” or “Cadence”. First, connect the “Cadence” but later we come back to also connect the “Herat Rate” (one at a time).
   
   Now, the Peloton app searches and finds your iPhone and asks if it’s the source sending the cadence, you should select it. After a few seconds, the Peloton app on your iPad will connect with the Cadence from your iPhone (QZ app).
   
   If you want to connect your heart rate monitor and see your heart rate along with the cadence on the Peloton app, you need to repeat the last part of the process (tap on the sensor icon on the screen, and this time choose to connect the “Heart Rate”).

How to connect a Bike to Zwift with the QZ Using 2 devices?

Here is a step-by-step instruction on how you can connect your indoor bike to the Zwift application with the help of the QZ application. For this tutorial, we are using two devices. For example, a smartphone for the QZ application and a tablet for the Zwift application.

1. Power on the bike
   
   If you have an Echelon or similar bike, plug it into an electricity socket and start pedaling to wake up the bike and activate the Bluetooth.
   
2. Connect the bike and the QZ app
   
   I assume you already installed the QZ app on your phone, read the QZ user guide listed at the beginning of this article. Open the QZ application on your phone and connect the bike to the app.
   
3. Open Zwift on your tablet and log in
   
   You should have a Zwift account and log in on your tablet to see the “Paired Devices” screen
   
4. Connect Zwift with the QZ
   
   On the “Paired Devices” screen, you can start connecting power source, cadence, speed, HR, and/or Controllable. It’s up to your which ones to sync from the QZ app. You can pair them all one by one.

If you have issues connecting, try these tips:

1. Make sure the Cycling Cadence Sensor (peloton compatibility) is off on the QZ app Settings.
2. Make sure your android device setting is set to visible for Bluetooth.
3. Make sure the location services are enabled on your phone setting.
4. Remove all the Bluetooth “pairs devices” on your phone and tablet.
5. Rename your devices (phone and tablet) to a “4-letter word” like “bike”. If you have an iPhone, you can do this by going to Settings>General>About>Name) to change the name.
6. For PC users, you might need a TP-Bluetooth Dongle UB400 to connect the Zwift with QZ.
7. Make sure to install the Zwift on a device that is supported, check Zwift.com for minimum system requirements.
8. If your phone is connecting to your PC, forget the PC on your phone’s list of “connected devices”
9. Try to exit Zwift and reboot your computer/device.
10. Unplug the bike and disable Bluetooth on your QZ device until Zwift is loaded on your device.
11. Remember to connect the Power Source first, then the other sensors.
12. The qz app must be in the foreground all the time.

How to connect a Bike to Zwift with the QZ Using 1 Device?

Here is a step-by-step instruction on how you can connect your indoor bike to the Zwift application with the help of the QZ application. In this particular example, we will be using only one device (an iPad) to install both applications (the QZ and the Zwift). If you want to use a PC or Mac, make sure it meets the Zwift device requirement.

1. Go to App Store or Google Play to download and install the QZ application on your device (PC users need to log in to GitHub and then follow this link “https://github.com/cagnulein/qdomyos-zwift/suites/9465963175/artifacts/448244333” to download the QZ application for PC). A Patreon subscription will unlock it.
2. Click on the QZ “Settings Page”
3. Click on the “Experimental Features”
4. Enable the “Wahoo Direct Connect Setting”
5. Check the “Server Port”
   Make sure the “Server Port” is “36866” and press OK
6. Close the QZ app
   To save and apply changes, you should always completely close the QZ app
7. Open the QZ app
   Open the QZ app on your iPad and connect your bike to Bluetooth
8. Click on the Split View Button
   The Split View button is on the top (three grey little dots) and then click the third button to move the QZ to a side of the screen.
9. Open the Zwift application
   Open the Zwift application and log in to your account
10. On Zwift Start Pairing
    On Zwift, you can see the “Pair Devices” screen, you can start pairing in this order one at a time “Power”, “Cadence”, “Heart Rate”, “Speed” and “Controllable”. When you click to pair these sensors, Zwift searches and finds the “Wahoo Kicker 0000 33 Virtual Device”. You should select this to pair because that’s basically your QZ app.
    
    Note: Click pair “Heart Rate” only if you already have a Bluetooth, or ANT+ armband, chest strap, or Apple Watch connected to your QZ application.
    
    You can now move the QZ app/window wherever you want on the screen of your iPad. If you want a bigger screen, you can use an Apple TV to mirror your iPad.

If you have issues connecting, try these tips:

1. Make sure the Cycling Cadence Sensor (peloton compatibility) is off on the QZ app Settings.
2. Make sure your device/iPad setting is set to visible for Bluetooth.
3. Make sure the location services are enabled on your device/iPad setting.
4. Remove all the Bluetooth “Paired Devices” on your device/iPad.
5. Rename your device/iPad to a “4-letter word” like “bike”. For iPad, you can do this by going to Settings>General>About>Name) to change the device name.
6. Unplug your bike, and wait 30 seconds before plugging it back on.
7. Toggle On the “Virtual Device” on the QZ application and exit out of QZ to save the settings.
8. In the QZ app enable the “Wahoo Dircon” option.
9. Make sure to use the TP-Link USB Bluetooth Adapter UB400 if you are installing the QZ and Zwift on a PC.
10. Try to exit Zwift and reboot your computer/device.
11. Wait for Zwift to load before turning on the bike and then connecting the QZ.
12. Remember to connect the Power Source first, then the other sensors.
13. The qz must be in the foreground all the time (there is a beta version to use qz in the background which requires a device with more ram).

How Can We Request Support For the QZ app?

Before sending an email or filling out a debug request, it’s very important to follow these steps. Often they help you get your answer or resolve the issue quicker.

1. Join and Search the QZ Facebook Group
   
   If you have any questions or issues related to the QZ application or its compatibility, you can join the QZ Facebook Group and search for your question using the search option. There is a big chance someone else has already asked a similar question and received the answer.
   
2. Ask Your Question in the Facebook Group
   
   If you already searched but didn’t find the answer to your question, you can post your question in the group. Group members are very helpful, plus, Roberto himself on daily basis replies to every question asked. By searching the group you see which members had this problem, write down their names and in the comment section of your post, tag those group members and asked if/how they solved their problem.
   
3. Follow the QZ Youtube Channel
   
   Head over to Youtube and subscribe to the QZ Channel. It has many useful videos explaining how to use the QZ to connect your bike with compatible applications.
   
4. Send an email to Roberto
   
   If your question or concern is still not answered (which will be unlikely), I suggest you send an email to (roberto.viola83@gmail.com) or reach out to Roberto directly on his Facebook. It’s very important that you first search and ask your question on the FB Group as we don’t want to fill his inbox with repeated questions.
   
5. Create a ticket on GitHub
   
   You can always create a ticket on the GitHub page if you don’t find the answer on the FB page

How to Ask Roberto to Add my Fitness Machine to QZ?

If you have a rowing machine, exercise bike, treadmill, or elliptical with Bluetooth connectivity, you can ask Roberto to see if he can add your machine to the QZ application. In order for Roberto to do a compatibility check and to add your machine to the QZ, you need to share a “nrfconnect” screenshot about your machine. Here is how you can provide a nrfconnect screenshot for Roberto:

1. Download the Free NRF-Connect
   
   Basically, you download the nrfconnect application on your phone. It’s a free app available for iOS devices on App Store and Android devices on Play Store.
   
2. Open Nrfconnect and Take Screenshots
   
   Then open the nrfconnect application (making sure your fitness machine is on), and take screenshots of the reported Bluetooth devices.
   
3. Send the Screenshots to Roberto
   
   You can then send these screenshots to (roberto.viola83@gmail.com) and he will try to make your machine compatible with the QZ application.

How to Connect an Apple Watch or a Bluetooth/ANT+ HRM to QZ App

The QZ application can connect with the Apple Watch as well as Bluetooth and ANT+ Heart Rate Monitors (HRMs).

1. How to connect an Apple Watch with the QZ app:

1. Go to Apple Watch App on your paired iPhone
2. Download and Install the QZ Application onto your Apple Watch
3. Press and hold Start on the QZ application in your Apple Watch
4. Confirm Heart Rate is displayed on QZ App on Apple Watch and on paired iPhone

2. How to connect a Bluetooth or ANT+ HRM to the QZ:

1. Depending on the model you might have to Press and/or Hold the power button to wake up the Bluetooth.
2. Open the QZ application, choose and connect your HRM – no other actions are required.

Note:

• Make sure to enable the heart broadcast on your watch
• Go to QZ “heart rate belt name” settings, select your watch and press ok
• Make sure to restart the QZ application at the end to save the settings

I Can’t get the heart rate from the Apple Watch to the QZ

QZ supports/connects heart rate monitors including Apple Watch, chest straps, armbands, and wristbands that have Bluetooth or ANT+ connectivity. When you pair an HRM with the QZ, it might take up to 1 minute to establish the connection. If you are having problems getting your heart rate from an Apple Watch to the QZ application, follow these instructions.

1. Enable Apple Health Permissions For QZ
   
   First, make sure all the Apple Health permissions are enabled for QZ.
   
2. Close all apps except the QZ
   
   Close other applications and make sure the QZ is the only running app on the watch.
   
3. Disable the Heart Belt Name
   
   Then go and make sure to set “Disabled” to the “Heart Belt Name” setting in the QZ.
   
4. Press Start
   
   Now you can press start on the QZ app on the watch and wait at least 10 seconds. The heart rate should appear.
   
   If you still can’t get the heart rate from your Apple Watch to the QZ, then restart both your iPhone and Apple Watch. Make sure all permissions, locations, and privacy options are set to allow.

How to get the debug log For IOS Devices?

Sometimes even when following all the instructions and doing everything right, it is possible that you still get errors and can’t make the QZ app work. In this case, Roberto will probably ask you to provide him with the debug login. Follow these instructions to get the debug log for the IOS Devices:

1. Enable the debug log
   
   Head over to your QZ application and enable the debug log in the QZ>Settings>Experimental Settings.
   
2. Quit and Restart QZ
   
   Completely quiet and restart the QZ application
   
3. Recreate the issue
   
   Access the app to recreate the issue/error so it’s recorded in the debug log
   
4. Go into the files app
   
   Go into the files app, under qdomyos folder and find the debug log for your session (you can see the date and time in the filename), and save the log on your device.
   
5. Fill out a request
   
   Fill out a request here ( https://github.com/cagnulein/qdomyos-zwift/issues ) and attach the debug log and any other useful information.

How to get the debug log For Android Devices?

Sometimes even when following all the instructions and doing everything right, it is possible that you still get errors and can’t make the QZ app work. In this case, Roberto will probably ask you to provide him with the debug login. Follow these instructions to get the debug log for the Android Devices:

1. Enable the debug log
   
   Head over to your QZ application and enable the debug log in the QZ>Settings>Experimental Settings.
   
2. Quit and Restart the QZ App
   
   Close the QZ and all the other apps on your phone and then only restart the QZ app
   
3. Recreate the issue
   
   Try to do what gives the error you are trying to resolve
   
4. Download CX File Explorer for older Android versions:
   
   Download the free app called “CX File Explorer” for older Android versions: https://play.google.com/store/apps/details?id=com.cxinventor.file.explorer&hl=it&gl=US
   
5. Or download FV File Manager for Android Version 13:
   
   Download this for the Android 13 version: https://play.google.com/store/apps/details?id=com.folderv.file
   
6. Find the debug log for your session
   
   Using the CX File Explorer app, go into the folder /android/data/org.cagnulein.qdomyoszwift/. Find the debug log for your session (you can see the date and time in the filename).
   
7. Fill out a support request
   
   Then fill out a support request here (https://github.com/cagnulein/qdomyos-zwift/issues) attaching the debug log and any other useful information.

I can’t connect the QZ to Zwift, can you help?

If you can not connect the QZ application to your Zwift application, please follow the instruction below before contacting support.

1. For iOS Devices:
   1. Make sure to run the QZ on one device and the zwift on another device
   2. Try to rename the QZ device to “bike” (only 4 letters) and reboot both devices
   3. Try to swap the devices (the one that was running zwift will now run QZ and vice versa).
   4. Not all Android devices can run Bluetooth peripherals and central at the same time
   5. Try also with older android phones
   6. Virtual device setting is enabled in the experimental settings? (don’t change the other settings there!)
      
2. For IOS Users:
   1. Make sure that your iOS devices are not paired in the Bluetooth settings. If they are paired, unpair them.
   2. Reset the network settings of the device that Zwift installed by going into the device settings
      
3. For Mac users:
   • Resetting PRAM Following these Steps
     1. Shut down your machine.
     2. Press the power button and then hold Command-Option-P-R until your Mac reboots again
     
4. Remove potentially corrupt files (Mac users)
   1. Open Finder on your Mac and select the Go menu in Menu Bar.
   2. Select the Go to Folder…
   3. Type in /Library/Preferences and then click on the blue Go button.
   4. Locate the com.apple.Bluetooth.plist file, Move to Trash.
   5. Open the Go menu in the Menu Bar, and click the Go to Folder option again.
   6. In the Go to Folder window, type in /Library/Preferences/ByHost into the text field and select the blue Go button.
   7. When the Finder window opens, locate the “com.apple.Bluetooth.xxxxxxxxxxxxxxxxxxfile”, and 10. Move to Trash.
   8. Reboot your Mac.
      
5. Reset the Bluetooth Module (Mac users)
   1. Hold down the Shift and Option keys, and click on the Bluetooth menu in your Menu Bar on your Mac.
   2. Select Debug.
   3. Select Remove all devices.
   4. Click on the Bluetooth menu
   5. Select Debug.
   6. Select Reset Bluetooth.
   7. Re-pair all of your Bluetooth accessories and everything should work as expected.
      
6. For Zwift PC and Desktop Users:
   1. PC and Desktop Bluetooth are the best and you might experience frequent interruptions in data transmission. I suggest you get the TP-Link Adapter. It’s an excellent Bluetooth Dongle.

How to Connect Your Bike to the Kinomap app using the QZ app?

The settings in the QZ app are not the same for Kinomap as they are for Zwift. After a ton of trial and error I have found QZ app settings that should make Kinomap work for most if not all people (At least for Echelon users, but hopefully others too), so please post this on your “How To” web page so that others, especially Echelon Users, will be able to benefit from the results, and again, as always, a major thanks to no end for creating this app for all of us to enjoy our fitness routines all the more!!!

• Adjust the “Rate of Resistance Change” and “Maximum Slope”

First, when using Kinomap, the user needs to make sure that in the “Training” settings, both “Rate of Resistance Change” and “Maximum Slope” have to be maxed at 15% otherwise the following settings will not work.

• TURN OFF “Zwift Workout/Erg Mode”

In the QZ app in “Bike Settings”, you have to TURN OFF “Zwift Workout/Erg Mode” otherwise the next following Bike Settings will not work. There are two settings profiles for “Video Virtual Rides” and “Structured Workouts”:

• “Video Virtual Rides”

QZ app “Bike Settings” for “Video” Virtual Rides: Along with Zwift Workout/Erg Mode turned off, you need to set the “Zwift Resistance Offset” to “16” and the “Zwift Resistance Gain” to “0.65”. The other options of ” Zwift Erg Up Filter” and Zwift Erg Down Filter” can be both set as 10, just like for Zwift, but I’m not sure that it impacts anything. The final setting of “Resistance at Start-up” is whatever resistance level the user wants to start with, but it will have no bearing on the actual exercise program.

• “Structured Workouts”

QZ app “Bike Settings” for “Structured Workouts” : Along with Zwift Workout/Erg Mode turned off, you need to set the “Zwift Resistance Offset” to “0” and the “Zwift Resistance Gain” to “0.08” . The other options of ” Zwift Erg Up Filter” and Zwift Erg Down Filter” can be both set as 10, just like for Zwift, but I’m not sure that it impacts anything. The final setting of “Resistance at Start-up” is whatever resistance level the user wants to start with, but it will have no bearing on the actual exercise program.

• Choose Resistance Program for Auto Resistance

Along with those QZ app settings for “Structured Workouts” the user can only choose “Resistance” programs in Kinomap and NOT FTP, WATT, or SLOPE for the programs to automatically change the resistance properly.

Again, these settings definitely work for Echelon users with a max of 32 resistance levels, but hopefully, they’ll work for others. If not, I’m sure a couple of slight changes will make it work for others too.