Skip to main content

MIDI to guitar tabs generator

Project description


A tool to generate guitar tabs from MIDI files

Live demo:


pip install tayuya


In [1]: from tayuya import MIDIParser

In [2]: mid = MIDIParser('sample.mid', track=0)

In [3]: mid.render_tabs()

Don't forget to set the track argument with the appropriate track number desired.

Get track numbers of all the tracks in the MIDI file

In [1]: from tayuya import MIDIParser

In [2]: mid = MIDIParser('sample.mid', track=0)

In [3]: mid.get_tracks()
{0: 'Lead Guitar',
 1: 'Rhthym Guitar Dist',
 2: 'Acoustic Guitar',
 3: 'Rhthym Guitar Clean & Dist',
 4: 'Lead Guitar Fill',
 5: 'Guitar Harmonics',



Get all notes played in the MIDI track

In [1]: mid = MIDIParser('sample.mid', track=0)

In [2]: mid.notes_played()
[{'note': 'C#5', 'time': 18},
 {'note': 'C#5', 'time': 30},
 {'note': 'B4', 'time': 26},
 {'note': 'C5', 'time': 0},
 {'note': 'C5', 'time': 28},
 {'note': 'C#5', 'time': 28},
 {'note': 'C#5', 'time': 30}]

Get key of the track

In [1]: mid = MIDIParser('sample.mid', track=0)

In [2]: mid.get_key()


Get all notes to play

You can use this example to generate all the notes to play with their string and fret positions.

In [1]: mid = MIDIParser('sample.mid', track=0)

In [2]: tabs = Tabs(notes=mid.notes_played(), key=mid.get_key())

In [3]: tabs.generate_notes(tabs.find_start())
[('C#3', 5, 4),
 ('G#3', 4, 6),
 ('C#4', 3, 6),
 ('F4', 2, 6),
 ('B2', 6, 7),
 ('D#3', 5, 6),
 ('F#3', 4, 4),
 ('B3', 3, 4),
 ('D#4', 3, 8),
 ('F#2', 6, 2)]

Each tuple here is (note, string, fret)

How it works?

Here's a brief of how it works:

  • Fetch a track from the MIDI file
  • Find all the notes played and convert from MIDI code values to music notes
  • Find a scale for the set of notes extracted
  • Find the best position to play the extracted notes using the scale detected


  • Works only for guitar solos. Implementation for determination and rendering of chords is not done yet.
  • Works only for standard tuning (E A D G B E)


  • <input type="checkbox" disabled="" /> Render tabs using Lilypond or some GUI alternative
  • <input type="checkbox" disabled="" /> Implement logic to determine and render chords
  • <input type="checkbox" disabled="" /> Better the scale detection implementation
  • <input type="checkbox" disabled="" /> Transposing
  • <input type="checkbox" disabled="" /> Add way to handle non standard tuning
  • <input type="checkbox" disabled="" /> More stringed instruments




Tayuya is made possible by following open source softwares:

The name

Tayuya (たゆや)

Project details

Download files

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

Files for tayuya, version 0.0.4
Filename, size File type Python version Upload date Hashes
Filename, size tayuya-0.0.4-py3-none-any.whl (10.0 kB) File type Wheel Python version py3 Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page