Para guardar y cargar las canciones, Pymprovisator utiliza un formato propio, muy parecido al de los archivos .ini de Windows. Una canción comienza con un encabezado [SONG] y varias líneas describiendo los distintos elementos de la canción:
[SONG] # Este es un ejemplo de canción id = ThisIsATestSong tempo = 153 n_choruses = 10 title = This is a test song key = C n_bars = 12 active_instruments = piano bass drums style = basic chords = 4c7 4f7 8c7 8f7 8c7 4g7 4f7 4c7 4g7
En el ejemplo anterior se muestran todos los elementos que componen una canción. Por convenio, las canciones para Pymprovisator se guardan con la extensión .ymp, pero puede utilizarse otra si se desea. Veamos cada uno de los elementos de una canción:
id Este elemento es un texto, sin espacios y sin signos de puntuación que identifica la canción, se utiliza principalmente al generar los archivos MIDI.
tempo Indica el tempo o velocidad de la canción. Debe ser un valor numérico entero (sin decimales) y razonable (no ponga 0 ni valores negativos).
n_choruses Indica el número de coros o veces que se reproducirá la secuencia de acordes. Debe ser un valor numérico entero mayor que 0.
title Título de la canción.
key Tonalidad de la canción. Los valores permitidos son: C, C#, Db, D, D#, Eb, E, F, F#, Gb, G, G#, Ab, A, A#, Bb, B, Cm, C#m, Dbm, Dm, D#m, Ebm, Em, Fm, F#m, Gbm, Gm, G#m, Abm, Am, A#m, Bbm y Bm
n_bars Número de compases que dura la canción. Valor numérico entero mayor que 0.
active_instruments Indica los instrumentos que se utilizarán para generar la canción (al menos uno de éstos: "piano", "bass" ó "drums" (tal cual están escritos, pero sin comillas).
style Estilo para la canción. Los siguientes estilos están definidos: swing, even_eights, jazz_waltz, waltz, five_swing, five, latin, bossa, samba, ballad, modern, funk, rock y basic. No vamos a describir cada uno de ellos: ¡sus nombres deberían ser lo suficientemente descriptivos!.
Todos los estilos se miden en compás 4/4, excepto waltz y jazz_waltz, en 3/4 y five y five_swing, que se miden en 5/4.
chords Secuencia de acordes que componen la canción, separados por espacios. Los acordes se escriben con la notación estándar del jazz, y cada uno de ellos va precedido del número de partes de compás que dura. Si sólo dura una parte, debe ponerse un 1 también.
Es muy importante que la sequencia de acordes sea coherente con el número de compases. Así, en el ejemplo anterior, tenemos 12 compases, en estilo 'basic', que es 4/4, luego nuestra secuencia de acordes debe comprender 48 partes (12x4). Comprobación: 4 + 4 + 8 + 8 + 8 + 4 + 4 + 4 + 4 = 48 partes. ¡Está bien!.