Repository navigation
Your Library
My Library lists every game you've added. Switch between Icons and List with the view picker in the toolbar. Add Game (the + in the toolbar) has Create Recipe… and Add from Recipe File…; to install a shared recipe, use the Community tab.
Each game has one main button:
| Button | When |
|---|---|
| Play | The game is ready. Double-clicking the game does the same. |
| Stop | The game is running. Stops everything running in its bottle. |
| Finish Setup… | The game isn't ready yet, for example its program to launch hasn't been chosen, or isn't in the bottle (an installer that was cancelled). It opens the [[recipe workshop |
A game whose files are on a drive that isn't connected shows why it can't start (for example, the drive's name) instead of a Play button; connect the drive and it's ready again.
When a recipe has adjustments for Macs like yours (overlays), the game shows Tuned for this Mac: and what was changed, such as a frame-rate cap on Macs with less than 16 GB of memory.
Before a game's first launch on a newer Wine build, Distiller saves a restore point and updates the game's bottle; the status bar shows Saving a restore point… and Updating …'s bottle to Wine …. This can take a minute. See Restore points.
Right-click (or Control-click) a game:
| Item | What it does |
|---|---|
| Play | Starts it. |
| Choose Icon… | Uses an image you choose as the game's icon. |
| Use the Program's Icon | Goes back to the icon read from the game's program. |
| Edit Recipe… | Opens the [[recipe workshop |
| Submit to Community… | Shares a recipe you made (needs a GitHub sign-in). See [[Sharing recipes |
| Just for Me | For recipes you made: keeps the recipe to yourself, so the library stops suggesting you share it. |
| Show Log | Opens the latest launch log (Wine's output from the last time you played). |
| Show Bottle in Finder | Opens the game's bottle folder. |
| Report How It Ran… | Opens the report form (below). |
| Remove from Library… | Removes the game and moves its bottle to the Trash (and, if its bottle was rebuilt and you hadn't decided yet, the old bottle too). Anything the game saved inside its bottle goes with it. |
After a session longer than two minutes, Distiller offers Report Game; you can also choose Report How It Ran… any time. Choose a rating (Platinum, Gold, Silver, Bronze or Borked; see ratings), optionally an Average FPS and Notes for other players, then Open Report on GitHub. It opens a pre-filled form on GitHub for you to submit; nothing is sent until you do. Reports include your Mac's chip, GPU cores, memory and macOS version, and nothing else about you. They decide how recipes are ranked for Macs like yours.
Not Now closes it.
Distiller is open source under the MIT licence · Website · Releases · Report a problem. Game names, icons and screenshots belong to their publishers.
Getting started
Playing
Recipes
Keeping things working
Command line