zwift-login is a simple utility which basically lets you launch Zwift without having to click any button or fill any fields in the login sequence of the game.
It can be used to launch Zwift and login directly from the command line, too.
This is how you use it…
See it demonstrated in a screencast by following this link. Otherwise, just try it – it is really simple to use.
Zwift is launched just by pressing Launch Zwift:
Launching Zwift by the press of a button…
Once the password is stored (it will be saved in a file on your harddrive) it only takes a single button press to launch Zwift and feed it your login details if you have not stored them directly in Zwift.
First time a bit of setup is required…
The first step is to store your username and password, so press Store Password (only necessary at first run or if you change your Zwift password).
Now the Launch Zwift button will be enabled. Naturally, you won’t have to save the password again unless you change it in Zwift.
Zwift status and preferences alerts
At the bottom of the window you can see the current Zwift status (from the Zwift status page).
Right above that you will see alerts for certain settings in prefs.xml, which it is good to be aware of before launching Zwift of if you did not intend to have them activated in this session:
- A world icon will be shown if the world hack is used
- A full screen icon (looking like an empty frame) will be shown if the Minimal UI-setting is set
It works together with other ZwiftHacks…
zwift-login plays together with some of the other tools here on the site.
If the zwift-preferences script is installed in the same folder as zwift-login there will be a button that you can launch it with. That way you can easily make your choice of e.g. trainer resistance level, world and course selection before you launch Zwift.
If the zwift-hotkeys script is installed in the same folder as zwift-login it will automatically be launched together with Zwift (depending on the option being activated) .
If the TR-Z-move script is installed in the same folder as zwift-login it will automatically be launched together with Zwift (depending on the option being activated).
Using as a command line tool
zwift-login accepts a command line parameter (/launch) which makes it launch Zwift automatically with the need for pressing a button. This can be used e.g. for scheduling an unattended start of Zwift.
Run zwift-login.ahk like this:
AutoHotkey.exe zwift-login.ahk /launch
It will launch with the stored settings of the last user selected in zwift-login.
To specify which user (1-5) you can combine /launch with the /user= parameter (see below) or use the short form /launch=1 etc.
AutoHotkey.exe zwift-login.ahk /launch /user=1
AutoHotkey.exe zwift-login.ahk /launch=1
To open zwift-login with a specific user selected:
Use one of the parameters /user=1, /user=2, /user=3, /user=4, and /user=5.
AutoHotkey.exe zwift-login.ahk /user=1
To skip checks for user/password and/or skip Change User step
/nouser When zwift-login is launched with that switch you are allowed to launch Zwift even if no user/password is stored in zwift-login, and zwift-login also just presses Let’s Go if that is the screen the launcher opens with (it skips the Change User step in the launcher which it normally would trigger).
This is intended mostly for specialised scenarios where you use zwift-login for automating the login process. If you use the
/launch command line switches together zwift-login will simply launch Zwift and press Let’s Go (assuming that the launcher have saved your username and password).
Other command line parameters:
/onlyzwift Will only launch Zwift and not look for any other ZwiftHacks scripts to launch simultaneosly.
/delay Will delay the launch for 10 seconds.
Using with non-standard Zwift setups
Even if you have Zwift installed in a location different from the default (which is %ProgramFiles(x86)\Zwift%, typically C:\Program Files (x86)\Zwift) or have the Zwift document\data files in a non-default location (which is Documents\Zwift) you can still use zwift-login if you set up a couple of environment variables: ZWIFTPROG and ZWIFTDOC.
If you have Zwift installed in a location different from the default:
Add an environment variable called ZWIFTPROG to your Windows account to point to your Zwift program folder:
You may have to log out of Windows and log in again after defining it for the environment variable to be known.
After this zwift-login will always use the value of ZWIFTPROG as the location of the Zwift program files instead of the default location.
If you have your Zwift documents (e.g. prefs.xml) in a location different from the default:
If you have your Zwift data files/documents in another folder than the default Documents\Zwift folder you can similarly control where zwift-login and zwift-preferences look for the data files (prefs.xml) with a new ZWIFTDOC environment variable (this is also supported in zwift-preferences).
Google can tell you how to add/modify environment variables:
Windows PC w/
In case you need it, here is the older v32:zwift-login script with installer
When Zwift updates it leaves its launcher in Administrator Mode (elevated) after the update. Now zwift-login handles that situation properly. Besides that the new version […]
While zwift-login already does handle the new Zwift launcher based on the modern Edge Webview2, this new version (v36) improves how the login dialogue is […]
Zwift have a new launcher (version 1.1.0) which changes the technology used in the Zwift Launcher. It is no longer an Internet Explorer component but […]
It is only a small update but it does make it easier to toggle options with new Alt+<key> shortcuts for some of the GUI elements. […]
This is an important update to zwift-login if you have more users sharing the same Zwift installation. […]
In the new version of zwift-login it is now user configurable if it will launch zwift-hotkeys and/or TR-Z-move together with Zwift […]
The new version version of zwift-login will automatically skip the annoying script error message which just recently started to appear in Zwift’s launcher. […]
zwift-login is fixed to launch TR-Z-move together with Zwift if both scripts (zwift-login and TR-Z-move) are located in the same folder. Download the update Get […]
zwift-login now works regardless of which language you have set in the Zwift Launcher. That's it. Download the update Get the new version 18 at […]
zwift-login now shows warning icons if a specific world is set or minimal_ui is enabled in prefs.xml The new version also checks if ZwiftLauncher is running […]
zwift-login got a few fixes to make it more robust when the Zwift status page cannot be reached, and to make sure that it closes when […]
zwift-login has been updated to support the Zwift Launcher which was changed in the update from Zwift 2018-04-26. Download the update Get the new version […]
zwift-login has been updated to fix a problem which was seen on some Windows 7 PC's. Download the update Get the new version 13 at […]
The Zwift Launcher now have a Let's Go button where it used to have a Ride On button. zwift-login has been fixed to handle this. […]
I just made a small update to zwift-login so it works with the latest version of the Zwift Launcher. zwift-login could not detect the Zwift […]