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

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

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

  • The View Audio Tab contains audio information about the music file, this information cannot be modified

  • The View Tab shows the Metadata for the loaded records, it is independent of any specific audio format.

  • For MP3s the View ID3V1 Tab contains the contents of the ID3v1 tag

  • For MP3s the View ID3V2 Tab contains the contents of the ID3v2 tag, if a file contains more than one ID3v2 tag the latest one will be displayed

  • For MP3s the View Merged ID3 Tab merges the ID3v1 and ID3v2 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. This tab shows more fields than the View Tab, and maps fields directly to the underlying MP3 format.

2.7. Detail Panel

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.

2.7.1. Summary

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.

2.7.2. Info

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.

2.7.3. MusicBrainz

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.

2.7.4. Sorting

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.

2.7.5. Relations

This shows relationships with websites such as Discogs and Wikipedia for the release or artist.

2.7.6. Lyrics

This shows the Lyrics associated with the file

2.7.7. Artwork

This shows the artwork associated with the file. You can add additional artwork and delete existing Artwork.

2.7.8. Console

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.

2.8. Status Bar

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.

2.9. The Jaikoz Way

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.

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

3. Saving Changes

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

3.1. Save Changes

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

3.2. Force Save

Force Save will resave files even if you have not 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. 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.

3.3. Save and Move

Save and Move saves any changes and then moves the 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. 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.

3.4. Save and Copy

Save and Copy saves any changes and then copies the files to the specified folder, this is an easy way to majke a copy 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. 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.

Chapter 4. Viewing Data

This chapter explains some of the features of Jaikoz, to make it easier to manage your files

1. Colour Coding

Colour coding is used extensively in Jaikoz to provide you with extra information without using up extra screen space.

Table 4.1. Colour Coding

Name Default Colour Description
Edited Purple Whenever a field value is different to the value in the saved file
Missing Green When a field does not actually exist in the file
Whitespace Pink Shows whitespace at the start or end of a field value
Deleted Delete When a field has been deleted from the file
Highlight Orange When a field matches a Highlighter
Find Yellow The field has been been matched by find

2. Table Columns

2.1. Column Sorting

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

2.2. Column Sizes

The size of a column can be set so that it fits exactly wide enough to display the title and all the data within the column by double-clicking on its header boundary with the next column header. It can also be increased or decreased by selecting the right hand side of the column header and dragging it inwards or outwards

2.3. Ordering Columns

The column order can be changed by selecting the middle of the column header and dragging it to the new location

2.4. Column Control

Selecting the column control button in the top right corner of the table, allow you to quickly make changes to the table view.

Pack All Columns trys to set the width of all the visible columns so that they are wide enough to display the data within them. If Horizontal Scroll is enabled then the columns can be as wide as required upto a limit of 500 pixels for any single column, if horizontal scroll is disabled then all the visible columns have to fit onscreen. The Pack Selected Column is available if you have selected a field before clicking the column control button, this will pack the selected column so it is just wide enough to display all the field values.

You can scroll down the list to make individual columns visible or invisible

The column control button only effects the table for which it is selected, changes are not synchronized to other tables

3. Synchronisation

Jaikoz automatically synchronises the View Panel and the Edit Panel when both are displayed. 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 and resizing between rows When the column order is changed in one view they will be changed in other V2 views

  • Synchronise horizontal scrolling between rows When scrolling through the columns in one view they will be scrolled in other V2 views

  • Synchronise vertical scrolling between rows When scrolling through the rows in one view they will be scrolled in other views

4. Highlighting

Highlighting uses Colour Coding as described earlier to make fields standout, there are currently two types of highlighter

4.1. Whitespace Highlighter

If there is any whitespace at the start or the end of the value it will be coloured the Whitespace Colour (default pink). 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.

4.2. Highlight Fields

You can temporarily highlight fields that match a particular rule, the matching fields are coloured the Highlight Colour (orange). Currently there are two highlight rules available

4.2.1. Duplicate MusicBrainz Unique Id

When enabled all Unique File Id fields that are the same as in at least one other record are highlighted.

4.2.2. Duplicate MusicIP Acoustic Id

When enabled all User Defined Text fields that contain a MusicIP PUID (Acoustic Id) that is the same as in at least one other record are highlighted.

4.2.3. Duplicate Musicbrainz and MusicIP Id

When enabled all User Defined Text fields that contain the same combination of Musicbrainz Id and MusicIP Id as at least one other record are highlighted.

5. Filtering

Filtering only shows rows that match a particular rule, any active filters are shown in the status bar. If you run an autocorrection task it will only be performed on the visible records. There are currently filters available for the MusicBrainz Unique Id and the MusicIP Id, only one MusicBrainz filter and/or one MusicIP filter can be enabled at the same time.

5.1. Duplicate Music Brainz Unique Id and MusicIP Id

When enabled only songs that contain the same combination of Musicbrainz Id and MusicIP Id same as at least one other records are displayed. This function is very useful for finding and possibly deleting duplicate versions of the same song.

5.2. Duplicate Music Brainz Unique Id

When enabled only records containing a Unique File Id field that is the same as at least one other records are displayed. This function is very useful for finding and possibly deleting duplicate versions of the same song.

5.3. MusicBrainz Unique Id Exists

When enabled only records containing a Unique File Id field are shown. This function is useful for checking tracks corrected by MusicBrainz.

5.4. MusicBrainz Unique Id does not Exist

When enabled only records that do not contain a Musicbrainz Id field are shown. This function is useful for finding tracks that have not been matched by MusicBrainz, that may need matching manually

5.5. Duplicate MusicIP Acoustic Id

When enabled only records containing a MusicIP Id field that is the same as at least one other records are displayed, filter status is also shown in the status bar. This function is very useful for finding and possibly deleting duplicate versions of the same song.

5.6. MusicIP Acoustic Id Exists

When enabled only records containing a MusicIP Id are shown. This function is useful for listing tracks that have been matched by MusicIP.

5.7. MusicIP Acoustic Id does not Exist

When enabled only records that do not contain a MusicIP Id field. This function is useful for finding tracks that have not been matched by MusicIP

6. Find and Replace

The Find dialog can be displayed for the current view by selecting it from the popup menu, or using the shortcut key. From the dialog you can search through the fields in the chosen table searching for fields containing the value you enter. The Search can be forwards/backwards , it can be case sensitive, and it can wrap round once and continue searching from the start of the table once it has got to the end. A match will be highlighted in yellow. You can highlight all matching fields using the Find All button

You can limit the search to only search a particular column by selecting it from the Column dropdown, Find All will now only match fields within that column

By default a field will match if it contains the find value. You can restrict the match to exact matches by changing the drop drown to Equals, or match the start or end of the field by selecting the Starts With or Ends With option.

If you started the Find Dialog for the edit view you it also offers you Replace and Replace All. If you have just done a find then replace will replace the matching value, otherwise replace will search for the next match and replace it with the replace value. Replace All will starting from the first record replace all matching fields

7. Reports

Reports let you analyse your tracks

7.1. Find Missing Tracks

Find Missing tracks generate a list of all the albums in your selected files, and the tracks within each album. It then compares the list to all the tracks you have loaded in Jaikoz to find matching tracks. It then generates a list of all missing tracks and all matching tracks. Within the html report if the album is a Various Artists album then the individual artist name will be listed for every track, if not then it is not displayed because it is assumed the same Artist will be on every track in the album. These lists can be viewed and saved as a html file, or as a cvs file, cvs files can easily be loaded into spreadsheets.

The matching is done based upon the MusicBrainz Unique Id and the MusicBrainz Album Id because this is the only accurate way to identify albums, and allows us to distinguish between albums of the same name by different artists. This means you should not run this report unless your tracks have been matched by MusicBrainz. The information in the Matching Reports shows the information as stored on the MusicBrainz Server rather than in your files, so for example if you have a track with Unique id of e785f700-c1aa-4943-bcee-87dd316a2c30 and the value of Artist in your file is 'Farming Incodent' but in the Musicbrainz Server it is 'The Farming Incident' then 'The Farming Incident' will be displayed, the report is done this way as it is intended to show what you dont have/have in relation to the details on MusicBrainz.

8. View Artwork Fullsize

This opens a window with all the artwork of the selected files shown fullsize, it can be triggered by either selecting the View Artwork Fullsize from the Popup menu, or by double clicking the image shown in the Detail/Summary Tab, you can have multiple windows open at one time, if a song has multiple images each is displayed in a seperate window.

9. Links with other Applications

9.1. View this Track at MusicBrainz

This option is only available when you have exactly one track selected, and that track has a MusicBrainz Unique File Id. It will open the MusicBrainz page for the track in your browser.

9.2. View this Artist at MusicBrainz

This option is only available when you have exactly one track selected, and that track has a MusicBrainz Artist Id. It will open the MusicBrainz page for the artist in your browser.

9.3. View this Album at MusicBrainz

This option is only available when you have exactly one track selected, and that track has a MusicBrainz Album Id. It will open the MusicBrainz page for the album in your browser.

9.4. View this PUID at MusicBrainz

This option is only available when you have exactly one track selected, and that track has a MusicIP id (PUID). It will open the MusicBrainz page for the PUID in your browser.

9.5. View this Track at Amazon

This option is only available when you have exactly one track selected, and that track has a Amazon Id (ASIN). It will open the Amazon page for the album in your browser.

9.6. View this Release at Discogs

This option is only available when you have exactly one track selected, and that track has a Release Discogs Url. It will open the release on Discogs in your browser.

9.7. View this Release at Wikipedia

This option is only available when you have exactly one track selected, and that track has a Release Wikipedia Url. It will open the release on Wikipedia in your browser.

9.8. View this Artist at Discogs

This option is only available when you have exactly one track selected, and that track has a Artist Discogs Url. It will open the artist in Discogs in your browser.

9.9. View this Artist at Wikipedia

This option is only available when you have exactly one track selected, and that track has a Release Wikipedia Url. It will open the release in Wikipedia your browser.

9.10. Run External App

Run External App, processes the item using your configured external application. Note you can use this to invoke applications such as a music players or playlist editors.

9.11. Copy Paste with other Applications

Fields copied from within a Jaikoz table can be pasted to other applications

Chapter 5. Editing Data Manually

1.  Simple Editing

Fields can be edited in the Edit Panel and the Detail Panel

Within the Edit and View Panels fields are displayed in a view akin to a spreadsheet. If a field does not exist its background will be coloured the Missing Colour (default green). If it does exist then it then the background will be white. If the field exists but is empty then the whole field will just be white.

Within the Edit Tab 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 Edit Colour (default purple), if you change it back to its original value it will no longer be Edited 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. Deleting a field will change its colour to Deleted Colour (default red)

The first column is the status column, this is also colour coded to indicate that the record has been modified (Edit Colour), if you mark the record to be deleted, it will be set to Deleted Colour.

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'

The Detail Panel allows you to edit the currently selected record, it groups toegther the fields logically in a series of tabs and can be easier to use than the Edit Panel. The Detail Panel does not use colour coding, changes made in the Detail Panel are immediately reflected in the Edit Panel and vice versa.

MP3 Files can also use the ID3 Edit Tab, this is similar to the Edit Tab, but provides access to more ID3 fields, and maps the fields directly to how they are stored within the file. Changes made in the Edit ID3 tab are immediately reflected in the Edit Tab and Detail Panel and vice versa.

2. Unicode

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

3.  Copy and Paste

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!

3.1. Copy

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.

3.2. Paste

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 wouldn't 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 for an mp3 file it appends the (MP3) suffix to the filename and checks that you have not already loaded a file with the same filename.

3.3. Paste all values

If the field to be pasted contains multiple values selecting this value will paste all values into the selected fields.

3.4. Paste to Start

Pastes the previously copied values to the start of the currently selected fields in the edit pane, (separated by a space character).

3.5. Paste to End

Pastes the previously copied values to the end of the currently selected fields in the edit pane, (separated by a space character).

4. Other Editing

Field values can be exchanged between fields in two column as follows

4.1. Swapping Field Values

If you have selected some fields in two separate columns this swaps the fields in one column with the fields in another

4.2. Prepend to Left

If you have selected some fields in two separate columns, this option will copy the contents of the fields in the right column into the start of the fields in the left column (separated by a space character)

4.3. Prepend to Right

If you have selected some fields in two separate columns, this option will copy the contents of the fields in the left column into the start of the fields in the right column (separated by a space character)

4.4. Renumber Track Nos

If you have selected some fields in the track no column, this option renumber the fields starting from the value of the first field (based on the current sort order), or starting from one if the first field has no value. The renumbering is based on the current order of the files, the numbering takes into account your Track No Preferences

5. Deletions

You can delete individual fields or the actual file, the deletions do not take place until you have saved changes.

5.1. Delete Field

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

5.2. Delete Record

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.

5.3. UnDelete Record

You can undelete a Record that you previously marked for deletion.

6. Reverting Changes

6.1. Revert To Saved

Revert to Saved will reset the records to their currently saved value. Any changes you have made but not saved will be lost.

6.2. Undo

Undo is a simple field based Undo it does not currently support stepping back multiple undos, if you select a number of fields and select Undo, their values will revert to the saved value.

7. AutoFix

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

Chapter 6. Correcting Data Automatically

Table of Contents

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

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

1. Remote Correct

Remote correct groups tasks together that require Internet access in order to run

1.1. What are MusicBrainz and MusicIP?

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.

1.2. How Does Jaikoz Use MusicBrainz and MusicIP?

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 compares your track acoustically with the MusicIP database and if it finds a match it retrieves the acoustic id. It can then be used to 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 many 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 values to many of the other fields such as the Music Id (PUID), Artist Id, Album Id, Disc Id, AmazonId ,artist, album, title, year, album artist, release status, release type, release country and track number if they do not exist already on your file, or if they are allowed to be overwritten based on your AutoFormat Preferences.

1.3. Retrieve Acoustic Ids

This attempts to find an acoustic match for your track in the MusicIP database. In order to get a successful match the track must exist in the MusicIP database and your track must be of sufficient quality so that it sounds similar enough to the track in the MusicIP database, if an Acoustic Id is found it will be added to the MusicIP Id Field. Acoustic matching takes a few seconds per track but the Acoustic Id for a track never changes so there is no need to regenerate it, it only has to be done once. Because the Acoustic Id for a particular file will never change, the Acoustic Id will be automatically saved to file as it is retrieved. By default Jaikoz does not submit unknown tracks to MusicIP because analysing unknown tracks take significantly longer, but this option can be enabled. When you submit an unknown track to MusicIP it will not give you an Acoustic Id immediately, you have to wait 24 hours and then retry retrieving acoustic ids for the unknown track. By this time the track should have been added to the MusicIP database and you will normally able to retrive an acoustic id for it. You can change these options in the Preferences/MusicBrainz/MusicIP window.

1.4. Autocorrect Tags from MusicBrainz

This attempts to find a match in the MusicBrainz Database, if an Acoustic Id has been found this will be used as the main key, otherwise Metadata such as artist, album and title will be used. How Jaikoz determines the best match depends on the options you have selected in the Match and Match Score Preferences. The default will provide a good match for mostb customers but you can finely tune the matching as reuired. If a match is found then Jaikoz will populate as many fields as it can from the MusicBrainz database, if they are enabled in your AutoFormat options

1.4.1. Match Preferences

The MusicBrainz Server field specifies what MusicBrainz server to use, currently there is only one but it is expected there will be mirror servers available in the future.

The Do not match online if already have a MusicBrainz Unique id option allows you to skip over tracks that have already had a Unique id. This is very useful if you reload records that you have already analysed, so you do not re-analyse them which could take some time if you are loading many records, it also allows you to skip over records you have just analysed if the online MusicBrainz match has timed out and you need to rerun it. This option is not enabled by default because you may want to re-analyse records because of improvements in your Metadata, which may give a more accurate match.

When Jaikoz finds potential matches for a track it doesn't have all the album information required to calculate exactly the rating a match should be given unless the album is in the Jaikoz album cache. For example it will have the album name but the not list of countries the album has been released in. To get this information it has to do another query for each album and this would slow down matching because MusicBrainz only allows one query per second so by default Jaikoz only retrieves the full album information for the track with the best rating although Jaikoz caches album information so it doesnt have to lookup the same album more than once in a Jaikoz session Enabling the Retrieve extended release details for more accurate ratings option will retrieve the extra album information for all potential matches, this will make matching slower but more accurate.

If Prefer releases that have been used by other tracks is enabled, releases that have been used by other tracks will have their rating increased by the Release has been used by other tracks score in the Match Score preference. Enabling this option helps minimize the number of albums tracks are spread over.

Musicbrainz categorizes all releases into either Official, Promo, Bootleg or Pseufo Release - most releases are Official. IfPrefer offical releases is enabled, Official releases will have their rating increased by Release is an Official Release score in the Match Score preference. Enabling this option helps prevents incorrect matching to live bootleg tracks.

If Prefer releases of the following types is enabled all the release types checked below it will cause tracks with releases of one of the checked types to have their rating increased by the Release is one of the preferred release types score in the Match Score preference. This option can be used to favour original abums, singles or compilations.

The selected Preferred Country of release will give tracks with releases in this country a rating increase by the Release released in preferred country score in the Match Score preference.

The Track Duration must be within this number of seconds options lets you specify that the duration of any matching tracks must be within x seconds of the actual duration for this track. Matches can be upto x seconds shorter or longer to account for slight differences in encoding or possibly song versions.

If the Possible matches must be within track duration option is enabled then no track will be returned based on a metamatch unless its track duration is within the range specified, if it is disabled then these track will still be returned as long as their total metamatch score is high enough. This option does not effect tracks matched based on their PUID.

1.4.2. Match Score Preferences

Jaikoz find the best few ten possible matches for a track then calculates a rating out of 100 for each track, and the highest rating track is selected by the Autocorrecter if its rating is above the minimum rating accepted. You can decide how the rating is calculated by adjusting how the rating is allocated. Some ratings are not used if the associated checkbox is not enabled in the Match Preferences, for example the Release is an Offical release rating is only used if you have enabled the Prefer official releases in the Match Preferences.

1.4.3. AutoMatch Options

The Do not match if unable to Acoustic Id Match option will only match tracks that have an acoustic id. This increases accuracy but reduces the number of matches.

The Minimum rating required if meta match only option allows you to balance the number of matches against accuracy. If your track has no acoustic id the match is done purely on the Metadata, the higher this setting the more likely it is that any match made will be correct, but less tracks will get matched at all. If your track has an acoustic id this setting is ignored because acoustic ids are so accurate it is very likely that if an acoustic match is made it will be for the correct track (even if it is not for the exact version), and forcing a check on Metadata as well would throw away accurate matches for tracks with poor or incorrect Metadata. The default value is 70.

If the Acoustic Id match must also have minimum meta rating option is enabled then matching tracks matched by their acoustic id must also have a Metadata match higher then the value in Minimum rating required if have an Acoustic Id Match. This option is not enabled by default.

If the Prefer to use acoustic id if exists even if rating is less than metamatch option is enabled Jaikoz will always use match based on MusicIp Id over a metamatch regardless of which has the best score. Using a MusicIP id is safer than a metamatch for identifying the correct title because it does not rely on your file having correct Metadata. But when a track appears on multiple releases metamatches can be better at ensuring all tracks from one release are all tagged against the same release.

1.4.4. Format Options

This lists most of the values that can possibly be populated by MusicBrainz upon a successful match, this includes text fields and Artwork. By default all fields are populated on a MusicBrainz match if MusicBrainz has a value, but you can select to only populate the field if it is empty , or never to populate it.

When matching cover art Jaikoz will attempt to finest the highest quality image it can from a variety of sources, the image is added to the audio file automatically but will like all tasks the image will not be saved until you save changes.

A release may have multiple release events, these consist of a Country and a Release Date. The When selecting year and country of release prefer to use option lets you specify what is more important - the country or the date of release.

The Translate foreign artist names to english where possible uses the english version of latin names where possible. this is useful if youre system is Englisg/latin based but you are have some tracks by non lation artists such as Chinese or Japanese which would be difficult to use otherwise.

This is the current list of fields that can be auto populated

  • MusicBrainz Unique Id
  • Artist
  • Album
  • Album Artist
  • Sort Artist
  • Sort Album Artist
  • Title
  • Year
  • Track No
  • is Compilation
  • MusicBrainz Artist Id
  • MusicBrainz Release Id
  • MusicBrainz Release Artist Id
  • MusicBrainz Disc Id
  • Release Type
  • Release Status
  • Release Country
  • Amazon Id
  • Artwork
  • Composer

1.4.5. Format 2 Options

This lists additional values that can possibly be populated by MusicBrainz upon a successful match.

This is the current list of fields that can be auto populated

  • Label
  • Barcode
  • Catalog No
  • Media
  • Lyricist
  • Conductor
  • Remixer
  • Release Discogs Url
  • Release Wikipedia Url
  • Release Official Url
  • Sort Composer

1.5. ManualCorrect Tags from MusicBrainz

For each (selected) track this finds upto ten potential matches in the MusicBrainz Database, the same algorithm is used as for the autocorrect but instead of automatically selecting the best match, upto ten matches are displayed and it is your decision to select a match or not. Matches by Acoustic Id are shown first, then matches by meta data - sorted by their rating. Each choice is displayed on a seperate row for each release event so that you can select the Release Date,Record Label and CatalogNo to select when there are multiple choices. You can modify what fields are displayed and in what order and these changes are preserved. The last column contains either Search for the master record or View for the choices, if you select View Jaikoz opens the release in Musicbrainz so that you can look in more detail. If you select Search it opens Musicbrainz Search you can then select one of the results or search again to find the track that you want, then select the tagger button on the webpage and Jaikoz will use this selection.

By default records are processed in batches of ten, after the first ten songs are processed the matches are displayed in a dialog. Whilst you are reviewing the options the next batch of songs is processed in the background. If you select Ok the songs are updated to your matches. This continues until there there are no more records to process, unless you select Cancel. You can select Reset to undo any changes you have made in the current batch that you are reviewing.

1.5.1. Manual Match Preferences

The Number of records to process before showing dialog sets how many records are processed before displaying the potential matches in a dialog when running ManualCorrect Tags from MusicBrainz.

1.6. Cluster Albums

Many albums exist within Musicbrainz as multiple releases, usually this is because the album was released with an extra track in a particular country. All the track ids for an album are unique to that album because of a flaw in MusicBrainz schema, so that even if there is an identical track on both releases it will have different track ids. Now when a PUID is created for a song it is likely to only be associated to one of the track ids. So what typically happens when you look up some tracks from one album in Jaikoz is that it finds matches, but some are for tracks in one version of the release and some in another. This means the MusicBrainz Release Id varies and things like Find Missing Tracks Report do not work so well because it compares release ids rather than album names. The Cluster Albums task analyses all the (selected) tracks that have been matched in Musicbrainz and groups them by artist and album and tries to reduce the number of release ids the tracks are spread over

1.7. Correct Lyrics

Jaikoz can retrieve the lyrics for many of your songs using an online database.

1.8. Update Tags from Existing MusicBrainz Id

For each (selected) track this checks that they already have a MusicBrainz Id, and if they do retrieve the latest information from MusicBrainz for this Id and updates the relevent fields in the record if they are enabled in your Format options. If the track does not have a MusicBrainz Id but it does have a Musicbrainz Release Id then Jaikoz tries to find the correct track on the release by comparing the trackname, track number and track duration.

This has a number of uses:

  • Ensuring that you have the latest information from MusicBrainz because MusicBrainz may have improved/corrected/increased the information held for this track since you originally matched it.

  • Jaikoz may not have been able to find a MusicBrainz Match itself, so you can find the correct track using the MusicBrainz Website yourself and then enter the id into the UniqueId field, then use this task to update all the fields based on this Id.

  • Even easier, just find the Release Id and then paste the Musicbrainz Release Id for every track into the Release Id field

1.9. Update Tags from Discogs

For each (selected) song this checks that they already have a Release Discogs Url, and if they do then Jaikoz retrieves the latest information from Discogs for this Release Id and tries to find the correct track on the release by comparing the trackname, track number and track duration of the tracks with the Discogs release information. Jaikoz then updates the relevent fields in the record if they are enabled in your Format options. The Release Discogs Url can be added after a successful Musicbrainz lookup but if you're song does not have one you can search on Discogs for it yourself and add it manually.

Whether or not you have already tagged your track from Musicbrainz, Discogs may contain additional information that is not included in the Musicbrainz Database. You can also use this to help identify information that you can be added into Musicbrainz. Discogs Cover Art is generally higher quality than is available from Musicbrainz.

1.9.1. Format Preferences

This lists the values that can possibly be populated by Discogs upon a successful match, this includes text fields and Artwork. By default fields are only populated if they are currently empty but you can select to always populate the field, or never to populate it.

This is the current list of fields that can be auto populated

  • Artist
  • Album
  • Album Artist
  • Release Type
  • Release Status
  • Title
  • Year
  • Track No
  • Is Compilation
  • Release Country
  • Artwork
  • Composer
  • Label
  • Barcode
  • Cat No
  • ISRC
  • Lyricist
  • Conductor
  • Remixer
  • Genre

1.10. Submissions to Musicbrainz

In order to submit data to MusicBrainz you need to have a user account, these are completely free and can be created at the MusicBrainz Website. If you have a user account specify your username and password in this tab in the MusicBrainz Username and MusicBrainz password fields. By submitting data to Musicbrainz you are helping to improve this open source database and maintain the most accurate music resource in existence. By submitting information for songs that you own you create an archive of information that will never be lost even if your own files get damaged. Currently the majority of information that is contributed to Musicbrainz is via their website, but you can contribute some information automatically via Jaikoz. if you do this please ensure the information you submit is accurate and of a high quality.

1.10.1. Submit MusicBrainz/PUID Pair

If you successfully create an Acoustic Id (MusicIP PUID) for a track and you have successfully found a match on MusicBrainz, and your track has a Music Brainz Unique File Id, you can submit the pairing to MusicBrainz the database. You should only submit a pairing if you have confirmed that the pairing has been correctly and identified and you should not submit the same pairing more than once.

1.10.2. Submit MusicBrainz Genres

Musicbrainz has a Folksonomy cloud that can be used to tag artists, releases and tracks with anything you like. Jaikoz uses this to add genres at releases and track level. Because genres are subjective this feature is going to become more useful as more people submit their genres, so please give it a go. Jaikoz also uses the folksonomy cloud to fix the genre field when correcting songs from Musicbrainz.

1.10.3. Submit Musicbrainz Collection

Musicbrainz can store a list of the release you own and inform you of new releases by your favourite artists. Submitting releases can be done via the website but Submit Musicbrainz Collection provides an easier way to submit all the releases loaded in Jaikoz in one go.

2. Local Correct

Local correct groups together some powerful tasks that can be performed without an Internet connection, each task attempts to improve the data in one column. Most of the local correct tasks work in a similar fashion, this is explained fully in the Cross Referencing Correct section, the other local correct tasks are discussed next

2.1. Correct Artwork

Often artwork is not embedded into the Metadata but held as a separate file, sometimes it is not available at the same time and has to be retrieved later. But cover art is much more useful if it is embedded into the Metadata because only then will it be displayed in MusicPlayers such as iTunes and iPods. Correct Artwork checks the folders of the audio files you are correcting and adds any image files it finds to the audio file unless they have already been added. The following formats are supported JPEG,PNG and GIF

2.1.1. Maximum number of images that should be added automatically to one file

Many applications only show the first image, so you may decide to only add the first image.

2.1.2. Maximum size of images to be added (MB)

You may want to set a limit to the size of images that can be added, very large images will make your audio files correspondingly large.

2.2. Delete Duplicates

Delete duplicates based on Musicbrainz Id, MusicIP Id or MusicBrainz Id/MusicIP Id

2.3. Correct Track Nos

This task correct the format of track number, using the specified options

2.3.1. Preserve Track/Total Setting

You can preserve or remove the trackNo/Total format where found

2.3.2. Zeroise Track

You can zerorise track numbers to enable sorting

2.4. Cross Referencing Correct - Correct Artists/Albums/Titles/Genres/Recording Times/Comments/Composers

If you have a number of Audio Files that you wish to adjust the data for the chances are at least some of them are by the same Artist and from the same Album. However if the source for these files are different the Metadata may be subtletly different,this means that when you try and play all tracks by a particular group or artist they do not all appear. For example the following artists are all different,but only slightly

  1. Flatuella Blurb - All words start with a capital letter

  2. Flatuella blurb- First words start with a capital letter

  3. The Flatuella Blurb - Additional definite article

  4. Blurb Flatuella - Words in different order

  5. Flatuella Blorb - Misspelling of second word

  6. Flatuella Blurb - Extra white space character at end of word

  7. Flatuella_Blurb - Words separated by underscore character

  8. Flatuella Blurbs - Extra punctuation

Which is the correct answer?

Item five is a misspelling so it is not this,item four is not that easy to read but is the accepted format for some audio encoders, any of the others could conceivably be ok. The correct answer really depends upon your personal preference. AutoFormat allows you to automatically modify values to to your personal taste.Are all these artists the same band, as a human reading this document it should be obvious that they are but to a computer it is not. But AutoMatch can detect these similar values, again the similarity is defined by you.

Cross Referencing Correct trys to work out which is the correct value to use by a combination of comparing similar values, and user options. Local Correct is available for the following fields

  1. Artist

  2. Album

  3. Listitem

  4. Genre

  5. Recording Time

  6. Comments

  7. Composer

2.4.1. How it Works

Cross Referencing Correct works on a column by column basis,it identifies similar values and converts all similar values to the most common value. The procedure is as follows

  1. Create an empty new list

  2. For each record retrieve the Field Value relating to that column

  3. Using the options defined in AutoMatch Preferences calculate a Match Value

  4. Using the options defined in AutoFormat Preferences calculate a Format Value

  5. Has this field been found before, if not add it to the list with Count of zero

  6. If it has just increment the Count of this field in the list

  7. Sort the list by their Match Value and then Count,highest count first.

  8. If a record has the same Match Value as its preceding record set its Format Value to the same as the previous records Format Value.

  9. Go through each Audio File record and find the record in the list with the same Field Value and set the name in the Audio record to the Format Value.

2.4.2. AutoMatch Preferences

You can decide on what the Correcter deems is similar when matching by selecting options from the Auto Match Preferences . The more options you enable the more matches the correcter will make but more false postives will also occur.

2.4.2.1. Match words that appear misspelt

Jaikoz can look for values that sound the same when spoken (based on English) but are spelt differently. For example Audio Bullies and Audio Bullys

2.4.2.2. Ignore Word Order when matching

If a field contains multiple words this option will ignore the order. This is particulary useful for Solo Artists because some Audio Encoders specify surname then firstname. For example 'Kate Bush' and 'Bush Kate' would match.

2.4.2.3. Ignore Case when matching

Ignore case when matching values. For example 'Flaming Lips' and 'Flaming lips' would match.

2.4.2.4. Ignore words in this list when matching

Certain common words in a Language are often used without much thought especially in group names. In English the biggest culprit is 'The'. This option allows to specify a Word Remover to use. For example 'Flaming Lips' and 'The Flaming Lips' would match.

2.4.2.5. Split into Words using these values

Earlier we looked at word order, but what defines a word. The Space character separates words but other characters such as '.' and ',' also separate words. Here you can specify a Word Separator which define show to break up words

2.4.3. AutoFormat Preferences

AutoFormat formats fields to save you from tedious typing , there are a number of options

2.4.3.1. Remove whitespace at start or end of value

This removes whitespace at the start or end of field values, this extra whitespace is marked pink in the field values

2.4.3.2. Remove Widespace

Widespace is when there is more than one space between words, this option removes the additional spaces so that there is only one space between words

2.4.3.3. Remove undisplayable characters

This option removes any characters found that do not relate to a character set, this works for all languages as defined in the Unicode standard, it is very useful for removing control characters

2.4.3.4. Capitalization

This option changes the case of the field, the options are as follows

  • No capitalization

  • Capitalize all words

  • Capitalize first word

  • Capitalize all letters

  • Lowercase all letters

If you select to Capitalize all words or Capitalize first words there a few improvements Jaikoz makes to simple capitalizing. The rules listed below are processed before the simple capitalization method of making the first letter upper case and the remaining letters of a word lowercase

  • O'Reilly rule

  • Mc rule

  • Acronym rule,words between 3 and 5 characters that contain only uppercase letters and numbers are not modified

2.4.3.5. Replace words by another word

Some words have acronyms or shorthands that can be used instead, this option allows you specify a Word Replacer to always use the one you want. For example 'ft' and 'Feat' are common shorthands for 'Featuring'. And '-' and '_' are often used instead of spaces.

2.4.3.6. Remove these Punctuation Characters

Specify a Punctuation Remover which will remove the list of characters you have specified from the resulting output.

3. File and Folder Correct

3.1. Shift Base Folder to Sub Folder

This shifts the last folder in the base folder over to become the first folder in the Sub Folder field, this is normally used in conjunction with the Correct Sub Folder From Tags action.

3.2. Shift Sub Folder to Base Folder

This shifts the first folder in the sub folder field over to become the last folder in the Base Folder field, this is normally used in conjunction with the Correct Sub Folder From Tags action.

3.3. Correct Tags from Filename

3.3.1. Example

3.3.2. Introduction

Usually fields provides more accurate information than the filename of the Audio File. But sometimes the field information is less accurate or missing information that can be found in the filename. However although there are some informal conventions for naming Audio Files, files can be a named in any way the user wishes, for example

  • Artist-Album-Title.mp3

  • Artist_Album_TrackNo_Title.mp3

  • Title Album.mp3

  • Title-Artist.mp3

With other applications when you extract information from a filename into fields you have to specify the format of the filename and how parts combine. But as can be seen from above different filenames are often formatted in different ways so it is impossible to process a number of records in one go.

But Jaikoz uses a special algorithm based on the general AutoCorrecter method to work out the the parts by comparing the filename not only with its corresponding fields but also the fields of all the other loaded Audio Files.

3.3.3. How it Works

Jaikoz assumes that filenames are made up only of

  • Artist

  • Album

  • Listitem

  • Track No

  • Characters to separate the fields

  • File Type (e.g.mp3)

The correction will take the following steps

  • Generate a list of audio files where it may be useful to extract information from the filename. Tags which already contain an Artist,Listitem and Album value are not included.

  • Run the AutoCorrecter algorithm on the filename using filename preferences this will generate a Filename List of distinct filenames together with a Word Count, words are calculated based on the Split Filename option specified in your Tags from Filename Settings. Note because The listitem is commonly separated only with the space character the space character should not be defined as a suitable word separator character for separating parts of the filename(i.e Artist from Album)

  • For each record in the FileName List.

    • Compare every word with all the Artists in the Artist Column, similarity is based on the Split Words option specified in your Tags from Filename Preferences. If it finds a match mark the word as being an Artist.

    • Compare every word except for marked words with all the Album in the Album Column,similarity is based on the Split Words Word Separator. If it finds a match mark the word as being an Album

    • Check all words except marked words to see if they are a number, if they are mark the word as being a track number.

  • For each record in Filename

    • Compare the number of words with the number of marked words, if no matches have yet been made

      • If number of words=3 assume filename format is Artist Album Listitem

        • Mark first word as artist

        • Mark next word as album

        • Mark next word as listitem.

      • If number of words=2 assume filename format is Artist Listitem

        • Mark first word as artist

        • mark next word as listitem.

      • If number of words=1 assume filename format is Listitem

        • Mark first word as listitem

  • For every file

    • If number of unmarked words is 1

      • If listitem not set set to Listitem

      • else if artist not set set to Artist

      • else if album not set set to Album

      • else do nothing

    • If number of unmarked words is 2

      • If listitem not set set to Listitem

      • else if artist not set set to Artist

      • else if album not set set to Album

    • If number of unmarked words is 3

      • If listitem not set set to Listitem

      • else if artist not set set to Artist

      • else if album not set set to Album

  • For every Audio File

    • If we decided to process this Audio File find match in Filename List

    • If matched Artist set TagArtist to filename Artist

    • If matched Album set TagAlbum to filename Album

    • If matched Listitem set TagListitem to filenameListitem

    • If matched Track set TagTrack to filename Track

3.3.4. Split the Filename using these words

When using Correct Tags From Filename, you need to specify two word separators. The first is this one which is used to split the filename. The second one is used to compare the split parts of the filename with the other columns.

3.4. Correct Filenames from Tags

This modifies the Filename to reflect the values of the fields within the tag. The AutoCorrecter applies the formatting mask specified and generates a new filename. It may be better to use the Album Artist rather than the Artist in your mask because when you have compilation albums because for these albums the Album Artist is usually Various Artists whereas the Artist field would change on a track by track basis, for regular albums both values would normally be the same.

3.5. Correct Sub Folders from Tags

It is usually useful to stores Audio Files on your computer in multiple subfolders for example by having a different subfolder for every artist. The AutoCorrecter applies the formatting mask specified and generates a subfolder. It may be better to use the Album Artist rather than the Artist in your mask because when you have compilation albums because for these albums the Album Artist is usually Various Artists whereas the Artist field would change on a track by track basis, for regular albums both values would normally be the same.

4. Delete Duplicates

Delete duplicates find records that appear to be the same song and marks for deletions all the duplicates, no records are actually deleted until changes are saved. By default Jaikoz identifies duplicates by looking for files with duplicate MusicBrainz Ids , but in the preferences you can change this to find duplicates based on their MusicIP Id or their MusicBrainz Id AND Music Ip Id. Jaikoz compares the duplicate files by their Audio Format, Bitrate, File size and Track Duration and deletes the files with the lowest quality.

5. Auto Correcter

The AutoCorrecter allows you batch up the various Local Correct/File and Folder Correct and MusicBrainz Correct tasks, it can also save changes to your files automatically

The full list of tasks available is as follows

  • Correct Artist
  • Correct Album
  • Correct Listitem
  • Correct Track
  • Correct Genre
  • Correct Recording Times
  • Correct Comment
  • Correct Tags from Filename
  • Correct SubFolder From Tags
  • Correct Filename From Tags
  • Correct Tags From MusicBrainz
  • Correct Composer
  • Correct Local Artwork
  • Retrieve Acoustic Ids
  • Save Changes
  • Cluster Albums
  • Updates tags from Existing MusicBrainz Ids
  • Updates tags from Existing Discogs Ids
  • Correct Lyrics

By default the AutoCorrecter does not run the actions that modify filenames and folders, actions that require internet access and saving changes. However all can easily be configured in the AutoCorrecter if required. For example you could set up the Autocorrecter to simply Retrieve Acoustic Ids and then save changes to the files, this allows you to complete this task unattended. Because Acoustic Ids are correct there is no need to review them before saving the changes.

Chapter 7. ITunes

You can configure Jaikoz to update your iTunes database when you save changes to files, this is enabled by default

If you do update iTunes from Jaikoz it is recommended that within iTunes own Preferences you disable the Advanced\Keep iTunes Music Folders organized option because otherwise iTunes may move files that you are still working on within Jaikoz, it will do this if you are working on files that are within the iTunes music folder location.

You must check Automatically update iTunes library to have iTunes integration. The iTunes Library xml file is found automatically by Jaikoz , but if you have an unusual iTunes configuration you may need to modify this, Jaikoz assumes the corresponding iTunes database file is in the same location.

If Create an iTunes playlist of all tracks added or updated by Jaikoz is checked then an iTunes playlist is created each time you save some changes listing all the files edited or added in Jaikoz where the corresponding file could be found in the iTunes library. If you move a file in Jaikoz it will show as a new file in iTunes.

If When a track is deleted or moved remove the old reference in iTunes is checked Jaikoz will try to remove references to non-existent files.

If Add new tracks not currently in iTunes to iTunes is checked any files saved in Jaikoz will be added to iTunes, if it is not checked Jaikoz will only add files if they already existed in the iTunes database. Usually you would want this option checked, unless you do not use iTunes for all your music tracks.

Chapter 8. Data Fields

Table of Contents

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

1. Metadata Fields

These represent the Audio Information

1.1. Jaikoz Fields

These fields are not part of the tags themselves but provide important information about the Tags

1.1.1. Row Number

Each record is allocated a row number numbered in the order the records were loaded,this cannot be modifed by you..The Row Menu Popup can be started by clicking on the row number. If you mark records for deletion and then save changes the successfully deleted records will disappear from Jaikoz and the records will be renumbered

1.1.2. Status

This represents the tag status, you cannot edit this field yourself.

  • C Tag has been changed

  • D Tag has been marked for deletion

  • Tag is unchanged

1.1.3. Version

Describes the tag versions in the file.

When you first load new files into Jaikoz it will check your Save Options. If your save options mean you want to save different tags then currently exist in the file, the version field and record status will be set to Changed. When editing this is a Selectable Combo .When saving the file it will create tag(s) of these version(s)

Warning if you edit fields which are not supported by the underlying version they will not be saved. For example if you add an Attached Picture and then select to only save a V1 Tag it will not be saved because ID3v1 does not support attached pictures.

1.2. File Location Fields

Be careful when modifying these files, if your files are already in a Music Library such as iTunes, because it may prevent iTunes from finding them. It is recommended that you run Jaikoz on your files before you add them to iTunes.

1.2.1. Base Folder

In the Read Panel this is the root of where you loaded the files from. When you first start Save Folder Preferences/Read Folder is used as the default location to read Audio Files from, you can shift folders from the Base Folder to the Sub Folder with the Shift Base Folder to Sub Folder action. In the Edit Panel this is the root of where you will save your files to, upon loading the file it will always start the same as for the read panel but you can modify it to an existing folder location here AutoFix will check the folder exists

1.2.2. Sub Folder

In the Read Panel this will indicate the subfolder the file is within if when loading you specified includesubdirs.

In the Edit Panel this will indicate the subfolder to write the file to, upon loading the file it will always start the same as for the read panel but you can manually enter any valid subfolder name for your operating system here. AutoFix will check the subfolder is a valid name for the operating system.

This is automatically populated by the Correct Sub Folder from Tags action, this uses output mask specified in Rename Sub Folder Preferences, you can shift folders from the Sub Folder to the Base Folder with the Shift Sub Folder to Base Folder action

1.2.3. Filename

In the Read Panel this is the name of the Audio File

In the Edit Panel this is the new name of the Audio File, upon loading the file it will always start the same as for the read panel, but you can manually enter any valid filename name for the operating system here. AutoFix will check the name is a valid name for the operating system, has a valid extension and does not have the same name as another loaded file.

This is automatically modified by the Correct Filenames from Tags action, you can specify an output mask for the filename in Rename File Preferences

1.3. Metadata Fields

These are the fields that can be directly view and edited within the View and Edit Panels, and the Detail Panel. These fields should be supported by most Audio Formats.

1.3.1. Artist

The artist performing on the recording.

1.3.2. Album

The album that this recording belongs. More accurately refers to the release that the tracks belongs, for example it may be a single or an E.P rather than an album

1.3.3. Track No

This the track number of the recording on the album.

In the Edit Panel you can enter the track number, there are four accepted formats

  • Zeroed Track Number -

    Are of the form 01,02,03-11,12.. this has the advantage the track number will be sorted correctly. If the Track Number is used to generate the filename this will also be sorted correctly

  • Non-zeroed Track Number

    Are of the form 1,2,3,..11,12 these may not be sorted properly for example 12 would come before 2

  • Zeroed Track Number/Total

    Are of the form 01/10,02/10.... where the Total is the total number of tracks on the recording that this is part of.

  • Non-zeroed Track Number/Total

    Are of the form 1/10,2/10.... where the Total is the total number of tracks on the recording that this is part of

This is automatically populated by the Correct Track Nos Action, using options specified in Track No Preferences

1.3.4. Title

This the name of the recording.

1.3.5. Genre

Displays the first genre this Audio File belongs to

In the Edit Panel editing the field will bring up an Editable Combo you can select one from the predefined list or enter your own. Genre support multiple values opening the Popup Window allow you to enter additional genres.

This is automatically populated by the Correct Genres Action using options specified in Genre Preferences.

1.3.6. Year

Displays the Year, actually this displays the Recording Time that can be a full date and time, but most players expect it to be just a year. The Valid formats are here

You can AutoCorrect the Recording Time with the Correct Recording Times using options specified in Recording Time Preferences.

1.3.7. Comment

Displays a comment description. Comment is a multi value field with multiple attributes but Description is the one you are most interested.

In the Edit Panel you can edit the comment description of the first comment . A comment comprises the language it is written in,a short description of the comment, and the comment itself. Selecting Multi Field Count allows you to edit these other attribute or add extra comments

This is automatically populated by the Correct Comments Action using options specified in Comment Preferences.

1.3.8. Album Artist (Accompanient)

The Artist for the album, this is most useful in Various Artist compilations. This field was originally defined by ID3 as the Accompanient but is rarely used for this purpose.

1.3.9. Composer

Defines the composer of a piece of music

1.3.10. Artwork

Images can be attached to a recording such as album art. This is a multi value field with multiple attributes, a thumbnail of the first image is displayed in the View Panel

From the Edit Panel you can select Multi Field Count to add new images

An image consists of

  • The Image itself, you can add an image with the SelectFile button. You should take care to add images of a suitable type and size, only images in JPG format should be added for maximum portability and you should scale the image so that its file size is not too large

  • A name, this is a text field where you can give the image a name

  • A type, this is a Selectable Combo where you select a type from a predefined list

The list on the lefthandside shows all images attached to this audio file. It shows additional attributes than cannot be modified.

  • The dimensions of the image in pixels

  • The size of the picture in bytes

Sometimes you may load an Audio File which contains an Image field but no actual picture because the tagging information was incorrectly created with another application. You can still edit this field with Jaikoz but wll not see a preview until you add a new valid image.

If may contain an image field with a picture in a format not supported by Jaikoz, in this case no preview will be displayed but you can still edit the other attributes of the image.

The supported Image Types are:

  • JPEG

  • GIF

  • PNG

1.3.11. Grouping

This allows you to link a number of tracks by giving them the same grouping value.

1.3.12. Disc No (Part of a Set)

Identifies that this field is a part of a set grouped with other fields with the same set number. usually applies to a disc number within a multi disc release so is more commonly known as Disc No.

1.3.13. BPM (beats per minute)

Beats per minute

1.3.14. MusicBrainz Artist Id

The Music Brainz Artist Id allows you to access MusicBrainz Information on the Web for the associated artist.

1.3.15. MusicBrainz Release Id

The Music Brainz Release Id allows you to access MusicBrainz Information on the Web for the associated release/album.

1.3.16. MusicBrainz Release Artist Id

The Music Brainz Release Artist Id allows you to access MusicBrainz Information on the Web for the associated album artist.

1.3.17. MusicBrainz Unique Id

In Jaikoz upon a successful MusicBrainz match the Music Brainz Unique Id is added to this field allowing you to access Music Brainz Information on the Web.

1.3.18. MusicBrainz Disc Id

The Music Brainz Disc Id relates the track to the physical recording that it was taken from such as a CD pressing

1.3.19. MusicIP Id

The MusicIP Id is a unique acoustic identifier for the file, as calculated by MusicIP.

1.3.20. Amazon Id

Amazon Id is the Amazon Identification for the associated album/release.

1.3.21. Release Status

Release status is a MusicBrainz category used to categorize releases statuses, the allowable values are.

Official
Promotion
Bootleg
Pseudo-Release

1.3.22. Release Type

Release type is a MusicBrainz category used to categorize releases types, the allowable values are

Album
Single
EP
Compilation
Soundtrack
Spoken word
Interview
Audiobook
Live
Remix
Other

1.3.23. Release Country

Country of release for the associated release.

1.3.24. Lyrics

lyrics

1.3.25. Is Compilation

Defines that this track is part of a compilation, originally used by iTunes but now in widepread use

1.3.26. Sort Artist

This defines a value which should be used instead of the artist for sorting purposes.

1.3.27. Sort Album Artist

Defines the sort name for the album artist, this is currently only used by iTunes

1.3.28. Sort Album

This defines a value which should be used instead of the album name for sorting purposes. e.g. an album named "A Soundtrack" might preferably be sorted as "Soundtrack".

1.3.29. Sort Title

This defines a value which should be used instead of the title for sorting purposes.

1.3.30. Sort Composer

Defines the sort name for the composer, this is currently only used by iTunes

1.3.31. Encoder

The encoder that encoded the track. For some audio formats (Ogg,Flac,Mp4) modifying this field will affect the field in the Audio tab when reloaded, because they are both displaying the same field. MP3 files do not allow modification of the field in the Audio tab, so setting this field in the ID3 tag, will not affect the field in the audio tab.

1.3.32. ISRC

International Standard Recording Code (ISRC) for the release, defined by ISO 3901, it is an international standard code for uniquely identifying sound recordings and music video recordings. IFPI has been appointed by ISO as registration authority for this standard. The ISO technical committee 46, subcommittee 9 (TC 46/SC 9) is responsible for the standard.

1.3.33. Label

Record label that this release was released on.

1.3.34. Barcode of the release

1.3.35. Catalog No

Catalog no of the releases, this is allocated by the Record Label.

1.3.36. Media

What format is the media, for example Vinyl or CD.

1.3.37. Mood

Can be used to describe the mood of the song.

1.3.38. Lyricist

Who wrotes the lyrics for the song.

1.3.39. Conductor of the music.

1.3.40. Remixer

Remixer of the track.

1.3.41. Release Discogs Url

Url of a Discogs page that describes the release. Discogs may contain additional information that isnt currently held in Musicbrainz.

1.3.42. Release Wikipedia Url

Url of a Wikipedia page that describes the release. Discogs may contain additional information that isnt currently held in Musicbrainz.

1.3.43. Release Official Url

Url of an official webpage that describes the release. This may contain additional information that isnt currently held in Musicbrainz.

1.3.44. Artist Discogs Url

Url of a Discogs page that describes the artist. Discogs may contain additional information that isnt currently held in Musicbrainz.

1.3.45. Artist Wikipedia Url

Url of a Wikipedia page that descibes the artist. Wikipedia may contain additional information that isnt currently held in Musicbrainz.

1.3.46. Artist Official Url

Url of an official webpage that describes the artist. This may contain additional information that isnt currently held in Musicbrainz.

1.4. Audio Fields

These are the fields displayed in the View Audio Tab, this is for your information only you cannot modify these values.

1.4.1. Size

This is the size of the file

1.4.2. Format

This shows the audio format. For example for MP3s this combines the MPEG Version and Layer. The version is related to the sampling rate the original file was sampled at. Most music and audio book tracks use Version 1 which can sample information at CD quality (44Mhz), whereas Version 2 and Version 2.5 can be used to sample at lower rates, typically they are used in niche applications such as sampling sound effects. For MP3 the layer will always be three, MP2 would have a value of two, and MP1 files would have a value of one.

1.4.3. Bit Rate

This displays the sampling rate used to create this file,usually the higher the bit rate the better quality the encoding. If variable bit rate is used it will be shown in brackets after the average bit rate e.g 192kbps (VBR)

1.4.4. Playing Time

The length of the audio track in seconds

1.4.5. Encoder

The encoder that encoded the track. For some audio formats (Ogg,Flac,Mp4) this fields can be modified by editing the Encoder field in the edit tab. MP3 files do not allow modification of this field, but you can set a corresponding field in the ID3 tag.

1.4.6. Emphasis

Emphasis

1.4.7. Channel Mode

Channel Mode

1.4.8. Sample Rate

This displays the sampling rate of the original audio source

1.4.9. Is Copyright

Is this Audio File copyrighted (MP3 only)

1.4.10. Is Original

Is this the original Audio File (MP3 only)

1.4.11. Is Private

Is this the Audio File private (MP3 only)

1.4.12. Is Protected

Is this the Audio File protected (MP3 only)

1.4.13. Is VBR

Is this Audio File encoded using Variable Bit Rate this means that the sampling rate varies depending on the content. This allows better quality encoding in smaller files.

2. ID3 Fields

This section explains the ID3 tabs and fields, as used by MP3 files and differences between the versions of ID3. Because of the complexity of ID3, MP3 files can be edited either using the generic Edit Panel or using the ID3 Edit Panel. Usually the generic view is the easiest option, but the ID3 view provides access to fields in a way that maps directly to how they are stored and some fields that are currently not displayed in the Metadata view

2.1. ID3 Fields

These are fields that directly correspond to a field in the ID3v24 Specification, each of these fields can be seen as a column with the View and Edit Panels

2.1.1. Unique File Identifier

The unique file identifier is used by some online music databases to identify a track. In Jaikoz upon a successful MusicBrainz match the Music Brainz Unique Id is added to this field allowing you to access Music Brainz Information on the Web.

2.1.2. Artist

The artist performing on the recording.

2.1.3. Album

The album that this recording belongs. More accurately refers to the release that the tracks belongs, for example it may be a single or an E.P rather than an album

2.1.4. Title

This the name of the recording.

2.1.5. Track No

This the track number of the recording on the album.

In the Edit Panel you can enter the track number, there are four accepted formats

  • Zeroed Track Number -

    Are of the form 01,02,03-11,12.. this has the advantage the track number will be sorted correctly. If the Track Number is used to generate the filename this will also be sorted correctly

  • Non-zeroed Track Number

    Are of the form 1,2,3,..11,12 these may not be sorted properly for example 12 would come before 2

  • Zeroed Track Number/Total

    Are of the form 01/10,02/10.... where the Total is the total number of tracks on the recording that this is part of.

  • Non-zeroed Track Number/Total

    Are of the form 1/10,2/10.... where the Total is the total number of tracks on the recording that this is part of

This is automatically populated by the Correct Track Nos Action, using options specified in Track No Preferences

2.1.6. Cover Art

Images can be attached to a recording such as album art. This is a multi value field with multiple attributes, a thumbnail of the first image is displayed in the View Panel

From the Edit Panel you can select Multi Field Count to add new images

An image consists of

  • The Image itself, you can add an image with the SelectFile button. You should take care to add images of a suitable type and size, only images in JPG format should be added for maximum portability and you should scale the image so that its file size is not too large

  • A name, this is a text field where you can give the image a name

  • A type, this is a Selectable Combo where you select a type from a predefined list

The list on the lefthandside shows all images attached to this audio file. It shows additional attributes than cannot be modified.

  • The dimensions of the image in pixels

  • The size of the picture in bytes

Sometimes you may load an Audio File which contains an Image field but no actual picture because the tagging information was incorrectly created with another application. You can still edit this field with Jaikoz but wll not see a preview until you add a new valid image.

If may contain an image field with a picture in a format not supported by Jaikoz, in this case no preview will be displayed but you can still edit the other attributes of the image.

The supported Image Types are:

  • JPEG

  • GIF

  • PNG

2.1.7. Genre

Displays the first genre this Audio File belongs to

In the Edit Panel editing the field will bring up an Editable Combo you can select one from the predefined list or enter your own. Genre support multiple values opening the Popup Window allow you to enter additional genres.

This is automatically populated by the Correct Genres Action using options specified in Genre Preferences.

2.1.8. Year

Displays the Year, actually this displays the Recording Time that can be a full date and time, but most players expect it to be just a year. The Valid formats are here

You can AutoCorrect the Recording Time with the Correct Recording Times using options specified in Recording Time Preferences.

2.1.9. Comment

Displays a comment description. Comment is a multi value field with multiple attributes but Description is the one you are most interested.

In the Edit Panel you can edit the comment description of the first comment . A comment comprises the language it is written in,a short description of the comment, and the comment itself. Selecting Multi Field Count allows you to edit these other attribute or add extra comments

This is automatically populated by the Correct Comments Action using options specified in Comment Preferences.

2.1.10. User Defined URL

Displays a User Defined URL, this should be used to specify a URL which does not fit into any of the other fields. This is a multi value field with multiple attributes

In the Edit Panel you can edit the URL of the first URL. A User Defined URL comprises a short description of the it, and the User Defined URL value itself. Selecting Multi Field Count allows you to edit these other attribute or add urls.

2.1.11. User Defined Text Information

Any other text information not covered by any of the other fields.This is a multi value field with multiple attributes

In the Edit Panel you can edit the text of the User Defined Text Information. User Defined Text Information comprises a description of which cateorises the text, and the text itself. Selecting Multi Field Count allows you to edit these other attribute or add extra information. MusicBrainz stores values in this field when there is not a suitable alternative.

2.1.12. Composer

Defines the composer of a piece of music

2.1.13. Copyright Info

Copyright for the piece of music

2.1.14. Encode By

The name of the application used to encode the track into an MP3. This field can be modified but it will not affect the value held in the Audio tab.

2.1.15. Original Artist

The original artist if this Audio File is a cover version

2.1.16. BPM (beats per minute)

Beats per minute

2.1.17. Encoding Time

The Date/Time when the original music file was encoded to MP3. The Valid formats are here

2.1.18. Playlist Delay

2.1.19. Original Release Time

The Date/Time when the recording was originally released if this recording is a rerelease. The Valid formats are here

2.1.20. Release time

The Date/Time when the original music file was released. The Valid formats are here

2.1.21. Tagging Time

The Date/Time when the Audio File was tagged The Valid formats are here

2.1.22. Lyricist

Songwriter of the recording.

2.1.23. File Type

The format of the encoded recording, should always be MP3

The Edit Panel provides a combo box specifying a list of encoded recording file types.

2.1.24. Involved People List

Other people involved in the recording.

2.1.25. Grouping

This allows you to link a number of tracks by giving them the same grouping value.

2.1.26. Title/Songname/Content Description

Further subcategorisation of title

2.1.27. Initial Key

The key the recording is keyed in.

2.1.28. Language(s)

The language the recording is sung in.

2.1.29. Length

The Length of the recording. THis is not normally used because normally the length can be accuraely determined from the audio header

2.1.30. Musician Credits List

Musicians playing on the recording.

2.1.31. Media Type

The format of the original recording that the Audio File was encoded from such as LP or CD

In the Edit Panel provides a combo box specifying a list of media types.

2.1.32. Mood

The mood of the recording such as 'Sad'

2.1.33. Original Album/Movie/Show Title

If the recording was part of a filem soundtrack, the film should be specified here.

2.1.34. Original Filename

Original name of the encoding of the recording.

2.1.35. Original Lyricist(s)

Original Lyricist(s)/text writer(s)

2.1.36. File Owner/Licensee

Who owns this file.

2.1.37. Album Artist (Accompanient)

The Artist for the album, this is most useful in Various Artist compilations. This field was originally defined by ID3 as the Accompanient but is rarely used for this purpose.

2.1.38. Conductor/Performer refinement

The name of the conductor on a recording

2.1.39. Remixed

The name of the musician who Interpreted, remixed, or otherwise modified recording

2.1.40. Disc No (Part of a Set)

Identifies that this field is a part of a set grouped with other fields with the same set number. usually applies to a disc number within a multi disc release so is more commonly known as Disc No.

2.1.41. Produced Notice

Produced notice

2.1.42. Publisher

Publisher of the recording

2.1.43. Internet Radio Station Name

This contains the name of the internet radio station from which the audio is streamed.

2.1.44. Internet Radio Station Owner

This contains the name of the owner of the internet radio station from which the audio is streamed.

2.1.45. Sort Album

This defines a value which should be used instead of the album name for sorting purposes. e.g. an album named "A Soundtrack" might preferably be sorted as "Soundtrack".

2.1.46. Sort Artist

This defines a value which should be used instead of the artist for sorting purposes.

2.1.47. Sort Title

This defines a value which should be used instead of the title for sorting purposes.

2.1.48. ISRC

ISRC (international standard recording code) for the recording

2.1.49. Encoding Preferences

Specific values used in the encoding

2.1.50. Set Subtitle

Set subtitle

2.1.51. URL: Commercial Information

This is a URL pointing at a webpage with information such as where the album can be bought.

2.1.52. URL: Copyright/Legal Information

This is a URL pointing at a webpage where the terms of use and ownership of the recording is described.

2.1.53. URL: Official Song Web Page

This a URL pointing at a file specific webpage.

2.1.54. URL: Official Artist Web Page

This a URL pointing at the artists official webpage.

2.1.55. URL: Official Audio Source Web Page

This a URL pointing at the official webpage for the source of the audio file, e.g. a movie.

2.1.56. URL: Official Internet Radio Web Page

This is a URL pointing at the homepage of the internet radio station.

2.1.57. URL: Payment

This a URL pointing at a webpage that will handle the process of paying for this file.

2.1.58. URL: Publishers Official Web Page

This a URL pointing at the official webpage for the publisher.

2.1.59. Play Counter

How many times has this recording been played.

2.2. ID3 Extended Fields

Jaikoz recognises a small number of additional fields that are not part of the ID3 standard, but are in widespread use.

2.2.1. Is Compilation

Defines that this track is part of a compilation, originally used by iTunes but now in widepread use

2.2.2. Sort Album Artist

Defines the sort name for the album artist, this is currently only used by iTunes

2.2.3. Sort Composer

Defines the sort name for the composer, this is currently only used by iTunes

2.3. Tag Field Groups

These are groupings of ID3 fields that are not fully supported by Jaikoz

2.3.1. Not Supported Field

This lists all fields that are found within a tag which are recognised by Jaikoz but are not fully supported, Jaikoz recognises all fields specified in the ID3 Specification. Jaikoz supports all fields that are easy for uses to edit but some fields are very specialized and of limited use. These are the fields recognised but editing is not supported. Jaikoz displays the identifier and trys to display the field value

Table 8.1. Not Supported Fields

ID3 Identifier Name
AENC Audio encryption
ASPI Audio seek point index
COMR Commercial frame
ENCR Encryption method registration
EQUA2 Equalisation (2)
ETCO Event timing codes
GEOB General encapsulated object
GRID Group identification registration
LINK Linked information
MCDI Music CD identifier
MLLT MPEG location lookup table
OWNE Ownership
PRIV Private frame
POPM Popularimeter
POSS Position synchronisation
RBUF Recommended buffer size
RVA2 Relative volume adjustment (2)
RVRB Reverb
SEEK Seek frame
SIGN Signature frame
SYLT Synchronised lyric/text
SYLC Synchronised tempo codes
USER Terms of use

From the Edit Panel although you cannot edit these fields you are able to remove them. If you select the Popup Menu and select Delete all unsupported fields are marked for removal. If you select the Multi Field Count you can elect to delete individual fields. Deleting fields will not effect the encoded recording but they may be required by an application you use to play Audio Files.

2.3.2. Unknown Fields

ID3 allows users and application to define their own fields, this lists all fields that are not standard and hence not recognised by Jaikoz

From the Edit Panel although you cannot edit these fields you are able to remove them. If you select the Popup Menu and select Delete all unsupported fields are marked for removal. If you select the Multi Field Count you can elect to delete individual fields. Deleting fields will not effect the encoded recording but they may be required by an application you use to play Audio Files.

2.4. Data Formats common to multiple Fields

2.4.1. Date Time Formats

Date Time fields formats are as follows, you can enter dates in any of these formats

YYYY
YYYY-MM
YYYY-MM-dd
YYYY-MM-dd:HH
YYYY-MM-dd:HH:MM
YYYY-MM-dd:HH:MM:SS

where

YYYY is a 4 digit year
MM is a 2 digit month
dd is a 2 digit day of month
HH is a 2 digit hour
MM is a 2 digit minute
SS is a 2 digit second

2.5. ID3 Tag Compatability

The Id3 View Merged Tab and ID3 Edit Panel show a view of the tag data as it would be stored in ID3v24. When changes to tags are saved to some other version some conversion has to occur.

2.5.1. ID3v2.4 Compatibility

The rarely used encryption scheme is not currently supported

2.5.2. ID3v1 Compatibility

ID3v1 supports the following fields only, and the fields have maximum fields lengths.

Table 8.2. ID3v1 Fields

Name Maximum Length
Artist 30
Album 30
Title 30
Genre 1
Recording Time 4
Comment 28
Track Number 1

When saving changes the values in the Edit Panel only predefined Genres will be saved. Only one Comment is allowed. Recording Time will only save the Year part of the recording time. Characters that are not part of the Standard European Character set will not be stored

2.5.3. ID3v2.2 Compatability

ID3v2.2 does not support sort fields, but iTunes does provide extended ID3 Tag fields. So when Sort Fields are saved to a ID3v2.2 the iTunes fields are used.

ID3v2.2 does not support the following fields, they will not be saved.

  • Mood

  • Produced Notice

  • Musicians Credits

2.5.4. ID3v2.3 Compatability

ID3v2.3 does not support sort fields, but iTunes does provide extended ID3 Tag fields. So when Sort Fields are saved to a ID3v2.3 the iTunes fields are used. Jaikoz also recognizes the alternative fields used by MusicBrainz (XSOP and XSOT).

ID3v2.3 does not support the following fields, they will not be saved.

  • Mood

  • Produced Notice

  • Musicians Credits

3. Ogg Vorbis Fields

This section explains some details of the Ogg Vorbis implementation

3.1. General usage

Jaikoz supports Ogg Vorbis Comments of any size. However many Music Players will only read upto 64kb of Metadata for this reason you might want to be careful when adding Metadata to not exceed that limit

Ogg Vorbis does not allow empty values so if you save a value with an empty value it will actually be deleted fron the file.

3.2. Cover Art

There is no offical way to add cover art to Ogg Vorbis but Jaikoz supports the common defacto standard of base64 encoding the image as used by Audio shell http://www.softpointer.com/AudioShell.htm, a restriction of this is that only one image can be added. For maximum compatbility with other applications you should try to add images that are not too large, so that the 64kb limit is not reached

3.3. Other Fields

Jaikoz supports all the fields within the Metadata View for use with OggVorbis. Other fields within OggVorbis are not currently shown within Jaikoz but will be preserved.

4. Mp4 Fields

This section explains some details of the Mp4 implementation

4.1. File Formats

Jaikoz supports M4a Files, Mp4 Audio Files and M4p Audio Files. Jaikoz will not open mp4 files that contain video, only audio tracks. Jaikoz can open and edit Protected Audio Files, this does not effect the protection mechanism

4.2. M4p Protected Files

Jaikoz can safetly edit protected files, the only functionality that is not available is the generation of Acoustic Ids for these files because the audio cannot be decoded.

4.3. General usage

Jaikoz supports writing values to Mp4 fields all the fields within the Metadata View. Other fields within Mp4 are not currently shown within Jaikoz but will be preserved. Note Mp4 does not allow multiple values to be entered for any fields, except for artwork. So if you add multiple values for any field (other than artwork) only the first field will be saved.

5. Flac Fields

This section explains some details of the Flac implementation

5.1. General usage

Jaikoz supports Flac of any size. However many Music Players will only read upto 64kb of Metadata for this reason you might want to be careful when adding Metadata to not exceed that limit

Flac does not allow empty values so if you save a value with an empty value it will actually be deleted fron the file.

Chapter 9. Menus

Table of Contents

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

1. Main Menu

1.1. Jaikoz

1.1.1. About Jaikoz

Describes this version of Jaikoz, the user license agreement and acknowledges the third party products used.

1.1.2. Preferences

Show the Jaikoz preferences window.

1.1.3. Services

Jaikoz does not provide any OSX Services at the moment.

1.1.4. Hide Jaikoz

Hide the Jaikoz application.

1.1.5. Hide Others

Hide all visible application.

1.1.6. Show All

Show all open application.

1.1.7. Quit Jaikoz

Quit Jaikoz. If you have outstanding modifications to your prteferences but not saved them, you will see

click Yes to save preferences or No to not.

It will then check if you have modified any records. if you have you will see

click Yes to save changes or No not to.

After making any requested saves Jaikoz will exit.

1.2. File

1.2.1. Open Folder

If you are attempting to load a large number of files a Progress Monitor will display showing the file loading progress, if you want to stop loading click on Cancel and no further files will be loaded. You cannot start editing until the load has completed.

1.2.2. Add Folder

Use this to load further Audio Files into Jaikoz, without replacing currently loaded files.

1.2.3. Open Files

Use this to load Audio Files into Jaikoz, you can use this option to select one or more individual files from a directory without having to load all the files in the directory, any currently loadd files will be discarded.

1.2.4. Add Files

Use this to load additional Audio Files into Jaikoz, without replacing currently loaded files.

1.2.5. Close Files

Use this to close the files within Jaikoz. If you have modified the file you will be given the chance to save your changes.

1.2.6. Install Full license

This can be used to install a full license before your trial license has expired, once a full license has been installed this option is permanently disabled.

1.2.7. Save Preferences

This will save any changes you have made to your preferences to file so they will be preserved the next time you start Jaikoz. By default preferences are automatically saved when you exit Jaikoz anyway unless yo have disabled this option.

1.2.8. Save Changes

This will save changes you have made to all Audio Files, including marking files for deletion.

Once the save has completed, for all records successfully saved the View Panel will be updated to show the tag information as is currently held in the record, the Edit Panel will show the same as the Read Panel. Any records not successfully saved will still have a status of Changed or Deleted and the records data will be the same as before the editing was done. For more details about how save works see Saving Changes

1.2.9. Save And Move

This will save changes you have made to all files currently listed and move them to a different folder that you select. For more details about how save works see Saving Changes

The moved files will no longer be open in Jaikoz

1.2.10. Save And Copy

This will save changes you have made to all files currently listed and copy them to a different folder that you select. For more details about how save works see Saving Changes

1.2.11. Force Save

This will save changes you have made to all Audio Files, regardless of whether you have made any changes, including marking files for deletion. 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.

Once the save has completed for all records successfully saved the View Panel will be updated to show the tag information as is currently held in the record, the Edit Panel will show the same as the Read Panel. Any records not successfully saved will still have a status of Changed or Deleted and the records data will be the same as before the editing was done. For more details about how save works see Saving Changes

1.3. Edit

This Menu provides access to basic editing functions.

1.3.1. Copy from View Pane

Copies the selected items from the View Pane, multiple fields within a single column can be copied. This data can be pasted into another applications outside of Jaikoz if you wish.

1.3.2. Copy from Edit Pane

Copies the selected items from the Edit Pane

1.3.3. Paste

Pastes the previously copied values to the currently selected fields in the edit pane. If the copy area was larger than the selected paste area, then only the required number of fields are pasted, if the copy area was smaller than the the selected paste area, we reuse the copied fields in order to populate the paste area.

1.3.4. Paste All Values

Pastes the previously copied values (including multiple values if they have them) to the currently selected fields in the edit pane

1.3.5. Paste to Start

Pastes the previously copied values to the start of the currently selected fields in the edit pane, (separated by a space character).

1.3.6. Paste to End

Pastes the previously copied values to the end of the currently selected fields in the edit pane, (separated by a space character).

1.3.7. Remove Whitespace

This removes whitespace at the start or end of the currently selected fields in the edit pane.

1.3.8. Remove Widespace

Widespace is when there is more than one space between words, this option removes the additional spaces so that there is only one space between words in the currently selected fields in the edit pane

1.3.9. Delete

Deletes the currently selected fields in the edit pane

1.3.10. Find and Replace

Find and Replace in the edit pane

1.3.11. Capitalizer...

Change the case/capitalisation of the selected fields.

1.3.11.1. Title Case

Change the case to Title case. The lteers for most words is capitalized except for a list of words that should not be capitalized

1.3.11.2. Sentence Case

Change the case to Sentence case

1.3.11.3. Capitalize all letters

Change all letters to uppercase

1.3.11.4. Lowercase all letters

Change all letters to lowercase

1.3.12. Swap Columns...

Swap the data between two predefined columns. Swapping between the most popular columns are defined in this submenu, laternatively you can use the Swap to swap data between fields in two arbitary columns

1.3.12.1. Swap Artist with Album

Swap the data between these two columns

1.3.12.2. Swap Artist with Title

Swap the data between these two columns

1.3.12.3. Swap Artist with Track No

Swap the data between these two columns

1.3.12.4. Swap Artist with Comment

Swap the data between these two columns

1.3.12.5. Swap Album with Title

Swap the data between these two columns

1.3.12.6. Swap Album with Track No

Swap the data between these two columns

1.3.12.7. Swap Album with Comment

Swap the data between these two columns

1.3.12.8. Swap Title with Track No

Swap the data between these two columns

1.3.12.9. Swap Track No with Comment

Swap the data between these two columns

1.3.12.10. Swap Title with Comment

Swap the data between these two columns

1.3.13. Swap

This menu is available whenever you have selected some fields in two separate columns,selecting it will swap the contents of the fields from one column with the other

1.3.14. Prepend to Left

This menu is available whenever you have selected some fields in two separate columns,selecting it will copy the contents of the fields in the right column into the start of the fields in the left column (separated by a space character)

1.3.15. Prepend to Right

This menu is available whenever you have selected some fields in two separate columns,selecting it will copy the contents of the fields in the left column into the start of the fields in the right column (separated by a space character)

1.3.16. Renumber Track Nos

This menu is available whenever you have selected some fields in the track no column,selecting it will renumbers the fields starting from the value of the first field (based on the current sort order), or starting from one if the first field has no value. The renumbering is based on the current order of the files, the numbering takes into account your Track No Preferences

1.4. View

This menu allows you to hide or show various components, your configuration is always automatically saved between invocations of Jaikoz without you having to save preferences.

1.4.1. Show View Pane

From here you can toggle between showing/hiding the View Pane. By default the View Pane is not shown because hiding it provides a simpler interface,providing more space for editing right away. But showing the View Pane allows you to identify the ID3v1,ID3v2 and MPEG fields and identify the modifications that you have made.

1.4.2. Show Tag Browser

From here you can toggle between showing/hiding the Tag Browser ,by default the Tag Browser is shown

1.4.3. Show Detail Pane

From here you can toggle between showing/hiding the Console Pane. By default the Console Pane is shown, you may wish to hide the Console Pane to provide more space for editing. Everything written to the Console also gets written to the user log file regardless of whether the console is visible for the View Pane.

1.4.4. Show ToolBar

From here you can toggle between showing/hiding the Toolbar. By default the Toolbar is shown.

1.4.5. Show ID3 Tabs

From here you can toggle between showing/hiding the ID3 tabs in the View and Edit panels. The ID3 tabs are only useful for MP3 files and are intended for users with an understanding of the ID3 format.

1.4.6. View Artwork Full-size

Available if you have one track selected with artwork

1.4.7. View this Track at MusicBrainz

Available if you have one track selected with a MB Unique Id see View this Track at MusicBrainz

1.4.8. View this Artist at MusicBrainz