Berikai / bitwig-theme-editor

A theme editor for Bitwig Studio, written educational purpose in mind!
MIT License
83 stars 7 forks source link

Bitwig Studio Theme Editor

ui

A theme editor for Bitwig Studio, written in java. Bitwig meets themes, finally!

:warning: Please back up your bitwig.jar file before running the app, just in case.

Download

GitHub release

Head to the Releases page to download the latest version.

Requirements

You need Java 17 or a higher version installed on your computer.

It should work with any Bitwig Studio version in theory, but it has not been tested extensively yet.

Themes

Where to find themes?

You can find themes made by community here.

How to create themes?

You can check the in development visual theme editor here!

Another way of creating themes is editing a theme file. You can do this by exporting the theme file via Bitwig Theme Editor from your bitwig.jar and changing color values on the exported theme file.

Usage

You can run the app directly without parameters to use it with a simple UI.

Alternatively, you can run:

java -jar bitwig-theme-editor.jar <bitwig-jar-path> [command] <theme-path>

Available commands:

Example usage:

java -jar bitwig-theme-editor.jar /opt/bitwig-studio/bin/bitwig.jar export current-bitwig-theme.yaml
# or
java -jar bitwig-theme-editor.jar /opt/bitwig-studio/bin/bitwig.jar apply current-bitwig-theme.json

Brief Explanation

First, run the app using the export command to create theme file based on your bitwig.jar file. This file will be in JSON or YAML format depending on your choice. Then, edit the color values in the theme file to your liking. After that, run the app with the apply command.

Voilà! You have themed your Bitwig!

Note: Using RGBA values instead of RGB values is not supported, as it may cause glitches in the Bitwig UI. However, you can use RGBA values where RGBA values are already in use.

Development

This project is built using the following tools.

Open the project with a Java IDE of your choice; IntelliJ IDEA is recommended. You can build the project with the jar task via Gradle.

Contribution

Pull requests are welcome!

License

This project is licensed under the MIT License - see the LICENSE file for details.