W3cubDocs

/Hammerspoon

hs.vox

Controls for VOX music player

API Overview

API Documentation

Functions

addurl
Signature hs.vox.addurl(url)
Type Function
Description

Add media URL to current list

Parameters
  • url {string}
Returns
  • None
Source extensions/vox/vox.lua line 115
backward
Signature hs.vox.backward()
Type Function
Description

Skips the playback position backwards by about 7 seconds

Parameters
  • None
Returns
  • None
Source extensions/vox/vox.lua line 141
decreaseVolume
Signature hs.vox.decreaseVolume()
Type Function
Description

Decreases the player volume

Parameters
  • None
Returns
  • None
Source extensions/vox/vox.lua line 193
fastBackward
Signature hs.vox.fastBackward()
Type Function
Description

Skips the playback position backwards by about 14 seconds

Parameters
  • None
Returns
  • None
Source extensions/vox/vox.lua line 167
fastForward
Signature hs.vox.fastForward()
Type Function
Description

Skips the playback position forwards by about 17 seconds

Parameters
  • None
Returns
  • None
Source extensions/vox/vox.lua line 154
forward
Signature hs.vox.forward()
Type Function
Description

Skips the playback position forwards by about 7 seconds

Parameters
  • None
Returns
  • None
Source extensions/vox/vox.lua line 128
getAlbumArtist
Signature hs.vox.getAlbumArtist()
Type Function
Description

Gets the artist of current Album

Parameters
  • None
Returns
  • A string containing the artist of current Album, or nil if an error occurred
Source extensions/vox/vox.lua line 261
getCurrentAlbum
Signature hs.vox.getCurrentAlbum()
Type Function
Description

Gets the name of the album of the current track

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

Gets the name of the artist of the current track

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

Gets the current playback state of vox

Parameters
  • None
Returns
  • 0 for paused
  • 1 for playing
Source extensions/vox/vox.lua line 287
getUniqueID
Signature hs.vox.getUniqueID()
Type Function
Description

Gets the uniqueID of the current track

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

Increases the player volume

Parameters
  • None
Returns
  • None
Source extensions/vox/vox.lua line 180
isRunning
Signature hs.vox.isRunning()
Type Function
Description

Returns whether VOX is currently open

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

Skips to the next track

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

Pauses the current vox track

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

Plays the current vox track

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

Toggles play/pause of current vox track

Parameters
  • None
Returns
  • None
Source extensions/vox/vox.lua line 50
playurl
Signature hs.vox.playurl(url)
Type Function
Description

Play media from the given URL

Parameters
  • url {string}
Returns
  • None
Source extensions/vox/vox.lua line 102
previous
Signature hs.vox.previous()
Type Function
Description

Skips to previous track

Parameters
  • None
Returns
  • None
Source extensions/vox/vox.lua line 76
shuffle
Signature hs.vox.shuffle()
Type Function
Description

Toggle shuffle state of current list

Parameters
  • None
Returns
  • None
Source extensions/vox/vox.lua line 89
togglePlaylist
Signature hs.vox.togglePlaylist()
Type Function
Description

Toggle playlist

Parameters
  • None
Returns
  • None
Source extensions/vox/vox.lua line 206
trackInfo
Signature hs.vox.trackInfo()
Type Function
Description

Displays information for current track on screen

Parameters
  • None
Returns
  • None
Source extensions/vox/vox.lua line 219

© 2014–2017 Hammerspoon contributors
Licensed under the MIT License.
https://www.hammerspoon.org/docs/hs.vox.html