No longer possible to convert .itl library files on my Big Sur Mac

For over a decade I've been using iTunes on Windows, while often making a copy on an external drive in order to use it on an old Mac (2014 version). With the introduction of Apple Music things got a bit more complicated but so far it always worked... till today. While using the option key to open a new library I get a pop up saying the .itl file is 'not valid' and I should chose a different library or create a new one.


Been checking and trying a few things out myself and updated from version 11.4 to 11.7 (seems to be the maximum update for this machine). Been reading about similar issues with Monterey but iOS 11.7 is still Big Sure so that shouldn't be a problem to be compatible with iTunes files. The .itl is also not corrupted, I linked the exact copy to iTunes on Windows and it works fine there. Checked permission acces on the Mac, all is available to read and write. Tried to do it the other way around and chose to import the playlist from within Apple Music but I get the same error, now saying the file is not a valid 'export file' instead of not being a valid 'file'. Then tried to import the xml file, I red about that option in a different sub here saying it would generate all data except from 'date added' but when I do that I only get the music purchased from Apple while my imported CD's (big majority) remain excluded. All help is appreciated here...


MacBook Pro 15″, macOS 11.4

Posted on Jan 22, 2025 5:52 AM

Reply
22 replies

Jan 22, 2025 7:51 AM in response to cdnathan

Hi,


It was all straightforward when iTunes was updated in parallel for Mac and Windows at the same time, and the library was cross platform compatible. The Mojave version of iTunes broke that somewhat as it became an OS component that Apple updated when they felt like it. With Music in Catalina it became more complicated as, as far as I can tell, Music only considers iTunes libraries created by Mojave as valid. Older .itl files don't work. There is a separate issue with Monterey where it just stalls when attempting to convert what would otherwise be valid .itl libraries.


If you'd like to send me your .itl file (email in profile) I can try converting it to a .musiclibrary package, but success may depend on which version of iTunes for Window the library was created by. When using the XML export/import route the import phase only works if you've edited the XML file such that it correctly uses the paths that you've copied the files to on the new computer. Failing this all you see is your purchase history, assuming that you are signed into your Apple Account.


The other approach you could use is to take out a temporary subscription to Apple Music, which would let you clone the library from one machine to the other. After you download all content in the cloud you could turn off Sync Library in both computers and then cancel the subscription renewal, assuming you no longer want it.


tt2

Jan 22, 2025 12:41 PM in response to cdnathan

Another issue moving between Mac and Windows is that Windows really only like NTFS, which Mac can read but not natively write. Both platforms can read and write exFAT, although Windows cannot create that format, and Macs prefer HFS+/APFS. The workaround here is to copy data over a network where the source and destination file systems don't have to match, and each computer can work with the disk format it prefers.


What build of iTunes is installed? See Help > About iTunes if you're not sure. I can run a test at my end to see if Mojave iTunes can read a library created by that version, and if that will then open in Music. I'm using Catalina, but Big Sur can also be persuaded to install iTunes at a push. (Search Retroactive iTunes for details). It that were to work you might be able to miss out a conversion step and stay in a familiar environment.


The main change when moving an XML between Windows and Mac is to flip any \ to / and replace the path to the media folder in Windows (something perhaps like X:\iTunes\iTunes Media) to its equivalent on the Mac (e.g. <VolumeName>/iTunes/iTunes Media) not forgetting that any spaces in the path need to be represented as %20. Typically it requires one or two global search and replace operations in a suitable text editor. Macs and Windows may also use different end of line markers (LF vs CRLF) which may or may not have an impact depending on which direction you are porting the XML.


tt2

Jan 24, 2025 5:02 AM in response to cdnathan

iTunes only backs up the .itl file in the Previous iTunes Libraries folder when there is a change to the database structure that makes the new library incompatible with the previous build of iTunes. .itl files are forwards compatible (ignoring Music's inability to open anything prior to Mojave) so the current version of iTunes should open any older library. An older version of iTunes for Windows likely won't read your current .itl file, but you might be able to bring an older version of your library up to date with the current content of your media folder. You would lose recent edits to playlists, play counts, etc. however. There isn't a way to trick iTunes into making a current library compatible with an older build. The only option there is to go via XML export, edit, and import, which loses Date Added details. If you'd like to share the full path to a specific track in both Windows and Mac I could suggest the edit you need to make, or potentially create the file from the .itl you've already shared with me.


tt2

Jan 25, 2025 4:30 AM in response to cdnathan

I suspect a previous attempt to import an XML version of your library explains why the playlists are there. Smart playlists should populate as they are based on rules. Regular playlists only repopulate if the tracks are at the locations indicated in the XML file, which they will only be if it has been edited correctly before import.


Most music formats support metadata, with the obvious exception of files in .wav format. Artwork isn't always embedded, but transferring tracks between libraries will be more successful when it is. I have some Windows scripts that ensure all art is embedded if you are interested. The scripts have slightly different functions:


CreateFolderArt ensures that every album folder ends up with a Folder.jpg image which is the art that iTunes already knows about. Side effects are that if artwork has been updated in iTunes the folder art should be updated also, and if any track from the album doesn't have embedded artwork it gets embedded.


EmbedFolderArt was actually written for someone who already had various artwork images stored in the album folders and wanted them added to their tracks, but not if iTunes had already downloaded a better quality image. It creates new files of any store art with the name iTunesArt.jpg, then embeds the largest image by area in the album's folder, based on the premise that this is likely to be the best image.


In either case you could search and destroy the images in the folders after they are embedded if you don't want them.


Date added, rating, plays, skips, and (regular) playlist membership are among the details that are not included in the tag. These values are only stored in the library database. All apart from date added can be restored if you rebuild the library by importing an XML file rather than importing the files into an otherwise empty library.


While Monterey has issues converting .itl files it should have no problem with a .musiclibrary database created in Big Sur.




I do have a working copy of your library (sans media files) in Sequoia, so I can export an XML file from that that should need only minor editing. If I look at the location record for the first track in the library I get the following:


<key>Location</key><string>file:///Volumes/Data%20Drive/Steve/Desktop/Music/Media.localized/Music/2%20Fabiola/Magic%20Flight/02%20Magic%20Flight%20(Don%20Joan%20Avantura%20M.m4a</string>


The text in bold is what would need to be changed to match the actual location you're intending to use for this file. All the %20s are spaces. What is the path to this track on your Mac?


tt2

Jan 26, 2025 6:34 AM in response to cdnathan

Hi.


1 & 2 aren't going to work because you're still trying to access a newer library in an incompatible older system. My Catalina Music won't read your .itl. The main point of using the network to transfer data from one system to another is when you have a disk format that isn't cross platform compatible.


3 won't be an issue for whatever Music library you have at the time.


I suspect 4 won't work because Monterey is three years old and anyway it hates .itl files.


Which leaves us with 5. I'm not at home right now, but I'll try editing the XML later and post it to you when I'm done so you can try it out.


tt2

Jan 28, 2025 5:03 AM in response to cdnathan

Hi,


I've just sent you an edited XML derived from your original .itl file which I hope you will be able to import correctly on your Mac.


Apple have a solution for syncing libraries across multiple computers and platforms already. It is the Apple Music subscription service, available for a fee. TANSTAAFL.


There is an Apple Music for Windows client, but it is not very good, and has no features for importing or switching libraries, ripping CDs, printing, scripting support, and installing it to try it out cripples the local iTunes installation. Avoid at all costs.


tt2

Jan 29, 2025 1:01 AM in response to turingtest2

Wouldn't call Apple's way to take care of the matter a solution but an alternative. Paying for a sync service that does nothing else but syncing - preferably in one direction only - would not be an issue for me. But since they unnecessarily seem to interfear in data and even replace ripped CD's it scares me to try.


Meanwhile the xml procedure is finished, but only loaded about 75% of the songs and no playlists at all. Images however did appear. I expected a full succes or a full failure, don't really get what happened. But it was worth trying of course so thank you for the edit.


Now I wanted to get back to the other library but that one doesn't load the music anymore. Perhaps because I pointed to the same media in the xml attempt which might have messed things up.


So it seems like the two option left are firstly getting over my fear and subscribe to Apple Music. But at least I hope nothing would be changed in the source library (Windows), if necessary I'd end / disable the subscription right after the transfer (when possible).

The other solution is the way as described on January 24th, which gave me all music and playlists. Ordinary playlists were empty but the smart playlists based on other smart playlists did work. Not perfect but for my needs this result is good enough as a functional copy to use for Serato.


Nathan



Jan 29, 2025 2:04 AM in response to cdnathan

I neglected to mention iTunes Match, which is cheaper than Apple Music, and limited to your own content rather than giving you access to an additional catalog that you can play on demand and add at will, however both services are limited to 100,000 tracks (excluding iTunes Store purchases) which I suspect makes them unsuitable for you.


I too was hoping for more from the XML edit. I did it using the Music library that Sequoia had generated. I should perhaps try again starting with the original Windows version of the library in case details were lost in translation somewhere.


tt2

Jan 23, 2025 4:39 AM in response to cdnathan

Hi. I got your library which unfortunately won't open in Mojave iTunes (12.9.5.5) or Catalina Music (1.0.6.10). It will open in my Sequoia version of Music, so in principle there is cross platform compatibility as long as you are running the current builds everywhere.


If it worked until recently can you identify when? You could potentially revert to the last version of iTunes where this process still worked for you. If you look inside the Previous iTunes Libraries folder inside your iTunes folder you should see a number of dated .itl files that are associated with each change to the .itl. I have links to various installers for iTunes listed at the bottom of Troubleshooting issues with iTunes for Windows updates - Apple Community. To use an older version you have to uninstall the copy you have now, replace the current library with a relevant copy of one from the Previous iTunes Libraries folder, removing the date from the filename, then install the version that you want to use.


Going back to Apple Music as a possible way to run the same library concurrently on Windows and Mac, the issue you are worried about is that sometimes Apple Music (or iTunes Match) can mismatch your songs in its database. A classic problem is an explicit version of a track being matched with a clean copy. This can be counteracted by physically replacing any mismatches with your originals from the source library. That does mean that you would need to review matched tracks on the Mac after transfer, but I don't think the issue is as common as it used to be. As long as you have all the source content maintained on at least one computer and backed up it shouldn't really be a cause for concern.


tt2

Jan 25, 2025 3:49 AM in response to cdnathan

...almost 24 hours later the process of loading the music is still going but the result is already better than expected at forehand.

  • All playlists - even the ones created very recently - show up. However without there content
  • Most important: All smart playlists are there, and they actually work!
  • Images seem to load as well, although only in the small thumbnails while playing the loaded song. I might get them at the end of this process (which can take a few more days).


Meanwhile I get the proposition to upgrade to Monterey, but since you stated 'There is a separate issue with Monterey where it just stalls when attempting to convert what would otherwise be valid .itl libraries' I strongly doubt that's a good idea (can't do it during this process anyway).


I really really don't understand how it's possible that all recently created playlists in the Windows version pop up, smart ones even working. While we know all attempts to import recent .itl and .xml failed.


In any case I think we now have a rather easy guideline to get the best possible result without taking the risk of messing up the content by giving it into the hands of an Apple Music subscription. Other possible solutions you mentionned I haven't tried yet are importing the .itl through a network / You converting the .itl on your machine / Making the .xml work by changing it's paths

Jan 30, 2025 1:02 PM in response to cdnathan

So I did this:


  • 1) Emptied the external LaCie and copied the Windows 'iTunes Media' folder in there (fresh start)
  • 2) Created an empty folder 'Apple Music Library' in the external Lacie
  • 3) Created an empty folder 'Music' in the external LaCie
  • 4) Sent the Windows xml to turingtest2 for a customized edit (as described earlier in this thread)
  • 5) Copied the edited xml into the empty folder 'Music' on the external LaCie
  • 6) Created a new library itl in the Mac
  • 7) In that library through preferences I pointed the location for the media files to the external LaCie 'Apple Music Library' folder
  • 8) In that library I chose 'Files' - 'Library' - 'Import library' and pointed to the xml in the folder 'Music' on the external LaCie


Unfortunately that went wrong within a minute. The library only imported the playlists and didn't even start working with the media files. That's a déjà vu...


Can't think of any other option than reaching back to the attempt of January 24th where a rather satisfying result came out 30 hours later. Only this time I have an xml customized to the Mac instead of just a Windows copy. So let's find out if we can do better than last week.


I renamed 'iTunes Media' (with all the music files) into 'Apple Music Media' (ditched the existing empty one) and did all as above, starting from step 6. At least now a larger import is happening. Be patient with me now for another 30 hours.


Nathan







Jan 22, 2025 12:19 PM in response to turingtest2

Hi,


Thanks for your answer and clear explanation about the history of this error, obviously an accident just waiting to happen...


On Windows I'm no longer having the default path C:\Users\<username>\ etc. since my library became too big and I had to move it all to an external drive. Therefore the current path on that source is now as short as it possibly can, unlike the external drive with the copy on the Mac it does oc has a drive letter.

After importing the .xml on the mac (with disappointing result) that file itself seems to remain in the external drive. I actually have no idea how to start editing anything in order to make the import work as complete as possible?


The other approach... not sure if that's an option at all with a library that's over 1TB (currently over 102k songs). My biggest scare here is that Apple would bring back the original data in all purchased iTunes songs, a few thousands that are now all edited to my own preferences. The majority of the tracks is imported from CD in 256 aac, and a bunch of very old fashionned mp3's. I'm fine with taking risk creating copy's as long as the original Windows version remains safe :-) That concern is also the main reason why I do these manual copies for years now. Apart from that constantly cloning from the Windows device to the Mac (and iPhone) would suit me very fine!


Thank you for your offer to try to convert the itl.file, which sounds really tempting and surely easy for me but it wouldn't be a solution in the long run since I'm used to update those copies at least once a year. The creation date of that specific itl.file gets updated all the time in properties, so can't tell the date that counts. I'm running iTunes since 17 years now, however about a year ago I needed to restore a Backblaze back-up of the .itl file.


Nathan

Jan 22, 2025 11:26 PM in response to turingtest2

Meanwhile I did some research about the Apple Music subscription, it seems they would mess up and/or ignore all my CD and file imports in the library. I hate Apple for it's attempts to interfear in customer's libraries, although I will probably always remain an iTunes fan in it's oldfashionned way.


The Mac did read the previous .itl files in the past. I bought it second handed in 2019 so it worked smoothly for 5 years till now. But since my library became bigger over those years I had to exchange an old powered external LaCie with a LaCie rugged. To plug that new one into the Mac I needed a USB adapter, which might influence the whole process also (not an expert in all that). Anyway, I did a test by making a copy of the .itl to the old external drive (without any media in that location), but that resulted into the same issue now...


I fully understand your explanation about the XML transmission but I'd need an expert here to make that happen. I can hardly work with that Mac, I only use it for iTunes and Serato. So far I managed everything by googling every step I wanted to take. For some reason yesterday the LaCie rugged didn't show up anymore (too much attempts to import those files?) so I had to dig deep - and learned a lot - to get it back. So I hope I won't be needing the XML solution. Currently I don't have a folder inbetween both LaCie's and the iTunes content, so the path is very short on the Windows side.


The iTunes version here is 12.13.4.4 (most recent update available). But I'm gonna send you the .itl file which is rather big (65MB) and may take over an hour to read in Apple Music, in case it turns out to be a valid file in your test. Thank you for your help, hoping all this is learnful for you as well.


Nathan

Jan 23, 2025 1:54 PM in response to cdnathan

I remember those 'previous library files' but my iTunes version doesn't seem to create them anymore. Which is one of the reasons I invested in continuous cloud back-up for my peace of mind. That allows to restores .itl files very precisely, I tested that once and it does work.

Re-creating an outdated version wouldn't really help me here. In fact, I still have an outdated music library file (april 2022) in the music folder of the mac. Which I just opened and all works as fine as possible for an outdated version.

Now I wonder what would happen if I installed a 2022 iTunes version on Windows and connect that with my current .itl file. Would that .itl file a) work and b) somehow adjust to that older version? And therefore be compatible with the Mac?


No longer possible to convert .itl library files on my Big Sur Mac

Welcome to Apple Support Community
A forum where Apple customers help each other with their products. Get started with your Apple Account.