Table of Contents
- 1. Introduction
- 2. Installation and Startup
- 3. GettingStarted
- 4. Viewing Data
- 5. Editing Data Manually
- 6. Correcting Data Automatically
-
- 1. Remote Correct
-
- 1.1. What are MusicBrainz and MusicIP?
- 1.2. How Does Jaikoz Use MusicBrainz and MusicIP?
- 1.3. Retrieve Acoustic Ids
- 1.4. Autocorrect Tags from MusicBrainz
- 1.5. ManualCorrect Tags from MusicBrainz
- 1.6. ManualCorrect Tags from MusicBrainz
- 1.7. Cluster Albums
- 1.8. Correct Lyrics
- 1.9. Update Tags from Existing MusicBrainz Id
- 1.10. Submissions to MusicBrainz
- 2. Local Correct
- 3. File and Folder Correct
- 4. Delete Duplicates
- 5. Auto Correcter
- 7. ITunes
- 8. Data Fields
-
- 1. Metadata Fields
-
- 1.1. Jaikoz Fields
- 1.2. File Location Fields
- 1.3. Metadata Fields
-
- 1.3.1. Artist
- 1.3.2. Album
- 1.3.3. Track No
- 1.3.4. Title
- 1.3.5. Genre
- 1.3.6. Year
- 1.3.7. Comment
- 1.3.8. Album Artist (Accompanient)
- 1.3.9. Composer
- 1.3.10. ArtWork
- 1.3.11. Grouping
- 1.3.12. Disc No (Part of a Set)
- 1.3.13. BPM (beats per minute)
- 1.3.14. MusicBrainz Artist Id
- 1.3.15. MusicBrainz Release Id
- 1.3.16. MusicBrainz Release Artist Id
- 1.3.17. MusicBrainz Unique Id
- 1.3.18. MusicBrainz Disc Id
- 1.3.19. MusicIP Id
- 1.3.20. Amazon Id
- 1.3.21. Release Status
- 1.3.22. Release Type
- 1.3.23. Release Country
- 1.3.24. Lyrics
- 1.3.25. Is Compilation
- 1.3.26. Sort Artist
- 1.3.27. Sort Album Artist
- 1.3.28. Sort Album
- 1.3.29. Sort Title
- 1.3.30. Sort Composer
- 1.3.31. Encoder
- 1.3.32. ISRC
- 1.3.33. Label
- 1.3.34. Barcode of the release
- 1.3.35. Catalog No
- 1.3.36. Media
- 1.3.37. Mood
- 1.3.38. Lyricist
- 1.3.39. Conductor of the music.
- 1.3.40. Remixer
- 1.3.41. Release Discogs Url
- 1.3.42. Release Wikipedia Url
- 1.3.43. Release Official Url
- 1.3.44. Artist Discogs Url
- 1.3.45. Artist Wikipedia Url
- 1.3.46. Artist Official Url
- 1.4. Audio Fields
- 2. ID3 Fields
-
- 2.1. ID3 Fields
-
- 2.1.1. Unique File Identifier
- 2.1.2. Artist
- 2.1.3. Album
- 2.1.4. Title
- 2.1.5. Track No
- 2.1.6. Cover Art
- 2.1.7. Genre
- 2.1.8. Year
- 2.1.9. Comment
- 2.1.10. User Defined URL
- 2.1.11. User Defined Text Information
- 2.1.12. Composer
- 2.1.13. Copyright Info
- 2.1.14. Encode By
- 2.1.15. Original Artist
- 2.1.16. BPM (beats per minute)
- 2.1.17. Encoding Time
- 2.1.18. Playlist Delay
- 2.1.19. Original Release Time
- 2.1.20. Release time
- 2.1.21. Tagging Time
- 2.1.22. Lyricist
- 2.1.23. File Type
- 2.1.24. Involved People List
- 2.1.25. Grouping
- 2.1.26. Title/Songname/Content Description
- 2.1.27. Initial Key
- 2.1.28. Language(s)
- 2.1.29. Length
- 2.1.30. Musician Credits List
- 2.1.31. Media Type
- 2.1.32. Mood
- 2.1.33. Original Album/Movie/Show Title
- 2.1.34. Original Filename
- 2.1.35. Original Lyricist(s)
- 2.1.36. File Owner/Licensee
- 2.1.37. Album Artist (Accompanient)
- 2.1.38. Conductor/Performer refinement
- 2.1.39. Remixed
- 2.1.40. Disc No (Part of a Set)
- 2.1.41. Produced Notice
- 2.1.42. Publisher
- 2.1.43. Internet Radio Station Name
- 2.1.44. Internet Radio Station Owner
- 2.1.45. Sort Album
- 2.1.46. Sort Artist
- 2.1.47. Sort Title
- 2.1.48. ISRC
- 2.1.49. Encoding Settings
- 2.1.50. Set Subtitle
- 2.1.51. URL: Commercial Information
- 2.1.52. URL: Copyright/Legal Information
- 2.1.53. URL: Official Song Web Page
- 2.1.54. URL: Official Artist Web Page
- 2.1.55. URL: Official Audio Source Web Page
- 2.1.56. URL: Official Internet Radio Web Page
- 2.1.57. URL: Payment
- 2.1.58. URL: Publishers Official Web Page
- 2.1.59. Play Counter
- 2.2. ID3 Extended Fields
- 2.3. Tag Field Groups
- 2.4. Data Formats common to multiple Fields
- 2.5. ID3 Tag Compatability
- 3. Ogg Vorbis Fields
- 4. Mp4 Fields
- 5. Flac Fields
- 9. Menus
-
- 1. Main Menu
-
- 1.1. Jaikoz
- 1.2. File
- 1.3. Edit
-
- 1.3.1. Copy from View Pane
- 1.3.2. Copy from Edit Pane
- 1.3.3. Paste
- 1.3.4. Paste All Values
- 1.3.5. Paste to Start
- 1.3.6. Paste to End
- 1.3.7. Remove Whitespace
- 1.3.8. Remove Widespace
- 1.3.9. Delete
- 1.3.10. Find and Replace
- 1.3.11. Swap Columns...
-
- 1.3.11.1. Swap Artist with Album
- 1.3.11.2. Swap Artist with Title
- 1.3.11.3. Swap Artist with Track No
- 1.3.11.4. Swap Artist with Comment
- 1.3.11.5. Swap Album with Title
- 1.3.11.6. Swap Album with Track No
- 1.3.11.7. Swap Album with Comment
- 1.3.11.8. Swap Title with Track No
- 1.3.11.9. Swap Track No with Comment
- 1.3.11.10. Swap Title with Comment
- 1.3.12. Swap
- 1.3.13. Prepend to Left
- 1.3.14. Prepend to Right
- 1.3.15. Renumber Track Nos
- 1.4. View
- 1.5. Action
- 1.6. Filters
- 1.7. Reports
- 1.8. Help
- 2. Preferences
- 3. Popup Menu
- 10. Keyboard Traversal
List of Tables
- 4.1. Colour Coding
- 8.1. Not Supported Fields
- 8.2. ID3v1 Fields
- 10.1. General Keyboard Actions
- 10.2. Main Menu Actions
- 10.3. Table Keyboard Actions
- 10.4. Shortcut keys for Main Menu
- 10.5. Shortcut keys for Row Header
Table of Contents
Are you fustrated by missing information in your audio files? Are you unable to play back your favourite tracks? Maybe you are a recording artist and need to improve the information in your distributed audio files? Whether you need to regain control of your music collection or simply make some refinements Jaikoz offers an effective music management solution. The missing information in your files is known as metadata and is stored in a Tag. The Jaikoz MP3 Tag Editor is a powerful yet simple to use tool that allows you to organize, edit and correct thousands of these tags with ease.
Jaikoz has powerful automation features designed to do the hard work for you. Jaikoz uses MusicBrainz, an online database of over 5 million songs. MusicBrainz is a community based database with contributions by over 200,000 people and its system of moderation ensures the data is extremely accurate. Many of these songs also 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! This feature means that Jaikoz gives you the flexibility to lookup your songs by both the acoustic id and the metadata making Jaikoz a very accurate tool. Jaikoz also provides easy access to look up your matching song on MusicBrainz using your default web browser.
No identification 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 convenient spreadsheet view to allow you to edit information very quickly and provides many autoformatting tasks. For example it compares your files to each other and using this information it can correct missing information and spelling mistakes. Jaikoz can extract information from a filename into the tag without you having to specify the format for the filename, and can rename filenames and folders from your metadata in your chosen format.
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 file and you want to copy it to another file 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 Mp4, M4a, M4p, Flac, Ogg Vorbis files and Mp3 files with ID3v1,ID3v2,ID3v2.2,ID3v2.3 and ID3v2.4 tags, and allows easy conversion between them.
Jaikoz is written in Java this means you can use it on Windows, UNIX and Mac OS X, and it works the same way on each.
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 512MB of RAM and 10MB free disk space
Ensure you have Java 1.5 Release 4 installed or later. This is freely available for OSX 10.4 (Tiger) but may not be installed by default and is not part of the automatic Apple Updater , it is available at http://developer.apple.com/java/download. Ensure you get the correct release for your Mac (Intel/PPC).
You can start Jaikoz by selecting if from the Application folder. If you wish you can add Jaikoz to the Dock and start it from there
If you do not have yet have Java 1.5 installed you will see this dialog
In which case, please download from the Apple website and retry. Otherwise unless there is a licensing problem jaikoz should now start
This section discusses problems starting Jaikoz due to problems with your Java configuration
Java is not recognized as an internal or external command,operable program or batch file..
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
Warning this section is for experienced users of Java only
By default Jaikoz allows upto 300MB to be used for storing the information about your loaded files, this is additional to about 100MB that is required to run Jaikoz. If you are attempting to load many audio files (more than 10,000) you may get a warning that memory is low, if your computer has sufficient memory you can increase the maximum value of memory than can be used you will be able to load larger amount of files if you require it. You should not set the memory to the actual amount that your system has because your computer requires some memory to run the operating system and other programs, additionally trying to load too many files may place too high a CPU load on your computer and could severely effect performance. If your computer only has 512MB of memory or less you should reduce the value as appropriate.
Jaikoz is usually run using Jaikoz.app from the Finder, but you can also run it using jaikoz.sh using the Terminal, memory is adjusted differently depending on which file you use.
If you are running Jaikoz you need to modify the value of -Xms within the Info.plist
Go to where you installed Jaikoz
Show popup, and select 'Show Package Contents'
Go into Contents/
Select popup on Info.plist and choose Open With Other...
Select Application/TextEdit
Find the line that says <string>-Xms64m -Xms300m</string>
Increase the value of Xms to the value you require
Jaikoz uses two log files, jaikozuser0-0.log contains the same information as is written to the Console Panel, it contains general information about what you've done within Jaikoz. The jaikozdebug0-0.log file contains warnings and debugging information that helps diagnose problems when running Jaikoz. These files are held in the within your log folder, for example /Users/paul/Library/Logs/Jaikoz and are renamed when they get to a certain size, the latest file is always called jaikozuser0-0.log, the next most recent is called jaikozuser0-1.log. if you require support with Jaikoz it is important to send both types of log files, to help diagnose the problem. The amount of logging written to the jaikozdebug0-0.log file can be adjusted, if you have a problem that you can reproduce it would be helpful if you could increase the amount of information logged, recreate the problem, send the logs and then return the logging to the normal levels.
The following parameters effect Jaikozes logging
-l2 -m2
The -l2 parameter specifies how much logging output should be generated by Jaikoz, the -m2 parameter specfies how much output should be generated when reading and writing files. The number 2 can be replaced by any value from 1 to 7, a value of 1 is the minimum and a value of 7 is the maximum. Setting a high value will noticeably slow the performance of Jaikoz, so changes should only be made temporarily to diagnose a problem.
Jaikoz is usually run using Jaikoz.app from the Finder, but you can also run it using jaikoz.sh using the Terminal, logging is adjusted differently depending on which file you use.
If you are running Jaikoz you need to modify the value of -l and -m within the Info.plist
Go to where you installed Jaikoz
Show popup, and select 'Show Package Contents'
Go into Contents/
Select popup on Info.plist and choose Open With Other...
Select Application/TextEdit
Find the line that says <string>-l2 -m2 -f</string>
Modify the -l and -m values you require
Table of Contents
Select the Open Folder Button 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 Automobile icon), 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 retrieve 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. Your file will then be updated with information from the MusicBrainz database, this includes not just fields such as Artist and Album but also Album Artwork and MusicBrainz Unique references to allow you to cross reference the MusicBrainz server
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 Save Changes Button 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 menu 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.
By default Jaikoz shows an Edit Panel and a Detail Panel but you can also show a View Panel by selecting the View/Show View Panel Menu Item. Then the screen is split horizontally between the View and Edit Panels, you can adjust the proportion of the screen taken up by each Panel by adjusting the divider up and down. The Panels contain tabs
The Toolbar provides access to most useful and commonly used commands. The Toolbar can be displayed or hidden from the View Menu.
The Tag Browser makes it very easy to quickly filter your loaded records to a more manageable size. The Genre list, groups together all the genres contained in your tracks, if you select a particular Genre only tracks containing that Genre will be displayed. The Artist and Album lists will be updated with only the Artist and Albums for tracks containing that genre, you can select an Artist or Album to further refine your choice, alternatively you can select all genres but limit by an Artist or Album. Note the lists are not case sensitive, and ignore therefore capitalization. The Tag Browser can be displayed or hidden from the View Menu. The Tag Browser makes it easy to work on subsets of your loaded records at a time.
The Edit Panel is always displayed, it contains the Edit Tab and the Edit ID3 Tab
.The Edit Tab starts with the same information as the View Tab showing most of a files metadata in an audio format independent way, but it is here you can edit the tag information. The fields are designed so that they can be edited inline wherever possible in an easy to understand format, the fields are similar to those within iTunes, but with additional information from MusicBrainz displayed. For example there are separate fields for all the MusicBrainz fields whereas within ID3 many of these are stored within the User Defined Text field. Usually you can edit a field by click on the field and start typing, some fields provide a combo box with a list of options. If the field is a multi value field it is the first field that is displayed in the table, to edit additional values click on the small numbered button to provide access to the additional values. The Edit Panel can show upto eighty different fields but by default only the more commonly used ones are shown, you can show more columns for just the Edit Panel using the column control in the right handside corner of the Edit Panel. If you also want the same columns to be displayed in the View Panel you should use the 'Settings/Table Settings' Menu Item.
For MP3s the Edit ID3 Tab can also be used to modify fields, this tab maps more directly to how fields are actually stored in the file, it also gives access to additional fields that are not yet in the Edit Tab
Selectable Combo is a drop down list where you can select a value
The View Panel can be displayed or hidden, it displays tagging information as it currently exists in the saved file
The View Tab shows the metadata for the loaded records, it is independent of any specific audio format.
The Detail Panel shows details of the currently selected file in a series of tabs (with the exception of the Console tab). As you select different files the detail tab gets updated automatically, (with the exception of the Read Only Summary Tab) you can edit values in the Detail tab and the changes will take effect immediately in the Edit Panel and vice versa. This provides a powerful alternative to the Edit Panel for making modifications and enables quick access to fields that may not be displayed in the Edit panel by default or without scrolling. The tabs are similar to the tabs from the GetInfo option within iTunes, but with additional information from MusicBrainz displayed. You can use the Up and Down arrows to change the selected record, selection is based on the record selected in the Edit Panel, selections within the View Panel have no effect.
This displays a summary of the file including audio information such as the length of the track and the size of the file. If the file contains artwork you can view it fullsize by double clicking on the image itself.
This shows the most common editable fields such as Artist,Album and Genre, all these fields are likley to be understood and used by most music players and organisers. The Is Compilation option is not standard but is becoming a defacto standard and is likely to be better supported by other applications in the future.
This shows all the MusicBrainz Ids that can be used to lookup information from MusicBrainz, plus it shows other fields that have been populated by the MusicBrainz looku, that do not fit into a standard ID3 field.
This shows the most common fields together with their corresponding sort field. Sort fields are useful because they can be used to sort records in a more useful way than using the main field. For example sort fields can be used to sort individual artists by their surname, or can disregard 'The' in group names. Some of the Sort fields are only supported by iTunes and are unlikely to be recognised by other Music Players.
The Console tab 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 ~/Library/Logs 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. You can view the logs using the /Applications/Utilities/Console application.
The Status Bar at the bottom of the screen shows how many records are loaded, how many records are actually visible due to filters and are any filters active.
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, if you have ever used another 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.
When editing data within Jaikoz either using the autocorrecters or manually, all changes are made in memory. Nothing is saved until you elect to save your changes.
If you use iTunes and have Automatically update iTunes library enabled Jaikoz will update the tracks in your iTunes library
Save Changes will save the files that you have modified and delete any files that you have marked for deletion. You can run it from the Main Menu in which case it will apply the changes to all files visible in the Edit Tab. Or from the Popup Menu so that it only is done for selected files, or as a task within the Autocorrecter so that it is applied to all files processed by the Auto Correcter
Force Save will save all the selected files, whether or not you have modified any fields. This can be useful if you wish to resave a file because you want to modify the way it is saved. For example you may wish to save a file with unsynchronization either enabled or disabled.
Save and Move saves any changes and then moves the selected files to the specified folder, this is an easy way to move a set of processed files to another folder. By default it will create the subfolder hierachy underneath the selected folder using the values in the subfolder fields for the selected files, but you can move the files without creating the subfolder hierachy by unchecking the Create subfolders hierachy option
Table of Contents