https://github.com/antoniond/gbt-player

A music player library for the PSG audio channels of the GB, GBC and GBA.
https://github.com/antoniond/gbt-player

assembly assembly-language c demoscene developer-tools gameboy gameboy-advance tracker

Last synced: 6 days ago
JSON representation

A music player library for the PSG audio channels of the GB, GBC and GBA.

• Host: GitHub
• URL: https://github.com/antoniond/gbt-player
• Owner: AntonioND
• License: mit
• Created: 2014-04-30T23:20:26.000Z (over 10 years ago)
• Default Branch: master
• Last Pushed: 2023-04-24T12:17:00.000Z (over 1 year ago)
• Last Synced: 2024-12-19T10:09:29.874Z (12 days ago)
• Topics: assembly, assembly-language, c, demoscene, developer-tools, gameboy, gameboy-advance, tracker
• Language: C
• Homepage:
• Size: 728 KB
• Stars: 284
• Watchers: 17
• Forks: 20
• Open Issues: 3
• Metadata Files:
  • Readme: readme.rst
  • Changelog: changelog.rst
  • License: LICENSE

Awesome Lists containing this project

README

        
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 `_ 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:

- **GBT Player**: Library to play GBT format on GB, GBC or GBA.

- **s3m2gbt**: Converts S3M files into GBT (GameBoy Tracker) format.

- **mod2gbt**: Converts legacy MOD files into GBT (GameBoy Tracker) format.

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.

- For GBA, the code is just in C, and it doesn't depend on any library apart from

  a few standard library headers.

- For GB/GBC, there is source code for **RGBDS**, the main option for Game Boy

  development (in my opinion). There is also legacy code for an old version that

  also supported **GBDK**, but it's mostly unmaintained. Note that there is no

  S3M support for GB/GBC, only for GBA.

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