#hs.itunes
Controls for iTunes music player
#API Overview
Constants - Useful values which cannot be changed
Functions - API calls offered directly by the extension
- displayCurrentTrack
- ff
- getCurrentAlbum
- getCurrentArtist
- getCurrentTrack
- getDuration
- getPlaybackState
- getPosition
- getVolume
- isPlaying
- isRunning
- next
- pause
- play
- playpause
- previous
- rw
- setPosition
- setVolume
- volumeDown
- volumeUp
#API Documentation
#Constants
Signature | hs.itunes.state_paused |
Type | Constant |
Description | Returned by hs.itunes.getPlaybackState() to indicates iTunes is paused |
Notes | None |
Source | extensions/itunes/itunes.lua line 17 |
Signature | hs.itunes.state_playing |
Type | Constant |
Description | Returned by hs.itunes.getPlaybackState() to indicates iTunes is playing |
Notes | None |
Source | extensions/itunes/itunes.lua line 22 |
Signature | hs.itunes.state_stopped |
Type | Constant |
Description | Returned by hs.itunes.getPlaybackState() to indicates iTunes is stopped |
Notes | None |
Source | extensions/itunes/itunes.lua line 27 |
#Functions
Signature | hs.itunes.displayCurrentTrack() |
Type | Function |
Description | Displays information for current track on screen |
Parameters |
|
Returns |
|
Notes | None |
Examples | None |
Source | extensions/itunes/itunes.lua line 108 |
Signature | hs.itunes.ff() |
Type | Function |
Description | Skips the current playback forwards by 5 seconds |
Parameters |
|
Returns |
|
Notes | None |
Examples | None |
Source | extensions/itunes/itunes.lua line 304 |
Signature | hs.itunes.getCurrentAlbum() -> string or nil |
Type | Function |
Description | Gets the name of the current Album |
Parameters |
|
Returns |
|
Notes | None |
Examples | None |
Source | extensions/itunes/itunes.lua line 137 |
Signature | hs.itunes.getCurrentArtist() -> string or nil |
Type | Function |
Description | Gets the name of the current Artist |
Parameters |
|
Returns |
|
Notes | None |
Examples | None |
Source | extensions/itunes/itunes.lua line 124 |
Signature | hs.itunes.getCurrentTrack() -> string or nil |
Type | Function |
Description | Gets the name of the current track |
Parameters |
|
Returns |
|
Notes | None |
Examples | None |
Source | extensions/itunes/itunes.lua line 150 |
Signature | hs.itunes.getDuration() |
Type | Function |
Description | Gets the duration (in seconds) of the current song |
Parameters |
|
Returns |
|
Notes | None |
Examples | None |
Source | extensions/itunes/itunes.lua line 290 |
Signature | hs.itunes.getPlaybackState() |
Type | Function |
Description | Gets the current playback state of iTunes |
Parameters |
|
Returns |
|
Notes | None |
Examples | None |
Source | extensions/itunes/itunes.lua line 163 |
Signature | hs.itunes.getPosition() |
Type | Function |
Description | Gets the playback position (in seconds) of the current song |
Parameters |
|
Returns |
|
Notes | None |
Examples | None |
Source | extensions/itunes/itunes.lua line 264 |
Signature | hs.itunes.getVolume() |
Type | Function |
Description | Gets the current iTunes volume setting |
Parameters |
|
Returns |
|
Notes | None |
Examples | None |
Source | extensions/itunes/itunes.lua line 216 |
Signature | hs.itunes.isPlaying() |
Type | Function |
Description | Returns whether iTunes is currently playing |
Parameters |
|
Returns |
|
Notes | None |
Examples | None |
Source | extensions/itunes/itunes.lua line 192 |
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 |
|
Returns |
|
Notes | None |
Examples | None |
Source | extensions/itunes/itunes.lua line 179 |
Signature | hs.itunes.next() |
Type | Function |
Description | Skips to the next itunes track |
Parameters |
|
Returns |
|
Notes | None |
Examples | None |
Source | extensions/itunes/itunes.lua line 82 |
Signature | hs.itunes.pause() |
Type | Function |
Description | Pauses the current iTunes track |
Parameters |
|
Returns |
|
Notes | None |
Examples | None |
Source | extensions/itunes/itunes.lua line 69 |
Signature | hs.itunes.play() |
Type | Function |
Description | Plays the current iTunes track |
Parameters |
|
Returns |
|
Notes | None |
Examples | None |
Source | extensions/itunes/itunes.lua line 56 |
Signature | hs.itunes.playpause() |
Type | Function |
Description | Toggles play/pause of current iTunes track |
Parameters |
|
Returns |
|
Notes | None |
Examples | None |
Source | extensions/itunes/itunes.lua line 43 |
Signature | hs.itunes.previous() |
Type | Function |
Description | Skips to previous itunes track |
Parameters |
|
Returns |
|
Notes | None |
Examples | None |
Source | extensions/itunes/itunes.lua line 95 |
Signature | hs.itunes.rw() |
Type | Function |
Description | Skips the current playback backwards by 5 seconds |
Parameters |
|
Returns |
|
Notes | None |
Examples | None |
Source | extensions/itunes/itunes.lua line 315 |
Signature | hs.itunes.setPosition(pos) |
Type | Function |
Description | Sets the playback position of the current song |
Parameters |
|
Returns |
|
Notes | None |
Examples | None |
Source | extensions/itunes/itunes.lua line 275 |
Signature | hs.itunes.setVolume(vol) |
Type | Function |
Description | Sets the iTunes playback volume |
Parameters |
|
Returns |
|
Notes | None |
Examples | None |
Source | extensions/itunes/itunes.lua line 227 |
Signature | hs.itunes.volumeDown() |
Type | Function |
Description | Decreases the iTunes playback volume by 5 |
Parameters |
|
Returns |
|
Notes | None |
Examples | None |
Source | extensions/itunes/itunes.lua line 253 |
Signature | hs.itunes.volumeUp() |
Type | Function |
Description | Increases the iTunes playback volume by 5 |
Parameters |
|
Returns |
|
Notes | None |
Examples | None |
Source | extensions/itunes/itunes.lua line 242 |