☰ ☓
TuxGuitar Help

Version 9.99-SNAPSHOT

# Supported file formats in TuxGuitar

Besides TuxGuitar’s own file format (with *.tg extension), TuxGuitar can work with various tablature and music file formats.

We strongly recommend that you use TuxGuitar’s own file format for your songs. The other formats may not support all features of TuxGuitar. These formats are mainly intended for exchanging files with other programs.

## Tablatures

Guitar Pro 1 and 2 (.gtp) | load
Guitar Pro 3 (.gp3) | load and export
Guitar Pro 4 (.gp4) | load and export
Guitar Pro 5 (.gp5) | load and export
Guitar Pro 6 (.gpx) | load
Guitar Pro 7 (.gp) | load
PowerTab (.ptb) | load
TablEdit (.tef) | load
LilyPond (.ly) | export

## Music and sheet

MIDI (.mid) | import (see below) and export
Scalable Vector Graphics (.svg) | export
Audio (.wav, .au, aif) | export
Lilypond (.ly) | export
MusicXML (.xml) | export
Adobe PDF (.pdf) | export
ASCII Text (.txt) | export

## MIDI file import

The feature for importing MIDI files is provided for convenience, as this file format is very common in the world of musicians. However, please bear in mind that TuxGuitar is basically a tablature editor and not a MIDI editor, so don’t expect magical results.

A MIDI file encodes sound in the form of sequential events. TuxGuitar stores, displays and plays tablatures for string instruments with frets, which is a slightly different concept. TuxGuitar performs a translation when importing a MIDI file, but manual adjustment is generally required to fine-tune the result. In some cases, where the MIDI file is not well suited for guitar or bass, this customization work may be extensive or even not feasible.

This section describes some examples of limitations (the list is not exhaustive).

### Unplayable note combinations

A pianist can play with 10 fingers simultaneously, a guitarist normally only on 6 strings at the same time. A piano chord with 10 notes can therefore not be imported completely: Some notes have to be discarded. But even with fewer notes, unplayable combinations can occur: (E2+G2) cannot be played simultaneously on a standard tuned guitar, as both notes are on the same (the lowest) string.

### Inaccurate rhythm

Some MIDI files on the Internet are recordings of musicians playing a MIDI-capable instrument (e.g. a keyboard). However, a human being is not a perfect metronome, especially if the musician brings in his or her own mood and feeling. Such interpretations can be very pleasant to listen to, but do not fit well into the very strict framework of a music score. In such a case, you should not be surprised if you find very unusual rhythm patterns in the imported files: very short notes or rests in surprising places, 7- or 11-tuplets, inconsistent tied notes, etc.

### Fingering

MIDI files do not contain any information about the number of strings or fingering. TuxGuitar tries to select a suitable number of strings and tuning preset based on the lowest and highest notes of the track, but the result is not always the best possible choice. The assignment of notes to strings is somehow arbitrary and generally looks for the lowest fret number for each note in a beat. This does not take into account the arrangement of a guitarist’s hands and fingers and can therefore lead to sub-optimal decisions in many cases. You can assume that in most cases manual editing of the imported song will be necessary.

### MIDI file types

There are two different MIDI file types:

- A type 0 file contains a single MIDI track, possibly with sounds played by different instruments.
- A type 1 file can contain one or more MIDI track(s), with one instrument per track.

Currently, TuxGuitar can import type 1 files quite correctly. Type 0 files are also correctly imported if they contain a single instrument. When importing a type 0 file with multiple instruments, TuxGuitar merges everything into a single track. This can of course lead to unwanted side effects, such as the loss of notes and/or incorrect tuning selection. In this case, you should consider converting the file to type 1 with an external MIDI application before importing it.

### Instrument range

This is probably the most critical point. Note: This section does not apply to percussion tracks.

Before importing a song, make sure that the song is suitable for guitar or bass in terms of range. Trying to import a piccolo track can lead to disastrous results as the notes are far too high for a guitar. If you can, check the note ranges in your MIDI file before you import it. Take the following into account:

- A standard tuned 6-string guitar with 24 frets can play midi notes 40 (E2) to 88 (E6).
- A standard tuned 4-string bass with 24 frets can play midi notes 28 (E1) to 67 (G4).

In practice, there is a little extra tolerance as TuxGuitar can select an alternative tuning preset to allow more notes to fit into the tablature.

A typical symptom of an inappropriate note range occurs when TuxGuitar selects an unexpected (or even unrealistic) tuning preset. Be careful, this may not be immediately visible in the tablature. Therefore, it is highly recommended to manually check the tuning of each track directly after importing. If a track is tuned with 6 identical strings, well, then something has definitely gone wrong: Fix the issue before you try to continue (see transposition below).

Another typical symptom of an incorrect note range is the loss of notes, either directly after import or when you try to change the tuning of a track. TuxGuitar will delete any notes it can’t place on a 30 frets instrument.

### Transposition

If the note range of the input file has not been adjusted, you can transpose it directly when importing the file using the corresponding dialog. Please note that the transposition is applied to all tracks in the song. If you only need to transpose one track in a multi-track song, you should split your file into several files using an external MIDI application before importing. Afterwards, you can copy/paste the tracks together again in TuxGuitar.

## MusicXML export

### Lyrics

To get the best output for lyrics, in the MusicXML export, do the following:

- Make sure the syllables, in one word, are appended with a hyphen (the '-' character).

  #### Example:

  "Halelujah" becomes "Ha- le- lu- ja". Notice the space after the hyphen, and there is no hyphen after 'ja'. This lyric will be spread over 4 notes.

## PDF Export

It is possible to fine-tune the export of PDF documents. In "Tools" menu, select "Plugins", browse to "PDF file format exporter" and click "Configure".

Default parameters are a good trade-off, but in specific context you might want to alter some parameters.