kblaschke/frontend-sdl2 2.0-macos-pre2

macOS x86_64/arm64 Development Pre-Release

on GitHub

This is a macOS 64-bit Universal Binary (x86_64/arm64) development pre-release of projectMSDL, built against a shared libprojectM library from upstream master (commit projectM-visualizer/projectm@d89c09e) and shared SDL2/Poco libraries. It is shipped as a macOS Installer package and installs (by default) into the system Applications directory (can be changed during installation). Being a Universal Binary, this application will run natively on both Apple-Silicon- and Intel-based Macs without requiring Rosetta emulation.

The applications contains the "Cream of the Crop" preset pack and our Milkdrop texture pack and is pre-configured to use those. To use your own preset pack or textures, change either path in the settings window, save the settings and restart the app.

The projectM app was built in debug mode to produce the best possible stack traces if it crashes, and thus isn't optimized for speed. It should run quite well on most Macs though.

Code Signing / Gatekeeper Issues

⚠️ Neither the installer package nor the contained .app bundle are digitally signed!

Thus, macOS Gatekeeper will probably warn you that the package came from an untrusted (AKA the internets) source. If you cannot dismiss the dialog and continue, you'll have to remove the file quarantine flag manually. to do this, open a terminal, cd to your download directory and run this command:

xattr -d com.apple.quarantine projectM-2.0.0-Darwin.pkg

Audio Recording

Due to macOS CoreAudio restrictions, the application cannot capture audio played by local applications. It can only record audio from external sources like microphones or line-in. To record system audio, you'll have to install a virtual loopback driver like BlackHole.

Hotkeys

• ESC toggles the built-in UI.
• r switches to a random preset immediately.
• n switches to the next preset (random if shuffle is on).
• p switches to the previous preset (random if shuffle is on).
• BACKSPACE switches to the previous preset in the playback history, regardless of shuffle.
• Shift+<preset switch key> uses a smooth transition for the above switch hotkeys.
• SPACE locks/unlocks the current preset.
• y toggles shuffle mode.
• ⌃+a rotates through audio capture devices.
• ⌃+f toggles fullscreen mode.
• ⌃+m moves the window through available monitors (works in fullscreen and windowed mode).
• ⌃+q quits the application.

If you want to edit the configuration manually, the user-specific configuration is stored at ~/Library/Preferences/projectM/projectM.properties - the path/file might not exist until you save the settings once in the application. See the default configuration file in /Applications/projectM.app/Contents/Resources/projectM.properties for details on the different settings.

Remember this is a development build, so crashes and bugs are to be expected. Nonetheless, please report any issues you find in the main projectM issue tracker.