raplayer

The raplayer is a C-based cross-platfrom remote audio player.
It can play simple audio files or streams.

Getting Started

Coverage

Windows: Cygwin environment only tested, MSVC and MinGW does NOT supported yet.
Linux: supported.
MacOS: supported.

Prerequisites

You must pre-install the corresponding package for each OS.

Windows: cmake make gcc-core
Linux: alsa-lib-development-package(debian: libasound-dev, RHEL: alsa-lib-devel) cmake make gcc
MacOS: cmake make gcc

Optional package: ffmpeg

Building

When you run the script, cmake automatically downloads the submodule and builds the source.

chmod +x ./build.sh && ./build.sh

Running the raplayer

server mode is an audio provider mode, client mode is an audio player mode.
The raplayer can set server, client mode with one executable file.

$ ./raplayer 

Usage: ./raplayer <Running Mode>

--client: Running on client mode.
--server: Running on server mode.

Server mode

$ ./raplayer --server

Usage: ./raplayer --server [--stream] <FILE> [Port]

<FILE>: The name of the wav file to play. ("-" to receive from STDIN)
[--stream]: Allows flushing STDIN pipe when client connected. (prevent stacking buffer)
[Port]: The port on the server to which you want to open.

Client mode

$ ./raplayer --client

Usage: ./raplayer --client <Server Address> [Port]

<Server Address>: The IP or address of the server to which you want to connect.
[Port]: The port on the server to which you want to connect.

You can adjust the volume by pressing the up and down arrow keys during playback.

Usage examples

• Play the pcm_16le file.

./raplayer --server s16le.pcm

• Play audio file using ffmpeg.

ffmpeg -loglevel panic -i audio.mp3 -f s16le -ac 2 -ar 48000 -acodec pcm_s16le - | ./raplayer --server -

• Play youtube audio using ffmpeg & youtube-dl

youtube-dl --quiet -f bestaudio "[Youtube URL]" -o - | ffmpeg -loglevel panic -i pipe: -f s16le -ac 2 -ar 48000 -acodec pcm_s16le - | ./raplayer --server -

• Play audio stream using ffmpeg.

ffmpeg -loglevel panic -i http://aac.cbs.co.kr/cbs939/_definst_/cbs939.stream/playlist.m3u8 -f s16le -ac 2 -ar 48000 -acodec pcm_s16le - | ./raplayer --server --stream -

Known issues

• There is a slight difference in playback time between clients when connecting multiple clients.

License

This project is licensed under the GPLv3 License - see the LICENSE file for details.

Contributions

PR is always welcome. If you have any questions, please contact at 20sunrin022@sunrint.hs.kr.