{"id":23842385,"url":"https://github.com/xynydev/bitwigbox","last_synced_at":"2025-10-07T12:14:48.887Z","repository":{"id":269724338,"uuid":"908262213","full_name":"xynydev/BitwigBox","owner":"xynydev","description":"A portable Bitwig Studio container with support for windows plugins through yabridge.","archived":false,"fork":false,"pushed_at":"2024-12-25T16:06:26.000Z","size":10,"stargazers_count":0,"open_issues_count":1,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-01-02T18:41:36.342Z","etag":null,"topics":["bitwig","bitwig-studio","clap","container","distrobox","linux","portable","vst","vst3","wine","yabridge"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/xynydev.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-12-25T16:00:58.000Z","updated_at":"2024-12-25T16:06:29.000Z","dependencies_parsed_at":"2024-12-25T17:28:14.629Z","dependency_job_id":null,"html_url":"https://github.com/xynydev/BitwigBox","commit_stats":null,"previous_names":["xynydev/bitwigbox"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xynydev%2FBitwigBox","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xynydev%2FBitwigBox/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xynydev%2FBitwigBox/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xynydev%2FBitwigBox/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/xynydev","download_url":"https://codeload.github.com/xynydev/BitwigBox/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":240129441,"owners_count":19752353,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bitwig","bitwig-studio","clap","container","distrobox","linux","portable","vst","vst3","wine","yabridge"],"created_at":"2025-01-02T18:38:26.828Z","updated_at":"2025-10-07T12:14:43.844Z","avatar_url":"https://github.com/xynydev.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# BitwigBox\n\nA portable Bitwig Studio container. Inspired by [davincibox](https://github.com/zelikos/davincibox).\n\nThe BitwigBox container is first built to include all dependencies needed to run your specific version of Bitwig Studio and windows plugins with yabridge. A distrobox container is then created using the container. This allows you to run Bitwig Studio in a portable way, without having to install it on your host system.\n\nBitwigBox can safely be removed and recreated without losing any data, such as configuration files, plugins, projects, login sessions, etc.\n\nThe BitwigBox uses it's own home directory at `~/BitwigBox/`. You can migrate your existing Bitwig Studio settings to the new home directory by copying over `~/BitwigStudio/` and `~/.BitwigStudio/` into `~/BitwigBox`. Bitwig Studio will be able to read and write to all directories and files on your system, but it will not litter your home directory with it's config files. This is why the home directory is in a separate location. You can install extensions, plugins, etc. normally into the BitwigBox directory.\n\nBitwigBox can mostly be managed with the supplied `just` recipes, but you may also run `distrobox enter bitwigbox` to interact with the container directly.\n\n## Requirements\n\nMake sure these are installed on your host system.\n\n-   [Distrobox](https://distrobox.it/)\n-   [Podman](https://podman.io/)\n-   [just](https://just.systems/)\n\n## Usage\n\n### Installation\n\n```bash\n# clone this repo (any directory works)\ngit clone https://github.com/xynydev/bitwigbox\n\n# enter the directory\ncd bitwigbox\n\n# build the container\njust build-local\n\n# create a distrobox container\njust create\n```\n\n### Running Bitwig Studio\n\nNote: The first run will take a while as it sets up the distrobox environment.\n\nYou can run Bitwig Studio inside the repo directory like this:\n\n```bash\njust run\n```\n\nYou can also export the Bitwig Studio app to the app menu:\n\n```bash\njust export\n```\n\n### Running Windows Plugins (VST2/3 \u0026 CLAP) with Yabridge\n\n[Yabridge](https://github.com/robbert-vdh/yabridge) is a tool that allows you to run Windows plugins on Linux. It is the reason this project exists, as Bitwig Studio can be used easily with Flatpak, but that setup does not support yabridge.\n\nTo run a Windows plugin with yabridge, you first need to install it into the BitwigBox wine prefix. You can interact with wine using `just wine`, and you can use `winecfg` to configure wine. You may also drop the `.dll` files into `~/BitwigBox/.wine/drive_c/`, but most plugins will come with installers you can just run with `just wine`.\n\nOnce you have some plugins installed, you can add them to yabridge by running `just yabridgectl add \u003cplugin-directory\u003e`. To quickly add the usual Windows plugin folders, you can use the following command. Note that this will fail if you haven't installed any plugins to the specific directories yet.\n\n```bash\njust yabridgectl 'add ~/BitwigBox/.wine/drive_c/Program\\ Files/Steinberg/VstPlugins' # vst2\njust yabridgectl 'add ~/BitwigBox/.wine/drive_c/Program\\ Files/Common\\ Files/VST3' # vst3\njust yabridgectl 'add ~/BitwigBox/.wine/drive_c/Program\\ Files/Common\\ Files/CLAP' # clap\n```\n\nLastly, you'll need to run `just yabridgectl sync` to add the yabridge plugin wrappers to `~/BitwigBox/.vst/`, `~/BitwigBox/.vst3/`, and `~/BitwigBox/.clap/` respectively.\n\nNow the plugins should be available in Bitwig Studio.\n\n## TODO\n\n-   investigate building on GitHub and publishing container images\n    -   possible copyright ramifications?\n-   figure out if it's possible to pass just recipe arguments to a subcommand without doing this quoting thing\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fxynydev%2Fbitwigbox","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fxynydev%2Fbitwigbox","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fxynydev%2Fbitwigbox/lists"}