Jaikoz Help


Table of Contents

1. Introduction
1. Summary of features
2. Installation and Startup
1. Installation Requirements
1.1. Platform Requirements
1.2. Operating System Requirements
2. Installation Instructions
3. Starting Jaikoz
3.1. General Startup Instructions
3.2. Java Problems
3.3. Licensing Problems
3.3.1. No License Installed
3.3.2. Expired Trial License
3.3.3. Corrupted License
3.4. Uninstalling Jaikoz
3.5. Memory Management
3.5.1. Jaikoz.app
3.5.2. jaikoz.sh
3.6. Logging
3.6.1. Jaikoz.app
3.6.2. Jaikoz.sh
3. GettingStarted
1. Quick Start
2. Jaikoz Components
2.1. General Terms
2.2. 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. Jaikoz
1.1.1. About Jaikoz
1.1.2. Preferences
1.1.3. Services
1.1.4. Hide Jaikoz
1.1.5. Hide Others
1.1.6. Show All
1.1.7. Quit Jaikoz
1.2. File
1.2.1. Open Folder...
1.2.2. Add Folder...
1.2.3. Open Files...
1.2.4. Add Files...
1.2.5. Open Playlist...
1.2.6. Add Playlist...
1.2.7. Open Recent
1.2.8. Close Files
1.2.9. Play Song
1.2.10. Install Full License
1.2.11. Save Preferences
1.2.12. Save Changes
1.2.13. Save And Move...
1.2.14. Save And Copy...
1.2.15. Force Save
1.2.16. Revert Changes
1.2.17. Save Artwork to Filesystem
1.3. Edit
1.3.1. Copy from View Pane
1.3.2. Copy from Edit Pane
1.3.3. Paste
1.3.4. Paste All Values
1.3.5. Paste to Start
1.3.6. Paste to End
1.3.7. Remove Whitespace
1.3.8. Remove Widespace
1.3.9. Delete
1.3.10. Set Value...
1.3.11. Undo
1.3.12. Find and Replace...
1.3.13. Capitalizer...
1.3.13.1. Title Case
1.3.13.2. Sentence Case
1.3.13.3. Capitalize all letters
1.3.13.4. Lowercase all letters
1.3.14. Swap Columns...
1.3.14.1. Swap Artist with Album
1.3.14.2. Swap Artist with Title
1.3.14.3. Swap Artist with Track No
1.3.14.4. Swap Artist with Comment
1.3.14.5. Swap Album with Title
1.3.14.6. Swap Album with Track No
1.3.14.7. Swap Album with Comment
1.3.14.8. Swap Title with Track No
1.3.14.9. Swap Track No with Comment
1.3.14.10. Swap Title with Comment
1.3.15. Empy Columns...
1.3.15.1. Empty Artist Column
1.3.15.2. Empty Album Column
1.3.15.3. Empty Title Column
1.3.15.4. Empty Album Artist Column
1.3.15.5. Empty Track No Column
1.3.15.6. Empty Genre Column
1.3.15.7. Empty Year Column
1.3.15.8. Empty Artwork Column
1.3.16. Swap
1.3.17. Prepend to Left
1.3.18. Prepend to Right
1.3.19. Renumber Track Nos
1.4. View
1.4.1. Show View Pane
1.4.2. Show Tag Browser
1.4.3. Show Detail Pane
1.4.4. Show ToolBar
1.4.5. Show ID3 Tabs
1.4.6. View Artwork Full-size
1.4.7. View this Track at MusicBrainz
1.4.8. View this Artist at MusicBrainz
1.4.9. View this Album at MusicBrainz
1.4.10. View this Acoustic Id at MusicBrainz
1.4.11. View this Track at Amazon
1.4.12. View this Release at Discogs
1.4.13. View this Release at Wikipedia
1.4.14. View this Artist at Discogs
1.4.15. View this Artist at Wikipedia
1.5. Action
1.5.1. Auto Correct
1.5.2. Match To Album
1.5.2.1. Match Songs to one MusicBrainz Release
1.5.2.2. Match Songs to Specified MusicBrainz Release...
1.5.2.3. Match Songs to MusicBrainz Release by Barcode...
1.5.2.4. Match Songs to one Discogs Release
1.5.2.5. Match Songs to Specified Discogs Release...
1.5.3. Local Correct
1.5.3.1. Correct Artists
1.5.3.2. Correct Albums
1.5.3.3. Correct Titles
1.5.3.4. Correct Genres
1.5.3.5. Correct Track Nos
1.5.3.6. Correct Years
1.5.3.7. Correct Comments
1.5.3.8. Correct Composers
1.5.3.9. Correct Artwork
1.5.4. File And Folder Correct
1.5.4.1. Change Base Folder
1.5.4.2. Shift Base Folder to Sub Folder
1.5.4.3. Shift Sub Folder to Base Folder
1.5.4.4. Correct Sub Folders From Metadata
1.5.4.5. Correct Filenames From Metadata
1.5.4.6. Correct Metadata From Filename
1.5.5. Remote Correct...
1.5.5.1. Retrieve Acoustic Ids
1.5.5.2. Autocorrect Metadata From MusicBrainz
1.5.5.3. Autocorrect Metadata From Discogs
1.5.5.4. Correct Lyrics
1.5.5.5. Submit MusicBrainz/PUID Pair
1.5.5.6. Submit MusicBrainz/AcoustId Pair
1.5.5.7. Submit MusicBrainz Genres
1.5.5.8. Submit Barcodes
1.5.5.9. Submit Ratings
1.5.5.10. Submit New Release
1.5.5.11. Add to your MusicBrainz Collection
1.5.5.12. Remove from your MusicBrainz Collection
1.5.5.13. Manual Correct Tags From MusicBrainz
1.5.5.14. Update Metadata From Existing MusicBrainz Id
1.5.5.15. Update Metadata From Discogs
1.5.6. Delete Duplicates
1.5.7. Delete Files
1.5.8. Undelete Files
1.6. Filters
1.6.1. Highlight Fields
1.6.1.1. Duplicate Music Brainz Unique identifier
1.6.1.2. Duplicate AmpliFIND Acoustic Identifier
1.6.1.3. Non-standard Genres
1.6.1.4. Non-iTunes Genres
1.6.2. Duplicate MB id and AmpliFIND Id
1.6.3. Filter Non Standard Genres
1.6.3.1. No Genres Enabled
1.6.3.2. Non Standard Genres
1.6.3.3. Non-iTunes Genres
1.6.4. Filter MusicBrainz Unique Ids
1.6.4.1. No Music Brainz Unique Id Filters Enabled
1.6.4.2. Duplicate Music Brainz Unique identifier
1.6.4.3. Music Brainz Unique Identifier Exists
1.6.4.4. Music Brainz Unique Identifier does not Exist
1.6.5. Filter AmpliFIND Acoustic Ids
1.6.5.1. No AmpliFIND Acoustic Ids Filters Enabled
1.6.5.2. Duplicate AmpliFIND Acoustic Identifier
1.6.5.3. AmpliFIND Acoustic Identifier Exists
1.6.5.4. AmpliFIND Acoustic Identifier does not Exist
1.7. Advanced
1.7.1. Use Advanced Toolbar...
1.7.2. Export...
1.7.3. Import...
1.7.4. Empty Cache
1.7.5. Create Support Files
1.8. Reports
1.8.1. List Missing Tracks for Albums
1.9. Help
1.9.1. Check for Later Version
1.9.2. Register
1.9.3. Offline Help
1.9.4. Online Help
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 is available for both Intel and PPC Macs, 32bit or 64bit

  • Mac OS X Snow Leopard

  • Mac OS X Leopard

  • Mac OS X Tiger

2. Installation Instructions

  1. Ensure you have Java 1.5 Release 4 installed or later. This is freely available for OSX 10.4 (Tiger) but may not be installed by default and is not part of the automatic Apple Updater , it is available at http://developer.apple.com/java/download. Ensure you get the correct release for your Mac (Intel/PPC).

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

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

  4. Copy Jaikoz to your /Applications folder

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

3. Starting Jaikoz

3.1. General Startup Instructions

You can start Jaikoz by selecting if from the Application folder. If you wish you can add Jaikoz to the Dock and start it from there

If you do not have yet have Java 1.5 installed you will see this dialog

In which case, please download from the Apple website and retry. Otherwise unless there is a licensing problem jaikoz should now start

3.2. Java Problems

This section discusses problems starting Jaikoz due to problems with your Java configuration

Java is not recognized as an internal or external command,operable program or batch file..

There is a problem with your JRE Installation. Please ensure that Java is installed and can be found in your path

Unable to load helpset

There is a problem with your JRE Installation. Please ensure that Java is installed and can be found in your path

3.3. Licensing Problems

3.3.1. No License Installed

If you start Jaikoz and it cannot find your license you will see this dialog

Select Path to Open a File Dialog and find the license file that you should have recieved by email (license.jai) and select Open. Then select OK to verify the license.

If the license is verified Jaikoz will start

3.3.2. Expired Trial License

If you start Jaikoz and your trial license has expired you will see this dialog

The trial license is supplied at no cost for a period of 30 days from date of issue. Thereafter, the application is disabled and a permanent license must be purchased in order to use the application.

If you wish to purchase a license go to the Website and purchase, then install in the usual way

Select Path to Open a File Dialog and find the license file that you should have recieved by email (license.jai) and select Open. Then select OK to verify the license.

If the license is verified Jaikoz will start

3.3.3. Corrupted License

If you start Jaikoz and there is a problem with your license you will see this dialog

Your license has been corrupted,retrieve the original license and reinstall it in the usual way

Select Path to Open a File Dialog and find the license file that you should have recieved by email (license.jai) and select Open. Then select OK to verify the license.

If the license is verified Jaikoz will start

3.4. Uninstalling Jaikoz

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

3.5. Memory Management

Warning this section is for experienced users of Java only

By default Jaikoz allows upto 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. If your computer only has 512MB of memory or less you should reduce the value as appropriate.

Jaikoz is usually run using Jaikoz.app from the Finder, but you can also run it using jaikoz.sh using the Terminal, memory is adjusted differently depending on which file you use.

3.5.1. Jaikoz.app

If you are running Jaikoz you need to modify the value of -Xmx within the Info.plist

  • Go to where you installed Jaikoz

  • Show popup, and select 'Show Package Contents'

  • Go into Contents/

  • Select popup on Info.plist and choose Open With Other...

  • Select Application/TextEdit

  • Find the line that says <string>-Xms150m -Xmx800m -XX:MaxPermSize=200m</string>

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

3.5.2. jaikoz.sh

  • From Finder select Utilities/Terminal

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

  • From Terminal vi jaikoz.sh

  • Within the Jaikoz.sh file , adjust parameters -Xmx800m to set the max heap in megabytes, adjust this value and run jaikoz.sh for it to take effect

3.6. Logging

Jaikoz uses two log files, jaikozuser0-0.log contains the same information as is written to the Console Panel, it contains general information about what you've done within Jaikoz. The jaikozdebug0-0.log file contains warnings and debugging information that helps diagnose problems when running Jaikoz. These files are held in the within your log folder, for example /Users/paul/Library/Logs/Jaikoz and are renamed when they get to a certain size, the latest file is always called jaikozuser0-0.log, the next most recent is called jaikozuser0-1.log. if you require support with Jaikoz it is important to send both types of log files, to help diagnose the problem. The amount of logging written to the jaikozdebug0-0.log file can be adjusted, if you have a problem that you can reproduce it would be helpful if you could increase the amount of information logged, recreate the problem, send the logs and then return the logging to the normal levels.

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.

Jaikoz is usually run using Jaikoz.app from the Finder, but you can also run it using jaikoz.sh using the Terminal, logging is adjusted differently depending on which file you use.

3.6.1. Jaikoz.app

If you are running Jaikoz you need to modify the value of -l and -m within the Info.plist

  • Go to where you installed Jaikoz

  • Show popup, and select 'Show Package Contents'

  • Go into Contents/

  • Select popup on Info.plist and choose Open With Other...

  • Select Application/TextEdit

  • Find the line that says <string>-l2 -m2 -f</string>

  • Modify the -l and -m values you require

3.6.2. Jaikoz.sh

  • From Finder select Utilities/Terminal

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

  • From Terminal vi jaikoz.sh

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

Chapter 3. GettingStarted

1. Quick Start

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

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

Once it has completed you can check the results and make any manual changes by editing the data directly

When you are happy with the result select the Save Changes Button to save your files.

Additionally you can select the Submit to MusicBrainz Button Button to submit records where a match as been made between an Acoustic Id and a MusicBrainz Unique id. By doing this you help to make MusicBrainz even more accurate and comprehensive. But you should only do this if you are happy that the match is correct, and you should not do this for the same track moree than once.

In the example above the tasks were performed on all files, but you can also select rows in the row header, and using the popup menu run any task on only the selected rows

2. Jaikoz Components

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

2.1. General Terms

This section explains the terminology used within Jaikoz and the main components of Jaikoz

  • MP3 is a audio format, which compresses music files to a small size making them suitable for storing on a computer.

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

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

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

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

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

  • AAC is an audio format normally used within MP4

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

  • Tag is another term for Metadata within 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 ~/Library/Logs folder, the latest log is called jaikozuser-0-0.log, as it get larger it will be renamed jaikozuser0-1.log, and an empty jaikozuser0-0.log will be created. There is also a jaikozdebug-0-0.log that contains additional information useful to us if you have a support query with Jaikoz. You can view the logs using the /Applications/Utilities/Console application.

2.8. Status Bar

The Status Bar at the bottom of the screen shows how many records are loaded, how many records are actually visible due to filters and are any filters active.

2.9. The Jaikoz Way

Jaikoz has been designed to allow you to do your editing as quickly and easily as possible. Is it particulary good if you have a large music collection, if you have ever used another tagger then you will find time spent using Jaikoz well spent.

  • PopWindows have been limited. Popup Windows are slow and cumbersome,Jaikoz allows you to edit 99% of the time directly within the Edit panel, popups are only used for editing multiple values for a field.

  • Generous type checking. Jaikoz does not impose unnecessary restrictions on your editing

  • Intelligent AutoFixing if you enter an invalid value Jaikoz tries to convert the value to an allowable value, if it cannot the value is left unchanged. This is much more user firendly then bringing up popup window errors

  • Keyboard and Mouse traversal are provided with many short cut keys available to perform common tasks.

3. Saving Changes

When editing data within Jaikoz either using the autocorrecters or manually, all changes are made in memory. Nothing is saved until you elect to save your changes.

If you use iTunes and have Automatically update iTunes library enabled Jaikoz will update the tracks in your iTunes library

3.1. Save Changes

Save Changes will save the files that you have modified and delete any files that you have marked for deletion. You can run it from the Main Menu in which case it will apply the changes to all files visible in the Edit Tab. Or from the Popup Menu so that it only is done for selected files, or as a task within the Autocorrecter so that it is applied to all files processed by the Auto Correcter

3.2. Force Save

Force Save will resave files even if you have not modified any fields. This can be useful if you wish to resave a file because you want to modify the way it is saved. For example you may wish to save a file with unsynchronization either enabled or disabled. You can run it from the Main Menu in which case it will apply the changes to all files visible in the Edit Tab, or from the Popup Menu so that it only is done for selected files.

3.3. Save and Move

Save and Move saves any changes and then moves the files to the specified folder, this is an easy way to move a set of processed files to another folder. By default it will create the subfolder hierachy underneath the selected folder using the values in the subfolder fields for the selected files, but you can move the files without creating the subfolder hierachy by unchecking the Create subfolders hierachy option. You can run it from the Main Menu in which case it will apply the changes to all files visible in the Edit Tab, or from the Popup Menu so that it only is done for selected files.

3.4. Save and Copy

Save and Copy saves any changes and then copies the files to the specified folder, this is an easy way to 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 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. Jaikoz
1.1.1. About Jaikoz
1.1.2. Preferences
1.1.3. Services
1.1.4. Hide Jaikoz
1.1.5. Hide Others
1.1.6. Show All
1.1.7. Quit Jaikoz
1.2. File
1.2.1. Open Folder...
1.2.2. Add Folder...
1.2.3. Open Files...
1.2.4. Add Files...
1.2.5. Open Playlist...
1.2.6. Add Playlist...
1.2.7. Open Recent
1.2.8. Close Files
1.2.9. Play Song
1.2.10. Install Full License
1.2.11. Save Preferences
1.2.12. Save Changes
1.2.13. Save And Move...
1.2.14. Save And Copy...
1.2.15. Force Save
1.2.16. Revert Changes
1.2.17. Save Artwork to Filesystem
1.3. Edit
1.3.1. Copy from View Pane
1.3.2. Copy from Edit Pane
1.3.3. Paste
1.3.4. Paste All Values
1.3.5. Paste to Start
1.3.6. Paste to End
1.3.7. Remove Whitespace
1.3.8. Remove Widespace
1.3.9. Delete
1.3.10. Set Value...
1.3.11. Undo
1.3.12. Find and Replace...
1.3.13. Capitalizer...
1.3.13.1. Title Case
1.3.13.2. Sentence Case
1.3.13.3. Capitalize all letters
1.3.13.4. Lowercase all letters
1.3.14. Swap Columns...
1.3.14.1. Swap Artist with Album
1.3.14.2. Swap Artist with Title
1.3.14.3. Swap Artist with Track No
1.3.14.4. Swap Artist with Comment
1.3.14.5. Swap Album with Title
1.3.14.6. Swap Album with Track No
1.3.14.7. Swap Album with Comment
1.3.14.8. Swap Title with Track No
1.3.14.9. Swap Track No with Comment
1.3.14.10. Swap Title with Comment
1.3.15. Empy Columns...
1.3.15.1. Empty Artist Column
1.3.15.2. Empty Album Column
1.3.15.3. Empty Title Column
1.3.15.4. Empty Album Artist Column
1.3.15.5. Empty Track No Column
1.3.15.6. Empty Genre Column
1.3.15.7. Empty Year Column
1.3.15.8. Empty Artwork Column
1.3.16. Swap
1.3.17. Prepend to Left
1.3.18. Prepend to Right
1.3.19. Renumber Track Nos
1.4. View
1.4.1. Show View Pane
1.4.2. Show Tag Browser
1.4.3. Show Detail Pane
1.4.4. Show ToolBar
1.4.5. Show ID3 Tabs
1.4.6. View Artwork Full-size
1.4.7. View this Track at MusicBrainz
1.4.8. View this Artist at MusicBrainz
1.4.9. View this Album at MusicBrainz
1.4.10. View this Acoustic Id at MusicBrainz
1.4.11. View this Track at Amazon
1.4.12. View this Release at Discogs
1.4.13. View this Release at Wikipedia
1.4.14. View this Artist at Discogs
1.4.15. View this Artist at Wikipedia
1.5. Action
1.5.1. Auto Correct
1.5.2. Match To Album
1.5.2.1. Match Songs to one MusicBrainz Release
1.5.2.2. Match Songs to Specified MusicBrainz Release...
1.5.2.3. Match Songs to MusicBrainz Release by Barcode...
1.5.2.4. Match Songs to one Discogs Release
1.5.2.5. Match Songs to Specified Discogs Release...
1.5.3. Local Correct
1.5.3.1. Correct Artists
1.5.3.2. Correct Albums
1.5.3.3. Correct Titles
1.5.3.4. Correct Genres
1.5.3.5. Correct Track Nos
1.5.3.6. Correct Years
1.5.3.7. Correct Comments
1.5.3.8. Correct Composers
1.5.3.9. Correct Artwork
1.5.4. File And Folder Correct
1.5.4.1. Change Base Folder
1.5.4.2. Shift Base Folder to Sub Folder
1.5.4.3. Shift Sub Folder to Base Folder
1.5.4.4. Correct Sub Folders From Metadata
1.5.4.5. Correct Filenames From Metadata
1.5.4.6. Correct Metadata From Filename
1.5.5. Remote Correct...
1.5.5.1. Retrieve Acoustic Ids
1.5.5.2. Autocorrect Metadata From MusicBrainz
1.5.5.3. Autocorrect Metadata From Discogs
1.5.5.4. Correct Lyrics
1.5.5.5. Submit MusicBrainz/PUID Pair
1.5.5.6. Submit MusicBrainz/AcoustId Pair
1.5.5.7. Submit MusicBrainz Genres
1.5.5.8. Submit Barcodes
1.5.5.9. Submit Ratings
1.5.5.10. Submit New Release
1.5.5.11. Add to your MusicBrainz Collection
1.5.5.12. Remove from your MusicBrainz Collection
1.5.5.13. Manual Correct Tags From MusicBrainz
1.5.5.14. Update Metadata From Existing MusicBrainz Id
1.5.5.15. Update Metadata From Discogs
1.5.6. Delete Duplicates
1.5.7. Delete Files
1.5.8. Undelete Files
1.6. Filters
1.6.1. Highlight Fields
1.6.1.1. Duplicate Music Brainz Unique identifier
1.6.1.2. Duplicate AmpliFIND Acoustic Identifier
1.6.1.3. Non-standard Genres
1.6.1.4. Non-iTunes Genres
1.6.2. Duplicate MB id and AmpliFIND Id
1.6.3. Filter Non Standard Genres
1.6.3.1. No Genres Enabled
1.6.3.2. Non Standard Genres
1.6.3.3. Non-iTunes Genres
1.6.4. Filter MusicBrainz Unique Ids
1.6.4.1. No Music Brainz Unique Id Filters Enabled
1.6.4.2. Duplicate Music Brainz Unique identifier
1.6.4.3. Music Brainz Unique Identifier Exists
1.6.4.4. Music Brainz Unique Identifier does not Exist
1.6.5. Filter AmpliFIND Acoustic Ids
1.6.5.1. No AmpliFIND Acoustic Ids Filters Enabled
1.6.5.2. Duplicate AmpliFIND Acoustic Identifier
1.6.5.3. AmpliFIND Acoustic Identifier Exists
1.6.5.4. AmpliFIND Acoustic Identifier does not Exist
1.7. Advanced
1.7.1. Use Advanced Toolbar...
1.7.2. Export...
1.7.3. Import...
1.7.4. Empty Cache
1.7.5. Create Support Files
1.8. Reports
1.8.1. List Missing Tracks for Albums
1.9. Help
1.9.1. Check for Later Version
1.9.2. Register
1.9.3. Offline Help
1.9.4. Online Help
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

1. Main Menu

1.1. Jaikoz

1.1.1. About Jaikoz

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

1.1.2. Preferences

Show the Jaikoz preferences window.

1.1.3. Services

Jaikoz does not provide any OSX Services at the moment.

1.1.4. Hide Jaikoz

Hide the Jaikoz application.

1.1.5. Hide Others

Hide all visible application.

1.1.6. Show All

Show all open application.

1.1.7. Quit Jaikoz

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

click Yes to save preferences or No to not.

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

click Yes to save changes or No not to.

After making any requested saves Jaikoz will exit.

1.2. File

1.2.1. Open Folder...

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

1.2.2. Add Folder...

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

1.2.3. Open Files...

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

1.2.4. Add Files...

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

1.2.5. Open Playlist...

Use this to open all the files specified in a playlist. Currently the popular M3U format is the only playlist format supported.

1.2.6. Add Playlist...

Use this to open all the files specified in a playlist, without replacing currently loaded files. Currently the popular M3U format is the only playlist format supported.

1.2.7. Open Recent

Use this to reopen files/folders or playlists that have been recently opened, maintains a history of the last ten items opened.

1.2.8. Close Files

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

1.2.9. Play Song

Play the selected song(s) using your default player or an alternative specified in the preferences.

1.2.10. Install Full License

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

1.2.11. Save Preferences

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

1.2.12. Save Changes

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

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

1.2.13. Save And Move...

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

The moved files will no longer be open in Jaikoz

1.2.14. Save And Copy...

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

1.2.15. Force Save

This will save changes you have made to all songs, regardless of whether you have made any changes, including marking files for deletion. This can be useful if you wish to resave a file because you want to modify the way it is saved. For example you may wish to save a file with unsynchronization either enabled or disabled.

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

1.2.16. Revert Changes

Undo any changes to all fields in the selected songs

1.2.17. Save Artwork to Filesystem

If any songs contain embedded artwork the first artwork for each song will be saved as folder.jpg in the songs folder overwriting any existing folder.jpg. This is useful for some players that look for artwork on the filesystem instead of within the artwork itself.

1.3. Edit

This Menu provides access to basic editing functions.

1.3.1. Copy from View Pane

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

1.3.2. Copy from Edit Pane

Copies the selected items from the Edit Pane

1.3.3. Paste

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

1.3.4. Paste All Values

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

1.3.5. Paste to Start

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

1.3.6. Paste to End

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

1.3.7. Remove Whitespace

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

1.3.8. Remove Widespace

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

1.3.9. Delete

Deletes the currently selected fields in the edit pane

1.3.10. Set Value...

Set the value of the selected fields to any text that you enter into the popup dialog.

1.3.11. Undo

Undo any changes to selected fields.

1.3.12. Find and Replace...

Find and Replace values in the edit pane

1.3.13. Capitalizer...

Change the case/capitalisation of the selected fields.

1.3.13.1. Title Case

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

1.3.13.2. Sentence Case

Change the case to Sentence case

1.3.13.3. Capitalize all letters

Change all letters to uppercase

1.3.13.4. Lowercase all letters

Change all letters to lowercase

1.3.14. Swap Columns...

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

1.3.14.1. Swap Artist with Album

Swap the data between these two columns

1.3.14.2. Swap Artist with Title

Swap the data between these two columns

1.3.14.3. Swap Artist with Track No

Swap the data between these two columns

1.3.14.4. Swap Artist with Comment

Swap the data between these two columns

1.3.14.5. Swap Album with Title

Swap the data between these two columns

1.3.14.6. Swap Album with Track No

Swap the data between these two columns

1.3.14.7. Swap Album with Comment

Swap the data between these two columns

1.3.14.8. Swap Title with Track No

Swap the data between these two columns

1.3.14.9. Swap Track No with Comment

Swap the data between these two columns

1.3.14.10. Swap Title with Comment

Swap the data between these two columns

1.3.15. Empy Columns...

By using the submenus you can empty all the visible fields in a particular column, you can also empty any column by selecting this option from the column header menu.

1.3.15.1. Empty Artist Column

Empty all the visible artist fields of metadata.

1.3.15.2. Empty Album Column

Empty all the visible album fields of metadata.

1.3.15.3. Empty Title Column

Empty all the title fields of metadata.

1.3.15.4. Empty Album Artist Column

Empty all the visible album artist fields of metadata.

1.3.15.5. Empty Track No Column

Empty all the visible track no fields of metadata.

1.3.15.6. Empty Genre Column

Empty all the visible genre fields of metadata.

1.3.15.7. Empty Year Column

Empty all the visible year fields of metadata.

1.3.15.8. Empty Artwork Column

Empty all the visible artwork fields of metadata.

1.3.16. Swap

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

1.3.17. Prepend to Left

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

1.3.18. Prepend to Right

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

1.3.19. Renumber Track Nos

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

1.4. View

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

1.4.1. Show View Pane

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

1.4.2. Show Tag Browser

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

1.4.3. Show Detail Pane

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

1.4.4. Show ToolBar

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

1.4.5. Show ID3 Tabs

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

1.4.6. View Artwork Full-size

Available if you have one track selected with artwork

1.4.7. View this Track at MusicBrainz

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

1.4.8. View this Artist at MusicBrainz

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

1.4.9. View this Album at MusicBrainz

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

1.4.10. View this Acoustic Id at MusicBrainz

Available if you have one track selected with a AmpliFIND Id see View this Acoustic Id at MusicBrainz. Some tracks may have an acoustic id that isnt actually in the Musicbrainz database so this option may open an empty page.

1.4.11. View this Track at Amazon

Available if you have one track selected with an Amazon Id see View this Amzon Id at Amazon

1.4.12. View this Release at Discogs

Available if you have one track selected with an Release Discogs Url

1.4.13. View this Release at Wikipedia

Available if you have one track selected with an Release Wikipedia Url

1.4.14. View this Artist at Discogs

Available if you have one track selected with an Artist Discogs Url

1.4.15. View this Artist at Wikipedia

Available if you have one track selected with an Artist Wikipedia Url

1.5. Action

This Menu is for performing auto correcting tasks.

1.5.1. Auto Correct

Runs the AutoCorrecter over all records performing the tasks as specified in your AutoCorrecter Preferences in the order they were specified. If the task takes a while to complete a Progress Monitor will display showing the Auto Correcter progress,

if you want to stop the Auto Correcter click on Cancel and it will not complete the remaining tasks

1.5.2. Match To Album

This menu is for fixing release information for just a single release.

1.5.2.1. Match Songs to one MusicBrainz Release

Tries to match all the selected songs to one Musicbrainz Release. This is very useful if your songs are listed as being from various albums but you know they all belong on a single album

1.5.2.2. Match Songs to Specified MusicBrainz Release...

Tries to match all the selected songs to specified Musicbrainz Release. This is very useful if you have already found the Musicbrainz release you want the songs to be linked to.

1.5.2.3. Match Songs to MusicBrainz Release by Barcode...

Tries to match all the selected songs to specified Musicbrainz Release matching on barcode, this is useful if you have been digitising an album and have the physical record available, saves you doing a Musicbrainz search.

1.5.2.4. Match Songs to one Discogs Release

Tries to match all the selected songs to one Discogs Release. This is very useful if your songs are listed as being from various albums but you know they all belong on a single album

1.5.2.5. Match Songs to Specified Discogs Release...

Tries to match all the selected songs to specified Discogs Release. This is very useful if you have already found the Discogs release you want the songs to be linked to. If your songs are not close matches to the selected release in duration Jaikoz warns you and gives you the chance to match to the release anyway.

1.5.3. Local Correct

This menu is for performing corrections that effect the Metadata but not the filename, and do not require access to the Internet. All these local corrections run very quickly.

1.5.3.1. Correct Artists

Perform a Cross Referencing Correct on the Artist column. More information about the Artist Column can be found here

1.5.3.2. Correct Albums

Perform a Cross Referencing Correct on the Album column. More information about the Album Column can be found here

1.5.3.3. Correct Titles

Perform a Cross Referencing Correct on the Title column. More information about the Title Column can be found here

1.5.3.4. Correct Genres

Perform a Cross Referencing Correct on the Genre column. More information about the Gnre Column can be found here

1.5.3.5. Correct Track Nos

Perform a Local Correct on the Track No column. More information about the Track No Column can be found here

1.5.3.6. Correct Years

Perform a Cross Referencing Correct on the Recording Time column. More information about the Year Column can be found here

1.5.3.7. Correct Comments

Perform a Cross Referencing Correct on the Comment column. More information about the Comment Column can be found here

1.5.3.8. Correct Composers

Perform a Cross Referencing Correct on the Composer column. More information about the Composer Column can be found here

1.5.3.9. Correct Artwork

Perform a Local Correct on the Artwork column. More information about the Artwork Column can be found here

1.5.4. File And Folder Correct

1.5.4.1. Change Base Folder

Modify the base folder field of the selected songs to another existing folder.

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

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

1.5.4.4. Correct Sub Folders From Metadata

Renames your subfolder from the information in your fields and the rename mask that you have provided. More information available from here

1.5.4.5. Correct Filenames From Metadata

Renames your filename from the information in your fields and the rename mask that you have provided. More information available from here

1.5.4.6. Correct Metadata From Filename

Extract information from your filename into your fields, more information from here

1.5.5. Remote Correct...

1.5.5.1. Retrieve Acoustic Ids

Retrieve acoustic ids for the songs. Your song is compared acoustically with the AmpliFIND database, and if a song is found that is acoustically the same the acoustic id is retrieved, allowing your track to be matched with the MusicBrainz Database. More information is available from here

1.5.5.2. Autocorrect Metadata From MusicBrainz

Matches your songs against the MusicBrainz Database, using the audio fingerprint and/or the song Metadata. More information is available from here

1.5.5.3. Autocorrect Metadata From Discogs

Matches your songs against the Discogs Database, using the song metadata. More information is available from here

1.5.5.4. Correct Lyrics

Automatically retrieves lyrics for your songs, more details at Autocorrect Lyrics

1.5.5.5. Submit MusicBrainz/PUID Pair

Submit your matches back into the MusicBrainz Database, more information available from Submit MusicBrainz/PUID pair

1.5.5.6. Submit MusicBrainz/AcoustId Pair

Submit your matches to the new AcoustId Database, Jaikoz will start to use this database for matching in the future.

1.5.5.7. Submit MusicBrainz Genres

Submit your track and release genres to the MusicBrainz Folksonomy, more information available from Submit MusicBrainz Genres

1.5.5.8. Submit Barcodes

Submit your album barcodes to MusicBrainz.

1.5.5.9. Submit Ratings

Submit your song ratings to MusicBrainz

1.5.5.10. Submit New Release

Adds the selected songs to Musicbrainz, the MusicBrainz Release Editor is opened with all the inforamtion from your selected songs already completed, this makes it much easier and quicker to add new releases to MusicBrainz.

1.5.5.11. Add to your MusicBrainz Collection

Submit your collection (list of releases) to MusicBrainz, more information available from Submit MusicBrainz Collection

1.5.5.12. Remove from your MusicBrainz Collection

Remove the selected releases from your MusicBrainz Collection

1.5.5.13. Manual Correct Tags From MusicBrainz

Matches your tracks against the MusicBrainz Database, using the audio fingerprint and/or the track Metadata, and provides a list of possible matches that you can select. More information is available from Manual Correct tags from Musicbrainz

1.5.5.14. Update Metadata From Existing MusicBrainz Id

Updates the Metadata from the MusicBrainz Database, for tracks that already have a MB Unique Id, or a MB Release Id, see Updates Tags from MusicBrainz for more details.

1.5.5.15. Update Metadata From Discogs

Updates the Metadata from the MusicBrainz Database, for tracks that already have a Discogs Release url, see Update Tags from Discogs for more details.

1.5.6. Delete Duplicates

Delete duplicates songs based on their Musicbrainz Id and/or Acoustic Id, more details at Delete Duplicates.

1.5.7. Delete Files

Mark Files for deletion, the files will only actually be deleted if you run Save Changes.

1.5.8. Undelete Files

Mark Files for undeletion

1.6. Filters

This Menu is for filtering and highlighting songs. Filtering restricts the songs that are displayed in the Edit window, subsequent menu options are only applied to the songs still available in the edit window. Highlighting changes the colour of fields to indicate they meet a particular condition.

1.6.1. Highlight Fields

Menu items within this menu highlight fields in particular columns based on some predefined conditions

1.6.1.1. Duplicate Music Brainz Unique identifier

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

1.6.1.2. Duplicate AmpliFIND Acoustic Identifier

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 in orange

1.6.1.3. Non-standard Genres

When enabled genre fields that contain a non-standard genre are highlighted in orange

1.6.1.4. Non-iTunes Genres

When enabled genre fields that contain a non-Itunes genre are highlighted in orange. Itunes only recognizes the basic set of Genres, rather the extended set.

1.6.2. Duplicate MB id and AmpliFIND Id

When enabled only records containing a Musicbrainz id and AmpliFIND id combination 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.

1.6.3. Filter Non Standard Genres

Menu items within this menu filter records to only show those that meet predefined conditions

1.6.3.1. No Genres Enabled

Cancels any genres filters

1.6.3.2. Non Standard Genres

When enabled only shows records with non-standard genres

1.6.3.3. Non-iTunes Genres

When enabled only shows records with iTunes genres

1.6.4. Filter MusicBrainz Unique Ids

Menu items within this menu filter records to only show those that meet predefined conditions

1.6.4.1. No Music Brainz Unique Id Filters Enabled

Cancels any MusicBrainz filters

1.6.4.2. Duplicate Music Brainz Unique identifier

When enabled only records containing a Unique File 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.

1.6.4.3. Music Brainz Unique Identifier Exists

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

1.6.4.4. Music Brainz Unique Identifier does not Exist

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

1.6.5. Filter AmpliFIND Acoustic Ids

1.6.5.1. No AmpliFIND Acoustic Ids Filters Enabled

Cancels any AmpliFIND Acoustic Ids filters

1.6.5.2. Duplicate AmpliFIND Acoustic Identifier

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

1.6.5.3. AmpliFIND Acoustic Identifier Exists

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

1.6.5.4. AmpliFIND Acoustic Identifier does not Exist

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

1.7. Advanced

1.7.1. Use Advanced Toolbar...

By default a very simple toolbar is displayed with only the most important icons, enabling this option replaces the toolbar with the advanced toolbar. The advanced toolbar was the default in Jaikoz version 3.1 and earlier.

1.7.2. Export...

Export the songs to a spreadsheet file so the details can be archived or modifed outside of Jaikoz. More details at Export

1.7.3. Import...

Import song information from a spreadsheet file replacing any modified values with the ones in the spreadsheet. More details at Import

1.7.4. Empty Cache

Empty the database cache. The database stores the details of artists, albums and tracks that have been downloaded from Musicbrainz and songs that have previously been loaded into Jaikoz. This allows subsequent lookup to be done locally and much more quickly, but you may wish to empty the cache to ensure that Jaikoz gets any updates to Musicbrainz since the information was originally downloaded. It also speeds up the reloading of files into Jaikoz from your computer.

1.7.5. Create Support Files

If you have a problem with Jaikoz please use this option to create a zip file containing all the important information that will help to fix the problem, please use this option whenever you have an unexpected error occurring within Jaikoz.

1.8. Reports

1.8.1. List Missing Tracks for Albums

This will create a list of albums from the tracks that you have selected that have been successfully matched to MusicBrainz, and the list the tracks within each album that you dont appear to have, more details from here

1.9. Help

This menu contains access to information about Jaikoz and a number of 3rd party websites that may be useful to you.

1.9.1. Check for Later Version

Check for updates to Jaikoz.

1.9.2. Register

Register Jaikoz

1.9.3. Offline Help

Shows this help

1.9.4. Online Help

Access the latest version of help online viewed in your default browser

2. Preferences

All tabs have similar format. At the bottom of the window are three buttons

  • OK saves any changes made.

  • Cancel closes the window without making any changes

  • Reset loads the current tab with the defaults, you need to select OK to save these changes.

2.1. General

2.1.1. Appearance

Select the Language used in the Jaikoz: English, Italian, Spanish, German and Greek are currently supported.

Jaikoz provides two different Appearances. By default Jaikoz runs as you would expect on the operating system you are using. But if you use Jaikoz on more than one computer (For example an Apple Mac and a Windows PC).there is a generic Appearance which makes Jaikoz look the same on all operating systems (Windows,Linux,Mac OS X) called Cross Platform If you change this option changes will not take place until you restart Jaikoz.

Specifies the Music Player used to process from the Play Song option.

Jaikoz will try to find and use the Default Browser but this is not always possible. Browser Path allows you to specify the path of the browser that you would like to use and overrides any browser Jaikoz finds automatically.

If Save preferences automatically without prompting is selected, any changes made by you in the Preferences will autoatically be saved this is the default. If you uncheck this option you will be prompted when you exit to save any unchanged preferences if you would like to

If Show Information Popups is selected then a popup is shown at the end of running a task summarizing what was changed, if you disable it then the information is just added to the console.

If Play sound when task completes is enabled there is a beep on task completion to alert you

2.1.2. Base Folder

The Read Folder specifies the location Jaikoz will look in by default. You can either type in a folder or use the Select Folder button to open a file browser to find the folder you require. If Include Sub Folders when searching for Songs is selected Songs within the subfolders will also be loaded. The Specify the number of folders above this selection to set the Base Folder to setting decides how the path selected is split between the Base Folder and the Sub Folder. When set to zero the path selected will be set as the Base Folder (any other folders below will be set as the Sub Folder), as the value is increased more of the path will be put into the Sub Folder field and less put into the Base Folder field.

If Load from this Folder on Startup is selected when Jaikoz starts it will automatically load songs from this folder

2.1.3. Proxy Server

In some environments you many need to use a proxy server to access the Internet from Jaikoz. If so select Use Web Proxy and enter the Proxy Server and Proxy Port. Some proxies additionally require you to enter an userame and password

2.1.4. Database

The Jaikoz database caches details of the songs you load into Jaikoz, and release lookups from Musicbrainz and Discogs, so it can get very large, you can specify the location of the Jaikoz database in the Database Folder field, this will take effect when you restart Jaikoz.

.

2.2. Table

This allows you to set how the data tables look and work

2.2.1. Columns

From here you can decide which columns are displayed, the order they are displayed in and the the width of the column

To change the order of a field select it and then drag it to the new location. (A field will still be saved to a tag whether it is visible or not)

To hide a field or display a hidden field select it and then double-click on the Visible checkbox

To adjust the width of a field select , then double-click on the Width field and enter the new width, this is measured in pixels

2.2.2. Audio Columns

Sets the columns displayed in the Audio Tab

2.2.3. ID3 Columns

Sets the columns displayed in the ID3 Tabs as used by MP3 files

2.2.4. Display

Fields have different colour based on their status, you can modify the colours here. Select the 'Select Colour' button to choose the new colour

2.2.5. Synchronisation

You can change the synchronisation settings here by selecting/deselecting the relevent checkbox.

the meaning of these is explained here

2.3. Save

2.3.1. ID3Tag V1

ID3v1 is the original tagging system used with MP3 files.

Specifies the default tag versions to save. What tags you save depends upon how you use the songs. ID3v1 is supported by most Audio applications however it is a very limited system, most applications now support ID3v2 tags in some form so there is a strong case for removing your ID3v1 tags from your file so you do not have two datasets to maintain. If your application supports ID3v2.4 you should save your tags to this version as it is the latest and greatest version, however many applications only support ID3v2.3 and ID3v2.2 so you need to take this into account when making a decision.

For ID3v1 tags you can elect to remove them, always write a particular tag version or to keep the existing tag version and provide a default if the tag does not exist.

2.3.2. ID3Tag V2

ID3v2 is the newer tagging system used with MP3 files. ID3v23 is more widely supported than ID3v22 or ID3v24.

For ID3v2 tags you can elect to always write a particular tag version or to keep the existing tag version and provide a default if the tag does not exist.

For ID3v2 you can select the text encoding to use. Most of the time the IS08859 encoding can be used but if you have values that use special characters or that are written in a language other than English one of the UTF encodings will sometimes have to be used instead. The difference is that IS08859 uses one byte per character, UTF16 uses two bytes per character so that it can store a wider range of characters - but requires more space. UTF8 uses one byte where it can, but two bytes otherwise.

The Default Text Encoding ... options are what Jaikoz will use when creating any new fields if it can, if you have also selected the Save existing fields using this encoding option then Jaikoz will use this text encoding for any existing fields if it can. When you have text that cannot be encoded in IS08859 ID3v23 will automatically use UTF16 there is no offer choice, but for ID3v24 you can choose between UTF16, UTF16BE and UTF8 with Text Encoding to use when need to write Unicode ID3v24 tags, if you have already set Default Text Encoding to use when writing ID3v24 tags to anything other than ISO8859 then this option will have no effect because UTF will be used anyway.

2.3.3. General

Pad Numbers with zero Track and Disc Nos are always padded in Jaikoz for readibility but the ID3, OggVorbis and Flac formats allow you to specify if you want to store the zeroes in the files themselves

If enabled Delete empty folders on save automatically deletes folders that are now empty because the songs that were in there previously have been renamed or moved. This is powerful way of housekeeping you filesystem but may not always be desired so it is disabled by default.

With Move files marked for deletion to the deletions folder instead of actually deleting them is enabled you can specify a folder that deleted files are moved to instead of them being removed from your computer completely. It is like having a Recycle Bin or Trash Can just for Jaikoz. Specify the folder to use in the Deletion Folder field.

If you move your songs to another folder Jaikoz also move other files found in the same folder as they may be artwork , liner notes or other files linked to the songs , but you can disable this default behaviour by unchecking Move associated files

If using the Save and Move task within the Autocorrecter you need to specify where the songs should be moved to in the Move Folder field.

2.3.4. Compatibility

The compatibility tab allows you to make adjustments to your preferences so that your files work best with different players, by default this tab is configured so that your files work best with iTunes.

If the Do not unsynchronise ID3 tags option is enabled the tags will not be unsynchronised. Unsynchronisation is required when there is Metadata which could be misinterpreted as the start of the the actual audio data, extra bytes are inserted so no misinterpretation will happen. But if you are using an application that does not understand unsynchronisation then the Metadata can be misintepreted instead, this problem is most likely to occur if you have added cover art, the end result will be an image that does not display properly in some applications. Enabling this option will not usually cause problems with the audio because most players will correctly identify the start of the audio even there is Metadata which could be misinterpreted as the start of the the actual audio data.

Usually Genres selected from a the Genres list are stored internally as a number but if the Save genres in an iTunes-friendly Format option is enabled than Jaikoz will ensure that when genres are saved they will store the genre as a String if it is one of the additional genres defined by Winamp to ensure that iTunes recognises it.

Unfortunately different Music Players use different internal values to represent ratings, so a particular value that might denotes 5 stars in iTunes would only denote 2 stars in Windows Explorer. To solve this issue Jaikoz lets you specify how to interpret the values when they are loaded using the Upload and Save ratings so compatible with option, this will interpret the ratings as they are loaded and save the ratings using that format. You can also use it to convert ratings, for example if you load songs that have ratings stored in Windows Media format and you want to use them in iTunes set the option to Windows Media Player, load the files into Jaikoz, change the option to iTunes and save your changes.

To further complicate things, many players do not actually store their ratings in the songs themselves instead they store therm in their own internal database, Jaikoz provides a solution for this problem if you are using iTunes. If Jaikoz is configured to update changes to iTunes and you have changed the rating field then on save this field is used to update the rating within the iTunes database, giving you a way to modify your iTunes ratings outside of iTunes itself. If you make further changes to the files in Jaikoz but do not modify the ratings field then on save it will not overwrite the rating within iTunes (unless you do Force Save), this means you can make subsequent changes to the ratings within iTunes without being concerned that Jaikoz will replace the values. Remember that iTunes does not store it's ratings in the files themselves, and ratings stored in the iTunes database are not read by Jaikoz

2.3.5. iTunes AutoUpdate

Here we specify preferences to be used for updating iTunes from Jaikoz, a full understanding of these sections can be found in ITunes chapter

2.4. MusicBrainz

Here we specify preferences to be used with MusicBrainz and AmpliFIND, a full understanding of these sections can be found here

2.5. Remote Correct

Preferences that apply to remote correct and are not specific to Musicbrainz which has its own preferences section.

2.5.1. Match

The options are explained at Match Settings

2.5.2. Discogs

The options are explained at Discogs Options

2.5.3. Correct Lyrics

If Only populate Lyrics field if empty option is checked no attempt is made to find lyrics for songs that already have lyrics

2.5.4. Correct Genres

The Blacklist lists words that should not be treated as genres, this list is used when getting genres from Musicbrainz and Discogs, and when submitting genres back to Musicbrainz.

2.6. Local Correct

The items in this sub menu allow you adjust the settings used when you run the associated local Correct task

2.6.1. Auto Match

Here we specify preferences to be used when matching tracks when local correcting the Artist, Album, Title, Genre, Composer or Comment fields. The meaning of these sections can be found here

2.6.2. AutoFormat

Here we specify preferences to be used when formatting matches performed by the local correcter for the Artist, Album, Title, Genre, Compposer or Comment fields. The meaning of these sections can be found here

2.6.3. Track Correct

2.6.4. Year Correct

The only setting you can change is to specify removal of undisplayable characters but running the Correcter will also validate the Recording Time Column and if it can not fix it will set it empty

2.6.5. Artwork Correct

Settings for Local Correct of the Artwork field, the options are explained in Correct Artwork

2.6.6. Delete Duplicates

Settings for Delete Duplicates are explained in Delete Duplicates

2.7. File And Folder Correct

2.7.1. File and Folder Naming

If Replace Non Ascii Characters is enabled then when renaming a file from the metadata any characters that cannot be encoded using the standard ascii charset is represented by a simplified representation instead, for example accented characters is represented by its unaccented version.

If Replace 'From' Character with 'To' Character is enabled you can then specify pairs of from and to words to map to.

2.7.2. Rename Folder from Metadata

Here we specify a format to be used when the sub folder name is generated from the metadata. You can edit the text box directly and select masks from the list which will automatically append the value. You should use the folder separator %folderseperator% rather than typing the folder separator directly. There are also some special masks that you can use, %bestartist% will use the album artist field if it exists, but use the artist field as a backup. The if function checks that a field has a value and if it does it displays the value after the ',' . For example the mask $if(%artist%,%artist%-)> would display Beck- if the artist contained the value Beck and nothing otherwise. There are two different masks, the Compilation Rename mask is used if the song has the Is Compilation field set, this is useful for keeping your compilation albums in a different location to your original albums.

2.7.3. Rename File from Metadata

Here we specify a format to be used when the filename name is generated from the metadata. You can edit the text box directly and select masks from the list which will automatically append the value There are two different masks, the Compilation Rename mask is used if the song has the Is Compilation field set, this is useful for naming your compilation albums songs differently to to your original albums.

2.7.4. Correct Metadata from Filename

Here we specify settings to be used by when AutoCorrecting metadata from filename, the meaning of these sections can be found here

2.8. Manipulators

2.8.1. AutoCorrecter

Jaikoz can perform a number of corrections automatically these can be batched up into the Auto Correcter task. Here we can specify which tasks to perform and in what order. Jaikoz comes with a default list that performs all local auto corrections, some corrections are performed twice this is because the output from one task can effect the input of another task. For example we do the following order:

Correct Artist
Tags From File
Correct Artist
Correct File from Tags

Correct Artist will find matches between Artist fields, Tag from File will populate missing Artist fields if possible from the filename it will use the values currently in the Artist column to get as accurate a match as possible. We then run Correct Artist again to take into account of any new matches, we then write the updated Artist fields to the filename with Correct Artist from Tags

The left hand side lists all the Available tasks, the right hand side your current Auto Correcter Tasks

To add tasks to your Auto Correcter Tasks select the task from Available Tasks you want to add then use either Add to or drag them over to the AutoCorrecter tasks.

To remove tasks from your Auto Correcter Tasks selecting an item(s) and select Remove.

To sort tasks in your Auto Correcter Tasks select the item you want to move and either use the Up and Down buttons to move it in the list or simply drag and drop it.

2.8.2. Word Remover

Word Removers are used by AutoMatch, they ignore words listed in a word remover when comparing field values. From here we can specify one or more word remover lists and the words they contain. The Window is split horizontally, the top half specifes the Word remover lists (a default called 'Default ' is provided) when you select a list the bottom half of the window shows all the words that will removed. Use the Add,Rename and Delete buttons in the half to create, rename or delete new word lists. use the Add,Rename and Delete in the bottom half to create, rename or delete a value from the word list

You may wish to define multiple word removers for different columns or for different dataset. For example if you are dealing with songs in a different language you could define a word remover specifically for that language

2.8.3. Word Separator

Word Separators are used by AutoMatch to identify when a word ends, words are separated by the values. From here we can specify one or more Word Separator lists and the Word Separators they contain. The Window is split horizontally the top half specifes the Word Separator lists (a default called 'Default ' is provided), when you select a list the bottom half of the window shows all the characters that are used to separate words. Use the Add,Rename and Delete buttons in the half to create, rename or delete new Word Separators. use the Add,Rename and Delete in the bottom half to create, rename or delete a value from the word list, only single characters are allowed.

You may wish to define multiple Word Separators for different columns or for a different dataset. For example two Default Word Separators are provided,one is used by the FileName to tag correcter to split a filename into separate components. In this case we do not want to include the ' ' character because this would break up song titles into different words whereas we want to keep the Title as a single word for this auto correction.

2.8.4. Word Replacer

Word Replacers are used by AutoFormat to replace words with another word. From here we can specify one or more word replacer lists and the words replacers they contain. The Window is split horizontally the top half specifes the Word Replacers lists (a default called 'Default ' is provided) ,when you select a list the bottom half of the window shows all the words that will be replaced and by what they will be replaced by. Use the Add,Rename and Delete buttons in the half to create, rename or delete new word replacers. Use the Add,Rename and Delete in the bottom half to create, rename or delete a valuepair from the word list, you have to specify what the word is and what you want to replace it by.

You may wish to define multiple word replacers for different columns or for a different dataset. For example if you are dealing with songs in a different language you could define a word replacer specifically for that language.

2.8.5. Punctuation Remover

Punctuation Removers are used by AutoFormat to remove characters we do not want. From here we can specify one or more Punctuation Removers lists and the Punctuation Removers they contain. The Window is split horizontally the top half specifes the Punctuation Removers lists (a default called 'Default ' is provided) , when you select a list the bottom half of the window shows all the punctuation that will be removed. Use the Add,Rename and Delete buttons in the half to create, rename or delete new punctuation removers. use the Add,Rename and Delete in the bottom half to create, rename or delete by a value from the list, only single character are allowed.

You may wish to define different punctuation removers for different columns or for a different dataset. For example if you are dealing with songs in a different language you could define a punctuation remover specifically for that language.

2.8.6. Capitalizer

In title case all words are capitalized except for the words listed here in the Usually keep lowercase in Title Case list

In title and sentence case only the first letter of each word is capitalised unless it is listed in the Capitalize all letters in Title and Sentence Case list

3. Popup Menu

Popup Menus allow you to do some tasks straightaway from where you are based on what you have currently selected.Most of the actions also have an associated keyboard shortcut.

3.1. View Panel Row Popup Menu

In the Read Panel you can invoke this Menu from the row number, it will effect all row numbers you have selected.

3.2. View Panel Popup Menu

In the Read Panel Table you can bring up a Popup Menu to act on all selected fields in the table

Chapter 11. Keyboard Traversal

The keyboard can be used to perform most functions

1. General Keyboard Actions

Table 11.1. General Keyboard Actions

Key Task
Tab Move to next field,button,table..
Shift+Tab Move to previous field,button,table...
Command+Tab Move to next field,button when inside a table
Option Go to Main Menu
Spacebar Select/Deselect checkbox or radio button

2. Main Menu Actions

Table 11.2. Main Menu Actions

Key Task
Option Go to Main Menu
Right Arrow Go to next Menu
Left Arrow Go to previous Menu
Up Arrow Scroll down Menu items in Menu
Down Arrow Scroll up Menu items in Menu
Enter Run selected Menu item
Esc Close Main Menu

3. Table Keyboard Actions

Table 11.3. Table Keyboard Actions

Key Task
Esc Return field prior to editing
Enter Start Editing current field
Command+C Copy information in selected field into clipboard
Command+V Paste first value from clipboard into selected field(s)
Shift+V Paste all value from clipboard into selected field(s)
Command+D Delete selected field
Command+J For multiple value fields open the associated Popup Window
Tab Move to next field
Right Arrow Move to next field
Shift+Tab Move to previous field
Left Arrow Move to previous field
Home Move to first field in row
End Move to last field in row
Command+Home Move to first field in table
Command+End Move to last field in table
Command+A Select all fields in table
Shift+Up/Down Extend selection one row