Jaikoz Help

Table of Contents

1. Introduction
1. Summary of features
2. Installation and Startup
1. Installation Requirements
1.1. Platform Requirements
1.2. Operating System Requirements
2. Installation Instructions
3. Starting Jaikoz
3.1. General Startup Instructions
3.2. Java Problems
3.3. Licensing Problems
3.3.1. No License Installed
3.3.2. Expired Trial License
3.3.3. Corrupted License
3.4. Uninstalling Jaikoz
3.5. Memory Management
3.5.1. Jaikoz.app
3.5.2. jaikoz.sh
3.6. Logging
3.6.1. Jaikoz.app
3.6.2. Jaikoz.sh
3. GettingStarted
1. Quick Start
2. Jaikoz Components
2.1. General Terms
2.2.
2.3. Toolbar
2.4. Tag Browser
2.5. Edit Panel
2.6. View Panel
2.7. Detail Panel
2.7.1. Summary
2.7.2. Info
2.7.3. MusicBrainz
2.7.4. Sorting
2.7.5. Relations
2.7.6. Lyrics
2.7.7. Artwork
2.7.8. Console
2.8. Status Bar
2.9. The Jaikoz Way
3. Saving Changes
3.1. Save Changes
3.2. Force Save
3.3. Save and Move
3.4. Save and Copy
4. Viewing Data
1. Colour Coding
2. Table Columns
2.1. Column Sorting
2.2. Column Sizes
2.3. Ordering Columns
2.4. Column Control
3. Synchronisation
4. Highlighting
4.1. Whitespace Highlighter
4.2. Highlight Fields
4.2.1. Duplicate MusicBrainz Unique Id
4.2.2. Duplicate MusicIP Acoustic Id
4.2.3. Duplicate Musicbrainz and MusicIP Id
5. Filtering
5.1. Duplicate Music Brainz Unique Id and MusicIP Id
5.2. Duplicate Music Brainz Unique Id
5.3. MusicBrainz Unique Id Exists
5.4. MusicBrainz Unique Id does not Exist
5.5. Duplicate MusicIP Acoustic Id
5.6. MusicIP Acoustic Id Exists
5.7. MusicIP Acoustic Id does not Exist
6. Find and Replace
7. Reports
7.1. Find Missing Tracks
8. View Artwork Fullsize
9. Links with other Applications
9.1. View this Track at MusicBrainz
9.2. View this Artist at MusicBrainz
9.3. View this Album at MusicBrainz
9.4. View this PUID at MusicBrainz
9.5. View this Track at Amazon
9.6. View this Release at Discogs
9.7. View this Release at Wikipedia
9.8. View this Artist at Discogs
9.9. View this Artist at Wikipedia
9.10. Run External App
9.11. Copy Paste with other Applications
5. Editing Data Manually
1. Simple Editing
2. Unicode
3. Copy and Paste
3.1. Copy
3.2. Paste
3.3. Paste all values
3.4. Paste to Start
3.5. Paste to End
4. Other Editing
4.1. Swapping Field Values
4.2. Prepend to Left
4.3. Prepend to Right
4.4. Renumber Track Nos
5. Deletions
5.1. Delete Field
5.2. Delete Record
5.3. UnDelete Record
6. Reverting Changes
6.1. Revert To Saved
6.2. Undo
7. AutoFix
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.4.1. Match Preferences
1.4.2. Match Score Preferences
1.4.3. AutoMatch Options
1.4.4. Format Options
1.4.5. Format 2 Options
1.5. ManualCorrect Tags from MusicBrainz
1.5.1. Manual Match Preferences
1.6. Cluster Albums
1.7. Correct Lyrics
1.8. Update Tags from Existing MusicBrainz Id
1.9. Update Tags from Discogs
1.9.1. Format Preferences
1.10. Submissions to Musicbrainz
1.10.1. Submit MusicBrainz/PUID Pair
1.10.2. Submit MusicBrainz Genres
1.10.3. Submit Musicbrainz Collection
2. Local Correct
2.1. Correct Artwork
2.1.1. Maximum number of images that should be added automatically to one file
2.1.2. Maximum size of images to be added (MB)
2.2. Delete Duplicates
2.3. Correct Track Nos
2.3.1. Preserve Track/Total Setting
2.3.2. Zeroise Track
2.4. Cross Referencing Correct - Correct Artists/Albums/Titles/Genres/Recording Times/Comments/Composers
2.4.1. How it Works
2.4.2. AutoMatch Preferences
2.4.2.1. Match words that appear misspelt
2.4.2.2. Ignore Word Order when matching
2.4.2.3. Ignore Case when matching
2.4.2.4. Ignore words in this list when matching
2.4.2.5. Split into Words using these values
2.4.3. AutoFormat Preferences
2.4.3.1. Remove whitespace at start or end of value
2.4.3.2. Remove Widespace
2.4.3.3. Remove undisplayable characters
2.4.3.4. Capitalization
2.4.3.5. Replace words by another word
2.4.3.6. Remove these Punctuation Characters
3. File and Folder Correct
3.1. Shift Base Folder to Sub Folder
3.2. Shift Sub Folder to Base Folder
3.3. Correct Tags from Filename
3.3.1. Example
3.3.2. Introduction
3.3.3. How it Works
3.3.4. Split the Filename using these words
3.4. Correct Filenames from Tags
3.5. Correct Sub Folders from Tags
4. Delete Duplicates
5. Auto Correcter
7. ITunes
8. Data Fields
1. Metadata Fields
1.1. Jaikoz Fields
1.1.1. Row Number
1.1.2. Status
1.1.3. Version
1.2. File Location Fields
1.2.1. Base Folder
1.2.2. Sub Folder
1.2.3. Filename
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
1.4.1. Size
1.4.2. Format
1.4.3. Bit Rate
1.4.4. Playing Time
1.4.5. Encoder
1.4.6. Emphasis
1.4.7. Channel Mode
1.4.8. Sample Rate
1.4.9. Is Copyright
1.4.10. Is Original
1.4.11. Is Private
1.4.12. Is Protected
1.4.13. Is VBR
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 Preferences
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.2.1. Is Compilation
2.2.2. Sort Album Artist
2.2.3. Sort Composer
2.3. Tag Field Groups
2.3.1. Not Supported Field
2.3.2. Unknown Fields
2.4. Data Formats common to multiple Fields
2.4.1. Date Time Formats
2.5. ID3 Tag Compatability
2.5.1. ID3v2.4 Compatibility
2.5.2. ID3v1 Compatibility
2.5.3. ID3v2.2 Compatability
2.5.4. ID3v2.3 Compatability
3. Ogg Vorbis Fields
3.1. General usage
3.2. Cover Art
3.3. Other Fields
4. Mp4 Fields
4.1. File Formats
4.2. M4p Protected Files
4.3. General usage
5. Flac Fields
5.1. General usage
9. Menus
1. Main Menu
1.1. Jaikoz
1.1.1. About Jaikoz
1.1.2. Preferences
1.1.3. Services
1.1.4. Hide Jaikoz
1.1.5. Hide Others
1.1.6. Show All
1.1.7. Quit Jaikoz
1.2. File
1.2.1. Open Folder
1.2.2. Add Folder
1.2.3. Open Files
1.2.4. Add Files
1.2.5. Close Files
1.2.6. Install Full license
1.2.7. Save Preferences
1.2.8. Save Changes
1.2.9. Save And Move
1.2.10. Save And Copy
1.2.11. Force Save
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. Capitalizer...
1.3.11.1. Title Case
1.3.11.2. Sentence Case
1.3.11.3. Capitalize all letters
1.3.11.4. Lowercase all letters
1.3.12. Swap Columns...
1.3.12.1. Swap Artist with Album
1.3.12.2. Swap Artist with Title
1.3.12.3. Swap Artist with Track No
1.3.12.4. Swap Artist with Comment
1.3.12.5. Swap Album with Title
1.3.12.6. Swap Album with Track No
1.3.12.7. Swap Album with Comment
1.3.12.8. Swap Title with Track No
1.3.12.9. Swap Track No with Comment
1.3.12.10. Swap Title with Comment
1.3.13. Swap
1.3.14. Prepend to Left
1.3.15. Prepend to Right
1.3.16. Renumber Track Nos
1.4. View
1.4.1. Show View Pane
1.4.2. Show Tag Browser
1.4.3. Show Detail Pane
1.4.4. Show ToolBar
1.4.5. Show ID3 Tabs
1.4.6. View Artwork Full-size
1.4.7. View this Track at MusicBrainz
1.4.8. View this Artist at MusicBrainz
1.4.9. View this Album at MusicBrainz
1.4.10. View this Acoustic Id at MusicBrainz
1.4.11. View this Track at Amazon
1.4.12. View this Release at Discogs
1.4.13. View this Release at Wikipedia
1.4.14. View this Artist at Discogs
1.4.15. View this Artist at Wikipedia
1.5. Action
1.5.1. Auto Correct
1.5.2. Local Correct
1.5.2.1. Correct Artists
1.5.2.2. Correct Albums
1.5.2.3. Correct Titles
1.5.2.4. Correct Genres
1.5.2.5. Correct Track Nos
1.5.2.6. Correct Years
1.5.2.7. Correct Comments
1.5.2.8. Correct Composers
1.5.2.9. Correct Artwork
1.5.3. File And Folder Correct
1.5.3.1. Shift Base Folder to Sub Folder
1.5.3.2. Shift Sub Folder to Base Folder
1.5.3.3. Correct Sub Folders From Tags
1.5.3.4. Correct Filenames From Tags
1.5.3.5. Correct Tags From Filename
1.5.4. Remote Correct...
1.5.4.1. Retrieve Acoustic Ids
1.5.4.2. Autocorrect Tags From MusicBrainz
1.5.4.3. Cluster Albums
1.5.4.4. Correct Lyrics
1.5.4.5. Submit MusicBrainz/PUID Pair
1.5.4.6. Submit MusicBrainz Genres
1.5.4.7. Submit MusicBrainz Collection
1.5.4.8. Manual Correct Tags From MusicBrainz
1.5.4.9. Update Tags From Existing MusicBrainz Id
1.5.4.10. Update Tags From Discogs
1.5.5. Delete Files
1.5.6. Undelete Files
1.5.7. Empty Cache
1.5.8. Create Support Files
1.6. Filters
1.6.1. Highlight Fields
1.6.1.1. Duplicate Music Brainz Unique identifier
1.6.1.2. Duplicate MusicIP Acoustic Identifier
1.6.1.3. Non-standard Genres
1.6.1.4. Non-iTunes Genres
1.6.2. Duplicate MB id and Musicbrainz Id
1.6.3. Filter Non Standard Genres
1.6.3.1. No Genres Enabled
1.6.3.2. Non Standard Genres
1.6.3.3. Non-iTunes Genres
1.6.4. Filter MusicBrainz Unique Ids
1.6.4.1. No Music Brainz Unique Id Filters Enabled
1.6.4.2. Duplicate Music Brainz Unique identifier
1.6.4.3. Music Brainz Unique Identifier Exists
1.6.4.4. Music Brainz Unique Identifier does not Exist
1.6.5. Filter MusicIp Acoustic Ids
1.6.5.1. No MusicIP Acoustic Ids Filters Enabled
1.6.5.2. Duplicate MusicIP Acoustic Identifier
1.6.5.3. Music Brainz Unique Identifier Exists
1.6.5.4. Music Brainz Unique Identifier does not Exist
1.7. Reports
1.7.1. List Missing Tracks for Albums
1.8. Help
1.8.1. Check for Later Version
1.8.2. Register
1.8.3. Offline Help
1.8.4. Online Help
2. Preferences
2.1. General
2.1.1. Appearance
2.1.2. Base Folder
2.2. Table
2.2.1. Columns
2.2.2. Audio Columns
2.2.3. ID3 Columns
2.2.4. Display
2.2.5. Synchronisation
2.3. Save
2.3.1. ID3Tag V1
2.3.2. ID3Tag V2
2.3.3. General
2.3.4. iTunes compatibility
2.3.5. iTunes AutoUpdate
2.4. MusicBrainz
2.5. Local Correct
2.5.1. Auto Match
2.5.2. AutoFormat
2.5.3. Track Correct
2.5.4. Year Correct
2.5.5. Artwork Correct
2.5.6. Delete Duplicates
2.6. Remote Correct
2.6.1. Correct Lyrics
2.6.2. Correct Genres
2.6.3. Correct Discogs
2.7. File And Folder Correct
2.7.1. Rename Folder from Tags
2.7.2. Rename File from Tags
2.7.3. Correct Tags from Filename
2.8. Manipulators
2.8.1. AutoCorrecter
2.8.2. Word Remover
2.8.3. Word Separator
2.8.4. Word Replacer
2.8.5. Punctuation Remover
2.8.6. Capitalizer
3. Popup Menu
3.1. View Panel Row Popup Menu
3.2. View Panel Popup Menu
3.3. Edit Panel Row Popup Menu
3.4. Edit Panel Popup Menu
10. Keyboard Traversal
1. General Keyboard Actions
2. Main Menu Actions
3. Table Keyboard Actions
4. Shortcut keys for Main Menu
5. Shortcut keys for Row Header

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

Chapter 1. Introduction

Table of Contents

1. Summary of features

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.

1. Summary of features

  • 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

  • Automatically download front cover album art from the Internet into your music file

  • Automatically get Metadata from Discogs from a Discogs url

  • Automatically get Lyrics using Lyrics Fly

  • Automatically updates iTunes database from Jaikoz

  • Powerful Find and Replace to quickly edit your data

  • Indentifies duplicate files based on the Acoustic Id or the MusicBrainz Id

  • 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

Chapter 2. Installation and Startup

Table of Contents

1. Installation Requirements
1.1. Platform Requirements
1.2. Operating System Requirements
2. Installation Instructions
3. Starting Jaikoz
3.1. General Startup Instructions
3.2. Java Problems
3.3. Licensing Problems
3.3.1. No License Installed
3.3.2. Expired Trial License
3.3.3. Corrupted License
3.4. Uninstalling Jaikoz
3.5. Memory Management
3.5.1. Jaikoz.app
3.5.2. jaikoz.sh
3.6. Logging
3.6.1. Jaikoz.app
3.6.2. Jaikoz.sh

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.

1. Installation Requirements

1.1. Platform Requirements

The Minimum run-time requirements are a Computer with 512MB of RAM and 10MB free disk space

1.2. Operating System Requirements

Jaikoz should work on any operating that supports Java JRE 1.5 or higher. it has been tested on

  • Mac OS X v10.4

  • Windows XP

  • Windows Vista

  • Linux (Fedoura)

2. Installation Instructions

  1. 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).

  2. Download the Jaikoz.dmg.zip from the Website

  3. This should automatically mount itself as an additional drive.

  4. Copy Jaikoz to your /Applications folder

  5. Start Jaikoz, if you have not installed Java 1.5, the following dialog will be displayed, in which case install java as required and retry

3. Starting Jaikoz

3.1. General Startup Instructions

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

3.2. Java Problems

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

3.3. Licensing Problems

3.3.1. No License Installed

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

3.3.2. Expired Trial License

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

3.3.3. Corrupted License

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

3.4. Uninstalling Jaikoz

To uninstall Jaikoz just drag it from the Application Folder to the Trash

3.5. Memory Management

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.

3.5.1. Jaikoz.app

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

3.5.2. jaikoz.sh

  • From Finder select Utilities/Terminal

  • From Terminal cd /Applications/Jaikoz.app/Contents/Resources/java

  • From Terminal vi jaikoz.sh

  • Within the Jaikoz.sh file , the line parameter-Xmx300m sets the max memory in megabytes, adjust this value and run jaikoz.sh for it to take effect

3.6. Logging

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.

3.6.1. Jaikoz.app

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

3.6.2. Jaikoz.sh

  • From Finder select Utilities/Terminal

  • From Terminal cd /Applications/Jaikoz.app/Contents/Resources/java

  • From Terminal vi jaikoz.sh

  • Within the Jaikoz.sh file, the parameters-l2 -m2 -f sets the logging, adjust this value and run Jaikoz.sh for it to take effect

Chapter 3. GettingStarted

Table of Contents

1. Quick Start
2. Jaikoz Components
2.1. General Terms
2.2.
2.3. Toolbar
2.4. Tag Browser
2.5. Edit Panel
2.6. View Panel
2.7. Detail Panel
2.7.1. Summary
2.7.2. Info
2.7.3. MusicBrainz
2.7.4. Sorting
2.7.5. Relations
2.7.6. Lyrics
2.7.7. Artwork
2.7.8. Console
2.8. Status Bar
2.9. The Jaikoz Way
3. Saving Changes
3.1. Save Changes
3.2. Force Save
3.3. Save and Move
3.4. Save and Copy

1. Quick Start

Select the File/Open Folder to select files to load in Jaikoz, by default subfolders will also be loaded, your files will start to load into Jaikoz.

Select the Autocorrect button , this runs a series of autocorrections and lookups to correct your songs metadata.

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 Button 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 should not 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

2. Jaikoz Components

This section explains the Main Jaikoz Window, and the visible components of Jaikoz.

2.1. General Terms

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.

  • Ogg is an open source media container format for storing audio and video. Jaikoz currently only supports use of Ogg with Vorbis Audio.

  • OggVorbis is an open source audio format, similar to MP3 but newer and of a higher quality, it uses the ogg container format to store Vorbis Audio

  • Flac is an open source lossless audio format, that preserves the original recording exactly.

  • MP4 is a audio/video container format for storing audio and video. Jaikoz only supports use of Mp4 with Audio files

  • M4P is a protected version of MP4, Jaikoz can edit the Metadata within an M4p audio file without affecting the protection.

  • AAC is an audio format normally used within MP4

  • Metadata is the term for any information about a music file other then the music file itself.

  • Tag is another term for Metadata within audio files.

  • ID3 is the tag format for use with MP3 files.

  • 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.

  • Vorbis Comment is the tag format for use with OggVorbis and Flac files.

  • Unicode is a way of specifying characters, it supports almost every language in the world.

  • Main Menu is accessible at the top of the screen

  • Popup Menus are available from within the tabs

  • Popup Window is a new window to the main application window

Jaikoz Terms

  • 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

  • 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.

  • A table consist of Columns and Rows

  • A Column Header displays the listitem of the column.

  • 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

  • Record refers to a single row in a Panel

2.3. Toolbar

The Toolbar provides access to most useful and commonly used commands. The Toolbar can be displayed or hidden from the View Menu.

2.4. Tag Browser

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.

2.5. Edit Panel

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

  • 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.

2.6. View Panel

The View Panel can be displayed or hidden, it displays tagging information as it currently exists in the saved file