ZwiftPref (macOS and Windows)

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 macOSmacOS The operating system on the Mac computers from Apple and WindowsWindows The Windows operating system from Microsoft. 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.

More screenshots:

World and Route selection in ZwiftPref – default view

Trainer Effect and Tacx New Road Feel screen

Select sport, tune the UI, remember/recall your preferred monitor, adjust workout settings, and turn power smoothing on/off

Version information and link to more information

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

ZwiftPref (macOS) (30452 downloads)

md5 checksum: 427a4b94f38cc756fd594d65eb2dd2ac

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

ZwiftPref (Windows) (12243 downloads)

md5 checksum: 90ac582e7e16638d76f551fdbf7c059e

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

The announcement posts provide a lot more information:

License

CC0 1.0 (Public Domain)

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

22 comments

mark says:
2018-08-08 at 16:33
when can we expect an update for the new locations maps?
1. jesper says:
  2018-08-08 at 16:41
  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 🙂 ).
Robert says:
2018-10-02 at 09:23
Are you planning an AndroidAndroid The Android operating system from Google is used on a number of mobile devices from various companies such as Samsung and Huawei. version soon?
1. jesper says:
  2018-10-02 at 14:36
  Actually not. I am not even an AndroidAndroid The Android operating system from Google is used on a number of mobile devices from various companies such as Samsung and Huawei. beta tester…
CELLE CEDRIC says:
2018-11-30 at 15:38
ZWIFT PREF is great but I use ZWIFT on IPAD. Is it possible to run zwift pref with IPAD ou IPHONE?
1. jesper says:
  2018-11-30 at 16:50
  No, that is not possible.
Michael Hare says:
2019-01-26 at 01:29
Any plan for an IOS version?
1. jesper says:
  2019-01-26 at 07:21
  No, there aren’t any plans for that.
sshMatthew says:
2019-10-02 at 12:27
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
1. Jesper says:
  2019-10-02 at 12:46
  No, the level restrictions in-game always apply.
Derek says:
2019-11-12 at 22:42
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!
1. Jesper says:
  2019-11-13 at 09:48
  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).
2. Jesper says:
  2019-11-15 at 21:35
  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 macOSmacOS The operating system on the Mac computers from Apple. This is because of changes to the security model in Catalina compared to previous macOS versions.
HelloWoody says:
2019-11-24 at 02:27
Very nice! What did you use to program this? Java?
1. Jesper says:
  2019-11-24 at 06:44
  It is built with the Electron framework using JavaScript, HTML, and CSS.
Jeff says:
2020-04-12 at 20:28
Will there be an update soon? Zwift now has two guest worlds and it seems to have broken the world selection for this hack.
1. Jesper says:
  2020-04-12 at 20:38
  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
  1. Jeff says:
    2020-04-13 at 00:19
    When I select a new world in ZwiftPrefs and save it the world I have chosen isn’t available in Zwift.
    1. Jesper says:
      2020-04-13 at 17:04
      Hi Jeff, I’m sending you an e-mail because I need extra information to understand what it is you experience (or not).
mauricio says:
2020-05-05 at 02:34
como puedo cambiar el mundo donde me muevo en zwift
Dan Duran says:
2020-07-01 at 20:26
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?
1. Jesper says:
  2020-07-01 at 21:33
  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 WindowsWindows The Windows operating system from Microsoft., and two of them work for macOSmacOS The operating system on the Mac computers from Apple, 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.

ZwiftPref (macOS and Windows)

What is ZwiftPref?

How to use