A theme editor for Bitwig Studio, written in Java.
- Bitwig Studio 4.x, 5.x, or 6.x
- Java 8 or later (64-bit)
- Run
bitwig-theme-editor.jar - Click Select bitwig.jar and choose your Bitwig Studio installation's
bitwig.jarfile - Browse and install themes directly from the Community Themes tab, import a
.bte/.jsontheme via File → Import file, or create your own in the Colors tab
Tip: Use Switch / Re-patch in the top-right bar anytime to target another Bitwig Studio installation, and check Options → Enable global theme file to share one
theme.bteacross all patched Bitwig versions.
- Directly inside the Community Themes tab in the app
- On GitHub in awesome-bitwig-themes
- More themes on Bitwig Community Discord, in
#your-themeschannel.
You can also manage themes manually after patching Bitwig Studio:
-
Run patched Bitwig Studio once to initialize defaults
-
Locate
default.btein the config directory:- Windows:
%APPDATA%\.bitwig-theme-editor\versions\<version>\ - Linux:
~/.config/bitwig-theme-editor/versions/<version>/- (or
$XDG_CONFIG_HOME/bitwig-theme-editor/versions/<version>/, or~/.bitwig-theme-editor/versions/<version>/if already existing)
- (or
- macOS:
~/.bitwig-theme-editor/versions/<version>/
See Config directory for the full resolution order, migration rules and overrides.
- Windows:
-
Create or edit
theme.btein the same directory (or in.bitwig-theme-editor/theme.bteif Global Theme is enabled) -
Add or modify
Color Name: #hexlines and save -
Click the Dashboard Button or resize the Bitwig Studio window to apply changes
- Polarity's Theme Editor Helper: A browser utility to batch-adjust, tint, and transform colors across
.bteand.jsontheme files. - Bitwig Theme Editor Web UI: A web-based theme editor / previewer to inspect and modify theme colors online. (Bitwig 5.x /
.json)
- GUI mode (default):
java -jar bitwig-theme-editor.jar
- Direct CLI patching:
java -jar bitwig-theme-editor.jar [--global-theme] [--config-dir <path>] <bitwig-jar-path>
--global-theme(optional): Share a single~/.bitwig-theme-editor/theme.bte(or%APPDATA%\.bitwig-theme-editor\theme.bte) across all patched Bitwig Studio installations.--config-dir <path>(optional): Override the config directory. Can also be set with theBTE_CONFIG_DIRenvironment variable (see Config directory).
Note:
applyandexportare deprecated. The theme editor patchesbitwig.jaronce, and patched Bitwig Studio watchestheme.btefor changes.
Config directory
Bitwig Theme Editor keeps its configuration, downloaded themes and per-version .bte files in one directory. It is resolved in this order:
| Priority | Platform | Directory |
|---|---|---|
| 1 | Any | --config-dir <path> command-line option |
| 2 | Any | BTE_CONFIG_DIR environment variable |
| 3 | Windows | %APPDATA%\.bitwig-theme-editor (falls back to ~\.bitwig-theme-editor when APPDATA is unset) |
| 4 | macOS | ~/.bitwig-theme-editor (kept for backwards compatibility) |
| 5 | Linux / Unix | ~/.bitwig-theme-editor when it already contains user data |
| 6 | Linux / Unix | $XDG_CONFIG_HOME/bitwig-theme-editor, defaulting to ~/.config/bitwig-theme-editor |
Notes:
- The resolved directory is printed on startup, for example
Config directory: /home/<username>/.config/bitwig-theme-editor (XDG_CONFIG_HOME). - A leading
~inBTE_CONFIG_DIRor--config-diris expanded, and relative values are resolved against your home directory. - Per the XDG Base Directory Specification,
XDG_CONFIG_HOMEmust be an absolute path; relative values are ignored with a warning. - On Linux, an existing
~/.bitwig-theme-editoris only kept when it contains data. Empty leftovers are ignored, and if both locations contain data the legacy one wins with a warning. - The config directory is compiled into the patched
bitwig.jar. If you change it, re-patch Bitwig Studio (the GUI does this on launch) so both use the same directory, and set the override consistently (shell profile, desktop entry, ...).
Development
- Java JDK
- IntelliJ IDEA Community Edition (recommended IDE)
- Open the project in your Java IDE or run
./gradlew build/ the Gradlejartask.
Contribution
Pull requests are welcome! Feel free to contribute and help improve the project.
Looking for the old version? (1.x)
This project is licensed under the MIT License. See the LICENSE file for details.