Content

Audiowaveform

Generating the waveform the player shows during playback

RKHM features automatic, high-performance visual waveform generation for your items. To achieve this, the platform utilizes audiowaveform, a lightning-fast C++ command-line tool.

Once configured, the entire process is fully automated—the script handles the generation, extraction, and rendering behind the scenes without any extra manual work.

Waveforms were added in v2.0.75.

Step-by-Step Setup

Install audiowaveform on your server. Ubuntu and Debian packages and build instructions are on the audiowaveform project page; you need a VPS or dedicated server where you can install software.
Locate the Binary Path: Find the absolute path to the executable on your server
Configure RKHM: go to Setting → General → External Tools → Audio Waveform.
Tick Enable and enter the binary's absolute path (for example /usr/bin/audiowaveform) in Absolute/Shell path.
Click the Test link next to the path to confirm RKHM can run it, then save.

After enabling awf, music-tracks and beats that are hosted locally ( on same server ) will display a waveform. Each waveform is generated the first time the item is viewed. See it on the Beats demo.

Compatibility

Waveforms are only made for MP3 files stored on your own server. Files on third-party storage and HLS-only sources show a normal playing bar instead.

How to display Waveform after enabling it?

Waveform will automatically load when users visit `tracks` or `beats` that have a local mp3 file

You can also visit PageBuilder, add a new widget for `music track` or `beat` and in `layout` tab enable `waveforms`. Then if items have waveform, the waveform is displayed. Otherwise a playing bar is displayed

Also, if all of your items do have a waveform and you want to display "top tracks" of "music artists" as "waveform sliders" instead of "table", you should edit your config_user.php and define a new constant. More info here