https://github.com/vipul-sharma20/tayuya
Python library to generate guitar tabs from MIDI files
https://github.com/vipul-sharma20/tayuya
guitar-tabs midi midi-parser python python3
Last synced: 18 days ago
JSON representation
Python library to generate guitar tabs from MIDI files
- Host: GitHub
- URL: https://github.com/vipul-sharma20/tayuya
- Owner: vipul-sharma20
- License: mit
- Created: 2019-09-14T11:52:52.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2019-10-13T10:26:18.000Z (over 5 years ago)
- Last Synced: 2025-04-10T14:46:53.465Z (19 days ago)
- Topics: guitar-tabs, midi, midi-parser, python, python3
- Language: Python
- Homepage:
- Size: 19.5 KB
- Stars: 81
- Watchers: 5
- Forks: 9
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
# Tayuya
Python library to generate guitar tabs from MIDI files
# Installation
```bash
# Install globaly
$ pip install tayuya
# Install only for the current user
$ pip install --user tayuya
```
# Usage
```python
>>> from tayuya import MIDIParser
>>> mid = MIDIParser('sample.mid', track=0)
>>> print(mid.render_tabs())
```
```
E-------------14--------------------------16--14----------14--------------
A-------------------------------------------------17--17------16--17--16--
D-16------16------16--16--16--16------16----------------------------------
G-----18--------------------------18--------------------------------------
B-------------------------------------------------------------------------
E-------------------------------------------------------------------------
```
***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
```python
>>> from tayuya import MIDIParser
>>> mid = MIDIParser('sample.mid', track=0)
>>> 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',
```
# Advanced
## MIDI
### Get all notes played in the MIDI track
```python
>>> mid = MIDIParser('sample.mid', track=0)
>>> 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
```python
>>> mid = MIDIParser('sample.mid', track=0)
>>> mid.get_key()
```
## Tabs
### Get all notes to play
You can use this example to generate all the notes to play with their string
and fret positions.
```python
>>> mid = MIDIParser('sample.mid', track=0)
>>> tabs = Tabs(notes=mid.notes_played(), key=mid.get_key())
>>> 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
# Limitations
* 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)
# Todo
- [ ] Render tabs using Lilypond or some GUI alternative
- [ ] Implement logic to determine and render chords
- [ ] Better the scale detection implementation
- [ ] Transposing
- [ ] Add way to handle non standard tuning
- [ ] More stringed instruments
# License
[MIT](https://github.com/vipul-sharma20/tayuya/blob/master/)
# Credits
Tayuya is made possible by following open source softwares:
* [Mido](https://github.com/mido/mido)
* [Music21](https://github.com/cuthbertLab/music21)
# The name
[Tayuya](https://naruto.fandom.com/wiki/Tayuya) (たゆや)