Skip to main content

Read, write, and manipulate GP3, GP4 and GP5 files.

Project description


PyGuitarPro is a package to read, write and manipulate GP3, GP4 and GP5 files. Initially PyGuitarPro is a Python port of AlphaTab which is a Haxe port of TuxGuitar.

This package helps you achieve several goals you might find yourself yearning to do in a day-to-day tabber life:

  • transpose a track without messing the fingering.
  • add first string to the track without messing the fingering.
  • map percussion notes to different values.

Reading .gp* files is as easy as:

import guitarpro
curl = guitarpro.parse('Mastodon - Curl of the Burl.gp5')

Writing .gp* files isn’t that hard as well:

guitarpro.write(curl, 'Mastodon - Curl of the Burl 2.gp5')

All objects representing GP entities are hashable, so they can be easily stored in a dict and compared. This gives us the great opportunity to apply diff algorithm to tabs, or even diff3 algorithm to merge tablatures.

To anyone wanting to create their the best guitar tablature editor in Python this package will be the good thing to start with.


Several usage examples are included in the /examples folder. Please feel free to add your own examples, or improve on some of the existing ones, and then submit them via Bitbucket as a pull-request.

To run one of the examples in your local environment, simply:

$ cd pyguitarpro
$ python examples/ --help


To install PyGuitarPro download the repository and install manually by doing:

$ hg clone ssh://
$ cd pyguitarpro
$ python install


Package documentation is located at Read the Docs.


Please see the file called LICENSE.

Project details

Release history Release notifications

History Node


History Node


History Node


History Node


This version
History Node


History Node


History Node


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
PyGuitarPro-0.2.1-py2.py3-none-any.whl (95.0 kB) Copy SHA256 hash SHA256 Wheel py2.py3 Feb 10, 2017 (85.7 kB) Copy SHA256 hash SHA256 Source None Mar 30, 2014

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page