A MediaMonkey addon that enables you to submit new discs to the freedb database or revise existing freedb entries using your MediaMonkey album and song data.
Requirements:
MediaMonkey 4+
Download URL:
https://www.mediamonkey.com/addons/download/704/
Installation:
Double click the freedbSubmitter26.mmip file.
If you prefer to install manually, follow these steps:
- Open freedbSubmitter26.mmip in a Zip utility
- Copy the freedbSubmitter folder to %appdata%\MediaMonkey\Scripts\
- Add the following entry to the Scripts.ini in the Scripts folder:
Code: Select all
[freedbSubmitter]
Filename=freedbSubmitter\freedbSubmitter.vbs
Procname=launchSubmitter
Order=100
;The order number determines where this addon will appear in the Tools>Scripts menu. You can change it to any number you prefer.
DisplayName=freedbSubmitter
Description=Submit disc metadata to freedb from MediaMonkey
Language=VBScript
ScriptType=0
Configuration:
The addon provides the options to preview your entry before submitting, and to include extended data from your Album Comment and Song Comment fields. You can configure default values for these options by opening the freedbSubmitter.hta file in a text editor and changing the values of the viewSubmitDefault and sendExtDefault variables. Values can be True or False (case-insensitive, no quotes).
It's also a good idea to ensure that you have a valid email address entered into MediaMonkey's User Name and User Domain fields under Options>Network (Proxy and Freedb)>Freedb Settings.
Usage:
FreedbSubmitter can be used in two different modes -- basic and extended. Basic mode is the default and easiest to use. Extended mode is more complex but allows to include your MM album and song comments as extended data to freedb. Extended data in freedb refers to additional disc and track data that doesn't fit into freedb's basic metadata fields.
In basic mode you can submit new or revised basic CD metadata like album title, artist, date, genre, and track titles, all taken from the disc you've selected in MediaMonkey. If you submit a new disc, no extended data from your album and song comment fields will be sent to freedb. If you revise an existing disc, the submission will retain freedb's existing extended data. Your MediaMonkey album and song comments will not be included.
Follow these steps to use freedbSubmitter in basic mode:
- Expand the Location node in the MM Music Tree
- Select the CD you would like to submit to freedb
- Ensure that the MM Song List is sorted by ascending Track Number
- Open freedbSubmitter from the Tools>Scripts menu
- In the freedbSubmitter window, click the Query freedb button
- The freedb query results will be displayed
- If your disc does not exist on freedb, you will see a freedb Category dropdown list and a Submit button
- Select a category for your disc (the category doesn't need to match your MM genre)
- If you see a message that inexact matches were found, you will not be able to submit your disc data
- If you would like to preview your submission, check the Preview Submission checkbox
- Click the Submit button
- The submission results will be displayed
- If you see a message that a DiscID collision has occurred, select a different freedb category and click Submit again (once again, the category doesn't need to match your MM genre).
- If you'd like to submit another CD to freedb, make your selection in a MM CD Location node, then click the Refresh button in freedbSubmitter
In extended mode, freedb submissions will include basic disc metadata as well as extended disc data and extended track data. Extended disc data is obtained from your MM album comment field, while extended track data is from your song comment fields.
Follow these steps to use freedbSubmitter in extended mode:
- Expand the Location node in the MM Music Tree
- Select the CD you would like to submit to freedb
- Ensure that the Song List is sorted by ascending Track Number
- Open freedbSubmitter from the Tools>Scripts menu
- In the freedbSubmitter window, ensure the Submit Extended Data checkbox is checked.
- Click the Query freedb button
- The freedb query results will be displayed
- If your disc does not exist on freedb, you will see a freedb Category dropdown list and a Submit button
- Select a category for your disc (the category doesn't need to match your MM genre)
- If you see a message that inexact matches were found, you will not be able to submit your disc data
- If you would like to preview your submission, check the Preview Submission checkbox
- Click the Submit button. Data in your MM album and song comment fields will be submitted to freedb as extended data.
- The submission results will be displayed
- If you see a message that a DiscID collision has occurred, select a different freedb category and click Submit again (once again, the category doesn't need to match your MM genre).
- If freedb finds a matching disc, you'll see box that summarizes the extended data in freedb and MM.
- If the extended data is identical in freedb and MM, you can click the Submit button.
- If the extended data differs, you'll need to click the Extended Data button to review or revise extended disc and track data.
- After reviewing the extended data, click the Close button in the Extended Data window to return to the main interface.
- Click the Submit button to complete your submission
- If you'd like to submit another CD to freedb, make your selection in a MM CD Location node, then click the Refresh button in freedbSubmitter.
When MediaMonkey imports disc metadata data from freedb, extended track data is saved in MM's song comment field. However, extended disc data is not imported or saved at all.
Since MediaMonkey does not include extended disc data when importing from freedb, extra care has been taken to avoid accidentally overwriting existing freedb data that you may not have been aware of. If you are revising an existing disc, you'll see a data comparison summary of freedb and MediaMonkey extended data. If there are differences in the data, you'll need to review the differences and make any desired edits before submitting to freedb. Please use care when editing extended data to avoid deleting content from previous freedb contributors.
Because extended disc data might be particularly prone to being inadvertantly overwritten, the data from both freedb and MediaMonkey are combined into a single text box. You can edit the text box's contents as needed. When you click Submit, the contents of the text box will be saved to MediaMonkey's album comment field and sent with your freedb submission as extended disc data.
For extended track data, you'll see a list of album tracks in which tracks with differing freedb and MM data are highlighted. You can click the track to see the specific freedb and MM data. If you'd like to revise the track data, you'll need to edit the MM song comment field for that track. Unlike disc data, track data cannot be directly edited in freedbSubmitter. Whatever data is in MM's song comment fields will be sent to freedb as extended track data when you click Submit.
Version History:
1.00 [2016-08-14]
- Initial release
1.01 [2016-08-17]
- Changes install/uninstall configuration to eliminate the requirement to run as admin
1.02 [2019-10-20]
- Fix faulty installation script implemented in version 1.01
2.0 [2019-10-30]
- Adds capability to revise discs that already exist in freedb
2.1 [2019-11-29]
- Adds capability to help prevent accidentally corrupting or deleting existing freedb extended disc data during MM submissions
2.2 [2020-12-29]
- Fixes faulty library node detection
2.3 [2021-01-03]
- Reconfigures addon to support gnudb.org, a new host for the freedb database
- Adds capability to store freedb category in MM Medias table
- Adds capability to search for the CD currently selected in MM
2.4 [2021-01-18]
- Improves handling of multisession discs
2.5 [2021-01-25]
- Fixes CD TOC read problem introduced by version 2.4 changes
2.6 [2021-07-06]
- Replaces Internet Explorer popup windows with HTML layers
- Error checking fixes and improvements
- Fixes empty Album Year field problem when submitting album data [changes MM 0 default to "" in freedb submission]
- Fixes a problem that occurs when usernames contain spaces
- Fixes a problem that occurs when freedb disc collisions are encountered