Changing format version
Last updated
Last updated
Each songfile can define the txt format specification version that it follows using the VERSION tag. To learn more about a particular version, please see the official project's website.
By setting the version you can benefit from automatic validation of your songfile. Karedi will make sure it is compliant with the format rules and it will forbid you from using unsupported features. You just have to decide which version to use based on how many apps support it.
On the other hand, if you do not specify the format, this responsibility falls on you - you will have to check each tag manually and verify whether it is supported by the target apps.
If you want to set or change the current txt format version, the best way to do it is to go to the Tags -> Format version menu and choose the version to which you want to convert your songfile:
A popup will be displayed informing you about the changes that will be automatically done to the tags contents in order to make your file compliant with the chosen version, e.g.:
Red tags will be removed, green will be added. Yellow tags will have their values edited (gray shows the original value).
This pop-up is purely informational, you can either accept all proposed changes or cancel the whole operation.
Alternatively, you can just set the version using Add new tag option:
All currently supported versions will be suggested in the value field. If you choose one of the supported versions, Karedi will use its specification to validate your song and search for any issues, for example:
It will not modify your song in any way (besides adding the VERSION tag).
If you go to Tags -> Format Version menu and choose "None" option, you will clear the current version. In practice, it will just remove the #VERSION tag.
From now on Karedi will allow you to use all features and it will just perform sanity checks to make sure you use the tags in the generally expected way, instead of the full-fledged validation.
