docs » hs.itunes

Controls for iTunes music player

API Overview

API Documentation

Constants

state_paused
Signature hs.itunes.state_paused
Type Constant
Description

Returned by hs.itunes.getPlaybackState() to indicates iTunes is paused

Source extensions/itunes/itunes.lua line 17
state_playing
Signature hs.itunes.state_playing
Type Constant
Description

Returned by hs.itunes.getPlaybackState() to indicates iTunes is playing

Source extensions/itunes/itunes.lua line 22
state_stopped
Signature hs.itunes.state_stopped
Type Constant
Description

Returned by hs.itunes.getPlaybackState() to indicates iTunes is stopped

Source extensions/itunes/itunes.lua line 27

Functions

displayCurrentTrack
Signature hs.itunes.displayCurrentTrack()
Type Function
Description

Displays information for current track on screen

Parameters
  • None
Returns
  • None
Source extensions/itunes/itunes.lua line 108
ff
Signature hs.itunes.ff()
Type Function
Description

Skips the current playback forwards by 5 seconds

Parameters
  • None
Returns
  • None
Source extensions/itunes/itunes.lua line 304
getCurrentAlbum
Signature hs.itunes.getCurrentAlbum() -> string or nil
Type Function
Description

Gets the name of the current Album

Parameters
  • None
Returns
  • A string containing the Album of the current track, or nil if an error occurred
Source extensions/itunes/itunes.lua line 137
getCurrentArtist
Signature hs.itunes.getCurrentArtist() -> string or nil
Type Function
Description

Gets the name of the current Artist

Parameters
  • None
Returns
  • A string containing the Artist of the current track, or nil if an error occurred
Source extensions/itunes/itunes.lua line 124
getCurrentTrack
Signature hs.itunes.getCurrentTrack() -> string or nil
Type Function
Description

Gets the name of the current track

Parameters
  • None
Returns
  • A string containing the name of the current track, or nil if an error occurred
Source extensions/itunes/itunes.lua line 150
getDuration
Signature hs.itunes.getDuration()
Type Function
Description

Gets the duration (in seconds) of the current song

Parameters
  • None
Returns
  • The number of seconds long the current song is, 0 if no song is playing
Source extensions/itunes/itunes.lua line 290
getPlaybackState
Signature hs.itunes.getPlaybackState()
Type Function
Description

Gets the current playback state of iTunes

Parameters
  • None
Returns
  • A string containing one of the following constants:
    • hs.itunes.state_stopped
    • hs.itunes.state_paused
    • hs.itunes.state_playing
Source extensions/itunes/itunes.lua line 163
getPosition
Signature hs.itunes.getPosition()
Type Function
Description

Gets the playback position (in seconds) of the current song

Parameters
  • None
Returns
  • A number indicating the current position in the song
Source extensions/itunes/itunes.lua line 264
getVolume
Signature hs.itunes.getVolume()
Type Function
Description

Gets the current iTunes volume setting

Parameters
  • None
Returns
  • A number, between 1 and 100, containing the current iTunes playback volume
Source extensions/itunes/itunes.lua line 216
isPlaying
Signature hs.itunes.isPlaying()
Type Function
Description

Returns whether iTunes is currently playing

Parameters
  • None
Returns
  • A boolean value indicating whether iTunes is currently playing a track, or nil if an error occurred (unknown player state). Also returns false if the application is not running
Source extensions/itunes/itunes.lua line 192
isRunning
Signature hs.itunes.isRunning()
Type Function
Description

Returns whether iTunes is currently open. Most other functions in hs.itunes will automatically start the application, so this function can be used to guard against that.

Parameters
  • None
Returns
  • A boolean value indicating whether the iTunes application is running.
Source extensions/itunes/itunes.lua line 179
next
Signature hs.itunes.next()
Type Function
Description

Skips to the next itunes track

Parameters
  • None
Returns
  • None
Source extensions/itunes/itunes.lua line 82
pause
Signature hs.itunes.pause()
Type Function
Description

Pauses the current iTunes track

Parameters
  • None
Returns
  • None
Source extensions/itunes/itunes.lua line 69
play
Signature hs.itunes.play()
Type Function
Description

Plays the current iTunes track

Parameters
  • None
Returns
  • None
Source extensions/itunes/itunes.lua line 56
playpause
Signature hs.itunes.playpause()
Type Function
Description

Toggles play/pause of current iTunes track

Parameters
  • None
Returns
  • None
Source extensions/itunes/itunes.lua line 43
previous
Signature hs.itunes.previous()
Type Function
Description

Skips to previous itunes track

Parameters
  • None
Returns
  • None
Source extensions/itunes/itunes.lua line 95
rw
Signature hs.itunes.rw()
Type Function
Description

Skips the current playback backwards by 5 seconds

Parameters
  • None
Returns
  • None
Source extensions/itunes/itunes.lua line 315
setPosition
Signature hs.itunes.setPosition(pos)
Type Function
Description

Sets the playback position of the current song

Parameters
  • pos - A number indicating the playback position (in seconds) to skip to
Returns
  • None
Source extensions/itunes/itunes.lua line 275
setVolume
Signature hs.itunes.setVolume(vol)
Type Function
Description

Sets the iTunes playback volume

Parameters
  • vol - A number, between 1 and 100
Returns
  • None
Source extensions/itunes/itunes.lua line 227
volumeDown
Signature hs.itunes.volumeDown()
Type Function
Description

Decreases the iTunes playback volume by 5

Parameters
  • None
Returns
  • None
Source extensions/itunes/itunes.lua line 253
volumeUp
Signature hs.itunes.volumeUp()
Type Function
Description

Increases the iTunes playback volume by 5

Parameters
  • None
Returns
  • None
Source extensions/itunes/itunes.lua line 242