Zwifit

Welcome to the cryptically named Zwifit! This NodeJS app joins Zwift with treadmills running iFit® with Wi-Fi.

Disclaimer: I'm not associated with either company. Their trademarks and content are their own. Heck, they might force me to take this down! But let's enjoy the run before they do.

How This Works

This software connects to your iFit® treadmill over Wi-Fi to observe its speed and incline. It then broadcasts that information over Bluetooth in a standard protocol that apps like Zwift are able to understand.

What Treadmills Are Compatible?

At the moment it seems hit or miss on which iFit treadmills with Wi-Fi work, but we are building a spreadsheet over at the following URL. Look through that. You may also be interested in the TreadSync app, which has a similar goal to this project, but runs in a slightly different way (on iOS devices).

http://bit.ly/TS-compat

Minimum Requirements

A Wi-Fi connected iFit® treadmill; those treadmills that use Bluetooth instead of Wi-Fi likely will not work
Zwift running on your favorite device
A Raspberry Pi ZeroW or 3B running this software (this software works on versions of Mac OS X before Mojave, but our Bluetooth dependency is presently borked on Mojave -- Windows requires an external Bluetooth LE dongle be properly configured).
Know the IP address of your treadmill. (I recommend reserving this IP in your router so it doesn't change.)
You need to be minimally comfortable with a command line / terminal. Or have a nerdy friend!

Raspberry Pi Zero W: https://www.amazon.com/CanaKit-Raspberry-Wireless-Complete-Starter/dp/B072N3X39J/ref=sr_1_4?ie=UTF8&qid=1546535245&sr=8-4&keywords=raspberry+pi+zero+w

Note: the above is NOT an affiliate link, I don't get anything from you clicking it. There are loads of other options and configurations for purchasing a Pi. If you're not in the US, you should be able to find a configuration that has a good power supply, a Zero W, and a MicroSD card. Or you could purchase the parts separately!

Software Requirements

Raspbian (Raspberry Pi)

This software works great on a Raspberry Pi 3b+ or a Zero W. Follow all of these steps on your Pi itself, not on your laptop or desktop! The easiest way to do this is to plug a monitor, keyboard and mouse in to your Pi. Or, if you've set up SSH, you can ssh in to your Pi to follow these steps (hint: this option is in the configuration UI).

sudo apt-get update
Install the dependencies we need: sudo apt-get install nodejs npm git bluetooth bluez libbluetooth-dev libudev-dev
Turn off the system Bluetooth daemon so we can control it: sudo systemctl disable bluetooth (to reverse this, change disable to enable)
Turn the Bluetooth chip back on: sudo hciconfig hci0 up
Give NodeJS access to Bluetooth without sudo: sudo setcap cap_net_raw+eip $(eval readlink -f `which node`)

Windows

NOT WELL TESTED! Before you can run this code, you'll need to install a couple different things:

NodeJS, specifically version 8: https://nodejs.org/dist/latest-v8.x/node-v8.14.0-x64.msi (The library we use to communicate over Bluetooth doesn't work with the latest versions of NodeJS yet.)
Git https://git-scm.com/downloads
To install node-gyp, after installing NodeJS, open a command prompt with "Run as administrator", and run the following: npm install --global --production windows-build-tools
You'll need a compatible bluetooth adapter as well; follow the steps here: https://github.com/noble/node-bluetooth-hci-socket#windows

Mac OS X

DOES NOT WORK ON MOJAVE! Before you can run this code, you'll need to install a couple different things:

NodeJS, specifically version 8: https://nodejs.org/dist/latest-v8.x/node-v8.14.0.pkg (The library we use to communicate over Bluetooth doesn't work with the latest versions of NodeJS yet.)
Git: https://git-scm.com/downloads
Xcode: https://developer.apple.com/xcode/

Getting Started

With the software requirements out of the way, you can run the following commands to get this program, set it up, and run it:

git clone https://github.com/dawsontoth/zwifit.git
cd zwifit
npm install
node app.js

The last command will guide you through connecting to your treadmill. It will save your answers, and won't ask you in the future. Your answers are saved in the settings.conf file. To change them, simply edit settings.conf (or delete it and run node app.js again).

Automatic Startup

Do you want this script to run in the background, even when you restart your computer? There are many ways to accomplish this. Personally, I use a program called PM2.

NOTE: To install this program globally, you can prefix sudo before the npm install line below, but it would be far wiser to tweak your installation of NPM so that sudo isn't required! Follow the steps in the following article, and you'll be doing your system a favor! https://docs.npmjs.com/resolving-eacces-permissions-errors-when-installing-packages-globally You only need to do this once.

Run the following to set everything up:

npm install -g pm2
pm2 startup
pm2 start app.js
pm2 save

You can undo this easily:

pm2 unstartup

Or restart, or view logs:

pm2 restart all
pm2 logs

Or update the code and restart:

git pull
pm2 restart all

Calibration

Zwifit will report your treadmill's exact speed, as measured by the machine itself. You can use the calibration feature within Zwift to adjust this, just like you would with a footpod. Alternatively, load up the Zwifit Web UI and head to the Settings page.

Control and Monitoring

The app runs a local web server that displays information from your treadmill, allows changing settings, and allows manual control of speed and incline. This can be used to change the speed and incline of your treadmill, too. To access this web site, you'll need to know the IP of your Pi, or the hostname, depending on your wireless router. For me, I can access it at http://raspberrypi.local:1337/ You may need to do the full IP, such as http://192.168.0.50:1337/ -- or if you're running this on a laptop, at http://localhost:1337/

If you have a monitor or touch screen connected to your Pi, you can run it in Kiosk mode. It can launch the Zwifit UI automatically. Follow the steps in this article to get started: https://pimylifeup.com/raspberry-pi-kiosk/

Contributing

Pull requests are welcome! Do your best to emulate the code around what you are editing.

Thank you!

If this works for you and improves your running experience, please consider donating to the developer who made this possible.

https://venmo.com/DawsonToth

This will also encourage future improvements. Thanks!

dmyers2004/zwifit