Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/ullenius/gbstag
:headphones: Displays info (tags) from GBS files (Game Boy Sound files)
https://github.com/ullenius/gbstag
cli gameboy gameboy-color gbs gpl3 java maven terminal
Last synced: about 1 month ago
JSON representation
:headphones: Displays info (tags) from GBS files (Game Boy Sound files)
- Host: GitHub
- URL: https://github.com/ullenius/gbstag
- Owner: ullenius
- License: gpl-3.0
- Created: 2019-08-05T18:37:57.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2022-10-30T15:12:04.000Z (about 2 years ago)
- Last Synced: 2023-03-09T07:18:10.244Z (almost 2 years ago)
- Topics: cli, gameboy, gameboy-color, gbs, gpl3, java, maven, terminal
- Language: Java
- Homepage:
- Size: 860 KB
- Stars: 2
- Watchers: 2
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: COPYING
Awesome Lists containing this project
README
# gbstag : Java GBS tag reader (Game Boy Sound Files)
[gbsTag](https://github.com/ullenius/gbstag) is a Java stand-alone command line
app for reading the tags from Game Boy music files (GBS).
GBS-files are sound files containing ripped chiptune music from Game Boy and
Game Boy Colour games. GBS stands for Game Boy Sound System.
## Usage
```sh
usage: gbstag
-v,--verbose verbose output
-V,--version print version
```
For example:
```sh
$ java -jar gbstag "/warez/gbs/dkland2.gbs"
Title : Donkey Kong Land 2
Artist(s) : Grant Kirkhope
Copyright : 1996 Rare, Nintendo
First Songs : 1
Total Songs : 28
```
## Features
* :heavy_check_mark: 100% Java (Java 11) :coffee:
* :heavy_check_mark: Supports UTF-8 encoding in the tags!
* :heavy_check_mark: Command line. Multi-platform.
* :heavy_check_mark: Batch processing using wildcards is possible! For example: `java -jar gbstag *.gbs`
## Building
This is a Maven-project.
Run:
```sh
mvn clean install assembly:single
```
to build the JAR-file. Or run the build script provided: `build.sh`
## Binaries
I've included a compiled jar-file with /lib dir to simplify for end-users who can't compile stuff on their platform.
* Download **gbstag-bin.zip**
## Development
1. I wrote this because there was a lack of tools supporting the GBS-format.
1. And it would be a fun project
Heavily based on the [SPCtag](https://github.com/ullenius/spctag) code (equivalent tool for SNES SPC-files).
Java is multi-platform and you can run and compile 20-year old Java programs without any issues. So I'd figure this would be a suitable platform for posterity.
## Changelog
* 0.1 - first release! August 2019
* 0.2 - UTF-8 support (replacing latin-1) November 2019
## Licence
GPL 3 only. See COPYING
### Libraries and copyright
* Apache Commons CLI-library - Apache Licence version 2
* Image by [Flappiefh](https://fr.wikipedia.org/wiki/Utilisateur:Flappiefh) (2013) from Wikimedia Commons. [Creative Commons Attribution-Share-Alike 3.0 Unported licence](https://creativecommons.org/licenses/by-sa/3.0/deed.en).