From Winamp iPod plugin ml_iPod
Jump to: navigation, search

Note: Device specific settings of ml_ipod are stored on the iPod itself (in \iPod_Control\iTunes\), so your settings will stay the same from computer to computer.

To access ml_iPod's preferences, simply right click on the iPod in the Devices section of the Media Library and click "iPod configuration..." or open Winamp's preferences (hotkey: CTRL P) and navigate to iPod Support. There is also a Config button on the ml_iPod interface which will open the preferences.

If serveral iPods are connected, select which iPod you want to configure from the pull down menu on the upper-right of the first screen [iPod Support].

The following is an explanation of ml_iPod's different preferences:


iPod Support

Home Tab

IPodSupport HomeTab .gif
Restore/Innitialize Menu

Having a Problem with your iPod?

In this tab, the first item deals with problems with the iPod Databases. Various option are available to Restore the databases (with of without a backup) or to initialize the database. The process of backing up the iPods database will be covered in 'iPod Tools' section.

Media Library View

The options here are:

  1/ Allow filtering tracks by Artist and/or album
  2/ Show all tracks in a single large list

Multiple user support

This item designates the access level for the selected iPod. It allows you to protect your iPod against unwanted changes on other computers. The options are:

 1/ Unrestricted [Grants write access to everyone]
 2/ Limited [Grants write access only to designated users]

To protect your iPod, select "limited" and check the box near "Grant the current user write access to this iPod". Now the iPod behaves as usual with your account on this PC, but other users or other PCs can open it in read-only mode only.

Caution: This protection does only work if all PCs are running ml_iPod 3.00 or later. It does not protect against changes made with older ml_iPod versions or with iTunes (or any other iPod management software).


 1/ Automatically perform a full sync on this iPod when connected
 2/ Automatically eject all iPods when Winamp is closed
 3/ Automatically select newly-connected iPods in the Media Library

Features Tab

Ml iPod FeaturesTab.png

Enable or disable iPod features

  • Enable live updating of smart playlists on the iPod
  • Enable podcast support for this iPod
  • Enable Cover art support for this iPod
  • Enable video support for this iPod
  • Enable the sorting of playlists alphabetically on this iPod

Note: These settings apply only to the iPod that is selected!

Sync Tab

Ml iPod SyncTab.gif

The Sync Tab is where the fun starts. This is where we begin to define the parameters to use during a sync when the sync is to be preformed.

Automatic Syncing:

  • Sync ratings, play counts, and last played times on connect: Every time an iPod is connected, the iPod and Media Library will be synced so all ratings, play counts, and last played times match.
  • Sync ratings, play counts, and last played times on disconnect: This setting does the same as the above setting when the iPod is ejected through Winamp.
  • Automatically preform a full sync on this iPod when connected

How to sync this iPod:

  • Sync query: This box lets you determine certain paramaters of the songs to be synced. The syntax is dealt with in another section.
  • Sync Media Library playlists: All is default but specific lists can be selected - see below
  • Sync Media Library smart views: All is default but specific views can be selected - see below
  • Sync only tracks that are in one or more of the selected playlists/smart views [bypasses the sync query]:
  • Sync ratings, play counts, and last played times:
  • Delete any existing tracks that would not otherwise be synced:
  • Resync tracks whose file modification time has changed: This is extremely useful when you are modifying the file, as in changing ID3 tags or using mp3gain and Replay Gain

Now we have our last two buttons on the tab:

  • Chose playlists to sync: Select which playlists are synced if the above option is checked.
  • Chose smart views to sync: Select which smart views are synced if the above option is checked.

A full explanation of playlists and smart views can be found in the Playlists section.

Autofill Tab

IPodSupport AutofillTab.gif

The Autofill feature is especially useful for iPods, such as the shuffle, where space is limited. Using defined parameters, the iPod is automatically loaded with content.


The Criteria Tab is used to define the parameters of the content to be included in the Autofill.

  • Source: You can select the entire media library or any of your playlists.
  • Query: You can setup which criteria are to be used when selection the content. Pressing the Edit button, will present you with additional criteria specifications. A full listing can be found in the section dealing with the Query.
  • CheckBox: Selecting this box combines this query with the sync query on the Sync Tab.
  • Space to fill: This slider determines the storage capacity that you wish to fill.

Distribute track ratings proportionally when autofilling this iPod

This is a very powerful and useful feature.

  • Choose ratings proportions button, permits you to select what percentage of each rating category should be included in the content transfered. The illustration should explain it best.

  • Choose sorting method button, enables you to select the sorting order, i.e. by playlist, by last played time, etc. One can also sort by Smart Shuffle, a feature unique to ml_iPod, that is described in another section.

Autofill behavior

Provides additional options to use during the Autofill process.

Advanced Tab

Ml iPod Advanced.png

The Avanced Tab is to implement special features and for debugging.

Advanced Configuration

Be careful using these options!

  • Bypass the Media Library when playing tracks on this iPod: Plays songs directly from the iPod.
  • Look for iPods on network and fixed disk drives: Tells the program to search for iPods in additional places.
  • Don't lock the Media Library while uploading tracks: Normally, the media library doesn't allow changes during a transfer. This can be overridden, but can cause damage if not properly used.
  • Show "Parsing database, please wait" while loading an iPod database: This removes the notice when an iPod is connected.

For debugging purposes only

      • Only use if instructed to do so on the Fourm!

Audio & Video

Cover Art Tab

AV CoverArt.gif

Enable or disable

You can choose if you want Cover Art content displayed on this iPod.


  • Look for cover art in ID3 tags: This option will display any cover art that is stored in the ID3 tag. Note: This only applies to the main cover art location in the tag!
  • Look for a matching JPEG file (e.g., for MySong.mp3, use MySong.jpg)
  • Look for a specific folder file: folder.jpg is the default, but you can use any name you wish. I particularly like this method as it applies one picture to all the songs in that folder, versus loading a pic into each song. I'm lazy!

Image Scaling

For non-square images:

  • Maintain aspect ratio and pad with whitespace:
  • Stretch to fit (does not preserve aspect ratio):

Use whatever you prefer.

Volume Tab

AV Volume.gif

Replay Gain

If you have used Replay Gain on your content to normalize the volume between albums or tracks, this is where you enable the transfer of this information to the iPod. You must also enable Sound Check on the iPod for it to function on the iPod.

Global volume adjustment

The Global volume adjustment feature allows for files to be played louder or softer than originally intended. Enable the checkbox below the slider to apply the Global volume adjustment to only files transferred after the checkbox is enabled.

Note: Please be responsible when using this feature. Prolonged listening at high volumes can cause hearing loss. Apple has a website setup to warn consumers about this issue:

Folders Tab

AV Folder.gif

This is where you define where your video content is located, and what type of video content it should be considered.

Video Folders

  • Movies: This is the path to the folder where you want your movies to be stored.
  • TV shows: This is the path to the folder where you want your TV shows to be stored.
  • Music TV shows: This is the path to the folder where you want your Music TV shows to be stored.
  • Music Videos: All videos not found in one of these specified folders, will be put in the "music videos" category.

Further details on how the iPod handles these catagories can be found in another section or in various discussion threads in the Forums.


Prefs speech.png

This is described in detail under Podcast and Audiobook support

Audiobooks Tab

Use this field to enter genres which will classify audiobooks. Please put each genre on a line by itself. No empty lines are allowed.


Sets the directory in which podcasts are stored and what genre they will be tagged with.


Upload Tab

Transfers Upload.gif


  • Never confirm uploads:
  • Confirm all upload operations: I tend to use this to maintain my sanity.
  • Confirm only sync and autofill operations:


  • Transcode mp3 and m4a files with a bitrate above YOU SELECT Kbs: This lets you take large lossy files and make them smaller lossy files. Can be useful, but by degrading a degraded file may not sound as desired.
  • Transcode incompatible files (e.g., FLAC, WAV, etc.: This option lets you transcode formats that are not compatible with the iPod, to a form that is compatible.

NOTE: WAV files are compatible with the iPod, but are not typically sent due to their large sizes. For the Purists among us, refer to the section on Hidden Settings to allow the transfer of WAV files.

Transcoder Configuration Menu
  • Change transcoder settings button: This lets you define how the Transcoding is to be preformed.

Special settings

  • Don't lock the Media Library while transferring files (experimental): Choosing this option will allow use of Winamp's Media Library while the transfer is made to the iPod. This is nice during long transfers, but has not been fully tested and may have unintended consequences. Use at your own risk!

Download Tab

Enables the downloading of songs from the iPod to your hard drive.


Directory and naming scheme

  • Destination folder: Enter the directory where you would like to transfer the files from the iPod.
  • File naming scheme: Enter How you want the album/tracks named.

Directory and naming scheme

  • Overwrite existing files... : Your choice!

Logging Tab


If logging is enabled, each song/video that is transferred or erased will be written to a file called "iPod Transfer Log.txt." The file is stored in the root Winamp directory (usually C:\Program Files\Winamp\).


Photo Upload Tab

Photo Upload.gif

This is a new feature in v3. This enables ml_iPod to fully replace iTunes.

Enable or disable

Enables photo uploading for the selected iPod.


Here you enter the base folder for your photos.


Here you select weather to include subfolders and how you want ml_iPod to process portraits. Tab

Enable or disable

Enables for the selected iPod. This option must be install to use the feature!

For songs played from the Media Library

Additional options for


About Version.gif

Version information

This tab shows the version information of ml_iPod that is installed on the system. It also lets you select weather to automatically update ml_iPod to the latest version. This only updates for full releases. Minor releases can be found at: patches

As these haven't always been fully tested, only use to solve a problem you have encountered or want to try a new feature. More information on these updates can be on the Forum.


About Support.gif

Support options

Here you are provided with convenient buttons to:

  • Visit the ml_iPod fourm to ask questions and learn more about all that ml_iPod has to offer.
  • Submit a bug report. As ml_iPod is constantly evolving.

Here is another convenient button to donate to those that make this all possible. To make sure that this works with YOUR iPod, they need to buy one for testing!

Hotkeys via the Nullsoft Global Hotkey's plugin

To enable certain functions of ml_iPod to be mapped to hotkeys, you must have Nullsoft's Global Hotkey's plugin installed, which comes with Winamp.


Instructions to set a hotkey

  • Open Winamp's preferences (CTRL P)
  • Go to Global Hotkeys and make sure it is enabled
  • Choose an action that is prefixed with "iPod:"
  • Select the Hotkey field below and enter the key(s) to be used as the hotkey
  • Click the Add button

Special Settings

Not everything can be controlled via checkboxes or other GUI stuff. There are some hidden settings, too.

Personal tools
Translations of the Wiki