{"id":13637047,"url":"https://github.com/detomon/bliplay","last_synced_at":"2025-04-11T08:42:13.535Z","repository":{"id":13119291,"uuid":"15801109","full_name":"detomon/bliplay","owner":"detomon","description":"Plaintext-based chiptune player","archived":false,"fork":false,"pushed_at":"2024-12-15T09:59:42.000Z","size":1021,"stargazers_count":23,"open_issues_count":3,"forks_count":4,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-03-25T06:12:21.604Z","etag":null,"topics":["audio","c","chiptune","chiptune-player","music","plaintext","player","sdl","sound","tracker"],"latest_commit_sha":null,"homepage":"https://play.blipkit.audio","language":"C","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/detomon.png","metadata":{"files":{"readme":"README.md","changelog":"ChangeLog","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2014-01-10T15:14:00.000Z","updated_at":"2024-12-15T09:59:47.000Z","dependencies_parsed_at":"2024-11-09T06:32:11.417Z","dependency_job_id":"4b1a84de-71c7-4173-8a14-13f62e2e896d","html_url":"https://github.com/detomon/bliplay","commit_stats":null,"previous_names":[],"tags_count":34,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/detomon%2Fbliplay","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/detomon%2Fbliplay/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/detomon%2Fbliplay/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/detomon%2Fbliplay/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/detomon","download_url":"https://codeload.github.com/detomon/bliplay/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248362457,"owners_count":21091131,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["audio","c","chiptune","chiptune-player","music","plaintext","player","sdl","sound","tracker"],"created_at":"2024-08-02T00:01:09.748Z","updated_at":"2025-04-11T08:42:13.516Z","avatar_url":"https://github.com/detomon.png","language":"C","funding_links":[],"categories":["Music","Music Sequencing"],"sub_categories":["Markup"],"readme":"# bliplay\n\n[![Build Status](https://github.com/detomon/bliplay/actions/workflows/c.yml/badge.svg?branch=master)](https://github.com/detomon/bliplay/actions/workflows/c.yml)\n\n**bliplay** is a plaintext-based chiptunes sound player.\n\nCheck out the [syntax description](SYNTAX.md). Some example files are located in [examples](examples).\n\nAlternatively, you can use the [web editor](https://play.blipkit.audio) to run your code.\n\n```blip\n% set speed\nst:18\n\n% set waveform\nw:square\n\n% set duty cycle of square wave\ndc:8\n\n% set note C on octave 5\na:c5\n\n% wait 1 step\ns:1\n\n% set note C on octave 6\na:c6\n\n% enable volume slide effect\ne:vs:9/1; v:0\n\n% wait 9 steps\ns:9\n\n% release note\nr\n```\n\n1. [Checkout](#1-checkout)\n2. [Install SDL](#2-install-sdl-optional)\n3. [Building](#3-building)\n4. [Playing Files](#4-playing-files)\n5. [Exporting Files](#5-exporting-files)\n6. [Related Projects](#6-related-projects)\n7. [Using with Docker](#7-using-with-docker)\n8. [License](#license)\n\n## 1. Checkout\n\n[BlipKit](https://github.com/detomon/BlipKit) is the core library which generates the sound.\nIt is added as a submodule.  To fetch its source, \nuse the following command when cloning the **bliplay** repository:\n\n```sh\ngit clone --recursive git@github.com:detomon/bliplay.git\n```\n\nor afterwards with:\n\n```sh\ngit submodule update --init\n```\n\n## 2. Install SDL (optional)\n\nFor simplyfing the audio output on a wide range of systems the program uses SDL (\u003chttps://www.libsdl.org\u003e).\nIf not already, you have to install it to be able to output the audio directly.\n\n## 3. Building\n\nFirst execute `autogen.sh` in the base directory to generate the build system:\n\n```sh\n./autogen.sh\n```\n\nNext execute `configure` in the base directory:\n\n```sh\n./configure\n```\n\nOr, use the `--without-sdl` option if you don't want to link against SDL. This will disable direct audio output, but it's still possible to export the audio.\n\n```sh\n./configure --without-sdl\n```\n\nThen execute `make` to build the program in the `bliplay` directory:\n\n```sh\nmake\n```\n\nYou can then run it from the bliplay directory, or install it on your system to run from anywhere.\n\n```sh\nsudo make install\n```\n\n## 4. Playing Files\n\nSome example files are located in `examples`. Use the following command to play them:\n\n```sh\nbliplay/bliplay examples/hyperion-star-racer.blip\n```\n\nFor Linux users:\nIf you associate bliplay with .blip files,\nthen the StopBlipAudio.sh script, that you'll find in the example directory,\nwill help you mute your blip tracks in a hurry.\n\n## 5. Exporting Files\n\nUse the `-o` option to render the audio to `WAV` or `RAW` files.\n\n```sh\nbliplay/bliplay -o killer-squid.wav examples/killer-squid.blip\n```\n\n## 6. Related Projects\n\n### [blipSheet](https://github.com/mgarcia-org/blipSheet)\n\nScript which uses a spreadsheet in order to render and play the files dynamically. By [@mgarcia-org](https://github.com/mgarcia-org/).\n\n### [bliplay-wasm](https://github.com/detomon/bliplay-wasm)\n\nA WebAssembly implementation of the player.\n\n## 7. Using with Docker\n\nA precompiled version can be used with Docker. There is no support for direct audio output, though.\n\nLoad/run container and mount local directory `/absolute/path/to/bliplay/examples` at container path `/examples`:\n\n```sh\ndocker run -it -v /absolute/path/to/bliplay/examples:/examples detomon/bliplay-alpine\n```\n\nRender file `examples/killer-squid.blip` to `killer-squid.wav` on local directory.\n\n```sh\n/ # bliplay -o examples/killer-squid.wav examples/killer-squid.blip\n```\n\n## License\n\nThis program is distributed under the MIT license. See `LICENSE`.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdetomon%2Fbliplay","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdetomon%2Fbliplay","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdetomon%2Fbliplay/lists"}