kawa is an ffmpeg-based radio streamer.

Install the dependencies:

• ffmpeg
• rustc (stable)
• cargo (stable)

$ cargo build --release
# cargo install

Start by copying example_config.toml to the location of your choice and reading through it. Batteries are not included - kawa needs to be paired with your own software to find songs to stream. You will have to provide an external API that kawa can query for songs to play and notify as new songs being played.

Kawa provides an HTTP API for management the queue. Kawa will play songs from the queue until it is exhausted, then request new tracks from [queue].random_song_api.

Response

{ track blob }

Response

[
    {
        "mount": "stream256.opus",
        "path": "/stream256.opus?user=minus",
        "headers": [
            {
                "name": "User-Agent",
                "value": "Music Player Daemon 0.20.9"
            },
            ...
        ]
    },
    ...
]

Response

[
    { track blob },
    ...
]

Inserts a track at the top of the queue.

Request

{ track blob }

Note: track blob is an arbitrary JSON blob that Kawa will hold on to for you. At a minimum it must include "path", the path to the audio source on the filesystem. Additionally, a unique "queue_id" field will be added whenever the blob is retrieved and can be used for manipulation of the queue.

Response

{
    "success": true,
    "reason": null
}

Inserts a track at the bottom of the queue. See /queue/head.

Unqueues the track at the top of the queue.

Response

{
    "success": true,
    "reason": null
}

Unqueues the track at the bottom of the queue. See /queue/tail.

Removes all tracks from the queue.

Response

{
    "success": true,
    "reason": null
}

Immediately skips to the next track in the queue.

Response

{
    "success": true,
    "reason": null
}