As an example of what can be done with the libventrilo3 library, we’ve created the much requested jukebox bot that will play MP3s from your music library.

It’s not installed/compiled by default, it’s definitely not stable, and the only way to get it is to compile from source (and even then it takes some effort). The jukebox plays random songs from your music directory, allows users to search for songs, has volume control, and refuses to play Creed songs on principle.

You’ll need some additional libraries to get the jukebox working: libmpg123-dev libmpg123-0 libspeexdsp-dev libspeexdsp1

After the bot logs in, enter global chat with it and type: !start

Chat Commands:

!start -- start playing music
!stop -- stop playing music
!next -- play a new random track
!move -- move to your channel
!play [song/artist/file name] -- search for a song by filename and play the first random match
!volume [0-1] -- Set the volume to the specified level: ex: !volume 0.5

Usage:

mangler-jukebox \
    -h hostname:port \
    -u username \
    [-p password] \
    [-c channelid] \
    [-v volume_multipler] \
    [-s stereo; celt only] \
    /path/to/music