The FooDoo Lounge

Home | Software | Tools | Routines | Info | Dictionaries

iTunes 3.0.1 Dictionary

Copyright Apple Computer, Inc. 2002. All rights reserved.

Index

  1. Standard Suite
  2. iTunes Suite
  3. Internet suite

Standard Suite: Common terms for most applications

Events:

close: Close an object

close reference -- the object to close

count: Return the number of elements of a particular class within an object

count reference -- the object whose elements are to be counted

each type class -- the class of the elements to be counted. Keyword 'each' is optional in AppleScript

Result: integer -- the number of elements

delete: Delete an element from an object

delete reference -- the element to delete

duplicate: Duplicate one or more object(s)

duplicate reference -- the object(s) to duplicate

[to location reference] -- the new location for the object(s)

Result: reference -- to the duplicated object(s)

exists: Verify if an object exists

exists reference -- the object in question

Result: boolean -- true if it exists, false if not

make: Make a new element

make

new type class -- the class of the new element. Keyword 'new' is optional in AppleScript

[at location reference] -- the location at which to insert the element

[with properties record] -- the initial values for the properties of the element

Result: reference -- to the new object(s)

open: open the specified object(s)

open reference -- list of objects to open

quit: quit iTunes

quit

run: run iTunes

run

set:

set reference

to anything

iTunes Suite: The event suite specific to iTunes

Classes:

Class EQ preset: equalizer preset configuration

Plural form:

EQ presets

Properties:

<Inheritance> item [r/o] -- inherits some of its properties from the item class

band 1 small real -- the equalizer 32 Hz band level (-12.0 dB to +12.0 dB)

band 2 small real -- the equalizer 64 Hz band level (-12.0 dB to +12.0 dB)

band 3 small real -- the equalizer 125 Hz band level (-12.0 dB to +12.0 dB)

band 4 small real -- the equalizer 250 Hz band level (-12.0 dB to +12.0 dB)

band 5 small real -- the equalizer 500 Hz band level (-12.0 dB to +12.0 dB)

band 6 small real -- the equalizer 1 kHz band level (-12.0 dB to +12.0 dB)

band 7 small real -- the equalizer 2 kHz band level (-12.0 dB to +12.0 dB)

band 8 small real -- the equalizer 4 kHz band level (-12.0 dB to +12.0 dB)

band 9 small real -- the equalizer 8 kHz band level (-12.0 dB to +12.0 dB)

band 10 small real -- the equalizer 16 kHz band level (-12.0 dB to +12.0 dB)

modifiable boolean [r/o] -- can this preset be modified?

preamp small real -- the equalizer preamp level (-12.0 dB to +12.0 dB)

Class EQ window: the iTunes equalizer window

Plural form:

EQ windows

Properties:

<Inheritance> window [r/o] -- inherits some of its properties from the window class

minimized boolean -- is the small EQ window visible?

Class URL track: a track representing a network stream

Plural form:

URL tracks

Properties:

<Inheritance> track [r/o] -- inherits some of its properties from the playlist class

address Unicode text -- the URL for this track

Class application: The application program

Elements:

browser window by numeric index, by name, by ID

encoder by numeric index, by name, by ID

EQ preset by numeric index, by name, by ID

EQ window by numeric index, by name, by ID

playlist window by numeric index, by name, by ID

source by numeric index, by name, by ID

visual by numeric index, by name, by ID

window by numeric index, by name, by ID

Properties:

current encoder encoder -- the currently selected encoder (MP3, AIFF, WAV, etc.)

current EQ preset EQ preset -- the currently selected equalizer preset

current playlist playlist [r/o] -- the playlist containing the currently targeted track

current track track [r/o] -- the current targeted track

current visual visual -- the currently selected visual plug-in

EQ enabled boolean -- is the equalizer enabled?

fixed indexing boolean -- true if all AppleScript track indices should be independent of the play order of the owning playlist.

frontmost boolean -- is iTunes the frontmost application?

full screen boolean -- are visuals displayed using the entire screen?

name Unicode text [r/o] -- the name of the application

mute boolean -- has the sound output been muted?

player position integer -- the player’s position within the currently playing track in seconds.

player state stopped/playing/paused/fast forwarding/rewinding [r/o] -- is iTunes stopped, paused, or playing?

selection reference [r/o] -- the selection visible to the user

sound volume integer -- the sound output volume (0 = minimum, 100 = maximum)

version version [r/o] -- the version of iTunes

visuals enabled boolean -- are visuals currently being displayed?

visual size small/medium/large -- the size of the displayed visual

Class audio CD playlist: a playlist representing an audio CD

Plural form:

audio CD playlists

Elements:

audio CD track by numeric index, by name, by ID

Properties:

<Inheritance> playlist [r/o] -- inherits some of its properties from the playlist class

artist Unicode text -- the artist of the CD

compilation boolean -- is this CD a compilation album?

composer Unicode text -- the composer of the CD

disc count integer -- the total number of discs in this CD’s album

disc number integer -- the index of this CD disc in the source album

genre Unicode text -- the genre of the CD

year integer -- the year the album was recorded/released

Class audio CD track: a track on an audio CD

Plural form:

audio CD tracks

Properties:

<Inheritance> track [r/o] -- inherits some of its properties from the playlist class

Class browser window: the main iTunes window

Plural form:

browser windows

Properties:

<Inheritance> window [r/o] -- inherits some of its properties from the window class

minimized boolean -- is the small player visible?

selection reference [r/o] -- the selected songs

view playlist -- the playlist currently displayed in the window

Class device playlist: a playlist representing the contents of a portable device

Plural form:

device playlists

Elements:

device track by numeric index, by name, by ID

Properties:

<Inheritance> playlist [r/o] -- inherits some of its properties from the playlist class

Class device track: a track residing on a portable music player

Plural form:

device tracks

Properties:

<Inheritance> track [r/o] -- inherits some of its properties from the playlist class

Class encoder: converts a track to a specific file format

Plural form:

encoders

Properties:

<Inheritance> item [r/o] -- inherits some of its properties from the item class

format Unicode text [r/o] -- the data format created by the encoder

Class file track: a track representing an audio file (MP3, AIFF, etc.)

Plural form:

file tracks

Properties:

<Inheritance> track [r/o] -- inherits some of its properties from the playlist class

location alias [r/o] -- the location of the file represented by this track

Class item: an item

Plural form:

items

Properties:

container reference [r/o] -- the container of the item

name Unicode text -- the name of the item

Class library playlist: the master music library playlist

Plural form:

library playlists

Elements:

file track by numeric index, by name, by ID

URL track by numeric index, by name, by ID

Properties:

<Inheritance> playlist [r/o] -- inherits some of its properties from the playlist class

Class playlist: a list of songs/streams

Plural form:

playlists

Elements:

track by numeric index, by name, by ID

Properties:

<Inheritance> item [r/o] -- inherits some of its properties from the item class

duration integer [r/o] -- the total length of all songs (in seconds)

index integer [r/o] -- the index of the playlist in internal application order

name Unicode text -- the name of the playlist

shuffle boolean -- play the songs in this playlist in random order?

size double integer [r/o] -- the total size of all songs (in bytes)

song repeat off/one/all -- playback repeat mode

time Unicode text [r/o] -- the length of all songs in MM:SS format

visible boolean [r/o] -- is this playlist visible in the Source list?

Class playlist window: a sub-window showing a single playlist

Plural form:

playlist windows

Properties:

<Inheritance> window [r/o] -- inherits some of its properties from the window class

selection reference [r/o] -- the selected songs

view playlist [r/o] -- the playlist displayed in the window

Class radio tuner playlist: the radio tuner playlist

Plural form:

radio tuner playlists

Elements:

URL track by numeric index, by name, by ID

Properties:

<Inheritance> playlist [r/o] -- inherits some of its properties from the playlist class

Class source: a music source (music library, CD, device, etc.)

Plural form:

sources

Elements:

audio CD playlist by numeric index, by name, by ID

device playlist by numeric index, by name, by ID

library playlist by numeric index, by name, by ID

playlist by numeric index, by name, by ID

radio tuner playlist by numeric index, by name, by ID

user playlist by numeric index, by name, by ID

Properties:

<Inheritance> item [r/o] -- inherits some of its properties from the item class

capacity double integer [r/o] -- the total size of the source if it has a fixed size

free space double integer [r/o] -- the free space on the source if it has a fixed size

kind library/iPod/audio CD/MP3 CD/device/radio tuner/unknown [r/o]

Class track: playable audio source

Plural form:

tracks

Properties:

<Inheritance> item [r/o] -- inherits some of its properties from the item class

album Unicode text -- the album containing the track

artist Unicode text -- the artist/source of the track

bit rate integer [r/o] -- the bit rate of the track (in kbps)

comment Unicode text -- freeform notes about the track

compilation boolean -- is this track from a compilation album?

composer Unicode text -- the composer of the track

database ID integer [r/o] -- the common, unique ID for this track. If two tracks in different playlists have the same database ID, they are sharing the same data.

date added date [r/o] -- the date the track was added to the playlist

disc count integer -- the total number of discs in the source album

disc number integer -- the index of the disc containing this track on the source album

duration integer [r/o] -- the length of the track in seconds

enabled boolean -- is this track checked for playback?

EQ Unicode text -- the name of the EQ preset of the track

finish integer -- the stop time of the track in seconds

genre Unicode text -- the music/audio genre (category) of the track

kind Unicode text [r/o] -- a text description of the track

modification date date [r/o] -- the modification date of the content of this track

played count integer [r/o] -- number of times this track has been played

played date date [r/o] -- the date and time this track was last played

rating integer -- the user rating of this track (0 to 100)

sample rate integer [r/o] -- the sample rate of the track (in Hz)

size integer [r/o] -- the size of the track (in bytes)

start integer -- the start time of the track in seconds

time Unicode text [r/o] -- the length of the track in MM:SS format

track count integer -- the total number of tracks on the source album

track number integer -- the index of the track on the source album

volume adjustment integer -- relative volume adjustment of the track (-100% to 100%)

year integer -- the year the track was recorded/released

Class user playlist: custom playlists created by the user

Plural form:

user playlists

Elements:

file track by numeric index, by name, by ID

URL track by numeric index, by name, by ID

Properties:

<Inheritance> playlist [r/o] -- inherits some of its properties from the playlist class

smart boolean [r/o] -- is this a Smart Playlist?

Class visual: a visual plug-in

Plural form:

visuals

Properties:

<Inheritance> item [r/o] -- inherits some of its properties from the item class

Class window: any window

Plural form:

windows

Properties:

<Inheritance> item [r/o] -- inherits some of its properties from the item class

bounds bounding rectangle -- the boundary rectangle for the window

closeable boolean [r/o] -- does the window have a close box?

collapseable boolean [r/o] -- does the window have a collapse (windowshade) box?

collapsed boolean -- is the window collapsed?

position point -- the upper left position of the window

resizable boolean [r/o] -- is the window resizable?

visible boolean -- is the window visible?

zoomable boolean [r/o] -- is the window zoomable?

zoomed boolean -- is the window zoomed?

Events:

add: add one or more files to a playlist

add a list of alias -- the file(s) to add

[to location reference] -- the location of the added file(s)

Result: track -- reference to added track(s)

back track: reposition to beginning of current track or go to previous track if already at start of current track

back track

convert: convert one or more files or tracks

convert a list of reference -- the file(s)/tracks(s) to convert

Result: track -- reference to converted track(s)

fast forward: skip forward in a playing track

fast forward

next track: advance to the next track in the current playlist

next track

pause: pause playback

pause

play: play the current track or the specified track or file.

play reference -- item to play

playpause: toggle the playing/paused state of the current track

playpause

previous track: return to the previous track in the current playlist

previous track

resume: disable fast forward/rewind and resume playback, if playing.

resume

rewind: skip backwards in a playing track

rewind

stop: stop playback

stop

update: update the contents of the specified iPod

update source -- the iPod to update

Internet suite: Standard terms for Internet scripting

Events:

open location: Opens a URL to an audio stream

open location string -- the URL to open

 

|| url: http://www.foodoo.sunreal.com.au/info/dictionaries/iTunes_301_asDict.html
|| created: 4-Aug-03, 9:48 PM; updated: 4-Aug-03, 2:48 PM
|| size: 67986 bytes