You want to make use the hidden setting with which YOU get to decide where you will be zwifting today?
You want easy access to set trainer effect (also called resistance level) before you launch Zwift?
You want to toggle fullscreen mode?
Then zwift-preferences for Windows can help you. If you use macOS take a look at ZwiftPref instead.
zwift-preferences is a script/an app which gives you access to safely modify the prefs.xml file from which Zwift reads your prefences when Zwift is launched. Notice that if you change prefs.xml while Zwift is running your changes will be overwritten by Zwift.
By the way, zwift-preferences can be used together with zwift-login.
Prerequisites
Windows PC with
- Zwift
- ( AutoHotkey version 1.1.24.01 or higher )
Choose the compiled version below for the simplest installation. Then you do not have to have AutoHotkey installed on your PC.
Downloads – compiled version
Download zwift-preferences (compiled with installer) setup-zwift-preferences-executable.exe – 738 KB
Downloads – script version
Download zwift-preferences script with installer setup-zwift-preferences-script.exe – 312 KB
Read more about the installer package.
Download individual script files to manually install the script (extract the content of the .zip file)
Download zwift-preferences script zwift-preferences.zip – 17 KB
History
zwift-preferences v26
zwift-preferences version 26 is a bug fix version specifically for Windows 7 users. It fixes a problem with download of the route definition files. Besides that it contains cosmetic... ...
Read More
How to choose a 3rd world…
It is really to simple to select a world other than Watopia and the guest world of the day with zwift-preferences and ZwiftPref. Just remember that you must click... ...
Read More
zwift-preferences v22
zwift-preferences skips version 21 and jumps straight to version 22 with support for changing the preferred screen resolution and toggle the Prefer Native BLE setting on the Miscellaneous tab. Download... ...
Read More
zwift-preferences v20
With zwift-preferences version 20 the new Title Music setting can be toggled on the Miscellaneous tab. This replaces the old hack to suppress the startup music in Zwift. This is... ...
Read More
Select any world and route with zwift-preferences v19
With zwift-preferences version 19 you can choose any of the five world including New York. It also handles route selection for both cycling and running. The ‘Sport’ toggle also determines... ...
Read More
Remember or forget the controllable trainer with v18 of zwift-preferences – the choice is yours
zwift-preferences introduces a new ‘Devices’ tab where you can see which devices are stored in prefs.xml. You can also remove the controllable trainer from the list and later add it... ...
Read More
Small fix in v16 of zwift-preferences – show current world
zwift-preferences has been updated to version 16, just to make sure that it shows you the current map/world correctly. Download the update Get the new version 16 over at... ...
Read More
World 5 is here…
…and supported by ZwiftPref and zwift-preferences. You won’t even have to download new version – both apps pull the list of worlds and courses from the ZwiftHacks server and... ...
Read MoreBug fix for a bug fix – v15 of zwift-preferences
The last update helped zwift-preferences work better on Windows 7 but made it worse on Windows 10. Version 15 fixes the this (hopefully). Leave feedback in the comments section if... ...
Read More
A new setting plus a Win7 bug fix
While chasing down a few bugs which occurred only on Windows 7, I also updated zwift-preferences to support the new Workout Distortion setting (the one which determines if the screen blur... ...
Read More
No more waiting… New routes and an updated map
The wait for new routes in Watopia is over with the update of Zwift to version 1.0.25225 today. The three new routes (level 12 locked) are Tour of Fire... ...
Read More
While we wait… an update for zwift-preferences
While we wait for new routes in the next Zwift update and probably a new world later on, now is a good time to get the latest version of... ...
Read More
Mega Pretzel and Greatest London Flat
All of the different ZwiftHacks apps know about the new Mega Pretzel and Greatest London Flat routes. That because they all get the latest list of routes here from... ...
Read More
New London routes
There are three new London routes in the new version 1.0.22839 (released for iOS today and eagerly awaited for macOS and Windows – it will probably happen before London is... ...
Read More
zwift-preferences and the Jungle Expansion
The addon zwift-preferences (Windows only) has not only been updated with the routes from the latest jungle expansion. In the future it will automatically retrieve the most recent list of... ...
Read Morezwift-preferences now with Three Sisters, Greater London 8, Greater London Loop, and The London Pretzel
The addon zwift-preferences (Windows only) now has all the possible route selections, including Three Sisters, Greater London 8, Greater London Loop, and The London Pretzel. The downloads are already live... ...
Read More
ZwiftPref for macOS & Windows – Change world and other settings
UPDATE: This was the original announcement of ZwiftPref. The most recent information can be found over at the main page for the app. You want to make use the... ...
Read More
zwift-preferences now has Volcano route selection
In support of the new routes in Zwift the addon zwift-preferences now has Volcano route selection. The downloads are already live in the usual place… ...
Read More
Bug fix in time zone conversion + just a few other things
A minor bug in zwift-preferences in time zone conversion (when displaying data from MapSchedule.xml) has been fixed. Other changes: You can now open prefs.xml from the Other menu, the minimal leaderboards... ...
Read MoreMore info packed into zwift-preferences
The most recent version of zwift-preferences now shows you information about the current world on the calendar (did anybody else notice the MapSchedule.xml file in the documents\zwift folder ?) and... ...
Read MoreNow with tabs and easier installation
A cleaner looking tabbed version of zwift-preferences is now ready. Btw it supports the new Neo Road Feel setting, too. I now also offer a compiled version so you do not... ...
Read MoreBug fix for zwift-preferences from 2016/08/22
Finally uploaded a bug fix version for https://zwifthacks.com/zwift-preferences/ from 2016/08/22. Corrects a possible bug in earlier version of the script which meant that a choice of a London course could... ...
Read MoreSupport for World 3 London in zwift-preferences
zwift-preferences has just been updated to support the new London courses. You can now easily switch between all three courses/worlds without having to edit the prefs.xml file yourself. ...
Read MoreUpdate – support for all routes
zwift-preferences has finally been updated to support the new way of storing route preferences in the prefs.xml file (was introduced by Zwift in April). Now you can select all... ...
Read MoreUpdate, zwift-preferences
There is a new version of zwift-preferences which supports the new Mountain 8 and The Pretzel route preferences as well as the setting Language Filtering. I have also included support... ...
Read MoreBug fix, zwift-preferences
A small bug fix to zwift-preferences: Did not initialise the ‘Follow calendar’ radio button correctly. ...
Read MoreNew features in zwift-preferences
A new version of zwift-preferences is ready for download. New functionality: Toggle ERG mode Menu bar added Reload from prefs.xml Launch My Dashboard on zwift.com from the menu or... ...
Read More
Zwift may be rolling out the choose a course option in the future, but I think the ability to vary your resistance is very helpful for riders with injuries who just want to spin around their favourite course.
Would you consider taking pity on Mac users and releasing this for the Mac too?
Hi Philip, I’m not sure I will be able to find the time for it. However, you can change the ‘Trainer Difficulty’ in the settings of Zwift yourself.
If you want to spin effortlessly just reduce your weight to a low number for that ride or segment?
Yes, technically you will be cheating and ineligble for “prizes” but it will be the workout you want.
My pc antivirus software wiped your file saying it was a virus within the .exe
It is a false positive from your anti virus software. I have just checked the downloads and they are virus free.
Thanks Jesper, I love it. Am able to follow nice routes now w/out having to concentrate on what turns to take where. Is it possible to do reverse routes this way too somehow?
You can only pick the same routes which you can pick in Zwift, too. To ride a reverse route pick the normal one and start with a u-turn. Unless there are bugs in the routing in Zwift this should take you through the reverse route in its entirety.
ah, stupid me for not thinking of that, thanks Jesper
On Zwift Preference.exe:
what is intended for Trainer effects?
Window: What’s the effect on Minimal UI ? and Minimal Leaderboards ?
Miscellaneous Workouts 2 choices: Use ERG. What is ERG? Or Edit in watts
Excuse my ignorance please
Avast is complaining that the compiled version contains Malware.
It is a false positive. Exactly when do you get the warning – during download or during installation?
Hey Jesper,
1st of all thank you for making our zwift life easier with such a piece of software like zwift preferences so now my feedback, i noticed in the new versions that the given info not matched with the chosen ride in Watopia.
The info for the “Big Loop” must switched with the “Jungle Circuit” info
The Info for the “Jungle Circuit” must switched with the “Road to Ruins” info
The info for the “Road to Ruins” must switched with the “Big Loop” info
Greetings
Thanks for telling me. I’ll fix it.
Where TRAINER_EFFECT number stored? its not in users docments folder file prefs.xml… i need to see what % of reality i have setted now, to be able revert to this setting, cos zwift not allow us to see it in numbers on scale (why?)…
It is in prefs.xml in ZWIFT > CONFIG > TRAINER_EFFECT as a number e.g. 0.5
The entry is first created when a smart trainer has been paired with Zwift (or added by ZwiftPref / zwift-preferences / manually).
thanx, i cant find it cos on laptop i have no try with smart) – on big mashine i think it row must be now… thanx again
Hi Jesper,
I can’t get the new settings to save on the preferences page. I hit the save button and nothing happens. If I click the reload button then everything goes blank. This is for a Mac
Hi Dewey, so we are talking about ZwiftPref here?
First of all, what happens if you press the button ‘Open prefs.xml’ (top right)? Does it open prefs.xml in TextEdit? If it does, please copy the content and send it to me via the contact form at https://zwifthacks.com/contact/
If it does not, can you locate the file prefs.xml using Finder in Documents > Zwift ?
Finally, try to rename the prefs.xml file to something else and launch Zwift. This will create a new prefs.xml file. Does that load properly into ZwiftPref? Please send the content of that new file to me, too.
Can I have a friend or friends join me on the ride if I choose a different route than what is on the calendar? If they do not have this hack, will they still see me and choose to join my ride?
They will also have to use the world hack to be able to ride with you. Otherwise they will be in the world of the day, and you will be in the world you chose.
FAN.. tastic piece of work! Very cool!
A random thought that may not be possible… Zwift opens on 1st monitor. I drag to 2nd monitor, close, change to full screen with ZwiftPref and re-open. As best as I can tell, any Windows disturbance, (restart, Zwift update, etc.) sends Zwift back to home (1st) monitor. Explored a few apps but none seem to be able to tell this app (Zwift) to always open on this screen (2nd [bigger}).
Since you’re already dictating full screen, any possibilities of dictating monitor choice?
Again, great tool! Thanks Jesper!
I’ve got an idea about how to handle this. I just have to find some time to implement it…
Take a look at the new versions of ZwiftPref and zwift-preferences. They both let you remember the preferred monitor (which Zwift stores in prefs.xml) and recall it. Set up Zwift like you prefer to have it, exit the game, and then use ZwiftPref/zwift-preferences to remember the preferred monitor (press the Remember button and do not forget to save/submit). Then you can always later press the Recall button in ZwiftPref/zwift-preferences to write that preference back to prefs.xml.
Hi there,
for some reason when I have installed the program (on windows 10) I click the app in the start menu and then it says that the the program has been changed or moved and so the shortcut won’t work.
It could be your antivirus program which has removed the program. You should check if the program file zwift-preferences.exe or zwift-preferences.ahk is in Documents\Zwift\Scripts or perhaps has been quarantined by your antivirus program.
Will I still get Strava credit using this app? Thanks!
I guess you mean if world hacking affects whether you get credit in certain Strava challenges or not? It shouldn’t mean anything so please share if you experience anything else.
Howdy. Had an old version of the app installed and just tried to install v18 on Windows 10. I get an error after hitting the install button: CreateFile failed; code 2. The system cannot find the file specified. I have already updated Autokeys to 1.130.00.
Any suggestions?
Thank you
My immediate guess would be that your antivirus program (wrongly) has quarantined one or more files. Please check the antivirus log.
I’m just curious when we’ll see the next version that includes the NYC map (no pressure!). We’ve got five more days with it before it switches out, and I know how to edit the prefs.xml file the old fashioned way, but I do enjoy using your program!
Don’t worry – it is almost ready and should be available for download within a day or two 🙂
Great to hear! – one quick note – when you release it, you may want to update the screenshots featured at the top of this page, as it is now they don’t include Innsbruck. (note number two – I just fired up zwift-preferences to see the correct spelling of “Innsbruck,” and there was New York! Excellent speed, my friends!)
For the login AHK script, I would like to be able to use the script to select among three different users who use the same set up. This could maybe be accomplished by adding a button for the different users into the GUI. I tried putting three different instances of the app with different INI file is in different folders, but I can’t get it to clear the previous user when I launch from a different instance.
Do you mean that you cannot get the Zwift Launcher to clear the previous user?
To make Zwift forget the user you can do the following:
Launch Zwift from the start menu
In the ‘Welcome!’ screen with the ‘Let’s go’ button press ‘Change user’
Enter your password, remove the check mark from ‘Remember me’, and press ‘Log in’
When the ‘Welcome!’ screen appears again, close it by clicking on the X in the top right corner.
What a cool app! i’m new in Zwift and was wondering, is it posible to ride Alp du Zwift with this tool whitout getting to lever 12?
No, it doesn’t change level based restrictions in Zwift.
Any ideas why zwiftpreferences doesn’t load anymore?
Error message https://i.imgur.com/MjionAE.jpg
I turned off firewall and AV software to make sure they weren’t blocking something…still won’t “connect” or whatever it is trying to do.
I need a bit of information from you: Which version of Windows are you using? Has it just updated (Windows Update)? Have you restarted the PC?
I’ll have a test version ready for you to try later tonight. I don’t know exactly what has changed in Windows 7 but I think I can work around the problem anyway.
Please try this test version (download, extract, and run the .exe file): https://www.dropbox.com/s/htitlzc8q9rthj6/zwift-preferences-test-2019-08-08%201941.zip?dl=0
If it works for you I will put the changes into the regular version of zwift-preferences.
Windows 7 Home Premium
I get this screen when I try to launch the programme after downloading and installing.
Error: 0x80072F7D –
Sourse: WinHttp.WinHttpRequest
Description: An error occurred in the secure channel support
Help File: (Null)
Help Context 0
Speficically: Wait For Response
Line#
139: whr.WaitForResponse()
Continue running the script
Yes No
Looking at the jpg Patrick has I have exact same issue ..I did try restarting the PC and clicking on YES to continue running the script but I saw nothing happening. I deleted Zwift Preferences and reinstalled three times but always ends the same way with the error msg I have posted – same as Patrick
I’ll have a test version ready for you to try later tonight. I don’t know exactly what has changed in Windows 7 but I think I can work around the problem anyway.
Please try this test version (download, extract, and run the .exe file): https://www.dropbox.com/s/htitlzc8q9rthj6/zwift-preferences-test-2019-08-08%201941.zip?dl=0
If it works for you I will put the changes into the regular version of zwift-preferences.
Thank you I am looking forward to going on the Great London Flat that is 7.2 miles, exactly the same distance and same as the TT I have coming up September 7th 🙂
Thank you for this Software.
I have a question, in the software is the Trainer Effect is 50%. Is he in Zwift orginal 100%? I would like to have the basics about my training. Greeting Thorsten
The default value in the game is 50%.
There is no difference between the values you see in the game and in zwift-preferences because zwift-preferences read from and write to the prefs.xml file of the game.
Thank you for the fast response