How to lay out JAM's and TAB's for import:
The easiest way to see this is to input a song to the app, export and observe the formatting of the generated file.
For multiple songs, a file must begin with a number, the number of songs in the file. Following that, a tag is inserted for each song:
The tag contains all the relevant information for the song, where applicable:
Songs will only be replaced/updated under three conditions:
The easiest way to see this is to input a song to the app, export and observe the formatting of the generated file.
For multiple songs, a file must begin with a number, the number of songs in the file. Following that, a tag is inserted for each song:
The tag contains all the relevant information for the song, where applicable:
- TITLE={}; place the title of the song between the brackets
- NOTES={}; place any performance notes eg. capo, playing style here
- CHORDS={}; place the chords & lyrics or tab in here
- ARTIST={}; the artist of the song
- TIMESIG={}; the time signature (ie 4/4) note: swing rhythms end with _S (ie 4/4_S)
- TUNING={}; the tuning of the instrument where applicable. (eg. E-A-D-G-B-E)
- INSTRUMENT={}; the instrument the tab is for
- DATESTAMP={}; this is the time in milliseconds the song was last saved (Android) or the date and time the song was last saved (Windows)
The tag opens with a "<" followed by TAB or JAM, depending on the song. The information is then inserted and the tag closed with a "/>". At the end of the file, "ENDOFLIST" is inserted to mark it. A sample file content would look something like:
2<TAB TITLE={GC} NOTES={afa} CHORDS={|--3------0----------------------||--3------1----------------------||--0------0----------------------||--0------2----------------------||--2------3----------------------||--3-----------------------------|} ARTIST={Mayeo} TIMESIG={4/4} TUNING={asfgsdf} INSTRUMENT={asgd} DATESTAMP={19/07/2016 15:19:31} /><JAM TITLE={dafgsnh,gs} NOTES={} CHORDS={akdfjvbs ls} ARTIST={ajdhn sdb} TIMESIG={4/4} TUNING={} INSTRUMENT={} DATESTAMP={19/07/2016 14:19:15} />ENDOFLISTSongs will only be replaced/updated under three conditions:
- The title is exactly the same as a song already in the database
- The artist is exactly the same on both songs
- The datestamp of the song being imported is more recent than the datestamp of the song in the database
If the song being imported won't update, try changing the datestamp, and make sure to use the current date and time in milliseconds for the Android version.
Comments
Post a Comment