Linux x64 Development Pre-Release

This is a Linux 64-bit development pre-release of projectMSDL, built against libprojectM 4.1.1 and a shared SDL2 library. Will require a recent Linux distro to run on (glibc 2.35 or higher is needed, e.g. Ubuntu 22.04) and have a libSDL2 library installed, ideally 2.0.16 or newer.

The package does not include any textures or presets, these have to be downloaded separately. For a start, use the Cream of the Crop preset pack and projectM's basic texture pack. Download, unzip and then configure projectMSDL to use the respective directories. To add the paths to the application, press ESC to open the menu, then select File->Settings and use the "..." buttons in each of the path fields to browse to the install dir. You can also paste the path directly into the text field. When finished, press "Save Settings" and restart the application (hot reloading is not yet implemented):

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.
• Ctrl+a rotates through audio capture devices.
• Ctrl+f toggles fullscreen mode.
• Ctrl+m moves the window through available monitors (works in fullscreen and windowed mode).
• Ctrl+q quits the application.

If you want to edit the configuration manually, the user-specific configuration is stored at ~/.config/projectM/projectMSDL.properties - the path/file might not exist until you save the settings one in the application. See the default configuration file in /usr/share/projectM/projectMSDL.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.

projectMSDL Windows x64 2.0 Pre-Release 3

This is a development preview build of the rewritten projectM SDL2 frontend application. It ships with version 4.1.0 of libprojectM, which has a rewritten expression parser and an all-new rendering stack. The new UI is still a work in progress, with the playlist management and preset search/selection dialogs still missing. Since the last pre-release, the application now comes with a fully working configuration dialog and has more settings to configure the windows position and size on startup, which might come in handy during live acts and capturing projectM's output with OBS.

If you get an error telling that VCOMP140.DLL, MSVCP140.DLL or a similarly named file is missing, please download and install the Microsoft Visual C Runtime Redistributable.

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.
• Ctrl+a rotates through audio capture devices.
• Ctrl+f toggles fullscreen mode.
• Ctrl+m moves the window through available monitors (works in fullscreen and windowed mode).
• Ctrl+q quits the application.

Configuration and Log Files

To find the user-specific configuration and log files, open Explorer and type into the address bar: %APPDATA%\projectM

If that doesn't work for some reason, you can usually browse to C:\Users\<your username>\AppData\Roaming\projectM manually. Note that AppData is a hidden directory and might not be shown by default.

The file projectMSDL.properties contains your personal settings made in the settings window. Refer to the file with the same name in the install dir for supported options and their descriptions.

projectMSDL.log contains all log output. Developers may ask you to set the debug level higher and provide information from this file for bug reports.

projectMSDL.UI.ini stores positions of the UI windows. If you have moved a window out of your screen and can't get it back, you can either delete the coordinates for that window from this file, or simply delete the whole file to reset the UI to the default positions and sizes.

Libraries used to build

• POCO 1.12.4
• SDL2 2.26.5
• Dear ImGui 1.89.2
• Freetype 2.12.1
• libprojectM version 4.1.0

Known Issues in this Version

• The Ctrl+s hotkey displayed in the File menu doesn't open the settings dialog yet (will be changed anyways, just ignore for now).
• Some presets still don't render properly for various, hard-to-fix reasons. If you come across such a preset, please feel free to report it to us so we can have a look at it and potentially fix the issue.

If you experience any issues with the SDL2 frontend, like crashes, audio capturing issues and other things we should know about, please use the links in the application's help menu to report your issue, or browse to the upstream issue tracker from here.

projectMSDL Windows x64 2.0 Pre-Release 2

This is a development preview build of the rewritten projectM SDL2 frontend application. This release contains an unmerged preview version of libprojectM, with a rewritten expression parser and an all-new rendering stack. Some functionality is still broken (e.g. automatic preset switchting and transisitions), but the visual quality and preset compatibility should be better than the 4.0 release, as the new expression parser now supports the full syntax (including megabuf and loops) plus the renderer uses more accurate code, better matching Milkdrop's rendering logic.

Libraries used to build:

• POCO 1.12.4
• SDL2 2.26.4
• Dear ImGui 1.89.2
• Freetype 2.12.1
• libprojectM revision e506701d30216ecd85c6660f60ab4c966b2906bb (Development version!)

This not a final release and can still have bugs or crashes. If you find issues, please feel free to report them in the upstream issue tracker.

If you get an error telling that VCOMP140.DLL or a similarly named file is missing, please download and install the Visual C Runtime Redistributable: https://aka.ms/vs/17/release/vc_redist.x64.exe

Known Issues in this Version

As it's just a random in-dev state, this build has some known, unresolved issues as these are still a work in progress. Before creating an issue ticket, please see if you find the problem in the following list:

• Some effects are rendered upside-down. This is due to an ongoing alignment process to get shader UV coordinates work properly with the other render steps, caused by coordinate differences between OpenGL and DirectX.
• The audio processing is (still) broken, so spectrum waveforms will have very high peaks, the beat detection values (bass, mid and treb) are way too high and custom waveforms in oscilloscope mode with more than 480 samples will have a "spike" at one end. These issues were already present in previous versions, and will be fixed at a later point.
• Random texture selection is currently not implemented, but it's the next item on the to-do list. Presets using sampler_randXX will not work and probably show a black screen for now.
• Smooth preset transitions are also not implemented yet.

projectMSDL macOS x86_64/arm64 2.0 Pre-Release

This is a development preview build of the rewritten projectM SDL2 frontend application. It is not yet packed as a proper application bundle, and delivered as a console application binary. Also note that the binary is not code-signed or notarized and will trigger a Gatekeeper warning on start. It is a universal binary and thus will run natively on both Intel-based Macs and also the new ARM64-based M1/M2 Silicon machines.

Requires MacOS 12 or higher to run!

Libraries used to build:

• POCO 1.12.3
• SDL2 2.25.0
• libprojectM revision 5a165f5de8d7687ed8945dcf3035fa0280754f74

This not a final release and can still have bugs or crashes. If you find issues, please feel free to report them in the upstream issue tracker.