Measure=NowPlaying retrieves information about the currently playing track from a number of media players.
Note: NowPlaying was previously a plugin measure.
In many existing skins you might see the syntax:
NowPlaying still works with those forms, and changing existing skins to the new
Measure=NowPlaying syntax is entirely optional. However, new skins created going forward should use the correct syntax for accuracy and clarity. NowPlaying is a measure, and not a plugin.
- 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.
Genre: Track genre.
Cover: Path to cover art.
File: Path to the playing media file.
Duration: Total length of track in seconds.
Lyrics: Lyrics for track, downloaded from
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.
With measures of type
Position, the string value is in the form
MM:SSand the number value is the actual number of seconds.
Lyricstype will detect and use both the
Titlevalues found for the .mp3 file in its ID3 tags, and will search https://www.letras.mus.br for the lyrics, returning the first match. No match is possible if both Artist and Title are not present in the ID3 tags for the .mp3 file.
PlayerType=Genreoption is currently supported with the AIMP, CAD, iTunes, WMP and WinAmp
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 5.00.
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. MusicBee 1.2 (or higher) is required.
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.