ViTLXML Online Help

This page last updated May 6, 2019, 6:10 PDT. You can access this page from ViTLXML's Help menu.

Go to the ViTLXML product page.

 

Bug reports, questions, comments can be emailed to support AT dougscripts DOT com. Include "ViTLXML" in your subject line. A response will be sent ASAP.

Bug reports should contain precise details. If possible check Console.app for any ViTLXML-related error messages. In case you don't know, Console.app is located in Applications/Utilities/. Launch Console.app. Enter "vitlxml" in the search field of Console's toolbar. (Many superfluous messages can be filtered with clever use of the search field.) You will see some "helpful" log entries indicating progress, but error messages will be of significant interest.

 

Current Known Issues

Version 1.1.0 released May 4, 2019.

The XML Window has been removed

Previous versions provided a window into which the entire selected XML file would be loaded. This feature was removed in version 1.1. Instead, if the entire XML needs to be viewed, it can easily be loaded in TextEdit or any text editor.

You didn't get your registration code?

Please email me at support AT dougscripts DOT com and I will re-send.

iTunes' "Share iTunes Library XML with other applications" Preferences setting

"Share iTunes Library XML with other applications" is a setting in iTunes > Preferences... > Advanced (v12.2 and later). It gives other applications permission to access the current iTunes library's XML file [screenshot]. ViTLXML needs to access this file to get information about the tracks and playlists in your library. Please be sure this setting is checkmarked ON. Otherwise, ViTLXML will alert you about being unable to access your iTunes library information.

 

ViTLXML Quick Help

ViTLXML (View iTunes Library XML) can display iTunes XML files in a more user-friendly form

  • File > Open... (Command-O) - Displays an open panel in which to navigate to an XML file exported by iTunes.
  • File > Open Current (Shift-Command-O) - Opens the current iTunes Library XML file.
  • Drag-and-drop any iTunes XML file to ViTLXML's window.

Depending on the amount of information contained in the XML file it can take a few moments to be completely parsed and loaded.

Here's an XML that was saved in March of 2011:

  1. The top panel displays general information about the loaded XML file and information from its top level.
  2. The Playlists Sidebar displays the playlists represented in the XML.
  3. Tracks and information about the playlist selected in the Playlists Sidebar are displayed in the Main Panel.
  4. The Toolbar has helpful tools to assist with viewing information:
    • Scroll to Selected (Command-L) - When the selected playlist or selected tracks have been scrolled out of view, click this to scroll them back into view.
    • Search - Enter text and only tracks with matching information will be displayed. You know. Search.
    • Now Showing - Filters the tracks by their "vitality" type:
      • All Items - shows every track item regardless of type
      • Only Accessible - shows only track entries whose files are accessible
      • Only Inaccessible - shows only track entries whose files are inaccessible
      • Only Cloud Tracks - shows only track entries that are Remote (Apple Music, iCloud, etc)
      • Only Likely Current - shows only track entries whose files are very likely also in the current iTunes Media folder (a file with the same name and parent Artist/Album folders has been confirmed to exist in the iTunes Media folder)
    • File Vitality - Toggle text coloring on and off. A different text color will be applied to the track entries of each file vitality type:
      • Accessible - black
      • Inaccessible - red
      • iCloud Tracks - blue
      • Likely Current - indigo
    • Text Size - Rotate through 3 text sizes.

Track Information

Control-click or Right-click on a selected track to display a contextual menu:

  • Show Entry Info (Command-I) - Shows the selected track's Entry Info panel displaying all of its tags and data (see below).
  • Show in Playlists - Selectable list of playlists that the track appears in.
  • Search for Match in iTunes - Try to find a matching track in the current iTunes library.
  • Show File in Finder - If a file for the track entry exists, show it in the Finder.

Entry Info

The Entry Info panel not only displays track data but can also aid with navigating the list of tracks in the Main Panel.

Open the Entry Info panel by selecting a track and pressing Command-I, choosing "Show Selected Entry Info" from the File menu, or choose "Show Entry Info" from the selected track's contextual menu.

  1. The top section displays primary information about the track and artwork from its file's metadata, if available.
    • The image can be copied to the clipboard for pasting elsewhere.
  2. This first middle section displays all the metadata for the track entry.
    • This section and the one below it can be resized using the splitter bar that divides them.
    • Right-clicking over the "Location" field (if present) will provide a button to copy the displayed file path to the clipboard.
  3. This second middle section is an isolated view of how the entry appears in the XML file.
  4. This section contains navigation and other tools:
    • Navigation Controls
      • < or left arrow key - Display Previous track entry
      • > or right arrow key - Display Next track entry
      • [center button] or down arrow key - Select the currently displayed entry in the Main Panel
    • Scroll Lock - When "on", scrolls the Main Panel in sync with Previous and Next selection
    • Action Popup
      • Show File in Finder
      • Show Track in iTunes

Export Options

It's one thing to be able to see data from an XML file, but its wholly another to be able to extricate it for practical purposes. ViTLXML has the following exporting features, which can be activated from the Tools menu or playlist and tracks contextual menus:

Export XML of Library with Replacing...
This is the sort of thing that people used to do by hand—export a copy of the entire XML replacing the "iTunes Media" path of track entry Location properties (everything up the /Artist/Album/file components) with a new user-selected base folder.
The exported XML can be imported into iTunes using its File > Library > Import Playlist... command.

Export Playlist as XML...
The selected playlist will be exported as a single-playlist XML playlist file.
Optionally, ViTLXML can replace the "iTunes Media" path of track entry Location properties (everything up the /Artist/Album/file components) with a new user-selected base folder.
The exported XML can be imported into iTunes using its File > Library > Import Playlist... command.
Export Files in Playlist...
Copy the accessible files associated with track entries in the selected playlist to a new location.
Export Files in Playlist and XML...
Copy the accessible files associated with track entries in the selected playlist to a new location and export a single-playlist XML file that references these files in the new location.
Optionally, create intermediate Library, Artist and/or Album folders, Compilations folder and choose to replace existing files.
The exported XML can be imported into iTunes using its File > Library > Import Playlist... command.

Export Selected as XML...
The selected tracks will be exported as a single-playlist XML playlist file.
Optionally, ViTLXML can replace the "iTunes Media" path of track entry Location properties (everything up the /Artist/Album/file components) with a new user-selected base folder.
The exported XML can be imported into iTunes using its File > Library > Import Playlist... command.
Export Files of Selected...
Copy the accessible files associated with the selected track entries to a new location.
Export Files of Selected and XML...
Copy the accessible files associated with track entries in the selected tracks to a new location and export a single-playlist XML file that references these files in the new location.
Optionally, create intermediate Library, Artist and/or Album folders, Compilations folder and choose to replace existing files.
The exported XML can be imported into iTunes using its File > Library > Import Playlist... command.

Reconstruct Playlist...
Using basic track information from the entries in a selected playlist, try to recreate the playlist in iTunes using any tracks that match in its current library.
Un-matched tracks will be skipped.
Export Smart Playlist Criteria...
The selected Smart Playlist's criteria will be imported into iTunes and a new Smart Playlist will be created using the criteria.

Keyboard Shortcuts

(In addition to the available standard keyboard shortcuts.)

  • Select All - Command-A
  • Select None - Shift-Command-A
  • Show Entry Info - Command-I
  • View Options... - Command-J
  • Scroll to Selected - Command-L
  • Open... - Command-O
  • Open Current - Shift-Command-O
  • Previous in Entry Info Panel - Left Arrow
  • Next in Entry Info Panel - Right Arrow
  • Select Entry Info Panel Track in List - Down Arrow

ViTLXML does not alter any files or tracks in your current iTunes library.

 

Version History

v1.1.0 (may 4 '19):
- Maintenance and performance enhancements
- Removed XML Window over processing considerations

v1.0.1 (oct 5 '18):
- Additional adjustments to accommodate macOS 10.14

v1.0.0 (aug 1 '18):
- Initial release

Site contents © 2001 - 2019 (that's right: 2001) Doug Adams and weblished by Doug Adams. Contact support AT dougscripts DOT com. About.
All rights reserved. Privacy.
AppleScript, iTunes, iPod, iPad, and iPhone are registered trademarks of Apple Inc. This site has no direct affiliation with Apple, Inc.
The one who says "it cannot be done" should not interrupt the one doing it.

Go to the AppleScripts for iTunes section.