dart_gp_tab_reader 0.1.0

Pure-Dart, read-only reader for Guitar Pro tablature files (GP3, GP4, GP5). Parses the binary format into a Song > Track > Measure > Voice > Beat > Note tree.

dart_gp_tab_reader

A pure-Dart, read-only reader for Guitar Pro tablature files — GP3, GP4 and GP5.

This is a Dart port of PyGuitarPro by Sviatoslav Abakumov, which is itself a port of AlphaTab / TuxGuitar. The binary format parsing logic mirrors PyGuitarPro closely.

The newer GP6/GP7 (.gpx / .gp) zip-based formats are not supported — they are out of scope of PyGuitarPro as well.

Usage

import 'dart:io';
import 'package:dart_gp_tab_reader/dart_gp_tab_reader.dart';

void main() {
  final bytes = File('song.gp5').readAsBytesSync();
  final Song song = parseGp(bytes);

  print('${song.title} — ${song.artist} @ ${song.tempo} bpm');
  for (final track in song.tracks) {
    print('Track: ${track.name} (${track.strings.length} strings)');
  }
}

See example/example.dart for a runnable version.

The returned Song is a tree of Track → Measure → Voice → Beat → Note. Durations are expressed in ticks (Duration.quarterTime == 960 per quarter note); convert to seconds against Song.tempo if you need wall-clock timing.

License

Because this is a derivative of PyGuitarPro, it is distributed under the GNU LGPL-3.0 (see LICENSE). It is intentionally kept as a separate package: an application may depend on it (e.g. via a normal pub dependency) without the LGPL extending to the application's own proprietary code, as long as this package's source remains available and replaceable.

Original work © Sviatoslav Abakumov and the PyGuitarPro contributors.

Trademark notice

"Guitar Pro" is a registered trademark of Arobas Music. This project is an independent, unofficial reader for the Guitar Pro file format and is not affiliated with, endorsed by, or sponsored by Arobas Music. The name is used only descriptively to identify the supported file format.