[!WARNING] This software is unfinished. Keep your expectations low.
The project aims to make a tool for creating beautiful music visualizations and rendering high quality videos of them.
Please, read CONTRIBUTING.md before making a PR.
Music by @nu11 from https://soundcloud.com/nu11_ft/nu11-wip-works-2016-2022 at 20:38
https://github.com/tsoding/musializer/assets/165283/8b9f9653-9b3d-4c04-9569-338fa19af071
External Dependencies:
PATH
environment variable. It is called as a child process during the rendering of the videos. So if you don't plan to render any videos it's completely optional.We are using Custom Build System written entirely in C called nob
. It is similar to nobuild in spirit. nob.h is the Build System and nob.c is the program that builds Musializer.
Before using nob
you need to bootstrap it. Just compile it with the available C compiler. On Linux it's usually $ cc -o nob nob.c
on Windows with MSVC from within vcvarsall.bat
it's $ cl.exe nob.c
. You only need to boostrap it once. After the bootstrap you can just keep running the same executable over and over again. It even tries to rebuild itself if you modify nob.c (which may fail sometimes, so in that case be ready to reboostrap it).
I really recommend to read nob.c and nob.h to get an idea of how it all actually works. The Build System is a work in progress, so if something breaks be ready to dive into it.
$ cc -o nob nob.c # ONLY ONCE!!!
$ ./nob
$ ./build/musializer
If the build fails because of missing header files, you may need to install the X11 dev packages.
On Debian, Ubuntu, etc, do this:
$ sudo apt install libx11-dev libxcursor-dev libxrandr-dev libxinerama-dev libxi-dev
On other distro's, use the appropriate package manager.
From within vcvarsall.bat
do
> cl.exe nob.c # ONLY ONCE!!!
> nob.exe
> build\musializer.exe
Install MinGW-w64 from your distro repository.
Edit ./build/config.h
and set MUSIALIZER_TARGET_WIN64_MINGW
instead of MUSIALIZER_TARGET_LINUX
.
$ ./nob
$ wine ./build/musializer.exe
Edit ./build/config.h
and enable MUSIALIZER_HOTRELOAD
.
$ ./nob
$ ./build/musializer
Keep the app running. Rebuild with ./nob
. Hot reload by focusing on the window of the app and pressing h.
The way it works is by putting the majority of the logic of the application into a libplug
dynamic library and just reloading it when requested. The rpath (aka hard-coded run-time search path) for that library is set to .
and ./build/
. See src/nob_linux.c for more information on how everything is configured.