This tool is no longer actively developed.
You want to 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 can use ZwiftPref on both macOS and Windows to do this and more…
What is ZwiftPref?
ZwiftPref is an app for your macOS or Windows computer which helps you change settings for Zwift in the prefs.xml file in an easy and safe way.
Important note re. the new home screen in Zwift:
Since Zwift doesn’t show your last selected route in the new home screen you cannot activate a ride on your last selected route anymore. That also means that you cannot activate a ride on a route pre-selected with ZwiftPref. There is no way to circumvent this but let’s hope that Zwift bring back the functionality to see your last selected route.
More screenshots:
How to use
After installation, launch the ZwiftPref app.
prefs.xml is loaded into the app when it starts and when you press the ‘Reload’ button.
Change settings as you like and press ‘Save’ to have the changes written back to prefs.xml. The changes will then apply the next time you start Zwift.
If you close/quit the app without pressing ‘Save’ nothing is changed in prefs.xml
Download
macOS
Download “ZwiftPref (macOS)” zwiftpref.dmg – Downloaded 71383 times – 78.58 MBmd5 checksum: 828687362e568594c8b145839ee32a59
Security settings
You will have to adjust some security settings to let ZwiftPref launch. See the section ‘Security settings’ in the post ZwiftMap for macOS is here. It is the same for ZwiftPref.
You also have to allow ZwiftPref access your Documents folder when prompted by macOS, at least under Catalina. This is because of changes to the security model in Catalina compared to previous macOS versions.
Windows
Download “ZwiftPref (Windows)” setup-zwiftpref-0.6.1.exe – Downloaded 36835 times – 60.21 MBmd5 checksum: b67723ade62e5c44a00034f7f61634b4
History
0.3.2 2018-03-26
- Fully data driven listing of worlds and routes (preparing for a new world)
- Remember and recall preferred monitor (stores the information in a separate file named saved_prefs.json)
- Supports –offline parameter to not read any data from the web (routes list, event schedule, map schedule)
- For development/test: Supports –test parameter to use local file routes-test.json as input (use with –offline)
0.2.5 2017-10-28
- Choose sport (Riding or Running)
- More routes
- Open prefs.xml in a text editor
0.2.4 2017-09-11
- Change more settings
- Pick routes
- See upcoming events
0.1.0 2017-01-26
- All platforms: First release
Read more
The announcement posts provide a lot more information:
ZwiftPref hotfix
ZwiftPref 0.6.1 is a bug fix update, necessary to get the full list of worlds and routes after some security updates server-side at ZwiftHacks. […]
Route selection woes in zwift-preferences / ZwiftPref
Important note re. the new home screen in Zwift: Since Zwift doesn’t show your last selected route in the new home screen you cannot activate […]
Fixing ZwiftPref to show world list again
This is a bug fix update, necessary to get the full list of world after a Let's Encrypt root certificate used in securing web communication […]
Makuri Islands
The new Makuri Islands world is supported by all of these ZwiftHacks tools: EventsRouteszwift-preferencesZwiftPref An update for ZwiftMap may still be needed but it will […]
World hack into France and Paris
The latest update of Zwift brings France and Paris into the regular guest world rotation. Even better, you can world hack into both France and […]
ZwiftPref shows both guest worlds
Since Zwift has recently introduced a second guest world on the calendar it would be nice to know what is on the calendar before you world […]
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 […]
ZwiftPref is updated with New York and run course selection
If you want more of New York when the calendar switches to Watopia in a couple of days, now may be a good time to […]
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 […]
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) […]
While we wait… ZwiftPref update
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 […]
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 […]
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 […]
Major update to ZwiftPref for macOS & Windows
Execute the World Hack safely with ZwiftPref and YOU get to decide where you will be zwifting today. Pre-select the route before you launch Zwift itself. […]
Use the <WORLD> hack and ZwiftMap together!
This is nice to know about the ZwiftMap app: Just curious – if you use ZwiftPref and select a route that is not on the calendar […]
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 […]
License
This license applies only to the original parts of the work. The original licenses of any included packages apply without modification.
Acknowledgements
Built on
Built with
when can we expect an update for the new locations maps?
Just make sure that you have the latest version (from March). This version is prepared for new worlds and new routes – when Zwift releases them, ZwiftPref will pull the information from the ZwiftHacks server and almost magically let you choose world and routes (well, unless Zwift changes too much – then it may require a bit more work on the ZwiftPref code 🙂 ).
Are you planning an Android version soon?
Actually not. I am not even an Android beta tester…
ZWIFT PREF is great but I use ZWIFT on IPAD. Is it possible to run zwift pref with IPAD ou IPHONE?
No, that is not possible.
Any plan for an IOS version?
No, there aren’t any plans for that.
Would I be able to ride routes I haven’t leveled up for yet, if I choose that route in Zwift Pref?
You guys are great; thanks!
Best,
Shyam
No, the level restrictions in-game always apply.
Has this been updated for Catalina? I’m new to Zwift and was very excited to find this, but even though the program opens, it only shows 3 worlds (Watopia, Richmond, and London), and I have yet to find any prefs.xml file on my machine. I’ve followed all the instructions above, but nothing seems to change. Looking into the Zwift software package, the only thing I find that looks remotely like the prefs.xml is the info.plist file, but it seems to be locked even in the administrator account, so I can’t try the manual world hack. Thanks for any help/feedback and your hard work!
I don’t of that it needs updating for Catalina – that I will have to look into.
Regarding the location of prefs.xml: See https://zwiftinsider.com/world-tag/ where it is described how you find this file. It is not in the software package but is created in Documents/Zwift (see the post and possibly also some of the first comments).
I have tested with Catalina now and it works as it should BUT you have to allow ZwiftPref to access your Documents folder when prompted by macOS. This is because of changes to the security model in Catalina compared to previous macOS versions.
Very nice! What did you use to program this? Java?
It is built with the Electron framework using JavaScript, HTML, and CSS.
Will there be an update soon? Zwift now has two guest worlds and it seems to have broken the world selection for this hack.
In which way do you mean that it is broken? I don’t see a difference here.
The world hack works – as before – and lets you choose a world other than Watopia as base world.
However, I will publish an update at some point so ZwiftPref can display which courses/worlds are on the calendar currently
When I select a new world in ZwiftPrefs and save it the world I have chosen isn’t available in Zwift.
Hi Jeff, I’m sending you an e-mail because I need extra information to understand what it is you experience (or not).
como puedo cambiar el mundo donde me muevo en zwift
France or Paris are not on there yet but friends have manualy hacked the xml on a PC and it works. On the Mac it just crashes. Will you update the hack app soon?
Until there is support for the ‘normal’ world hack in-game I won’t add France and Paris to ZwiftPref and zwift-preferences; but I’ll add it as soon as it works.
There are several ways to get access to both France and Paris already now. I know of four different ways you can do it in Windows, and two of them work for macOS, too. However, since they are probably beyond what Zwift would deem fair use — otherwise they had probably enabled the world hack — I won’t publish the methods here at zwifthacks.com. You will have to search for them elsewhere.
The Reverse Routes don’t seem to be working – e.g. Richmond Cobbled Climbs Reverse. They are listed in the Zwift menu but don’t actually send you to the course. same problem in ZwiftPrefs and Zwift Preferences.
I think you’re right. At one point it was possible to select event only routes via ZwiftPref and then ride then in-game but that hack doesn’t seem to be working anymore. I may remove the event only routes from ZwiftPref to avoid any confusion it may cause.
I want to finish handful of gravel run . I use prefs and save prefs.xml to Document/Zwift. then i open zwift.and I found it doesnt work