Installation

Engine Prime

Before running blueberry, install Engine Prime and import at least one song. Once you've done that, you can launch blueberry.

note

In case you're wondering whether you need to import all of your music before launching blueberry for the first time, don't worry! The answer is an emphatic no. Any time you add, edit, or remove songs in your Engine Prime database, simply close and re-open blueberry. Your library will automatically sync!

Windows

To set up blueberry on Windows, download and run the .exe setup package. You'll likely be prompted that the application is from an unknown publisher, in which case choose "Run anyway."

tip

We'll never distribute malicious software, but you don't have to take our word for it! Upload your copy of blueberry to VirusTotal, or scan it with your favorite anti-virus software, if you want third-party confirmation that our app doesn't contain malware.

Firewall

Windows may ask you if you want to allow blueberry to communicate on certain networks. This is required to use the remote mixer, so check both boxes and click "Allow access."

macOS

To install blueberry on macOS, download and mount the .dmg package. Once its mounted, drag the blueberry.app file into your Applications folder. You can delete the .dmg package once you're finished.

Gatekeeper

Since blueberry is currently available for free, we haven't paid Apple $99 for a developer ID to sign and notarize our application. This means that, when you first try to run blueberry, you'll be alerted that it can't be opened because it's from an unknown developer. To solve this, open your Applications folder in Finder, and control-click (or right-click) on blueberry.app. Select "Open" from the context menu that appears. When prompted again that the application is from an unknown developer, click "Open Anyway." You can read the relevant Apple suport docs for more information.

tip

We'll never distribute malicious software, but you don't have to take our word for it! Upload your copy of blueberry to VirusTotal, or scan it with your favorite anti-virus software, if you want a third-party confirmation that our app doesn't contain malware.

Permissions

When panning/zooming around the arrangement view, or adjusting the tempo, blueberry locks your mouse cursor so it doesn't leave the selected control until you're done interacting with it. This requires the "Accessibility" permission in recent versions of macOS, so the first time you interact with one of those controls, you'll be prompted to grant blueberry permission. If you don't grant the permission, those controls will not function properly.