Revision as of 22:09, 16 September 2014

General Information

Apple iTunes is primarily a program to play different types of media, but it is also required if you want to backup an IPod/IPad/IPhone or sync your emails, notes, bookmarks etc over USB with your PC. ITunes comes bundled with multiple sub programs that are all automatically installed when running the regular ITunes setup wizard. However depending on your use case you don't actually need all of them. Therefore this page is divided into two subparts: On the one hand a full blown ITunes installation (excluding Apple Software Update) when you actually want to use ITunes as an audio and video player, podcast streamer, etc and on the other hand a minimal ITunes installation if you only want to use it to sync/backup mobile devices.

ITunes is one of the programs that are more difficult to package, since Apple is using it as a vehicle to distribute their other software. To get rid of at least some of those "extra" programs additional configuration steps are necessary to perform. Please read the instructions carefully, because some things here dont work as you would assume. Don't blindly copy and paste the XML code.

Pre-Setup Process

The ITunes installer consists of multiple MSI packages for each of its sub programs and a runtime that executes those MSI packages one after the other. To extract the MSI files do the following:

• Download the ITunes setup file from Apple (usually called iTunesSetup.exe)
• Open the file with 7zip or another file archiver
• Extract iTunes.msi, AppleApplicationSupport.msi and AppleMobileDeviceSupport.msi

Notes

• Starting with ITunes version 10.5, Quicktime is not part of the setup package anymore and also not necessary any longer to run ITunes. The installation instructions were therefore removed from this page.
• Apple Mobile Device Support is only necessary if you want to connect an IPod, IPad or IPhone. Apple Application Support is mandatory to be able to run ITunes.
• Each sub-application has its own version. When a new version for ITunes comes out, you will need to extract the MSI packages from the EXE installer, right click on the MSI files and check their version to see which sub-applications have updated. Each sub-applications has its own WPKG package definition with separate install, upgrade and uninstall commands.
• To also get the latest available version of Apple Application Support you'll have to download every installer from the Apple website and check which one contains the latest version of the Apple Application Support.
• Apple sometimes updates the MSI packages inside the EXE installer without changing the version number on the website. So do not take it for granted that there are no new packages available just because the version number on the website is still the same.
• Apple is also known to sometimes modify the setup packages of their programs even at minor version changes, so do not blindly assume that a new ITunes installer will work the same way as the old one did!
• There is a 64bit version of ITunes available too. As of version 11 the 64bit installer contains 64bit versions of ITunes itself and Apple Mobile Device Support and 32bit versions of Apple Application Support. The package definitions for the 64bit versions look basically the same as below, just the paths and GUIDs are different.
• Apple usually changes the GUIDs for every new release. This means that you need to perform a test install and check the GUIDs every time you deploy a new version unless you're willing to require that the original MSI be present to perform an uninstallation. One could potentially also write a script to check HKLM\SOFTWARE\Microsoft\Windows\CurrentVersion\Installer\UserData\S-1-5-18\Products and find the correct uninstall string for whatever version of each package is currently installed.

Full iTunes 10.4.0.80 installation in VBS

' Directory folder %Software\iTunes, the script requires that the *.vbs file is located the same place as all *.msi files. If you have SCCM, you can distribute this script as a package.

Set WshShell = WScript.CreateObject("WScript.Shell") 
Set objFSO = CreateObject("Scripting.FileSystemObject") 
strScriptFileDirectory = objFSO.GetParentFolderName(wscript.ScriptFullName) 

' Create Transform for iTunes with orca or another msi editor, to make iTunes more "admin" friendly for distribution in company networks. A "how to" is described under the item iTunes.

WshShell.Run "msiexec /I AppleApplicationSupport.msi /q /norestart", 0, true
WshShell.Run "msiexec /I Bonjour.msi /q /norestart", 0, true
WshShell.Run "msiexec /I AppleMobileDeviceSupport.msi /q /norestart", 0, true
WshShell.Run "msiexec /I itunes.msi TRANSFORMS=itunes.mst /q /norestart", 0, true
WshShell.Run "msiexec /I quicktime.msi DESKTOP_SHORTCUTS=0 SCHEDULE_ASUW=0 REENABLEAUTORUN=0 /q /norestart", 0, true

' set parental controls, that disables "Run first welcome window", "Cannot change parental controls" and "No autoupdate"

Dim wshShell

Set wshShell = CreateObject( "WScript.Shell" )
wshShell.RegWrite "HKEY_LOCAL_MACHINE\SOFTWARE\Apple Computer, Inc.\iTunes\Parental Controls\Default\AdminFlags", 16777473, "REG_DWORD"

'Copy this to notepad++ or anoter editor, save as *.vbs :-)

Full ITunes installation 11

If you update this code, please remember the uninstall GUIDs change on each new version installed!

Deploy File/Folder Structure

 %SOFTWARE%\itunes\iTunes.msi
 %SOFTWARE%\itunes\iTunes64.msi
 %SOFTWARE%\itunes\AppleMobileDeviceSupport.msi
 %SOFTWARE%\itunes\AppleApplicationSupport.msi
 %SOFTWARE%\itunes\AppleApplicationSupport64.msi

<?xml version="1.0" encoding="UTF-8"?>
<package id='appleapplicationsupport' name='Apple Application Support' revision='%PKGVER%' reboot='false' priority='10'>
	<variable name='PKGVER' value='3.0.6' />
 
	<check type='uninstall' condition='versiongreaterorequal' path='Apple Application Support' value='%PKGVER%'/>
 
	<install cmd='msiexec /i "%SOFTWARE%\itunes\AppleApplicationSupport.msi" /passive /norestart' timeout='300'>
		<exit code='0' />
		<exit code='3010' reboot='postponed' />
	</install>
 
	<upgrade include='install' />
 
	<remove cmd='msiexec /x{78002155-f025-4070-85b3-7c0453561701} /passive /norestart' timeout='300'>
		<exit code='0' />
		<exit code='1605' />
		<exit code='3010' reboot='postponed' />
	</remove>
</package>
 
<package id='applemobilesupport' name='Apple Mobile Device Support' revision='%PKGVER%' reboot='false' priority='10'>
	<variable name='PKGVER' value='8.0.0.23' />
        <variable name="PKG_SOURCE" value='%SOFTWARE%\itunes\AppleMobileDeviceSupport.msi' architecture="x86" /> 
        <variable name="PKG_SOURCE" value='%SOFTWARE%\itunes\AppleMobileDeviceSupport64.msi' architecture="x64" /> 
	<variable name="PRODUCT_ID" value='{c0cc75cd-f5b7-46ad-b016-17c0f5171718}' architecture="x86" /> 
	<variable name="PRODUCT_ID" value='{b678797f-df38-4556-8a31-8b818e261868}' architecture="x64" /> 

	<check type='uninstall' condition='versiongreaterorequal' path='Apple Mobile Device Support' value='%PKGVER%' />
 
	<install cmd='msiexec /i "%PKG_SOURCE%" /passive /norestart' timeout='300'>
		<exit code='0' />
		<exit code='3010' reboot='postponed' />
	</install>
 
	<upgrade include='install' />
 
	<remove cmd='msiexec /x%PRODUCT_ID% /passive /norestart' timeout='300'>		
		<exit code='0' />
		<exit code='1605' />
		<exit code='3010' reboot='postponed' />
	</remove>
</package>
 
<package id='itunes' name='Apple iTunes' revision='%PKGVER%' reboot='false' priority='9'>
	<depends package-id='appleapplicationsupport' />
        <depends package-id='applemobilesupport' />

	<variable name='PKGVER' value='11.4.0.18' />
        <variable name="PKG_SOURCE" value='%SOFTWARE%\itunes\iTunes.msi' architecture="x86" /> 
        <variable name="PKG_SOURCE" value='%SOFTWARE%\itunes\iTunes64.msi' architecture="x64" /> 
 	<variable name="PRODUCT_ID" value='{f32dc846-4457-40a8-beca-bcc0e960bc53}' architecture="x86" /> 
	<variable name="PRODUCT_ID" value='{f46aa0f1-e284-4878-a462-5f11b9166c0e}' architecture="x64" /> 

	<check type='uninstall' condition='versiongreaterorequal' path='iTunes' value='%PKGVER%' />
	<!-- Check if automatic updates have been disabled (value: 256) and settings have been locked (value: 1) -->
	<check type='registry' condition='equals' path='HKLM\SOFTWARE\Apple Computer, Inc.\iTunes\Parental Controls\Default\AdminFlags' value='257' />
 
	<install cmd='msiexec.exe /i "%PKG_SOURCE%" SCHEDULE_ASUW=0 /passive' timeout='300'>
		<exit code='0' />
		<exit code='3010' reboot='postponed' />
	</install>
	<!-- Disable automatic update of ITunes via parental controls and lock the settings, see below for more info -->
	<install cmd='reg add "HKLM\SOFTWARE\Apple Computer, Inc.\iTunes\Parental Controls\Default" /v "AdminFlags" /t REG_DWORD /d "0x101" /f' timeout='60' />
 
	<upgrade include='install' />
 
	<remove cmd='msiexec.exe /x%PRODUCT_ID% /passive /norestart' timeout='300'>
		<exit code='0' />
		<exit code='1605' />
		<exit code='3010' reboot='postponed' />
	</remove>
</package>

Minimal ITunes installation 11

The goal of this setup is to get a working installation of ITunes which allows you to activate, backup and sync an IPod, IPad or IPhone, install new iOS versions and optionally get songs/apps from the Apple Store, but does otherwise interfere with the PC as little as possible. Specifically this means: No automatic update checks, no desktop shortcuts, no automatic file type associations with ITunes, no ITunes CD grabbing, no unecessary background services or autostart entries, no traybar icons, no Windows firewall modifications. These package definitions are suited for someone who has to roll out ITunes in a corporate environment because the employees are using IPhones/IPads, but otherwise has no use case for ITunes at all. Of course all steps in this section are optional, if you don't want to leave a certain feature out, then simply omit the corresponding step.

Configuration

Not all necessary changes to the setup packages can be made at the command line level, therefore the MSI files have to be modified. For this the Microsoft tool Orca (freeware) is necessary. If you don't have Orca yet, download it from Microsoft.

Apple Application Support

• Open AppleApplicationSupport.msi, select New Transform from the main menu.
• Drop the component APSDaemon.exe from the table FeatureComponents. This prevents the wireless sync daemon from being installed and added to the Windows autostart.
• Drop the action WixSchedFirewallExceptionsInstall from the table InstallExecuteSequence. This prevents WebKit.dll being added as an internetwide exception to the Windows Firewall.
• Click Generate Transform and save the resulting file into the same folder as the MSI.

Apple Mobile Device Support

• Open AppleMobileDeviceSupport.msi, select New Transform from the main menu.
• Drop the Component OutlookChangeNotifierAddIn.dll from the table FeatureComponents. This removes the Outlook change notifier, which detects changes to contacts and calendards within Outlook. You don't need this if you sync the iPhone over the air via Activesync.
• Click Generate Transform and save the resulting file into the same folder as the MSI.

ITunes

• Open iTunes.msi, select New Transform from the main menu.
• Drop the component itms.js from the table Component. This file is responsible for registering ITunes as a trusted application in Firefox.
• Drop iTunesOutlookAddIn.dll from FeatureComponents, so that the Outlook plugin does not get installed.
• Drop the actions Launch_iTunesHelper and WixSchedFirewallExceptionsInstall from the table InstallExecuteSequence. This prevents iTunesHelper.exe from being started after the setup finishes and ITunes.exe from being added as an internetwide exception to the Windows Firewall. ITunes Helper is responsible for automatically starting ITunes when an iPhone or iPod is being connected to the PC.
• Open the table Registry and drop the keys Registry415 (adds iTunesHelper.exe to the Windows autorun) and Registry835 to Registry843 (adds the ITunes detector plugin to Firefox and other browsers). Of course the registry IDs may change in future ITunes versions, you can instead search for CurrentVersion\Run and MozillaPlugins in the column Key of the Registry table.
• Drop the file ITDetector.ocx from the table SelfReg. This prevents the ITunes detector ActiveX component from being registered, which is otherwise added as a plugin to Internet Explorer.
• Click Generate Transform and save the resulting file into the same folder as the MSI.

You can disable certain ITunes features via the registry. Apple has a list of almost everything that you can disable: How to manage iTunes control features. In the XML code below, only the update check in ITunes is disabled. If you want to disable other features too, look up their hexadecimal numbers at the above link, add them up and write the result as a DWORD value to HKLM\SOFTWARE\Apple Computer, Inc.\iTunes\Parental Controls\Default\AdminFlags. Be aware that you always need to include the "Locked" flag (1) for the settings to take effect. Also don't forget to change the <check> statement, if you modify the value in the registry. Be aware that disabling automatic updates in ITunes also stops the user from being able to download updates for Appstore apps in ITunes. Also ITunes does not recognize IPhones in DFU mode anymore. If the registry key for parental controls already exists in the HKCU hive, the ITunes seems to ignore the HKLM entries.

After ITunes is removed, it does not delete the files in %APPDATA%\Apple Computer\iTunes, %USERPROFILE%\Local Settings\Application Data\Apple Computer\iTunes and %ALLUSERSPROFILE%\Anwendungsdaten\Apple Computer\iTunes. If you want to remove those directories, you have to specify additional remove commands for WPKG. The same is true for the registry key HKCU\Software\Apple Computer, Inc.\iTunes. The backups of IPhones, songs and applications from the Apple Store are stored outside of those directores!

Package definitions

Apple Application Support

<?xml version="1.0" encoding="UTF-8"?>
<package id='appleapplicationsupport' name='Apple Application Support' revision='%PKGVER%' reboot='false' priority='10'>
	<variable name='PKGVER' value='2.3.6' />
 
	<check type='uninstall' condition='versiongreaterorequal' path='Apple Application Support' value='%PKGVER%'/>
 
	<install cmd='msiexec /i "%SOFTWARE%\itunes\AppleApplicationSupport.msi" TRANSFORMS="%TEMP%\software\application-transform-from-above.mst" /passive /norestart' timeout='300'>
		<exit code='0' />
		<exit code='3010' reboot='postponed' />
	</install>
 
	<upgrade include='install' />
 
	<remove cmd='msiexec /x{78002155-f025-4070-85b3-7c0453561701} /passive /norestart' timeout='300'>
		<exit code='0' />
		<exit code='1605' />
		<exit code='3010' reboot='postponed' />
	</remove>
</package>

Apple Mobile Device Support

<?xml version="1.0" encoding="UTF-8"?>
<package id='applemobilesupport' name='Apple Mobile Device Support' revision='%PKGVER%' reboot='false' priority='10'>
	<variable name='PKGVER' value='7.0.0.117' />
        <variable name="PKG_SOURCE" value='%SOFTWARE%\itunes\AppleMobileDeviceSupport.msi' architecture="x86" /> 
        <variable name="PKG_SOURCE" value='%SOFTWARE%\itunes\AppleMobileDeviceSupport64.msi' architecture="x64" /> 
        <variable name="PRODUCT_ID" value='{c0cc75cd-f5b7-46ad-b016-17c0f5171718}' architecture="x86" />
        <variable name="PRODUCT_ID" value='{b678797f-df38-4556-8a31-8b818e261868}' architecture="x64" />

 
	<check type='uninstall' condition='versiongreaterorequal' path='Apple Mobile Device Support' value='%PKGVER%' />
 
	<install cmd='msiexec /i "%SOFTWARE%\itunes\AppleMobileDeviceSupport.msi" TRANSFORMS="%TEMP%\software\mobiledevice-transform-from-above.mst" /passive /norestart' timeout='300'>
		<exit code='0' />
		<exit code='3010' reboot='postponed' />
	</install>
 
	<upgrade include='install' />
 
	<remove cmd='msiexec /x%PRODUCT_ID% /passive /norestart' timeout='300'>		
		<exit code='0' />
		<exit code='1605' />
		<exit code='3010' reboot='postponed' />
	</remove>
</package>

ITunes

<?xml version="1.0" encoding="UTF-8"?>
<package id='itunes' name='Apple iTunes' revision='%PKGVER%' reboot='false' priority='1'>
	<depends package-id='appleapplicationsupport' />
	<depends package-id='applemobilesupport' />
 
	<variable name='PKGVER' value='11.1.0.126' />
	<variable name="PKG_SOURCE" value='%SOFTWARE%\itunes\iTunes.msi' architecture="x86" /> 
	<variable name="PKG_SOURCE" value='%SOFTWARE%\itunes\iTunes64.msi' architecture="x64" /> 
        <variable name="PRODUCT_ID" value='{f32dc846-4457-40a8-beca-bcc0e960bc53}' architecture="x86" />
        <variable name="PRODUCT_ID" value='{f46aa0f1-e284-4878-a462-5f11b9166c0e}' architecture="x64" />

 
	<check type='uninstall' condition='versiongreaterorequal' path='iTunes' value='%PKGVER%' />
	<check type='registry' condition='equals' path='HKLM\SOFTWARE\Apple Computer, Inc.\iTunes\Parental Controls\Default\AdminFlags' value='257' />
 
	<!-- DESKTOP_SHORTCUTS=0: Don't create desktop shortcuts
	MEDIA_DEFAULTS=0: Don't make ITunes the default program for Audio CDs and various audio filetypes
	SCHEDULE_ASUW=0: Don't create a scheduled task to automatically search for ITunes updates
	REENABLEAUTORUN=0: Don't try to re-enable Windows autorun feature for CDs -->
	<install cmd='msiexec.exe /i "%SOFTWARE%\itunes\iTunes.msi" TRANSFORMS="%SOFTWARE%\itunes\itunes-transform-from-above.mst" DESKTOP_SHORTCUTS=0 MEDIA_DEFAULTS=0 SCHEDULE_ASUW=0 REENABLEAUTORUN=0 /passive /norestart' timeout='300'>
		<exit code='0' />
		<exit code='3010' reboot='postponed' />
	</install>
	<!-- Disable update feature in ITunes via parental controls -->
	<install cmd='reg add "HKLM\SOFTWARE\Apple Computer, Inc.\iTunes\Parental Controls\Default" /v "AdminFlags" /t REG_DWORD /d "0x101" /f' timeout='60' />
	<!-- Don't automatically load ITunes-Calendar-Addin for Outlook -->
	<install cmd='reg add "HKCU\Software\Microsoft\Office\Outlook\Addins\iTunesAddIn.CalendarHelper" /v "LoadBehavior" /t REG_DWORD /d "0x0" /f' timeout='60' />
 
	<upgrade include='install' />
 
	<remove cmd='msiexec.exe /x%PRODUCT_ID% /passive /norestart' timeout='300'>
		<exit code='0' />
		<exit code='1605' />
		<exit code='3010' reboot='postponed' />
	</remove>
</package>

Removing iTunes without GUIDs

To avoid having to check the GUIDs every time you update this package, you can change the removal process to refer to the original MSIs. If you do this and later decide to remove iTunes from your site, you have to keep the installers in %SOFTWARE% until every computer has removed iTunes.

To do this, replace the remove stanzas with the following:

Apple Application Support

	<remove cmd='msiexec /x %SOFTWARE%\itunes\AppleApplicationSupport.msi /passive /norestart' timeout='300'>
                <!-- <exit code='any' /> --> <!-- uncomment to just rely on the check conditions -->
		<exit code='0' />
		<exit code='1605' />
		<exit code='3010' reboot='postponed' />
	</remove>

Apple Mobile Device Support

        <remove cmd='msiexec /x "%PKG_SOURCE%" /passive /norestart' timeout='300'>    
                <!-- <exit code='any' /> --> <!-- uncomment to just rely on the check conditions -->
		<exit code='0' />
		<exit code='1605' />
		<exit code='3010' reboot='postponed' />
        </remove>

iTunes

        <remove cmd='msiexec.exe /x "%PKG_SOURCE%" /passive /norestart' timeout='300'>
                <!-- <exit code='any' /> --> <!-- uncomment to just rely on the check conditions -->
                <exit code='0' />
                <exit code='1605' />
                <!-- <exit code='3010' reboot='postponed' /> -->
        </remove>