kblaschke/frontend-sdl2 2.0-windows-pre3

projectMSDL Windows x64 2.0 Pre-Release 3

on GitHub

This is a development preview build of the rewritten projectM SDL2 frontend application. It ships with version 4.1.3 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.

Update 2024-12-19

Updated the release ZIP with the latest libprojectM version 4.1.3. If you've already downloaded this package, you can simply download it again, or the smaller projectM-4.1.3-windows-x64-dll.zip archive and replace your existing DLLs with the ones contained within.