PhantomDeejay
Hi, I'm George!
I started to involve with dj-ing in 1992. I have been a Digital Jockey since 1998, and from year 2000 and afterwards I've went EXCLUSIVELY Digital (meaning that I don't use other media for my gigs).
I have been involved with some dj software titles development and beta testing all these years, and of course I've been an active member of various dj communities.
I have worked as an audio engineer for several years, mainly in the PA field covering various live performances from small bands up to some big names of the industry.
Currently I'm a resident Dj on a small club of a small town in Greece, and in collaboration with...
 VirtualDj Small Tagger

Tue 25 Sep 12 @ 1:47 am

Welcome to VirtualDj Small Tagger online manual!!!




When you open the app you should see the image above. In order to start using the app the first thing you have to do is to select a database file. To do so you just click on the drop down menu (1) to select the drive you wish to work, and then click the "Open" button (2)



After this stage you can select what you want to do. The application operations are grouped in three categories:

  1. Copy infos from VirtualDj database to the id3v2 tags of your mp3 files (3)
  2. Copy infos from the id3v2 tags of your mp3 files to your VirtualDj database (4)
  3. Perform specific database operations (5)



VDJ DB -> ID3 Tags Operations (3)
On this page you can select to copy various information from your VirtualDj Database to the id3v2 tags of your mp3 files. All the operations on this page will affect the tags of your media files and NOT your XML database!
When you select an operation the entire GUI of the app will lock and the progress bar on the bottom will start moving. Once the operation completes, a message box will pop up informing you that the task has completed successfully and the GUI will unlock again!

  • Copy BASIC INFO from VDJ DB to ID3 Tags(6)
    This operation will copy the info from the following fields of your XML database to the id3v2 tags of your files:
    Author (Artist), Title, Album, Year, Genre, Composer
  • Copy BPM from VDJ DB to ID3 Tags(7)
    This operation will copy the BPM from the XML database to the id3v2 tags of your files.
    Please note that VDJ stores the "BPM" value in the XML database as a distance (in samples) between each beat. The application converts this distance to standard BPM value, however some inaccuracies may occur due to round up issues (E.g: a track that VDJ reports as 128.01 may have 128.00 written in it's tag or vise versa)
  • Copy Key from VDJ DB to ID3 Tags(8)
    This operation will copy the Musical Key from the XML database to the "Initial Key" field of the id3v2 tags of your files.
  • Copy Ratings from VDJ DB to ID3 Tags(9)
    This operation will copy the ratings (aka Stars) from the XML database to the id3v2 tags. The application uses the WMP standard tagging scheme. This means that you will be able to see the rating in Windows Explorer as well!
  • Copy Comments from VDJ DB to ID3 Tags(10)
    This operation will copy the comments from the XML database to the id3v2 tags. Please note that according to the id3v2 standards each tag can have multiple comments in it with different 'owners'. Most of the time this makes things more complicated than they need to be. When you use this operation the app will REMOVE all other comments and it will write it's own comment. This will leave you with a tag that has only ONE comment and the 'owner' will be set to blank (the default behavior so that every app that can read id3v2 tags will be able to see/read your comment)
  • Copy HotCues from VDJ DB to ID3 Tags(11)
    This operation copies the HotCue info of your tracks from the XML database to the id3v2 tags of your files. Since there's no dedicated tag field for this info, the app will create a "custom" text frame which is part of the id3v2 standard. Advanced Tagging software (like MP3Tag) will be able to see and read this info as a simple "TEXT" frame. Again, this frame is part of the id3v2 standard.



ID3 Tags -> VDJ DB Operations (4)
On this page you can select to copy various information from your mp3 files id3v2 tags to the VirtualDj Database. All the operations on this page will affect your XML Database and NOT your media files! The application will automatically take a backup of the XML database before each save.
When you select an operation the entire GUI of the app will lock and the progress bar on the bottom will start moving. Once the operation completes, a message box will pop up informing you that the task has completed successfully and the GUI will unlock again! Finally, the "Save" button will be enabled, allowing you to save the changes you have made on your XML database.
While you can save the XML database after each operation, it is advised to perform all the tasks you want, and save the XML file when you're done. This is so that the auto-created backup file of your database is the one that you started with, and not an intermediate one.

  • Copy BASIC INFO from ID3 Tags to VDJ DB(12)
    This operation will copy the info from the following fields of your id3v2 tags to your XML database:
    Artist (Author), Title, Album, Year, Genre, Composer
  • Copy BPM from ID3 Tags to VDJ DB(13)
    This operation will copy the BPM from the id3v2 tags of your files to the XML database.
    Please note that the app will not write the actual "BPM" value in the database (which is measured as distance in samples between each beat). It will write the "BpmTag" value on your database which will tell VirtualDj the "approximate" BPM of the file. If the file hasn't been analyzed by VirtualDj it will have to be analyzed for VDJ to have the 100% accurate BPM info it needs.
  • Copy Key from ID3 Tags to VDJ DB(14)
    This operation will copy the "Initial Key" field of the id3v2 tags of your files to the Musical Key field of your XML database.
  • Copy Ratings from ID3 Tags to VDJ DB(15)
    This operation will copy the ratings (aka Stars) from the id3v2 tags of your files to the XML database. The application uses the WMP standard tagging scheme. This means that it will copy the rating you are able to see in Windows Explorer (if you don't use WMP).
  • Copy Comments from ID3 Tags to VDJ DB(16)
    This operation will copy the comments from the id3v2 tags of your files to the XML database. Please note that according to the id3v2 standards each tag can have multiple comments in it with different 'owners'. Most of the time this makes things more complicated than they need to be. When you use this operation the app will read the FIRST comment of the file and it will ignore the others. Most likely the first comment is the one with 'blank' as its owner. However there's a chance to see a comment written on your database that doesn't appear on your tagging software. That's because a lot of programs use and read only the comment with 'blank' as the owner, while this app reads the first comment it can find on your tag. According to the tagging standards the 'blank' owner is served first, and if it doesn't exist, then comes each owner in alphabetic order.
    Most likely you don't have to bother with all this info, but I thought that I should let you know how things work in the rare occasion you start seeing comments that you thought they didn't exist.
  • Copy HotCues from ID3 Tags to VDJ DB(17)
    This operation copies the HotCue info of your tracks from the id3v2 tags of your files back to the XML database. For this operation to work you will have to write the HotCues on the tags first by using the Copy HotCues from VDJ DB to ID3 Tags (11) command. Since there's no dedicated tag field for this info, the app will read it's own "custom" text frame which is part of the id3v2 standard. For "safety" reasons, if this frame is missing from your file's tag the app will NOT reset the current HotCues of the track. In other words it won't delete the current HotCue points if the custom text frame is missing!
  • Copy Track Nr from ID3 Tags to Field1 or Field2 in VDJ DB(18)
    This operation copies the Track Nr info of your tracks from the id3v2 tags of your files to the XML database. Since VDJ database doesn't offer a dedicated Field for this info, the app will write the track number in one of the two custom (user) fields available. When you start this operation a pop-up window will ask you to which of the two fields you want this info to be copied to.
  • Copy FirstSeen data from files attributes to VDJ DB(19)
    This operation will read the creation date your files attributes and will store it on the FirstSeen field inside the VDJ XML database. This operation is harmless, but it may produce some strange effects. For this operation to work as desired you must use a filesystem on your drive(s) that's capable to retain this info, like NTFS. When the operation completes and works as it should, your FirstSeen data on VDJ should reflect the date the file was created, and NOT the date VDJ saw the file for the first time.



VDJ DB Operations (5)
On this page you can select to perform various database operations. All the operations on this page will affect your XML Database and NOT your media files! The application will automatically take a backup of the XML database before each save.
When you select an operation the entire GUI of the app will lock and the progress bar on the bottom will start moving. Once the operation completes, a message box will pop up informing you that the task has completed successfully and the GUI will unlock again! Finally, the "Save" button will be enabled, allowing you to save the changes you have made on your XML database.
While you can save the XML database after each operation, it is advised to perform all the tasks you want, and save the XML file when you're done. This is so that the auto-created backup file of your database is the one that you started with, and not an intermediate one.

  • Clear Field1 data(20)
    This operation will clear all the data from the Field1 (User1) field inside the VDJ Database
  • Clear Field2 data(21)
    This operation will clear all the data from the Field2 (User2) field inside the VDJ Database
  • Swap Field1 and Field2 data(22)
    This operation will swap the data between the Field1 (User1) and Field2 (User2) fields inside the VDJ Database
  • Clear Comments data(23)
    This operation will clear all the comments data inside the VDJ Database
  • Clear Ratings data(24)
    This operation will clear all the ratings (aka Stars) data inside the VDJ Database



General notes:


  • The application auto-detects which drive(s) have an available XML database:
    A) When it starts up and
    B) When you close a working database.
    If you connect an external drive on your system while the application is open you must restart the application, or open and close another database for the app to be able to pick up the new connected drive!
  • For external drives the application uses a "smart" way to find your files. It is NOT necessary for the application in order to work properly that the external drive has the same letter each time! The application uses "relative" paths in order to find your files!
  • Each time you save your XML database a backup of the last saved database file is created inside your VirtualDj Home Directory (typically C:\Users\YourUsername\Documents\VirtualDj)
    Inside this directory a new directory gets created named "VDJ Small Tagger Backup Files"
    That's where you can find the backup files of your XML databases in case anything goes wrong and you want to revert back! You should see sub-folders organized by date, and then sub-sub folders named after the drive the backup file come from!
  • Generally all XML operations have been tested and they are considered to be 100% safe. However the app will prompt you each time you save an XML database to run the typical "Check-Clean-Fix" procedure from inside VirtualDj in order to achieve optimal database performance.
    You "can" skip this procedure, but it's strongly advised not to!!! Especially if you copied your HOTCUES back from the id3v2 tag data!!!
    If you use this function I strongly advise to run "Check-Clean-Fix" procedure right afterwards!!!
  • There is a small chance that the app will not be able to open your XML file, and it will through a warning message saying:
    "...blah blah blah is an invalid character. Line XXXX, position XXX."
    In this rare case you should open your XML database in question with an advanced text editor like Notepad++, and after you select to see all special characters (like CR/LF) go to Line XXXX and take a look at the character in the position XXX.
    It should be an "invalid" (aka non-printable) character. Most likely this character has come to your database by a file with bad or damaged id3 tag data. I would strongly advise you to delete the tag of this file completely (by using a tag editor) and then re-create it. Also I would strongly advise you to DELETE this character from your database!
    After you delete this character, the application will be able to read your XML database.
    Please note, that this is NOT a bug. My app complies fully with all XML standards. The "invalid" (non-printable) character should not be there in first place!

Finally:

The application's forum thread is HERE
In this thread you can post any of your questions, problems, or suggestions for future update.
Also, the download link (in case you come here by accident) is HERE

Thank you very much!!!