gt-extract

GoatTracker instrument extractor for SNG files.

gt-extract reads one or more GoatTracker song files (.sng) and exports every instrument as a GoatTracker instrument file (.ins).

Requirements

• Python 3.8+ (no external dependencies)

Usage

./gt-extract path/to/song1.sng path/to/song2.sng

Extracted .ins files are always written to the current working directory (the folder where you run the command), not next to the input files.

Examples

Run from project directory:

./gt-extract ../goattracker-vibed-out/examples/unleash.sng

Run from any directory (absolute path to script and input):

/path/to/gt-extract /path/to/song.sng

Output naming

Each instrument is exported as:

<song-stem>-<instrument-index>-<instrument-name>.ins

Example:

unleash-03-BD-Bass.ins

If a filename already exists, gt-extract appends -2, -3, etc. to avoid overwriting.

Supported input formats

• GTS2
• GTS3
• GTS4
• GTS5

Unsupported or invalid files return an error message and a non-zero exit code.