#hs.itunes

Controls for iTunes music player


#API Overview

Constants - Useful values which cannot be changed

Functions - API calls offered directly by the extension


#API Documentation

#Constants

Signaturehs.itunes.state_paused
TypeConstant
DescriptionReturned by hs.itunes.getPlaybackState() to indicates iTunes is paused
NotesNone
Sourceextensions/itunes/itunes.lua line 17

Signaturehs.itunes.state_playing
TypeConstant
DescriptionReturned by hs.itunes.getPlaybackState() to indicates iTunes is playing
NotesNone
Sourceextensions/itunes/itunes.lua line 22

Signaturehs.itunes.state_stopped
TypeConstant
DescriptionReturned by hs.itunes.getPlaybackState() to indicates iTunes is stopped
NotesNone
Sourceextensions/itunes/itunes.lua line 27

#Functions

Signaturehs.itunes.displayCurrentTrack()
TypeFunction
DescriptionDisplays information for current track on screen
Parameters
  • None
Returns
  • None
NotesNone
ExamplesNone
Sourceextensions/itunes/itunes.lua line 108

Signaturehs.itunes.ff()
TypeFunction
DescriptionSkips the current playback forwards by 5 seconds
Parameters
  • None
Returns
  • None
NotesNone
ExamplesNone
Sourceextensions/itunes/itunes.lua line 304

Signaturehs.itunes.getCurrentAlbum() -> string or nil
TypeFunction
DescriptionGets the name of the current Album
Parameters
  • None
Returns
  • A string containing the Album of the current track, or nil if an error occurred
NotesNone
ExamplesNone
Sourceextensions/itunes/itunes.lua line 137

Signaturehs.itunes.getCurrentArtist() -> string or nil
TypeFunction
DescriptionGets the name of the current Artist
Parameters
  • None
Returns
  • A string containing the Artist of the current track, or nil if an error occurred
NotesNone
ExamplesNone
Sourceextensions/itunes/itunes.lua line 124

Signaturehs.itunes.getCurrentTrack() -> string or nil
TypeFunction
DescriptionGets the name of the current track
Parameters
  • None
Returns
  • A string containing the name of the current track, or nil if an error occurred
NotesNone
ExamplesNone
Sourceextensions/itunes/itunes.lua line 150

Signaturehs.itunes.getDuration()
TypeFunction
DescriptionGets 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
NotesNone
ExamplesNone
Sourceextensions/itunes/itunes.lua line 290

Signaturehs.itunes.getPlaybackState()
TypeFunction
DescriptionGets 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
NotesNone
ExamplesNone
Sourceextensions/itunes/itunes.lua line 163

Signaturehs.itunes.getPosition()
TypeFunction
DescriptionGets the playback position (in seconds) of the current song
Parameters
  • None
Returns
  • A number indicating the current position in the song
NotesNone
ExamplesNone
Sourceextensions/itunes/itunes.lua line 264

Signaturehs.itunes.getVolume()
TypeFunction
DescriptionGets the current iTunes volume setting
Parameters
  • None
Returns
  • A number, between 1 and 100, containing the current iTunes playback volume
NotesNone
ExamplesNone
Sourceextensions/itunes/itunes.lua line 216

Signaturehs.itunes.isPlaying()
TypeFunction
DescriptionReturns 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
NotesNone
ExamplesNone
Sourceextensions/itunes/itunes.lua line 192

Signaturehs.itunes.isRunning()
TypeFunction
DescriptionReturns 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.
NotesNone
ExamplesNone
Sourceextensions/itunes/itunes.lua line 179

Signaturehs.itunes.next()
TypeFunction
DescriptionSkips to the next itunes track
Parameters
  • None
Returns
  • None
NotesNone
ExamplesNone
Sourceextensions/itunes/itunes.lua line 82

Signaturehs.itunes.pause()
TypeFunction
DescriptionPauses the current iTunes track
Parameters
  • None
Returns
  • None
NotesNone
ExamplesNone
Sourceextensions/itunes/itunes.lua line 69

Signaturehs.itunes.play()
TypeFunction
DescriptionPlays the current iTunes track
Parameters
  • None
Returns
  • None
NotesNone
ExamplesNone
Sourceextensions/itunes/itunes.lua line 56

Signaturehs.itunes.playpause()
TypeFunction
DescriptionToggles play/pause of current iTunes track
Parameters
  • None
Returns
  • None
NotesNone
ExamplesNone
Sourceextensions/itunes/itunes.lua line 43

Signaturehs.itunes.previous()
TypeFunction
DescriptionSkips to previous itunes track
Parameters
  • None
Returns
  • None
NotesNone
ExamplesNone
Sourceextensions/itunes/itunes.lua line 95

Signaturehs.itunes.rw()
TypeFunction
DescriptionSkips the current playback backwards by 5 seconds
Parameters
  • None
Returns
  • None
NotesNone
ExamplesNone
Sourceextensions/itunes/itunes.lua line 315

Signaturehs.itunes.setPosition(pos)
TypeFunction
DescriptionSets the playback position of the current song
Parameters
  • pos - A number indicating the playback position (in seconds) to skip to
Returns
  • None
NotesNone
ExamplesNone
Sourceextensions/itunes/itunes.lua line 275

Signaturehs.itunes.setVolume(vol)
TypeFunction
DescriptionSets the iTunes playback volume
Parameters
  • vol - A number, between 1 and 100
Returns
  • None
NotesNone
ExamplesNone
Sourceextensions/itunes/itunes.lua line 227

Signaturehs.itunes.volumeDown()
TypeFunction
DescriptionDecreases the iTunes playback volume by 5
Parameters
  • None
Returns
  • None
NotesNone
ExamplesNone
Sourceextensions/itunes/itunes.lua line 253

Signaturehs.itunes.volumeUp()
TypeFunction
DescriptionIncreases the iTunes playback volume by 5
Parameters
  • None
Returns
  • None
NotesNone
ExamplesNone
Sourceextensions/itunes/itunes.lua line 242