Table of Contents
List of Tables
Table of Contents
Everybody is using MP3s these day. These can be created from CD or downloaded off the Internet, however often these do not contain the correct information to identify and playback the song, problems include missing album names and misspelled titles, and different spellings for the same artis, information such as artist, album, title and track numbers is known as metadata, and it is stored within your mp3s in a tag. Correcting these mistakes by hand is time consuming and inaccurate
Jaikoz has been designed for managing large music collections, it can load 10,000 records at a time without a problem. Jaikoz uses an online database of information on more than 5 million songs, this database is called MusicBrainz. This is a community based database with contributions by over 200,000 people, a system of moderation ensures the data is extremely accurate. Additionally many of these songs have associated Acoustic Ids provided by MusicIP, allowing a song to be identified by the actual music, so it do a match even if you have no metadata ! Jaikoz allows to lookup your songs by both the acoustic id and the metadata making it very accurate, nothing has to be done by you so you can go away and do something else more interesting. Jaikoz provides easy access to look up your matching Song on MusicBrainz using your default web browser.
But no system is 100% accurate so we have made it as quick and easy as possible to edit your data manually as well. Jaikoz uses a spreadsheet view to allow you to edit information much quicker than other applications and provides many autoformatting tasks which do most of the work for you. For example it compares your MP3s to each other and using this information it can correct missing information and spelling mistakes, we know of no other tagger that does this ! Jaikoz can extract information from a filename into the tag without you having to specify the format for the filename. Some applications hide multi-complex fields away but Jaikoz allows you to access the first field of every one from the main view. For example if you have an album cover tag in one mp3 and you want to copy it to other mp3s just copy and paste it. Jaikoz provides access to many more fields than just the popular ones like artist and album, in fact you can modify ninety fields such Official Artist Web Page or ISRC code and Play Counter. Jaikoz also provides a split screen view letting you view the the original file(s) and the changes you have made at the same time
Jaikoz transparently supports tagging of MP3 files with ID3v1,ID3v2,ID3v2.2,ID3v2.3 and ID3v2.4 tags, and allows easy conversion between them. Many Music Players only support certain tag versions and this often a cause of confusion for users
Jaikoz is written in Java this means you can use it on Windows, UNIX and,Mac OS X, and it woreks the same way on each.
Acoustic matching using MusicBrainz and MusicIP to match tracks based on the actual music
MetaData matching using MusicBrainz to match tracks from the metadata in your files
Rename your files and folders based on your tag metadata
Intelligent FileName to Tagger can extract information from the filename into the tag without having to know the format of the field
Intelligent AutoMatch compares different Audio files and finds field matches and then allows all similar fields to be formatted the same.
Intelligent AutoFormat provides automatic capitalization, conversion of special words and removal of invalid and punctuation characters.
Designed to allow tagging of large number of audio files
The innovative spreadsheet view allows easy editing of all fields.
Provides full support of all text fields and partial support of all other fields
Automatically keeps v1 and v2 tags synchronised
Split screen view allows you to view the data before and after modifications at same time,view are automatically synchronised with each other.
Full Unicode support allow any character from any language to be used
Easy conversion of tags between version.
Displays what is actually contained in the tag allowing the user full control
Table of Contents
This section explains platform requirements and installation procedures. It also provides instructions on how to obtain and apply a Jaikoz license, how to perform upgrades and uninstall Jaikoz if required.
The Minimum run-time requirements are a Computer with 256MB of RAM and 10MB free disk space
To use Jaikoz you must have the Java Runtime Environment (JRE) installed version 1.5 or later.
Download the Jaikoz.bin file from the Website
Open a XTerminal Window and login as root
Run ./Jaikoz.bin and follow the instructions
Creating shortcuts in the default /usr/bin location will make Jaikoz available to all users
Installation is now complete
You may want create shortcuts on the defaults user desktop, to do this create a launcher for Jaikoz (Default location /opt/jaikoz/Jaikoz
You can start Jaikoz using /usr/bin/Jaikoz. Alternatively you can start Jaikoz with /usr/bin/jaikoz.sh
You can create links on your desktop for both these programs
If everything is ok there will be a short delay whilst Jaikoz initialises and then it should start. If you have not yet installed your license, you will see this dialog


Select Path to Open a File Dialog and find the license file that you should have recieved by email (license.jai) and select Open. Then select OK to verify the license.
If the license is verified Jaikoz will start
This section discusses problems starting Jaikoz due to problems with your Java configuration
bash: java: No such file or directory.
There is a problem with your JRE Installation. Please ensure that Java is installed and can be found in your path
Unable to load helpset
There is a problem with your JRE Installation. Please ensure that Java is installed and can be found in your path
If you start Jaikoz and it cannot find your license you will see this dialog

Select Path to Open a File Dialog and find the license file that you should have recieved by email (license.jai) and select Open. Then select OK to verify the license.
If the license is verified Jaikoz will start
If you start Jaikoz and your trial license has expired you will see this dialog

The trial license is supplied at no cost for a period of 30 days from date of issue. Thereafter, the application is disabled and a permanent license must be purchased in order to use the application.
If you wish to purchase a license go to the Website and purchase, then install in the usual way
Select Path to Open a File Dialog and find the license file that you should have recieved by email (license.jai) and select Open. Then select OK to verify the license.
If the license is verified Jaikoz will start
If you start Jaikoz and there is a problem with your license you will see this dialog

Your license has been corrupted,retrieve the original license and reinstall it in the usual way
Select Path to Open a File Dialog and find the license file that you should have recieved by email (license.jai) and select Open. Then select OK to verify the license.
If the license is verified Jaikoz will start
Run the uninstall provided program with your OS. If you wish to completely remove the application folder and any work saved in it, you will have to delete this folder manually.
Warning this section is for experienced users of Java only
The following parameters effect Jaikozes memory usage
-Xms64m -Xmx256m
The -Xms64m parameter specifies how much memory in megabytes (64) to allocate for storing data (such as the Audio Files Tagging Information) when you start Jaikoz, the -Xmx256 (256 megabytes) parameter sets the maximum memory allowed to be allocated.
If you are attempting to load many audio files (more than 10000) you may get a warning that memory is low, by increasing the value of -Xms you will be able to load larger amount of files if you require it. However trying to load too many files may place too high a CPU load on your computer could severely effect performance.
If you are using Jaikoz.bin you need to modify the value of lax.nl.java.option.java.heap.size.max in Jaikoz.lax, if you are using Jaikoz.sh , edit the shell script directly.
Table of Contents
Select the File/Open Folder Menu Item to select files to load in Jaikoz, by default subfolders will also be loaded.Your files will start to load into Jaikoz. If Jaikoz estimates it will take a while an indication will be given of how many files it expects to load, you can halt the file loading by selecting Cancel.
Select the AutoCorrect button (the large green tick), this will perform a number of local corrections such as removing whitespace and correcting capitalization. This is very quick and will improve the accuracy of a subsequent MusicBrainz match
Then create acoustic ids for your files. Select the MusicIP Button to get Jaikoz to create an Acoustic id for each track which can be used to match the track. This step takes significantly longer ( about 5 seconds per track), however the created acoustic is saved with your track and never needs to be recalculated again. You can skip this step if you like but matches will be less accurate.
Now find a match using the online MusicBrainz database. Select the Correct from MusicBrainz button (left arrow) to get Jaikoz to look up the tracks from the database. If you previously created an acoustic id this will be matched first, and then if there is no match your tracks metadata will be used, if no acoustic id was created only your metadata will be matched, matches take about a second per track.
Once it has completed you can check the results and make any manual changes by editing the data directly
When you are happy with the result select the File/Save Changes Menu to save your files.
Additionally you can select the Submit to MusicBrainz button (right arrow) to submit records where a match as been made between an Acoustic Id and a MusicBrainz Unique id. By doing this you help to make MusicBrainz even more accurate and comprehensive. But you should only do this if you are happy that the match is correct, and you shouldnt do this for the same track moree than once.
In the example above the tasks were performed on all files, but you can also select rows in the row header, and using the popup run any task on only the selected rows
This section explains the Main Jaikoz Window, and the visible components of Jaikoz.


This section explains the terminology used within Jaikoz and the main components of Jaikoz
MP3 is a audio format, which compresses music files to a small size making them suitable for storing on a computer.
Metadata is the termfor any information about a music file other then the music file itself.
ID3v1 is the original format which is very basic but supports many applications . It comes in two flavours ID3v1.0 and ID3v1.1.
ID3v2 is a newer more advanced format which allows over 100 different types of information to be stored. It comes in three versions ID3v2.2,ID3v2.3 and ID3v2.4. ID3v2 is not supported by all applications and some applications only support a particular version.
Unicode is a way of specifying characters, it supports almost every language in the world.
Popup Window is a new window seperate to the main application window
By default Jaikoz shows an Edit Panel and a Console Panel but you can also show a View Panel by selecting the View/Show View Pane menu item. Then the screen is split horizontally between the View and Edit Panels, you can adjust the proportion of the sceen taken up by each Panel by adjusting the separator up and down. The View and Edit Panels contain tabs
You can view the contents of a tab using the vertical and horizontal scroll bars
Each tab consists of a table which holds audio information.
Fields store the data within a column and refers to particular information such as Artist or Album
Values are what are stored by a field such as the 'Artist' field may contain the value 'The MisVitals'. Some fields can have multiple values for example the Genre field may contain two values such as 'Rock' and 'Pop'
Attributes make up parts of the value. Most values have only one attribute, but some values have multiple attributes, for example an attached picture has the image itself, an image name and an image type
The View Panel displays tagging information as it currently exists in the saved file
The Merged Tab merges the v1 and V2 tags. If a V2 field exists (and is not empty) it is displayed, if it is empty or does not exist and there is an equivalent v1 tag this value will be displayed. If it not contain either fields it will be shown as missing.
The V2 Tab contains the contents of the ID3v2 tag, if a file contains more than one ID3v2 tag the latest one will be displayed
The MPEG Tab contains MP3 specific information about the music file
The Edit Panel contains a single tab the Edit Tab . Because the Edit Panel only contains the one Edit Tab we use the terms interchangably in this help document. This starts with the same information as the Merged Tab, but it is here you can edit the tag information
Selectable Combo is a drop down list where you can select a value
Editable Combo is a drop down list where you can select a value or enter a value not in the list
Multi Field Count Fields which support multi value fields have a row count specifying how may values a field contains, clicking on the multifield count will show up a PopupWindow showing all the values held in a field.
The Console Panel summarizes tasks you have done, plus any problems encountered. Everything written to the Console Panel, also gets written to the User Log, and everything will always be written to the User Log even if the Console Panel is not displayed.
The user log is stored in your installation folder, the latest log is called jaikozuser-0-0.log, as it get larger it will be renamed jaikozuser0-1.log, and an empty jaikozuser0-0.log will be created. There is also a jaikozdebug-0-0.log that contains additional information useful to us if you have a support query with Jaikoz.
Jaikoz has been designed to allow you to do your editing as quickly and easily as possible. Is it particulary good if you have a large music collection and have ever used other tagger then you will find time spent using Jaikoz well spent.
PopWindows have been limited. Popup Windows are slow and cumbersome,Jaikoz allows you to edit 99% of the time directly within the Edit panel, popups are only used for editing multiple values for a field.
Generous type checking. Jaikoz does not impose unnecessary restrictions on your editing
Intelligent AutoFixing if you enter an invalid value Jaikoz tries to convert the value to an allowable value, if it cannot the value is left unchanged. This is much more user firendly then bringing up popup window errors
Keyboard and Mouse traversal are provided with many short cut keys available to perform common tasks.
If you click on a column you can sort it in ascending order, click on it again and it will be sorted in descending order. if you click on the Row Number column the records will be sorted by row number this will be the same order as when they were originally loaded into Jaikoz
The size of a column can be increased or decreased by selecting the right hand side of the column and dragging it inwards or outwards
Jaikoz automatically synchronises the View Panel and the Edit Panel. For example if you scroll the EditPanel to the right-hand-side, the currently displayed view tab will also be scrolled to the right-hand-side.This is a very powerful feature but you can disable it if you wish, it is also quite computationally intensive
Synchronise row sorting between rows When rows are sorted in one view they will be sorted in all other views
Synchronise column sorting between rows When the column order is changed in one view they will be changed in other views
Synchronise column resizing between rows When the column order is resized in one view they will be resized in other views
Synchronise horizontal scrolling between rows When scrolling through the columns in one view they will be scrolled in other views
Synchronise vertical scrolling between rows When scrolling through the rows in one view they will be scrolled in other views
The keyboard can be used to perform most functions
Table 3.1. General Keyboard Actions
| Key | Task |
|---|---|
| Tab | Move to next field,button,table.. |
| Shift+Tab | Move to previous field,button,table... |
| Cntrl+Tab | Move to next field,button when inside a table |
| Alt | Go to Main Menu |
| Spacebar | Select/Deselect checkbox or radio button |
Table 3.2. Main Menu Actions
| Key | Task |
|---|---|
| Alt | Go to Main Menu |
| Right Arrow | Go to next Menu |
| Left Arrow | Go to previous Menu |
| Up Arrow | Scroll down Menu items in Menu |
| Down Arrow | Scroll up Menu items in Menu |
| Enter | Run selected Menu item |
| Esc | Close Main Menu |
Table 3.3. Table Keyboard Actions
| Key | Task |
|---|---|
| Esc | Return field prior to editing |
| Enter | Start Editing current field |
| Cntrl+C | Copy information in selected field into clipboard |
| Cntrl+V | Paste first value from clipboard into selected field(s) |
| Shift+V | Paste all value from clipboard into selected field(s) |
| Cntrl+D | Delete selected field |
| Cntrl+J | For multiple value fields open the associated Popup Window |
| Tab | Move to next field |
| Right Arrow | Move to next field |
| Shift+Tab | Move to previous field |
| Left Arrow | Move to previous field |
| Home | Move to first field in row |
| End | Move to last field in row |
| Cntrl+Home | Move to first field in table |
| Cntrl+End | Move to last field in table |
| Cntrl+A | Select all fields in table |
| Shift+Up/Down | Extend selection one row |
Table 3.4. Shortcut keys for Main Menu
| Key | Task |
|---|---|
| F1 | Auto Correct |
| F2 | AutoCorrect the Artist Column |
| F3 | AutoCorrect the Album Column |
| F4 | AutoCorrect the Title Column |
| F5 | AutoCorrec the Genre Column |
| F6 | AutoCorrect theTrack No Column |
| F7 | AutoCorrect the Comments Column |
| F8 | AutoCorrect the Recording Time Column |
| F9 | AutoCorrect the SubFolder from Tag |
| F10 | AutoCorrect the Filename from Tag |
| F11 | AutoCorrect Tags from Filename |
| Cntrl+F1 | AutoCorrecter Settings |
| Cntrl+F2 | Artist Autocorrect Settings |
| Cntrl+F3 | Album Autocorrect Settings |
| Cntrl+F4 | Title Autocorrect Settings |
| Cntrl+F5 | Genre Autocorrect Settings |
| Cntrl+F6 | Track No Autocorrect Settings |
| Cntrl+F7 | Comments Autocorrect Settings |
| Cntrl+F8 | Recording Time Autocorrect Settings |
| Cntrl+F9 | Sub Folder Autocorrect Settings |
| Cntrl+F10 | Filename Autocorrect Settings |
| Cntrl+F11 | Tags from filename Settings |
Table 3.5. Shortcut keys for Row Header
| Key | Task |
|---|---|
| Alt+F1 | Auto Correct selected rows |
| Alt+F2 | AutoCorrect the Artist Column for selected rows |
| Alt+F3 | AutoCorrect the Album Column for selected rows |
| Alt+F4 | AutoCorrect the Title Column for selected rows |
| Alt+F5 | AutoCorrec the Genre Column for selected rows |
| Alt+F6 | AutoCorrect theTrack No Column for selected rows |
| Alt+F7 | AutoCorrect the Comments Column for selected rows |
| Alt+F8 | AutoCorrect the Recording Time Column for selected rows |
| Alt+F9 | AutoCorrect the SubFolder from Tag for selected rows |
| Alt+F10 | AutoCorrect the Filename from Tag for selected rows |
| Alt+F11 | AutoCorrect Tags from Filename for selected rows |
| Alt+F12 | Delete selected rows |
| Cntrl+F12 | UnDelete selected rows |
| Alt+P | Pass selected rows to External App |
| Alt+S | Save changes to selected rows |
Table of Contents
Fields are displayed in a view akin to a spreadsheet. If a field does not exist its background will be coloured the Missing Colour . If it does exist then it then the background will be white. If there is any whitespace at the start or the end of the value it will be coloured the Whitespace Colour. This is very useful for identifying white space at the end of a field,if you have ever wondered why two field that appear to have the same value are not listed together in an Audio Player it is probably because one contains white space or undisplayable characters. If the field exists but is empty then the whole field will just be white.
Within the Edit Panel you can edit a value by simply clicking on it and entering the new information. After leaving the field it will perform Auto Fixing if necessary, if the value is invalid it will revert back to original value.Once you edit a field its colour will change to Change Colour, if you change it back to its original value it will no longer be changed colour.Most fields are simple text fields but some provide a Selectable Combo or an Editable Combo providing a list of valid values. Some fields allow multiple values in this case Multi Field Count will display showing the current number of records, double clicking on this will open a Popup Window to allow you to add additional values. Some of these fields have multiple parts that can also be edited here.
Displaying the View panel is useful to allow you to compare modified values with the original values, no changes will actually be made to the file until you select 'Save Changes'
Jaikoz supports the full Unicode character set, this means you can enter text in any language you wish. Whether you can do this directly from your keyboard depend on your keyboard settings and your operating system type and settings. If you cannot enter a character directly you can use the Unicode notation using the form /uXXXX,once you have finished editing the field it will display the value as a character. The full Unicode specification can be found here


After exiting the field Jaikoz will show its displayed value


Fields from a single column can be copied from any of the tabs and pasted into one or more fields in the Edit Panel if all the fields to be pasted to accept the copied fields as valid
Select field(s) to copy


Select fields to paste into


Thats it!


You can only select a fields froma single column to be copied at any time, if you select fields from more than one column the copy will not take place.
Select some fields to paste into and select Paste provided all fields accept the copied value the paste will take place.If the field to be copied has multiple values only the first value will be pasted to the paste fields. If the paste area is larger than the copy area, the copied fields will be cycled through again to populate the required paste area. For example you can copy data from the Artist field to the Album field but not to an Attached Picture field because it wouldnt make any sense. In some cases the data is automatically formatted so it is valid for the pasted field, this is known as Auto Fixing. For example if you paste a value from an Artist field to the Filename field it appends the (MP3) suffix to the filename and checks that you have not already loaded a file with the same filename.
You can delete a field, this is different to setting the field to empty, the field will no longer exist in the Audio File after saving changes
You can delete the whole Audio Record. You are most likely to do this if you find you have duplicate files of the same recording.
Jaikoz checks any data you have entered to check it is valid, if it is not valid it will try to fix it, if it can not it will revert it back to its original value. This is known as AutoFixing, at first it may seem confusing that the value displayed in the field after editing is different to the value you entered but it cuts down on annoying warning and error messages that you get with most applications
Table of Contents
Auto Correction allows your metadata to be corrected without you manually editing the changes. This is a much quicker and more accurate way of sorting out your music. Jaikoz can perform 'Local Correct' which does not require Internet Access, and is very quick but can only work with the metadata that you already have in your files. Jaikoz can do 'Musicbrainz/MusicIP Correct' which uses the MusicBrainz/MusicIP database to perform matches, this is much more accurate but takes longer. 'File and Folder Correct' is another form of Local Correct that modifies your folder and filenames, rather than just your metadata. The 'Autocorrecter' allows you to batch up a number of these tasks into a single task. Usually you would use all these methods to clean up your Music library
MusicBrainz is an online database of information on more than 5 million songs. This is a community based database with contributions by over 200,000 people, a system of moderation ensures the data is extremely accurate. Additionally many of these songs have associated Acoustic Ids provided by MusicIP, allowing a song to be identified by the actual music, so it can do a match even if you have no metadata. MusicIP also provides an online database and a number of Music Mixing and Music Identification services. This is the very latest technology and is much more powerful than other systems that only allow a match by metadata, or only match album by album instead of uniquely per track.
Jaikoz allows to lookup your songs by both the acoustic id and the metadata making it very accurate, nothing has to be done by you so you can go away and do something else more interesting Jaikoz can calculate acoustic ids for most audio tracks and then contact the MusicBrainz Server to find matching tracks and meta-data. Sometimes multiple tracks may be returned but unlike other systems Jaikoz can use its its AutoMatch algorithm to determine which is the correct match in most cases. It does this by comparing the meta-data in the records returned from MusicBrainz with the record it is trying to match. As a user this means you can run Jaikoz against MusicBrainz and the corrections will be done without any additional intervention required from yourself. This is very useful because the creation of Acoustic ids and lookup in the MusicBrainz Database can take a while if you want to correct may files so is best run unattended for a large number of files. If a match is found Jaikoz will always write a record to the Unique File identifier which provides a link back to the Music Brainz Website , it also writes records to the User Defined Text Information identifying the Acoustic Id (Puid), Artist Id, Album Id and AmazonId if available. The artist,album,title,time and track number will also be added if they do not exist, or if they are allowed to be overwritten based on your AutoMatch Settings.