ℹ️ About cAmp2

Reimplementation of my Audio Player Crystal AMP (cAmp) for GNU/Linux (and Windows).

Website with more description of cAmp2 here.
🖼️ Screenshots gallery here.

Currently needs building from sources.
Mostly working well, with few new things, but still some missing.

---

📊 Features

In addition to old cAmp features.
Below are listed only new and missing things in cAmp2.

New

• Gui with options in many own windows (for find, view, tab, playlist etc.)
• All program keys bindable, filterable list
• Visualization themes with options and sliders in Gui
• Queue tab (set tab as Queue Alt-E, add to queue key: E)

To do

restore old

• move track, selection (critical), insert at cursor
• hotkeys (how?)
• threads for spectrogram, insert files, etc.
• use shaders for visualizations (not very needed)

add new

• refresh dir F6, or whole playlist, find missing file after rename
• rename files, dirs
• skins, xml

Using

Libraries used:

• for Audio: bass (NOT FOSS)
• for Graphics: SFML 2.5.1

and also included in libs/:

• for Gui: ImGui 1.82 and ImGui-SFML 2.2
• TinyXML-2
• Native File Dialog

---

⚙️ Building

How to compile project from sources.
Project uses C++17 and CMake to build.

Basic

Basic setup (on Debian-based):

sudo apt-get install g++ git cmake make binutils

Extras (not needed to build):

sudo apt-get install gdb clangd clang

Then install SFML and Gtk3:

sudo apt-get install libsfml-dev libgtk-3-dev

Bass

Now inside some folder, let's call it dev/.
To setup bass, download bass24-linux.zip (clicked Linux there).
I unpacked it into dev/bass/ subdir, then created x64 dir like so: dev/bass/src/x64/ and copied libbass.so there, from /bass/libs/x86_64/.
These paths can be changed in CMakeLists.txt, top under # bass

cAmp2

To get sources, back inside dev/:

git clone https://github.com/cryham/cAmp2.git cAmp2
cd cAmp2

To build:

mkdir bin && cd bin
cmake ..
make -j

Then to start, just run the binary: ./cAmp2.

Notes

Tested on Debian 11 and 12 only.

Building with CMake in Qt Creator is easy.
Building in VSCodium / VS Code is possible too, with some more effort.
More info in my C++ guide under IDEs.

📖 Documentation

For sources, class list, members, hierarchy, diagrams etc.
It can be generated using Doxygen.
Setup for it is in Doxyfile.
After installing Doxygen (and its needed deps for diagrams), start in dev/ by: doxygen.
Then access it by opening created doxygen/html/index.html.

Included simpler UML ClassDiagram.xmi can be opened and edited in Umbrello.
And looks like this: ClassDiagram.png.