AntonioND / gbt-player

A music player library for the PSG audio channels of the GB, GBC and GBA.
MIT License
281 stars 20 forks source link
assembly assembly-language c demoscene developer-tools gameboy gameboy-advance tracker

GBT Player

Music player library and converter kit for the Game Boy family of consoles. It's available for the Game Boy Advance as a C library. It's also avaliable for Game Boy and Game Boy Color as a RGBDS <https://github.com/gbdev/rgbds> library. There is also a legacy version that uses GBDK. If you're interested in the changes introduced with each version, check the changelog <./changelog.rst>.

On GBA it is possible to use GBT Player at the same time as other players like Maxmod, check this example <./gba/examples/combined_maxmod>_.

Introduction

GBT Player is a music creation environment for GB, GBC and GBA. It is formed by:

It's the same idea as the old Lemon player for Game Boy, but greatly improved: You take a MOD file that you can edit in any tracker, convert it with a special converter to something that the Game Boy can understand, and play it there.

Because of this workflow, there are some limitations that are needed so that the MOD/S3M file and the result on the GB/GBA are similar.

As of version 4.0.0 there is a big split between the GB/GBC version and the GBA version. The GB version is stuck in version 3.X, and all the new changes are added to the GBA because it's easier to prototype new features there.

GBT Player is open source, and it is licensed under the MIT license. That means that you can use and modify it but you have to give credit for the original work. It would be nice to you tell me if you use it, anyway. :)

About

Licensed under the MIT license.

Copyright (C) 2009-2022 Antonio Niño Díaz

All rights reserved.

Email: antonio [underscore] nd [at] outlook [dot] com

Web: www.skylyrac.net

Latest version: https://github.com/AntonioND/gbt-player