Timbre on a Mac or Linux

On a Mac or on Linux, Timbre does everything with your library that it does on Windows: add, sort, switch, preview and paint your mods. The game runs only on Windows, so you play from there.

• A Mac with Apple silicon (M1 or later), or a Linux desktop on a 64-bit Intel or AMD processor.
• Your mods folder, or an empty folder for one.

1. Open the releases page and download Timbre_<version>_aarch64.dmg from the newest Timbre release.
2. Open it. If it shows the beta's terms, press Agree.
3. Drag Timbre onto Applications.
4. Open Applications and double-click Timbre. The beta is not signed by Apple yet, so macOS says it could not verify Timbre: press Done.
5. Open System Settings, then Privacy & Security. Under Security, beside "Timbre" was blocked, press Open Anyway, and confirm with your password.
6. Press Open Anyway once more. Timbre opens, and from now on it opens like any other app.

1. Download Timbre_<version>_amd64.AppImage from the newest Timbre release on the releases page.
2. Move it to a folder of yours, such as ~/Applications.
3. Make it executable: in your file manager, open its Properties and allow it to run as a program, or run chmod +x Timbre_*.AppImage.
4. Double-click it. Timbre opens.

Timbre looks for a newer release every hour. When there is one, a banner says so: press Update, then Update now. Timbre replaces itself and opens again.

Timbre updates itself only where it can write its own folder. If Settings → About says Timbre can't update itself where it is, move it as the table says and open it again.

Running from	Move it to
the .dmg, or Downloads on a Mac	Applications
Applications on a Mac account that is not an administrator	the Applications folder in your home folder
a folder you cannot change on Linux	a folder of yours, such as ~/Applications

	On a Mac or Linux
Add, sort, switch and update mods	as on Windows
The preview, Paint and Blender	as on Windows; on Linux, choose Blender yourself (Edit a mod in Blender)
Play, Overtone's install and its in-game settings, the live view	Windows only: Timbre does not show them
Delete a mod	to the Trash, where your file manager can put it back

macOS keeps apps out of Documents, Desktop, Downloads and other drives until you allow them. The first time Timbre opens a mods folder there, macOS asks: press Allow. If you pressed Don't Allow, Timbre shows Timbre can't open your mods in place of your library, and changes nothing in it.

1. Press Open System Settings. Files & Folders opens.
2. Open the row of Timbre. Its folders show.
3. Turn on the folder your mods are in, such as Documents Folder.
4. Go back to Timbre. Your library shows.

You see	Do
Timbre can't open your mods after you allowed it, on a Mac	Quit Timbre and open it again.
Timbre can't open your mods on Linux	Your account can't read the mods folder: in the folder's Properties, give yourself permission to read it, then go back to Timbre.

You see	Do
No Open Anyway button	Open Timbre once first, then look again in Privacy & Security.
The AppImage does nothing on Ubuntu	Install FUSE 2: sudo apt install libfuse2 (libfuse2t64 on Ubuntu 24.04 and later).

• Getting started: your first mod, played on Windows.
• Add your mods: more ways to add mods, and bringing over an XXMI library.
• Mix outfits and loadouts: several outfits on one character, and loadouts for the wheel.