Automated Installations

Automated Installations with WineBottler
The tab "Download" is your one-click-stop to install Apps. WineBottler will configure, download and install these Apps for you.
The sources of these items are often changed. Don't be surprised, if some downloads are broken – but we try hard to keep the list up to date. WineBottler is looking for changes once a day.

On My Mac

Manage Installed Apps with WineBottlerIn this tab, you find all programs you have bottled, as well as their working copies.
It is important to understand, that the Apps themselves are but templates. The data is stored in working copies – as apps are immutable on OS X.
From this page you can remove working copies (Reset). This will IRREVERSIBLY remove all data of an App. Or you can remove apps AND their working copy.
I recommend, that you manage your apps from here, as this will guarantee that you are deleting all the necessary files.

Do Your Own

If the program you are looking for is not in the "Download" section, you can create a bottle it yourself in the "Advanced" section. 90% of the time, this is as simple as selecting the installer and click "install".

General things to watch out for: But some programs – and developers :) – have special needs. We try to cover that in the following diagram as well.
Custom Settings in with WineBottler
For Developers: If you have an existing prefix you would like to take as a base for the new app, choose that prefix here. It will be copied and the new program will be installed into the copied prefix instead of a generic new prefix.
Advanced: Normally you got a file, that will install your program on Windows. But in some rare cases, the file you got is already the program, and you don't need to install it to run it. In that case, tell WineBottler to just copy it to the new app.
For Developers: Her you can enter arguments for the installer. You can use this to do unattended installs, for example.
Advanced: Some programs need special libraries or settings to run on Wine. This is where Winetricks enter the stage. If you have no success bottling or running your program, have a look at the program database on There you find often the libraries and settings your program needs.
Advanced: Your program might come with libraries that extend the functionality of system installed dlls. Enter the names of the dlls, that should be preferred to the system libraries. Again, the program database at is your first stop for infos.
For Developers: This will copy into your app. The app can then be distributed without having users to download and install The app will always use the included, which gives you a somewhat of a controlled environment. Adding will make your app considerably bigger.
Advanced: These arguments will be passed to the installed program each time the app is started. Some programs need switches by design, others can be tweak by applying switches. Browsers, for example, can deactivate the cache for easier website testing. The program documentation is a good start for clues on what switches are supported.
For Developers: The app version and unique bundle identifier. Have look at Apples Bundle Documentation for more info.
You can even Code Signing your app to pass OS X Gatekeeper.