PolarPlayer Studio is a MIDI synth for the ROLI Seaboard or other MIDI instruments that send pressure data.
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Jakob Meier d5e03d915a
added android disclaimer #2
2 months ago
assets added image library & prepared icons 5 months ago
res fixed android build 2 months ago
screenshots prepared alpha 3 release 5 months ago
src code cleanup using clippy 2 months ago
.gitignore Initial commit 5 months ago
CHANGELOG.org version 2 with android support 2 months ago
Cargo.lock version 2 with android support 2 months ago
Cargo.toml fixed android build 2 months ago
LICENSE Initial commit 5 months ago
README.org added android disclaimer #2 2 months ago

README.org

PolarPlayer Studio

/comcloudway/polarplayer-studio/src/branch/main/assets/icon.png
PolarPlayer Studio Icon

PolarPlayer Studio

Batteries includes

About

PolarPlayer Studio is a MIDI synth for the ROLI Seaboard and other MIDI instruments that transmit pressure data using channel aftertouch.

As of version 2.0 the sdl core has been replaced with miniquad and egui's miniquad bindings. In theory miniquad should allow PolarPlayer Studio to run an nearly every device, but only Linux has been confirmed to be working.

Getting started

Because there are no prebuild binaries available you have to build PolarPlayer Studio yourself, but don't let that scare you

  • it shouldn't take long.

Requirements

As mentioned above only Linux has been confirmed to be supported.

If you are running Linux, then hey you are in luck, you just have to follow the instructions.

If you are not running Linux, well you are kind of on your own.

NOTE: I was able to compile the android version, but touch input does not appear to be working, nor is there midi support for android

Either way here is a list of tools needed to build PolarPlayer Studio:

  • git [recommended]
  • rust and cargo, using rustup is recommended
  • if you want to try to build the android version, you might want to try crossbundle

Grabbing the source

Lets get going by downloading the source. The only official repository is hosted over on codeberg.

Start by navigating into your Projects folder, or your Downloads folder, depending on where you want to store the source code. (I personally like storing software others made in $HOME/.local/opt)

After navigating into the folder you have to download the source code. You can either download the source code as a .zip and extract it in a seperate folder, or you use git to clone the repository, which is recommended as it allows you to update the source code easier.

git clone https://codeberg.org/comcloudway/polarplayer-studio

Performing a check and doing a test run

Although you could build the binary immediately, you should make sure that the source code does not contain any errors, and that PolarPlayer Studio does work on your system.

You can achive this by navigating into this projects directory, and running cargo check, which will check if the projects contains any errors. Additionally cagro check also pulls all the dependencies used by this project.

After making sure that the version you downloaded does not contain errors, you are ready to run it. Running PolarPlayer Studio is as easy as typing cargo run --release into your command line and waiting for the window to open.

NOTE: If you plan on using midi you have to append --features midi to the previous commands, to enable the midi feature

If PolarPlayer Studio launches successfully you are ready to build the binary.

Finally building the binary

Here comes the fifth and last command: To build PolarPlayer Studio as a binary/executable replace the run in the previous command with build.

# without midi features (for unsupported platforms, e.g. android)
cargo build --release
# with midi support
cargo build --release --features midi

Troubleshooting

ALSA lib seq_hw.c:466:(snd_seq_hw_open) open /dev/snd/seq failed: Permission denied

I get the same error message on my artix install and even though my first though was to use doas, that would have required me to reinstall everything.

So I did a quick startpage search, which revealed that one has to modproble snd_seq.

After running on of the following commands you have to restart PolarPlayer Studio.

# using sudo
sudo modprobe snd_seq

# using doas
doas modprobe snd_seq

Sound is lagging behind

If your speakers keep producing clicking sounds, this indicates that PolarPlayer Studio isn't running as fast as it is supposed to be running. This might happen if you build the debug version instead of the release version.

To solve this rebuild the binary using the --release flag

cagro build --release --features midi

Screenshots

/comcloudway/polarplayer-studio/src/branch/main/screenshots/setup.png
Setup Screen
/comcloudway/polarplayer-studio/src/branch/main/screenshots/basic.png
Basic Player View
/comcloudway/polarplayer-studio/src/branch/main/screenshots/popups.png
About and Visualisation tester Popup