6
6
7
7
## projectM - The most advanced open-source music visualizer
8
8
9
-
10
-
11
9
** Experience psychedelic and mesmerizing visuals by transforming music into equations that render into a limitless array
12
10
of user-contributed visualizations.**
13
11
@@ -25,49 +23,68 @@ outsourced into separate repositories. If you're not a developer and just look f
25
23
your machine or device, please use one of the links listed below. The releases section in this repository only contains
26
24
source-code and binary releases of the projectM development libraries and headers, which aren't useful for end users.
27
25
28
- ### Available For
26
+ ### End-User Applications
27
+
28
+ ** Important** : projectM is currently undergoing heavy development, so the available end-user frontends are either
29
+ outdated or unavailable. We've released a few development previews, which are not feature-complete and may have bugs. As
30
+ soon as we've finished the current modernization of libprojectM, we'll release new and tested versions of most of the
31
+ frontends listed below, while we may remove or replace some of those which are no longer maintained by their original
32
+ developers.
29
33
30
34
##### Windows
31
35
32
- - [ Standalone] ( https://github.com/projectM-visualizer/frontend-sdl2/releases ) ([ latest build] ( https://ci.appveyor.com/project/revmischa/projectm/build/artifacts ) )
33
- (Requires the
34
- latest [ Visual C++ redistributable] ( https://support.microsoft.com/en-us/help/2977003/the-latest-supported-visual-c-downloads )
35
- to run)
36
- - [ Steam] ( https://store.steampowered.com/app/1358800/projectM_Music_Visualizer/ )
37
- - [ Windows Store] ( https://www.microsoft.com/store/apps/9NDCVH0VCWJN )
36
+ - Standalone (currently only available as
37
+ a [ development preview] ( https://github.com/kblaschke/frontend-sdl2/releases/tag/2.0-windows-pre1 ) )
38
+ - [ Steam] ( https://store.steampowered.com/app/1358800/projectM_Music_Visualizer/ ) (Same as standalone development
39
+ preview)
40
+ - [ Windows Store] ( https://www.microsoft.com/store/apps/9NDCVH0VCWJN ) (Old 3.1.12 release )
38
41
39
42
#### macOS
40
43
41
- - [ Standalone] ( https://github.com/projectM-visualizer/frontend-sdl2/releases )
42
- - [ Steam] ( https://store.steampowered.com/app/1358800/projectM_Music_Visualizer/ )
43
- - [ Music.app Plugin] ( https://github.com/projectM-visualizer/frontend-music-plug-in/releases )
44
- - [ Brew] ( https://formulae.brew.sh/formula/projectm )
44
+ - Standalone (currently only available as
45
+ a [ development preview] ( https://github.com/kblaschke/frontend-sdl2/releases/tag/2.0-macos-pre1 ) )
46
+ - [ Steam] ( https://store.steampowered.com/app/1358800/projectM_Music_Visualizer/ ) (Old 3.1.12 release)
47
+ - Music.app Plugin (currently only available as an
48
+ _ unsigned_ [ development preview] ( https://github.com/kblaschke/frontend-music-plug-in/releases/tag/v3.0-pre1 ) )
49
+ - [ Brew] ( https://formulae.brew.sh/formula/projectm ) (Old 3.1.12 release)
45
50
46
51
#### Linux
47
52
48
- - [ Standalone] ( https://github.com/projectM-visualizer/frontend-sdl2/releases )
49
- - [ Steam] ( https://store.steampowered.com/app/1358800/projectM_Music_Visualizer/ )
50
- - Check your distribution's package manager for a binary release.
53
+ - Standalone (currently only available as
54
+ a [ development preview] ( https://github.com/kblaschke/frontend-sdl2/releases/tag/2.0-linux-pre1 ) for Ubuntu 22.04 and
55
+ compatible distributions)
56
+ - [ Steam] ( https://store.steampowered.com/app/1358800/projectM_Music_Visualizer/ ) (Same as standalone development
57
+ preview)
58
+
59
+ Or check your distribution's package manager for a binary release. If it is outdated, please contact the package
60
+ maintainer, as the projectM development team does not maintain any of the distribution-specific packages.
51
61
52
62
#### Android
53
63
54
- - [ Google Play] ( https://play.google.com/store/apps/details?id=com.psperl.prjM ) (** Note** : This app is _ not_ created or
55
- supported by the projectM developers!)
64
+ - [ Google Play] ( https://play.google.com/store/apps/details?id=com.psperl.prjM )
65
+
66
+ ** Note** : Both the free and paid apps plus the Android TV app are _ not_ created or supported by the projectM developers!
67
+ If you have technical troubles or other inquiries, please contact the app author via the means provided in the Play
68
+ Store. Any bug reports in the projectM issue tracker regarding the apps will be closed immediately.
56
69
57
70
#### Xbox / Windows Phone
58
71
59
- - [ Windows Store] ( https://www.microsoft.com/store/apps/9NDCVH0VCWJN )
72
+ - [ Windows Store] ( https://www.microsoft.com/store/apps/9NDCVH0VCWJN ) (Old 3.1.12 release)
60
73
61
74
#### Other
62
75
63
- - [ Library source code] ( https://github.com/projectM-visualizer/projectm/ )
76
+ Source code and other resources, mostly aimed at developers.
77
+
78
+ - [ Library source code] ( https://github.com/projectM-visualizer/projectm/ ) (this repository)
64
79
- [ Qt5] ( https://www.qt.io/ ) based [ PulseAudio] ( https://www.freedesktop.org/wiki/Software/PulseAudio/ ) and JACK desktop
65
- apps [ as source code for Linux] ( https://github.com/projectM-visualizer/frontend-qt )
66
- - [ ALSA, XMMS, Winamp, JACK] ( https://sourceforge.net/projects/projectm/files/ ) (source, unmaintained)
80
+ apps [ as source code for Linux] ( https://github.com/projectM-visualizer/frontend-qt ) , currently broken and needs some
81
+ updating (help wanted!).
82
+ - [ ALSA, XMMS, Winamp, JACK] ( https://sourceforge.net/projects/projectm/files/ ) (legacy 2.x sources for historic
83
+ purposes, unmaintained since 2012)
67
84
68
85
### Discord chat
69
86
70
- [ Chat with us on Discord. ] ( https://discord.gg/mMrxAqaa3W )
87
+ [ Chat with us on Discord! ] ( https://discord.gg/mMrxAqaa3W )
71
88
72
89
### Demo Video
73
90
@@ -80,8 +97,15 @@ The preset files define the visualizations via pixel shaders and Milkdrop-style
80
97
The projectM library does not ship with any presets. The frontends come with varying preset packs which can be found in
81
98
separate repositories in the projectM repository list:
82
99
83
- - [ Base Milkdrop texture pack] ( https://github.com/projectM-visualizer/presets-milkdrop-texture-pack )
84
- -
100
+ - [ Base Milkdrop texture pack] ( https://github.com/projectM-visualizer/presets-milkdrop-texture-pack ) - Recommended for
101
+ use with _ any_ preset pack!
102
+ - [ Cream of the Crop Pack] ( https://github.com/projectM-visualizer/presets-cream-of-the-crop ) - A collection of about 10K
103
+ presets compiled by Jason Fletcher. Currently, projectM's default preset pack.
104
+ - [ Classic projectM Presets] ( https://github.com/projectM-visualizer/presets-projectm-classic ) - A bit over 4K presets
105
+ shipped with previous versions of projectM.
106
+ - [ Milkdrop 2 Presets] ( https://github.com/projectM-visualizer/presets-milkdrop-original ) - The original preset
107
+ collection shipped with Milkdrop and Winamp.
108
+ - [ En D Presets] ( https://github.com/projectM-visualizer/presets-en-d ) - About 50 presets created by "En D".
85
109
86
110
Included with projectM are the bltc201, Milkdrop 1 and 2, projectM, tryptonaut and yin collections. You can grab these
87
111
presets [ here] ( http://spiegelmc.com/pub/projectm_presets.zip ) .
@@ -91,13 +115,16 @@ presets [here](https://mischa.lol/projectM/presets_community.zip) (123MB zipped)
91
115
92
116
### Also Featured In
93
117
94
- [ ![ Kodi] ( https://github.com/projectM-visualizer/projectm/raw/master/web/kodi.png ) Kodi (formerly XBMC)] ( https://kodi.tv/ )
118
+ [ ![ Kodi] ( web/kodi.png ) Kodi (formerly XBMC)] ( https://kodi.tv/ )
119
+
120
+ [ ![ Helix] ( web/helix.jpg ) Helix] ( https://web.archive.org/web/20180628174410/http://ghostfiregames.com/helixhome.html )
95
121
96
- [ ![ Helix ] ( https://github.com/projectM-visualizer/projectm/raw/master/ web/helix.jpg ) Helix ] ( https://web.archive.org/web/20180628174410/http://ghostfiregames.com/helixhome.html )
122
+ [ ![ Silverjuke ] ( web/silverjuke.png ) Silverjuke (FOSS Jukebox) ] ( https://www.silverjuke.net )
97
123
98
- [ ![ Silverjuke ] ( https://github.com/projectM-visualizer/projectm/raw/master/ web/silverjuke .png) Silverjuke (FOSS Jukebox )] ( https://www.silverjuke.net )
124
+ [ ![ VLC Media Player ] ( web/vlc .png ) VLC Media Player (AKA VideoLAN Client )] ( https://www.videolan.org/vlc/ )
99
125
100
- [ <img src =" https://silentradiance.com/demos/projectM_vr/projectm_vr.png " width =" 200 " > Silent Radiance Distance Disco] ( https://silentradiance.com )
126
+ Reminder: These are all third-party integrations of libprojectM and not developed or supported by the projectM
127
+ development team. Please report bugs in those applications to their respective developers.
101
128
102
129
---
103
130
@@ -147,7 +174,7 @@ the [projectM organization's repositories](https://github.com/projectM-visualize
147
174
148
175
# Todo
149
176
150
- - Steal cool stuff from the recently-released Milkdrop source.
177
+ - Improve projectM using the recently-released Milkdrop source (WIP) .
151
178
- Update the various implementations using libprojectM.
152
179
- Update downstream projects with new versions.
153
180
@@ -164,9 +191,10 @@ Report issues on GitHub in the respective repositories:
164
191
- Issues regarding the ** projectM Android apps in the Play Store** , please contact the app author via the Play Store. We
165
192
cannot help with any problems or requests.
166
193
167
- If unsure, post your issue in the main [ libprojectM repository] ( https://github.com/projectM-visualizer/projectm/issues ) .
194
+ If unsure, post your issue in the
195
+ main [ libprojectM issue tracker] ( https://github.com/projectM-visualizer/projectm/issues ) .
168
196
Please always check any existing issues if your problem has already been posted by another user. If so, add your logs
169
- and findings to the existing issue instead of opening a new one .
197
+ and findings to the existing issue instead of opening a new ticket .
170
198
171
199
## Get in contact with us
172
200
@@ -181,7 +209,7 @@ Before starting to write code, please take your time to read
181
209
the [ contribution guidelines] ( https://github.com/projectM-visualizer/projectm/wiki#contributing-to-projectm ) in our
182
210
wiki.
183
211
184
- ## Maintainers
212
+ ## Package Maintainers
185
213
186
214
If you maintain packages of libprojectM, we are happy to work with you! Please note well:
187
215
@@ -201,11 +229,11 @@ If you maintain packages of libprojectM, we are happy to work with you! Please n
201
229
202
230
## License
203
231
204
- projectM is released under
232
+ The core projectM library is released under
205
233
the [ GNU Lesser General Public License 2.1] ( https://github.com/projectM-visualizer/projectm/raw/master/LICENSE.txt ) to
206
- keep any changes to the core library open-sourced, but also enable the use of libprojectM in closed-source
207
- applications ( as a shared library)
208
- as long as the license terms are adhered to .
234
+ keep any changes open-sourced, but also enable the use of libprojectM in closed-source applications (as a shared
235
+ library) as long as the license terms are adhered to. The up- and downstream projects may use different licenses -
236
+ please check all parts of the software to be compatible with your specific project if you plan an integration .
209
237
210
238
## Wiki
211
239
0 commit comments