mgarcia-org / bliplay

Plaintext-based chiptune player which uses the BlipKit library

bliplay

bliplay is a plaintext-based chiptune sound player. See the interactive player at https://play.blipkit.audio for examples and syntax description. Some example files also are located in examples.

1. Install SDL

---

For simplyfing the audio output on a wide range of systems the program uses SDL (https://www.libsdl.org). If not already, you have to install it to be able to run the program.

2. Checkout BlipKit

---

BlipKit is the core library which generates the sound. It is added as a submodule. To fetch its source, use the following command when cloning the bliplay repository:

git clone --recursive https://github.com/detomon/bliplay.git

or afterwards with:

git submodule update --init

3. Building

---

First execute autogen.sh in the base directory to generate the build system:

./autogen.sh

Next execute configure in the base directory:

./configure

Use the --without-sdl option if you don't want to link against SDL.

./configure --without-sdl

Then execute make to build the program in the bliplay directory:

make

You can then run it from the bliplay subdirectory, or install it on your system to run from anywhere.

sudo make install

4. Playing files

---

Some example files are located in examples. Use the following command to play them:

bliplay/bliplay examples/hyperion-star-racer.blip

For Linux users: If you associate bliplay with .blip files, then the StopBlipAudio.sh script, that you'll find in the example directory, will help you mute your blip tracks in a hurry.

License

This program is distributed under the MIT license. See LICENSE.