Plugin=NowPlaying retrieves information about the currently playing track from a number of media players.
- General measure options
- All general measure options are valid.
- Can be either:
- The player interface name (e.g.
- Or the name of another measure (e.g.
- The player interface name (e.g.
- Type of the measure value. Valid values are:
Artist: Track artist.
Album: Current album.
Title: Track title.
Number: Track number.
Year: Track year.
Cover: Path to cover art.
File: Path to the playing media file.
Duration: Total length of track in seconds.
Position: Current position in track in seconds.
Progress: Percentage of track completed.
Rating: Rating of current track (0 to 5).
Repeat: 0 if repeat/loop track is off, 1 if on.
Shuffle: 0 if shuffle/random tracks is off, 1 if on.
State: 0 for stopped, 1 for playing, and 2 for paused.
Status: 0 for inactive (player closed) and 1 for active (player open).
Volume: From 0 to 100.
Position, the string value is in the form
MM:SSand the number value is the actual number of seconds.
- If defined, used to launch the player with the
OpenPlayercommand. If not defined, the plugin will attempt to automatically detect the path.
- Action to execute when the track changes.
- If set to
1, the format of Duration and Position is
MM:SS. This option must be set on the main measure.
NowPlaying measures can be controlled with the !CommandMeasure bang with the argument parameter being:
Pause: Pause current track.
Play: Play current track.
PlayPause: Play (if stopped/paused) or pause (if playing) current track.
Stop: Stop current track.
Next: Change to next track.
Previous: Change to previous track.
OpenPlayer: Opens the player. If already open, the player will be brought to the top.
ClosePlayer: Closes the player.
TogglePlayer: Opens/closes the player depending on current state.
SetPosition n: Where n is either an absolute value (
SetPosition 50to jump to 50% of the track) or a relative value (
SetPosition +5to jump 5% forward or
SetPosition -10to jump 10% backward).
SetRating n: Where n is a value between
0(no rating) and
SetShuffle n: Where n is
0(shuffle off), or
SetRepeat n: Where n is
0(repeat off), or
SetVolume n: Where n is either an absolute value (
SetVolume 50to set volume to 50%) or a relative value (
SetVolume +20to increase volume by 20% or
SetVolume -40to decrease volume by 40%).
Fully supported players
The following players are fully supported. All features should work unless stated otherwise.
Fully supported. Tested with AIMP 2.61.
Fully supported. The foo_cad plugin (download) needs to be installed.
Fully supported. Tested with iTunes 10.2.
- J. River Media Center and Media Jukebox:
Fully supported through the CAD interface with Media Center 19 and later. More information here.
Fully supported. Tested with MediaMonkey 3.2.5.
Fully supported. MusicBee 1.2 (or higher) is required.
Fully supported. The libcad plugin for VLC must be installed.
Fully supported, except for the
Partially supported players
The following players are partially supported. Only some features will work.
Partially supported. Only the types
Trackand the bangs
- Last.fm Client, TTPlayer, OpenPandora, Zune:
Partially supported. Even in the best case, only the types
Albumand the bangs
For a more complete example, check the Soita skin.
; MeasurePlayer is the main measure.
; MeasureArtist and MeasureAlbum are secondary measures.
; The main measure specifies the media player on PlayerName.
; PlayerPath, TrackChangeAction, and DisableLeadingZero are valid here on
; the main measure only.
; Secondary measures specify the name of the main measure on PlayerName.
LeftMouseUpAction=[!CommandMeasure "MeasurePlayer" "Previous"]
LeftMouseUpAction=[!CommandMeasure "MeasurePlayer" "Next"]