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.exe
3.5.2. Jaikoz.bat
3.6. Logging
3.6.1. Jaikoz.exe
3.6.2. Jaikoz.bat
3. GettingStarted
1. Quick Start
2. Jaikoz Components
2.1. General Terms
2.2. Jaikoz Terms
2.3. Toolbar
2.4. Tag Browser
2.5. View Panel
2.6. Edit 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 AmpliFIND Acoustic Id
4.2.3. Duplicate Musicbrainz and AmpliFIND Id
5. Filtering
5.1. Duplicate Music Brainz Unique Id and AmpliFIND 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 AmpliFIND Acoustic Id
5.6. AmpliFIND Acoustic Id Exists
5.7. AmpliFIND 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. Play Song
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
3.6. Set Value
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 Files
5.3. UnDelete Files
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 AmpliFIND?
1.2. What is Discogs?
1.3. How Does Jaikoz Use MusicBrainz and AmpliFIND?
1.4. Retrieve Acoustic Ids
1.4.1. AmpliFIND Preferences
1.5. Autocorrect Metadata from MusicBrainz
1.5.1. AutoMatch Preferences
1.5.2. Match Preferences
1.5.3. Format
1.5.4. Format 2
1.5.5. Format Preferences
1.6. Autocorrect Metadata from Discogs
1.7. ManualCorrect Tags from MusicBrainz
1.7.1. Manual Match Preferences
1.8. Correct Lyrics
1.9. Update Metadata from Existing MusicBrainz Id
1.10. Update Metadata from Discogs
1.11. Submissions to Musicbrainz
1.11.1. Submit MusicBrainz/PUID Pair
1.11.2. Submit MusicBrainz Genres
1.11.3. Submit Musicbrainz Collection
2. Local Correct
2.1. Correct Artwork
2.2. Delete Duplicates
2.3. Correct Track Nos
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. Export and Import
1. Export
2. Import
9. 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
1.3.9. Composer
1.3.10. Artwork
1.3.11. Grouping
1.3.12. Disc No
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. AmpliFIND 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. Barcode of the release
1.3.34. Catalog No
1.3.35. Label
1.3.36. Lyricist
1.3.37. Conductor of the music.
1.3.38. Remixer
1.3.39. Mood
1.3.40. Media
1.3.41. Release Official Url
1.3.42. Release Discogs Url
1.3.43. Release Wikipedia Url
1.3.44. Artist Official Url
1.3.45. Artist Discogs Url
1.3.46. Artist Wikipedia Url
1.3.47. Lyrics Url
1.3.48. Disc Total
1.3.49. Track Total
1.3.50. Custom1
1.3.51. Custom2
1.3.52. Custom3
1.3.53. Custom4
1.3.54. Custom5
1.3.55. Floating Bpm
1.3.56. MB Release Group Id
1.3.57. MB Work Id
1.3.58. Occasion
1.3.59. Original Album
1.3.60. Original Artist
1.3.61. Original Lyricist
1.3.62. Original Release Year
1.3.63. Quality
1.3.64. Script
1.3.65. Tags
1.3.66. Tempo
1.3.67. Rating
1.3.68. Producer
1.3.69. Mixer
1.3.70. DJ Mixer
1.3.71. Arranger
1.3.72. Engineer
1.3.73. Language
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
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
10. Menus
1. Main Menu
1.1. File
1.1.1. Open Folder...
1.1.2. Add Folder...
1.1.3. Open Files...
1.1.4. Add Files...
1.1.5. Open Playlist...
1.1.6. Add Playlist...
1.1.7. Open Recent
1.1.8. Close Files
1.1.9. Play Song
1.1.10. Install Full License
1.1.11. Preferences
1.1.12. Save Preferences
1.1.13. Save Changes
1.1.14. Save And Move...
1.1.15. Save And Copy...
1.1.16. Force Save
1.1.17. Revert Changes
1.1.18. Save Artwork to Filesystem
1.1.19. Exit
1.2. Edit
1.2.1. Copy from View Pane
1.2.2. Copy from Edit Pane
1.2.3. Paste
1.2.4. Paste All Values
1.2.5. Paste to Start
1.2.6. Paste to End
1.2.7. Remove Whitespace
1.2.8. Remove Widespace
1.2.9. Delete
1.2.10. Set Value...
1.2.11. Undo
1.2.12. Find and Replace...
1.2.13. Capitalizer...
1.2.13.1. Title Case
1.2.13.2. Sentence Case
1.2.13.3. Capitalize all letters
1.2.13.4. Lowercase all letters
1.2.14. Swap Columns...
1.2.14.1. Swap Artist with Album
1.2.14.2. Swap Artist with Title
1.2.14.3. Swap Artist with Track No
1.2.14.4. Swap Artist with Comment
1.2.14.5. Swap Album with Title
1.2.14.6. Swap Album with Track No
1.2.14.7. Swap Album with Comment
1.2.14.8. Swap Title with Track No
1.2.14.9. Swap Track No with Comment
1.2.14.10. Swap Title with Comment
1.2.15. Empy Columns...
1.2.15.1. Empty Artist Column
1.2.15.2. Empty Album Column
1.2.15.3. Empty Title Column
1.2.15.4. Empty Album Artist Column
1.2.15.5. Empty Track No Column
1.2.15.6. Empty Genre Column
1.2.15.7. Empty Year Column
1.2.15.8. Empty Artwork Column
1.2.16. Swap
1.2.17. Prepend to Left
1.2.18. Prepend to Right
1.2.19. Renumber Track Nos
1.3. View
1.3.1. Show View Pane
1.3.2. Show Tag Browser
1.3.3. Show Detail Pane
1.3.4. Show ToolBar
1.3.5. Show ID3 Tabs
1.3.6. View Artwork Full-size
1.3.7. View this Track at MusicBrainz
1.3.8. View this Artist at MusicBrainz
1.3.9. View this Album at MusicBrainz
1.3.10. View this Acoustic Id at MusicBrainz
1.3.11. View this Track at Amazon
1.3.12. View this Release at Discogs
1.3.13. View this Release at Wikipedia
1.3.14. View this Artist at Discogs
1.3.15. View this Artist at Wikipedia
1.4. Action
1.4.1. Auto Correct
1.4.2. Match To Album
1.4.2.1. Match Songs to one MusicBrainz Release
1.4.2.2. Match Songs to Specified MusicBrainz Release...
1.4.2.3. Match Songs to MusicBrainz Release by Barcode...
1.4.2.4. Match Songs to one Discogs Release
1.4.2.5. Match Songs to Specified Discogs Release...
1.4.3. Local Correct
1.4.3.1. Correct Artists
1.4.3.2. Correct Albums
1.4.3.3. Correct Titles
1.4.3.4. Correct Genres
1.4.3.5. Correct Track Nos
1.4.3.6. Correct Years
1.4.3.7. Correct Comments
1.4.3.8. Correct Composers
1.4.3.9. Correct Artwork
1.4.4. File And Folder Correct
1.4.4.1. Change Base Folder
1.4.4.2. Shift Base Folder to Sub Folder
1.4.4.3. Shift Sub Folder to Base Folder
1.4.4.4. Correct Sub Folders From Metadata
1.4.4.5. Correct Filenames From Metadata
1.4.4.6. Correct Metadata From Filename
1.4.5. Remote Correct...
1.4.5.1. Retrieve Acoustic Ids
1.4.5.2. Autocorrect Metadata From MusicBrainz
1.4.5.3. Autocorrect Metadata From Discogs
1.4.5.4. Correct Lyrics
1.4.5.5. Submit MusicBrainz/PUID Pair
1.4.5.6. Submit MusicBrainz/AcoustId Pair
1.4.5.7. Submit MusicBrainz Genres
1.4.5.8. Submit Barcodes
1.4.5.9. Submit Ratings
1.4.5.10. Submit New Release
1.4.5.11. Add to your MusicBrainz Collection
1.4.5.12. Remove from your MusicBrainz Collection
1.4.5.13. Manual Correct Tags From MusicBrainz
1.4.5.14. Update Metadata From Existing MusicBrainz Id
1.4.5.15. Update Metadata From Discogs
1.4.6. Delete Duplicates
1.4.7. Delete Files
1.4.8. Undelete Files
1.5. Filters
1.5.1. Highlight Fields
1.5.1.1. Duplicate Music Brainz Unique identifier
1.5.1.2. Duplicate AmpliFIND Acoustic Identifier
1.5.1.3. Non-standard Genres
1.5.1.4. Non-iTunes Genres
1.5.2. Duplicate MB id and AmpliFIND Id
1.5.3. Filter Non Standard Genres
1.5.3.1. No Genres Enabled
1.5.3.2. Non Standard Genres
1.5.3.3. Non-iTunes Genres
1.5.4. Filter MusicBrainz Unique Ids
1.5.4.1. No Music Brainz Unique Id Filters Enabled
1.5.4.2. Duplicate Music Brainz Unique identifier
1.5.4.3. Music Brainz Unique Identifier Exists
1.5.4.4. Music Brainz Unique Identifier does not Exist
1.5.5. Filter AmpliFIND Acoustic Ids
1.5.5.1. No AmpliFIND Acoustic Ids Filters Enabled
1.5.5.2. Duplicate AmpliFIND Acoustic Identifier
1.5.5.3. AmpliFIND Acoustic Identifier Exists
1.5.5.4. AmpliFIND Acoustic Identifier does not Exist
1.6. Advanced
1.6.1. Use Advanced Toolbar...
1.6.2. Export...
1.6.3. Import...
1.6.4. Empty Cache
1.6.5. Create Support Files
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
1.8.5. About
2. Preferences
2.1. General
2.1.1. Appearance
2.1.2. Base Folder
2.1.3. Proxy Server
2.1.4. Database
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. Compatibility
2.3.5. iTunes AutoUpdate
2.4. MusicBrainz
2.5. Remote Correct
2.5.1. Match
2.5.2. Discogs
2.5.3. Correct Lyrics
2.5.4. Correct Genres
2.6. Local Correct
2.6.1. Auto Match
2.6.2. AutoFormat
2.6.3. Track Correct
2.6.4. Year Correct
2.6.5. Artwork Correct
2.6.6. Delete Duplicates
2.7. File And Folder Correct
2.7.1. File and Folder Naming
2.7.2. Rename Folder from Metadata
2.7.3. Rename File from Metadata
2.7.4. Correct Metadata 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
11. 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
9.1. Not Supported Fields
9.2. ID3v1 Fields
11.1. General Keyboard Actions
11.2. Main Menu Actions
11.3. Table Keyboard Actions
11.4. Shortcut keys for Main Menu
11.5. Shortcut keys for Row Header

Chapter 1. Introduction

Table of Contents

1. Summary of features

Are you fustrated by missing information in your songs? Are you unable to play back your favourite tracks? Maybe you are a recording artist and need to improve the information in your distributed songs? 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 Tagger 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 ten 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 AmpliFIND, 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 uses other databases such as Discogs and Amazon to provide even better matching.

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 export/import your metadata to/from a spreadsheet, and can rename filenames and folders from your metadata in your chosen format.

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 a tag editor not a music player and it has been designed to be fully compatible with popular media players. If you are an iTunes user you can configure Jaikoz to update your iTunes library from within Jaikoz. Not all media players interpret metadata in the same way so there are options to enable maximum compatability with Windows Media Player and Media Monkey as well.

Jaikoz is available with the same features for Mac OS X, Windows and Linux.

1. Summary of features

  • Acoustic matching using MusicBrainz and AmpliFIND to match tracks based on the actual music.

  • MetaData matching using MusicBrainz to match tracks from the metadata in your songs.

  • MetaData matching using Discogs to match tracks from the metadata in your songs.

  • Automatically download front cover album art from the Internet into your songs.

  • Automatically get Lyrics using Lyrics Fly.

  • Automatically extract embedded artwork into cover.jpg files.

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

  • 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 requires Java JRE 1.6.0_02 or higher, it has been tested on

  • Windows 7

  • Windows XP

  • Windows Vista

  • Linux Fedora

2. Installation Instructions

  1. To use Jaikoz you should have the Java Runtime Environment (JRE) installed version 1.6.0_02 or later.

  2. Download the Jaikoz.zip file from the Website

  3. Extract jaikoz_install.exe from the zip file

  4. Run jaikoz_install.exe and follow the instructions

  5. If Java 1.6 is not installed you will see this dialog, giving you the chance to download and install it, once that has been done installation will continue

  6. Installer provides installation in English and some other common languages

  7. You will then see this information page

  8. Please accept the license in order to continue installation

  9. Select where you would like to install Jaikoz or accept the default.

  10. Check the details and select to 'next' to start installation.

  11. Files have now been installed

  12. You can now elect to install shortcuts

  13. Installation has now completed

3. Starting Jaikoz

3.1. General Startup Instructions

You can start Jaikoz using the shortcut that should have been created in your Start Menu Jaikoz.exe. Alternatively you can start Jaikoz using the batch file jaikoz.bat

If everything is ok there will be a short delay whilst Jaikoz initialises and then it should start.

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

Once installed the license is held in the Jaikoz folder in your home directory, for example C:\Documents and Settings\paul\license.jai

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

Run Uninstall Jaikoz from your Start menu If you wish to completely remove the application folder and any work saved in it, you will have to delete this folder manually.

3.5. Memory Management

Warning this section is for experienced users of Java only

By default Jaikoz allows upto 800MB 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 songs (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.

Usually Jaikoz is run using Jaikoz.exe, but you can also run it using Jaikoz.bat. If you hide extensions within File Explorer both files will be listed as Jaikoz, but Jaikoz.exe will have the Jaikoz Insect icon and have type of Application and Jaikoz.bat will have a DOS icon and a type of MS-DOS Batch File. Memory is adjusted differently depending on which file you use.

3.5.1. Jaikoz.exe

Find the Jaikoz.exe shortcut in your Start menu,right click and select 'Properties'

Edit the value in target using the -JmaxHeap parameter. For example if the target field currently contains C:\Program Files\Jthink\Jaikoz\jaikoz.exe", change to C:\Program Files\Jthink\Jaikoz\jaikoz.exe" -Jmaxheap=512000000 sets the max memory to 512 megabytes.

3.5.2. Jaikoz.bat

Within the Jaikoz.bat file, the parameters<string>-Xms150m -Xmx800m -XX:MaxPermSize=200m</string> sets the memory in megabytes. Increase the value of Xmx to the value you require i.e. to double total memory usage to 2GB set it to <string>-Xms150m -Xmx1600m -XX:MaxPermSize=200m</string>, adjust this value and then run Jaikoz.bat 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 Jaikoz folder in your home directory, for example C:\Documents and Settings\paul\Jaikoz\Logs 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.

You can send your logs and other support files from within Jaikoz by selecting Advanced/Create Support Files and then emailing the zip file created.

The following parameters effect 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.

Usually Jaikoz is run using Jaikoz.exe, but you can also run it using Jaikoz.bat. If you hide extensions within File Explorer both files will be listed as Jaikoz, but Jaikoz.exe will have a Insect icon and have type of Application and Jaikoz.bat will have a DOS icon and a type of MS-DOS Batch File. Logging is adjusted differently depending on which file you use.

3.6.1. Jaikoz.exe

Find the Jaikoz.exe shortcut in your Start menu,right click and select 'Properties'

Edit the value in target using the -l and -m parameters. For example if the target field currently contains C:\Program Files\Jthink\Jaikoz\jaikoz.exe", change to C:\Program Files\Jthink\Jaikoz\jaikoz.exe" -l7 -m7 sets the maximum amont of logging.

3.6.2. Jaikoz.bat

Within the Jaikoz.bat file , the parameters-l2 -m2 -f sets the logging, adjust this value and run Jaikoz.bat 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 songs.

  • 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

2.2. 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. 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.6. 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.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 installation folder, the latest log is called jaikozuser-0-0.log, as it get larger it will be renamed jaikozuser0-1.log, and an empty jaikozuser0-0.log will be created. There is also a jaikozdebug-0-0.log that contains additional information useful to us if you have a support query with Jaikoz.

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 make 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 AmpliFIND Acoustic Id

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

4.2.3. Duplicate Musicbrainz and AmpliFIND Id

When enabled all User Defined Text fields that contain the same combination of Musicbrainz Id and AmpliFIND 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 AmpliFIND Id, only one MusicBrainz filter and/or one AmpliFIND filter can be enabled at the same time.

5.1. Duplicate Music Brainz Unique Id and AmpliFIND Id

When enabled only songs that contain the same combination of Musicbrainz Id and AmpliFIND 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 AmpliFIND Acoustic Id

When enabled only records containing a AmpliFIND 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. AmpliFIND Acoustic Id Exists

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

5.7. AmpliFIND Acoustic Id does not Exist

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

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 separate 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 AmpliFIND 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. Play Song

Play Song, plays the song using your default Music Player , or configured Music Player

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

3.6. Set Value

Sets the currently selected fields to the value you enter in the popup window.

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 Files

You can delete the whole song. You are most likely to do this if you find you have duplicate files of the same recording.

5.3. UnDelete Files

You can undelete a song 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 AmpliFIND?
1.2. What is Discogs?
1.3. How Does Jaikoz Use MusicBrainz and AmpliFIND?
1.4. Retrieve Acoustic Ids
1.4.1. AmpliFIND Preferences
1.5. Autocorrect Metadata from MusicBrainz
1.5.1. AutoMatch Preferences
1.5.2. Match Preferences
1.5.3. Format
1.5.4. Format 2
1.5.5. Format Preferences
1.6. Autocorrect Metadata from Discogs
1.7. ManualCorrect Tags from MusicBrainz
1.7.1. Manual Match Preferences
1.8. Correct Lyrics
1.9. Update Metadata from Existing MusicBrainz Id
1.10. Update Metadata from Discogs
1.11. Submissions to Musicbrainz
1.11.1. Submit MusicBrainz/PUID Pair
1.11.2. Submit MusicBrainz Genres
1.11.3. Submit Musicbrainz Collection
2. Local Correct
2.1. Correct Artwork
2.2. Delete Duplicates
2.3. Correct Track Nos
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 song information to be corrected without you manually entering the information, this is a much quicker and more accurate way of sorting out your music. Jaikoz can perform Local Correct this does not require internet access, and is very quick but can only work with the metadata that you already have in your files. Much more powerful are Autocorrect from Musicbrainz and Autocorrect from Discogs, these use online databases to do comprehensive 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 AmpliFIND?

MusicBrainz is an online database of information on more than nine million songs. This is a community based database with contributions by over 200,000 people, with a comprehensive system of moderation ensuring the data is extremely accurate. Additionally many of these songs have associated Acoustic Ids provided by AmpliFIND, allowing a song to be identified by the actual music, so it can do a match even if you have no metadata. AmpliFIND 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.

1.2. What is Discogs?

Discogs is another online database of information similar to Musicbrainz, Discogs also allows you to buy and sell records and CD's to other Discogs users. We use Musicbrainz and Discogs to get the best possible coverage of your song library.

1.3. How Does Jaikoz Use MusicBrainz and AmpliFIND?

Jaikoz allows to lookup your songs by both the acoustic id and the metadata making it very accurate, no decisions have to me made by you whilst the correction is progressing so you can go away and do something else more interesting and review the changes when complete. Jaikoz compares your track acoustically with the AmpliFIND 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.4. Retrieve Acoustic Ids

This attempts to find an acoustic match for your track in the AmpliFIND database. In order to get a successful match the song must exist in the AmpliFIND database and your song must be of sufficient quality so that it sounds similar enough to the song in the AmpliFIND database, if an Acoustic Id is found it will be added to the AmpliFIND Id field within your song. 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 AmpliFIND because analysing unknown tracks take significantly longer, but this option can be enabled. When you submit an unknown track to AmpliFIND 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 AmpliFIND database and you will normally able to retrieve an acoustic id for it.

1.4.1. AmpliFIND Preferences

You can change the following options the Preferences/MusicBrainz/AmpliFIND window.

The Save Acoustic Ids to file as retrieved save the acoustic id to the file as it is retrieved. This protects you from losing your work against a system crash, because acoustic ids are always correct, no verfication is required by the user

To analyse songs that are not found in the AmpliFIND database use the Analyse and submit tracks that do not currently exist in AmpliFIND database option

You may retrieve acoustic ids more quickly by increasing the Maximum Cpus to use when retrieving Acoustic Ids but by default it is only set to one because there have been some incidences of crashing when using multiple cpus in some scenerios.

When an acoustic id is retrieved from AmpliFIND it can usually provide the artist and the song title as well. You can add these to your songs metadata if empty, always or not at all using the Artist and Title options.

1.5. Autocorrect Metadata from MusicBrainz

This attempts to find a match in the MusicBrainz Database, using metadata such as artist, album and title, track duration and track number and/or the Acoustic Id. Jaikoz groups your songs by album if they have album field specified and/or by folder and first of all try to find a matching release on Musicbrainz for all the songs in the grouping, a sophisticated algorithm analyses potential matches and selects the one that matches all songs the best and is most similar to your preferences including preferred country and media format. If no suitable match is found Jaikoz then does song by song matching based on the metadata, and then for remaining songs it matches based on acoustic ids. Jaikoz will complete as many fields as it can from MusicBrainz if they are enabled in your AutoFormat options.

Because different customers use Jaikoz in different ways there are a number of preferences you can change

1.5.1. AutoMatch Preferences

The Do not match online if already have a MusicBrainz Unique id option allows you to skip over songs that have already had a Unique id, this option is enabled by default.

If the matching Musicbrainz song has a match to a Discogs Release Jaikoz can use Discogs to retrieve additional information for the song, if you do not wish to do this then check Do not update from Discogs when matching

By default Autocorrect from Musicbrainz uses your songs metadata, but if it cannot find a suitable match it will try and do a match based on the songs acoustic id if it it already has one. If Retrieve Acoustic Ids as required to help with matching is enabled then it will try and get acoustic ids for missing songs as required, so with this option enabled you do not need to run the Retrieve Acoustic Ids task seperately, however if you do it would normally make sense to disable this option.

Jaikoz can find the orginal release a song was releasd on, this is most useful when you are trying to match a song on a compilation, but sometimes more searches are required to do this accurately and this can slow down the totasl matching time so is disabled by default, you ca enable it using the Do extra searches to find original releases

1.5.2. Match Preferences

These preferences apply to both matching from Musicbrainz and matching from Discogs

The Prefer do not match to Various Artist Compilations and Prefer do not match to Single Artist Compilations options will give preference to matching a song on an original release such as original album or single, and will only match to a compilation album as a last resort.

The selected Preferred Country of release will give song linked to a releases in this country an improved score.

The selected Preferred Media Formats will give songs with releases of this type an improved score.

If Preferred Release Date is set to Earliest Release Date this will boost scores of releases with the earlier release dates, you can also specify Latest Release Date and No Preference

The Only match complete releases option is useful if you have a collection that already had good metadata and you want to ensure that only really good matches based on your groupings are made.

If your songs are already organised one album per folder you can get better matching if you enable Group Songs by folder only.

1.5.3. Format

This lists most of the values that can possibly be updated 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 Replace if empty or Never Alter the field.

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 like all tasks the image will not be saved until you save changes.

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 English/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

  • Artist
  • Album Artist
  • Sort Artist
  • Sort Album Artist
  • Title
  • Year
  • Track No
  • Is Compilation
  • Disc No
  • Original Artist
  • Original Lyricist
  • Language
  • Album
  • MB Disc Id
  • Release Type
  • Release Status
  • Release Country
  • Amazon Id
  • Artwork
  • Composer
  • Disc Total
  • Original Album
  • Original Release Year
  • Script

The Translate foreign artist names to english where possible option can be used to convert artist names containing non latin characters to latin script, this is very useful if you can only understand latin script

The Put Original Year into Year field can be used when the orginal album is found so that the original year is stored in the year field. When creating playlists in some players you may want to create date based playlists i.e Songs from the 60's and only some players provide access to the original release year.

1.5.4. Format 2

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

  • Label
  • Barcode
  • Cat No
  • Media
  • Lyricist
  • Conductor
  • Producer
  • DJ Mixer
  • Remixer
  • Genre
  • Grouping
  • Release Discogs Url
  • Release Wikipedia Url
  • Release Official Url
  • Sort Composer
  • ISRC
  • Track Total
  • Engineer
  • Mixer

Musicbrainz can store Folksonomy Tags at Artist, Release and Track level. These tags are often (but not always) used to associate an artist, release or track with a musical genre. With Jaikoz you can specify at what level should genre tags be taken from, and how many genres you want to link to any one song. Because most players only understand the first genre linked to a song some customers put a list of genres in the grouping field as a single field to make it easier to create multiple genre based playlists. So with Jaikoz you can also specify whether to write genres to the grouping field as well, independently of the values added to the genre field.

1.5.5. Format Preferences

These preferences apply to both matching from Musicbrainz and matching from Discogs

Add EP and Single release types to release title is useful for distinguishing between a release and a single of the same name, it is common for a release to have the same name as a song on the album and if that song is released as a single there is nothing to differentiate between them.

Sometimes a recording artist may use a different name on some of their releases, this can mke it harder to manage your collection. If you enable Use Artist Name instead of Artist Credit Name then the artist name will always be used in your songs metadata.

Sometimes a recording is given another name on a different release, to force a consistent name to be used enable Use Recording Name instead of Track Name

The different discs of a multi disc release can be determined using the Disc No field. But it is also possible to add the discno to the title by setting Multi Disc Releases to Always add Disc No information to the release title. Discs within a disc can sometimes titles, if you want these to be added to the release title use Add Disc No to the release title if disc has title

1.6. Autocorrect Metadata from Discogs

This attempts to find a match in the Discogs Database, using metadata such as artist, album and title, track duration and track number. Jaikoz groups your songs by album if they have album field specified and/or by folder and first of all try to find a matching release on Discogs for all the songs in the grouping, a sophisticated algorithm analyses potential matches and selects the one that matches all songs the best and is most similar to your preferences including preferred country and media format. If no suitable match is found Jaikoz then does song by song matching based on the metadata. Jaikoz will complete as many fields as it can from Discogs if they are enabled in your AutoFormat options, by default if the song has already been matched to a Musicbrainz release only empty fields will be modified by Discogs

If you are an editor of Musicbrainz you may find the Only match if matches to Musicbrainz release option useful. When this is enabled Autocorrect from Discogs will only try to match to Discogs if the song has a Musicbrainz Id, and will only accept the match if the Discogs metadata is a good match with the existing Musicbrainz metadata. This is a a very useful way of finding links between Musicbrainz and Discogs that you can then add to the Musicbrainz release as a Discogs Relationship Type.

The Match Settings also apply to Discogs

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

Discogs categorises releases by styles and sub categories called genres. With Jaikoz you can complete the genre field using styles and/or genres, and select how many genres you want to link to any one song. Because most players only understand the first genre linked to a song some customers put a list of genres in the grouping field as a single field to make it easier to create multiple genre based playlists. So with Jaikoz you can also specify whether to write genres to the grouping field as well, independently of the values added to the genre field.

1.7. ManualCorrect Tags from MusicBrainz

For each (selected) track this finds upto ten potential matches in the MusicBrainz Database, a similar algorithm is used as for the AutoCorrect from Musicbrainz but is track based instead of release based , and 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 separate row for each release event so that you can select the Release Date, Record Label and Catalog No 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.

If you select the popup menu for a song you have some further options. Match Songs to Selected Release looks at the Release Id of the selected song, it then checks all the other potential matches for the other songs and selects any match that has the same Release Id. This is a nice easy way of matching a whole album of songs just by finding the best match for one song. View Track in Musicbrainz and View Release in Musicbrainz open the selected match in Musicbrainz so that you can check al the details.

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.7.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.8. Correct Lyrics

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

1.9. Update Metadata from Existing MusicBrainz Id

For each (selected) song 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. If Musicbrainz contains a link to a Discogs Release Id the songs will also be updated with any more information available from Discogs.

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.10. Update Metadata 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.11. Submissions to Musicbrainz

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.

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.11.1. Submit MusicBrainz/PUID Pair

If you successfully create an Acoustic Id (AmpliFIND 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.11.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.11.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 Music players such as iTunes and iPods. Correct Artwork checks the folders of the songs 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

There are options you can make that apply to Correct Artwork and when getting artwork from a Musicbrainz or Discogs match

Many applications only show the first image, so you may decide to only add the first image by setting the value of Maximum artwork images that can be added to song.

You can resize large images using Resize Artwork if dimensions larger than (pixels), very large images will make your songs correspondingly large.

You can ignore artwork smaller than a certain size using Ignore artwork smaller than this (pixels)

By default Local Artwork Correct ignores folders containing more than fifty songs because it is unlikely that the folder contains only a single album, but sometimes this is the case and you can remove this restriction by checking Preferences/Local Correct/Artwork Correct/Allow Artwork to be loaded from folders containing more than 50 songs

2.2. Delete Duplicates

Song is a duplicate if allows you to decide how Jaikoz find duplicates. You can detect duplicates based on Musicbrainz Id, AmpliFIND Id or MusicBrainz Id/AmpliFIND Id

The When you have duplicate songs option defines what to do once duplicates have been found. They can either be deleted , moved to a special Duplicates folder or linked to the duplicate file that is not being deleted. If you want them to be moved you must specify a Duplicates Folder. If you want to link them use the Alias should be named so that option to specify if they should keep their name, be renamed to match the file they link to, or have a combination of both names.

Delete from iTunes if moving duplicates searches for these songs in iTunes and removes them from the iTunes library as well.

2.3. Correct Track Nos

If Remove Undisplayable Characters is selected control characters can be removed.

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

If you have a number of songs 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

Local correct tasks like Local Artist Correct only modify songs that do not have a Musicbrainz Id. The reason for this is that Local Correcters are primarily provided to improve the quaility of your metadata in preparation for Musicbrainz matching, so having run Autocorrecter on a group of songs you may run it again after making some manual edits to match the remaining unmatched songs, and would not expect songs that have been successfully matched to Musicbrainz to be modified further. You can make it run against all songs by checking Preferences/Local Correct/Auto Match/Do local correct on songs that already have a Musicbrainz Id

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 positives 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 songs, 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 songs.

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 songs 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 songs 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 AmpliFIND 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. More information at Deleting Duplicates

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

  • Local Correct Artist
  • Local Correct Album
  • Local Correct Listitem
  • Local Correct Track
  • Local Correct Genre
  • Local Correct Year
  • Local Correct Comment
  • Correct Tags from Filename
  • Correct SubFolder From Tags
  • Correct Filename From Tags
  • Correct Tags From MusicBrainz
  • Local Correct Composer
  • Correct Local Artwork
  • Retrieve Acoustic Ids
  • Save Changes
  • Updates tags from Existing MusicBrainz Ids
  • Updates tags from Existing Discogs Ids
  • Correct Lyrics
  • Delete Duplicates

By default the AutoCorrecter does not run the actions that modify filenames and folders or save 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 not 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.

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. Export and Import

Table of Contents

1. Export
2. Import

1. Export

The Export action is simple and effective. It will allows you to export the details of your loaded songs in either an XLS (Excel) or CSV (comma separated values) file (both of the file types can be opened by Apples Numbers spreadsheet). You can then use this file as an archive of your metadata AND you can also open and edit values within a proper spreadsheet application and then import the changes back into Jaikoz.

You can use the export feature on all visible songs or just selected songs using the context menu. You can add to an existing file from a previous export , and if you reexport songs the spreadsheet will store the latest values for the reexported songs. The export file should be easy to view in any spreadsheet application, the information is stored in UTF8 format (to enable any unicode character to be stored) so specify UTF8 as the charset - if requested by your spreadsheet application.

The only restrictions are

  1. Export does not export coverart, a separate action will be added to Jaikoz for this in a later release
  2. Export does not export multiple values from multivalues like genre - only the first value is exported.
  3. Export only export fields available from the Metadata view, it does not export fields that are only visible in the ID3 view or fields that are not visible with Jaikoz at all.

2. Import

You can use a spreadsheet to edit the details within an export file created with the Export action. Typically there are two types of edit you might like to make

  1. Field data such as album or artist, then this songs info will be corrected when import this file into Jaikoz
  2. Filename field, by modifying this field you can import song data from one file into another file. This is especially useful if you have a partciular song in two formats (e.g mp3 and mp4) and only have the correct metadata for one song.

Before using Import make sure you have already loaded your songs into Jaikoz before you use Import because Import does not load songs into Jaikoz it matches against the filename of songs in Jaikoz and updates the metadata when it finds any matches. Import is none destructive, for example although it will only import the first genre if your song has additional genres these will be left untouched.

Chapter 9. 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
1.3.9. Composer
1.3.10. Artwork
1.3.11. Grouping
1.3.12. Disc No
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. AmpliFIND 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. Barcode of the release
1.3.34. Catalog No
1.3.35. Label
1.3.36. Lyricist
1.3.37. Conductor of the music.
1.3.38. Remixer
1.3.39. Mood
1.3.40. Media
1.3.41. Release Official Url
1.3.42. Release Discogs Url
1.3.43. Release Wikipedia Url
1.3.44. Artist Official Url
1.3.45. Artist Discogs Url
1.3.46. Artist Wikipedia Url
1.3.47. Lyrics Url
1.3.48. Disc Total
1.3.49. Track Total
1.3.50. Custom1
1.3.51. Custom2
1.3.52. Custom3
1.3.53. Custom4
1.3.54. Custom5
1.3.55. Floating Bpm
1.3.56. MB Release Group Id
1.3.57. MB Work Id
1.3.58. Occasion
1.3.59. Original Album
1.3.60. Original Artist
1.3.61. Original Lyricist
1.3.62. Original Release Year
1.3.63. Quality
1.3.64. Script
1.3.65. Tags
1.3.66. Tempo
1.3.67. Rating
1.3.68. Producer
1.3.69. Mixer
1.3.70. DJ Mixer
1.3.71. Arranger
1.3.72. Engineer
1.3.73. Language
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
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 songs 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

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

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. AmpliFIND Id

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

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. Barcode of the release

1.3.34. Catalog No

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

1.3.35. Label

Record label that this release was released on.

1.3.36. Lyricist

Who wrotes the lyrics for the song.

1.3.37. Conductor of the music.

1.3.38. Remixer

Remixer of the track.

1.3.39. Mood

Can be used to describe the mood of the song.

1.3.40. Media

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

1.3.41. 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.42. 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.43. 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.44. Artist Official Url

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

1.3.45. 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.46. 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.47. Lyrics Url

Url of a website that provides the lyrics of a song.

1.3.48. Disc Total

Total number of discs in the release.

1.3.49. Track Total

Total number of tracks within the disc in the release.

1.3.50. Custom1

Custom field that can be used for whatever you want.

1.3.51. Custom2

Custom field that can be used for whatever you want.

1.3.52. Custom3

Custom field that can be used for whatever you want.

1.3.53. Custom4

Custom field that can be used for whatever you want.

1.3.54. Custom5

Custom field that can be used for whatever you want.

1.3.55. Floating Bpm

Beats per minutes sored using a real number instead of an integer.

1.3.56. MB Release Group Id

Musicbrainz Release Group Id, within Musicbrainz different versions of a release all belong to the same release group.

1.3.57. MB Work Id

Musicbrainz Work Id, within Musicbrainz a piece of music is called a work, this concept is particulary important for classical music.

1.3.58. Occasion

Use to link this song to family event such as a wedding or party.

1.3.59. Original Album

The album that this song originally was released on. Very useful for storing the original studio album of a track that you have on a compilation.

1.3.60. Original Artist

If the song is a cover this can store the original artist.

1.3.61. Original Lyricist

1.3.62. Original Release Year

The year that the original album was released.

1.3.63. Quality

Quality of the recording.

1.3.64. Script

The script that the songs metadata is written in

1.3.65. Tags

Can be used for storing arbitary tags about the song.

1.3.66. Tempo

Tempo of song such as Slow, Fast, Very Fast.

1.3.67. Rating

Rating of song from 1 to 5 stars.

1.3.68. Producer

Song Producer.

1.3.69. Mixer

Song Mixer

1.3.70. DJ Mixer

DJ Mix

1.3.71. Arranger

Arranger

1.3.72. Engineer

Engineer

1.3.73. Language

The language used for the metadata i.e English, French

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

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 9.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 songs.

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

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 9.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 10. Menus

Table of Contents

1. Main Menu
1.1. File
1.1.1. Open Folder...
1.1.2. Add Folder...
1.1.3. Open Files...
1.1.4. Add Files...
1.1.5. Open Playlist...
1.1.6. Add Playlist...
1.1.7. Open Recent
1.1.8. Close Files
1.1.9. Play Song
1.1.10. Install Full License
1.1.11. Preferences
1.1.12. Save Preferences
1.1.13. Save Changes
1.1.14. Save And Move...
1.1.15. Save And Copy...
1.1.16. Force Save
1.1.17. Revert Changes
1.1.18. Save Artwork to Filesystem
1.1.19. Exit
1.2. Edit
1.2.1. Copy from View Pane
1.2.2. Copy from Edit Pane
1.2.3. Paste
1.2.4. Paste All Values
1.2.5. Paste to Start
1.2.6. Paste to End
1.2.7. Remove Whitespace
1.2.8. Remove Widespace
1.2.9. Delete
1.2.10. Set Value...
1.2.11. Undo
1.2.12. Find and Replace...
1.2.13. Capitalizer...
1.2.13.1. Title Case
1.2.13.2. Sentence Case
1.2.13.3. Capitalize all letters
1.2.13.4. Lowercase all letters
1.2.14. Swap Columns...
1.2.14.1. Swap Artist with Album
1.2.14.2. Swap Artist with Title
1.2.14.3. Swap Artist with Track No
1.2.14.4. Swap Artist with Comment
1.2.14.5. Swap Album with Title
1.2.14.6. Swap Album with Track No
1.2.14.7. Swap Album with Comment
1.2.14.8. Swap Title with Track No
1.2.14.9. Swap Track No with Comment
1.2.14.10. Swap Title with Comment
1.2.15. Empy Columns...
1.2.15.1. Empty Artist Column
1.2.15.2. Empty Album Column
1.2.15.3. Empty Title Column
1.2.15.4. Empty Album Artist Column
1.2.15.5. Empty Track No Column
1.2.15.6. Empty Genre Column
1.2.15.7. Empty Year Column
1.2.15.8. Empty Artwork Column
1.2.16. Swap
1.2.17. Prepend to Left
1.2.18. Prepend to Right
1.2.19. Renumber Track Nos
1.3. View
1.3.1. Show View Pane
1.3.2. Show Tag Browser
1.3.3. Show Detail Pane
1.3.4. Show ToolBar
1.3.5. Show ID3 Tabs
1.3.6. View Artwork Full-size
1.3.7. View this Track at MusicBrainz
1.3.8. View this Artist at MusicBrainz
1.3.9. View this Album at MusicBrainz
1.3.10. View this Acoustic Id at MusicBrainz
1.3.11. View this Track at Amazon
1.3.12. View this Release at Discogs
1.3.13. View this Release at Wikipedia
1.3.14. View this Artist at Discogs
1.3.15. View this Artist at Wikipedia
1.4. Action
1.4.1. Auto Correct
1.4.2. Match To Album
1.4.2.1. Match Songs to one MusicBrainz Release
1.4.2.2. Match Songs to Specified MusicBrainz Release...
1.4.2.3. Match Songs to MusicBrainz Release by Barcode...
1.4.2.4. Match Songs to one Discogs Release
1.4.2.5. Match Songs to Specified Discogs Release...
1.4.3. Local Correct
1.4.3.1. Correct Artists
1.4.3.2. Correct Albums
1.4.3.3. Correct Titles
1.4.3.4. Correct Genres
1.4.3.5. Correct Track Nos
1.4.3.6. Correct Years
1.4.3.7. Correct Comments
1.4.3.8. Correct Composers
1.4.3.9. Correct Artwork
1.4.4. File And Folder Correct
1.4.4.1. Change Base Folder
1.4.4.2. Shift Base Folder to Sub Folder
1.4.4.3. Shift Sub Folder to Base Folder
1.4.4.4. Correct Sub Folders From Metadata
1.4.4.5. Correct Filenames From Metadata
1.4.4.6. Correct Metadata From Filename
1.4.5. Remote Correct...
1.4.5.1. Retrieve Acoustic Ids
1.4.5.2. Autocorrect Metadata From MusicBrainz
1.4.5.3. Autocorrect Metadata From Discogs
1.4.5.4. Correct Lyrics
1.4.5.5. Submit MusicBrainz/PUID Pair
1.4.5.6. Submit MusicBrainz/AcoustId Pair
1.4.5.7. Submit MusicBrainz Genres
1.4.5.8. Submit Barcodes
1.4.5.9. Submit Ratings
1.4.5.10. Submit New Release
1.4.5.11. Add to your MusicBrainz Collection
1.4.5.12. Remove from your MusicBrainz Collection
1.4.5.13. Manual Correct Tags From MusicBrainz
1.4.5.14. Update Metadata From Existing MusicBrainz Id
1.4.5.15. Update Metadata From Discogs
1.4.6. Delete Duplicates
1.4.7. Delete Files
1.4.8. Undelete Files
1.5. Filters
1.5.1. Highlight Fields
1.5.1.1. Duplicate Music Brainz Unique identifier
1.5.1.2. Duplicate AmpliFIND Acoustic Identifier
1.5.1.3. Non-standard Genres
1.5.1.4. Non-iTunes Genres
1.5.2. Duplicate MB id and AmpliFIND Id
1.5.3. Filter Non Standard Genres
1.5.3.1. No Genres Enabled
1.5.3.2. Non Standard Genres
1.5.3.3. Non-iTunes Genres
1.5.4. Filter MusicBrainz Unique Ids
1.5.4.1. No Music Brainz Unique Id Filters Enabled
1.5.4.2. Duplicate Music Brainz Unique identifier
1.5.4.3. Music Brainz Unique Identifier Exists
1.5.4.4. Music Brainz Unique Identifier does not Exist
1.5.5. Filter AmpliFIND Acoustic Ids
1.5.5.1. No AmpliFIND Acoustic Ids Filters Enabled
1.5.5.2. Duplicate AmpliFIND Acoustic Identifier
1.5.5.3. AmpliFIND Acoustic Identifier Exists
1.5.5.4. AmpliFIND Acoustic Identifier does not Exist
1.6. Advanced
1.6.1. Use Advanced Toolbar...
1.6.2. Export...
1.6.3. Import...
1.6.4. Empty Cache
1.6.5. Create Support Files
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
1.8.5. About
2. Preferences
2.1. General
2.1.1. Appearance
2.1.2. Base Folder
2.1.3. Proxy Server
2.1.4. Database
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. Compatibility
2.3.5. iTunes AutoUpdate
2.4. MusicBrainz
2.5. Remote Correct
2.5.1. Match
2.5.2. Discogs
2.5.3. Correct Lyrics
2.5.4. Correct Genres
2.6. Local Correct
2.6.1. Auto Match
2.6.2. AutoFormat
2.6.3. Track Correct
2.6.4. Year Correct
2.6.5. Artwork Correct
2.6.6. Delete Duplicates
2.7. File And Folder Correct
2.7.1. File and Folder Naming
2.7.2. Rename Folder from Metadata
2.7.3. Rename File from Metadata
2.7.4. Correct Metadata 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