427 lines
14 KiB
Python
427 lines
14 KiB
Python
from __future__ import absolute_import, unicode_literals
|
|
|
|
import warnings
|
|
|
|
from mopidy.core import PlaybackState
|
|
from mopidy.mpd import exceptions, protocol
|
|
|
|
|
|
@protocol.commands.add('consume', state=protocol.BOOL)
|
|
def consume(context, state):
|
|
"""
|
|
*musicpd.org, playback section:*
|
|
|
|
``consume {STATE}``
|
|
|
|
Sets consume state to ``STATE``, ``STATE`` should be 0 or
|
|
1. When consume is activated, each song played is removed from
|
|
playlist.
|
|
"""
|
|
context.core.tracklist.consume = state
|
|
|
|
|
|
@protocol.commands.add('crossfade', seconds=protocol.UINT)
|
|
def crossfade(context, seconds):
|
|
"""
|
|
*musicpd.org, playback section:*
|
|
|
|
``crossfade {SECONDS}``
|
|
|
|
Sets crossfading between songs.
|
|
"""
|
|
raise exceptions.MpdNotImplemented # TODO
|
|
|
|
|
|
# TODO: add at least reflection tests before adding NotImplemented version
|
|
# @protocol.commands.add('mixrampdb')
|
|
def mixrampdb(context, decibels):
|
|
"""
|
|
*musicpd.org, playback section:*
|
|
|
|
``mixrampdb {deciBels}``
|
|
|
|
Sets the threshold at which songs will be overlapped. Like crossfading but
|
|
doesn't fade the track volume, just overlaps. The songs need to have
|
|
MixRamp tags added by an external tool. 0dB is the normalized maximum
|
|
volume so use negative values, I prefer -17dB. In the absence of mixramp
|
|
tags crossfading will be used. See http://sourceforge.net/projects/mixramp
|
|
"""
|
|
pass
|
|
|
|
|
|
# TODO: add at least reflection tests before adding NotImplemented version
|
|
# @protocol.commands.add('mixrampdelay', seconds=protocol.UINT)
|
|
def mixrampdelay(context, seconds):
|
|
"""
|
|
*musicpd.org, playback section:*
|
|
|
|
``mixrampdelay {SECONDS}``
|
|
|
|
Additional time subtracted from the overlap calculated by mixrampdb. A
|
|
value of "nan" disables MixRamp overlapping and falls back to
|
|
crossfading.
|
|
"""
|
|
pass
|
|
|
|
|
|
@protocol.commands.add('next')
|
|
def next_(context):
|
|
"""
|
|
*musicpd.org, playback section:*
|
|
|
|
``next``
|
|
|
|
Plays next song in the playlist.
|
|
|
|
*MPD's behaviour when affected by repeat/random/single/consume:*
|
|
|
|
Given a playlist of three tracks numbered 1, 2, 3, and a currently
|
|
playing track ``c``. ``next_track`` is defined at the track that
|
|
will be played upon calls to ``next``.
|
|
|
|
Tests performed on MPD 0.15.4-1ubuntu3.
|
|
|
|
====== ====== ====== ======= ===== ===== ===== =====
|
|
Inputs next_track
|
|
------------------------------- ------------------- -----
|
|
repeat random single consume c = 1 c = 2 c = 3 Notes
|
|
====== ====== ====== ======= ===== ===== ===== =====
|
|
T T T T 2 3 EOPL
|
|
T T T . Rand Rand Rand [1]
|
|
T T . T Rand Rand Rand [4]
|
|
T T . . Rand Rand Rand [4]
|
|
T . T T 2 3 EOPL
|
|
T . T . 2 3 1
|
|
T . . T 3 3 EOPL
|
|
T . . . 2 3 1
|
|
. T T T Rand Rand Rand [3]
|
|
. T T . Rand Rand Rand [3]
|
|
. T . T Rand Rand Rand [2]
|
|
. T . . Rand Rand Rand [2]
|
|
. . T T 2 3 EOPL
|
|
. . T . 2 3 EOPL
|
|
. . . T 2 3 EOPL
|
|
. . . . 2 3 EOPL
|
|
====== ====== ====== ======= ===== ===== ===== =====
|
|
|
|
- When end of playlist (EOPL) is reached, the current track is
|
|
unset.
|
|
- [1] When *random* and *single* is combined, ``next`` selects
|
|
a track randomly at each invocation, and not just the next track
|
|
in an internal prerandomized playlist.
|
|
- [2] When *random* is active, ``next`` will skip through
|
|
all tracks in the playlist in random order, and finally EOPL is
|
|
reached.
|
|
- [3] *single* has no effect in combination with *random*
|
|
alone, or *random* and *consume*.
|
|
- [4] When *random* and *repeat* is active, EOPL is never
|
|
reached, but the playlist is played again, in the same random
|
|
order as the first time.
|
|
|
|
"""
|
|
return context.core.playback.next().get()
|
|
|
|
|
|
@protocol.commands.add('pause', state=protocol.BOOL)
|
|
def pause(context, state=None):
|
|
"""
|
|
*musicpd.org, playback section:*
|
|
|
|
``pause {PAUSE}``
|
|
|
|
Toggles pause/resumes playing, ``PAUSE`` is 0 or 1.
|
|
|
|
*MPDroid:*
|
|
|
|
- Calls ``pause`` without any arguments to toogle pause.
|
|
"""
|
|
if state is None:
|
|
warnings.warn(
|
|
'The use of pause command w/o the PAUSE argument is deprecated.',
|
|
DeprecationWarning)
|
|
|
|
if (context.core.playback.state.get() == PlaybackState.PLAYING):
|
|
context.core.playback.pause()
|
|
elif (context.core.playback.state.get() == PlaybackState.PAUSED):
|
|
context.core.playback.resume()
|
|
elif state:
|
|
context.core.playback.pause()
|
|
else:
|
|
context.core.playback.resume()
|
|
|
|
|
|
@protocol.commands.add('play', tlid=protocol.INT)
|
|
def play(context, tlid=None):
|
|
"""
|
|
*musicpd.org, playback section:*
|
|
|
|
``play [SONGPOS]``
|
|
|
|
Begins playing the playlist at song number ``SONGPOS``.
|
|
|
|
The original MPD server resumes from the paused state on ``play``
|
|
without arguments.
|
|
|
|
*Clarifications:*
|
|
|
|
- ``play "-1"`` when playing is ignored.
|
|
- ``play "-1"`` when paused resumes playback.
|
|
- ``play "-1"`` when stopped with a current track starts playback at the
|
|
current track.
|
|
- ``play "-1"`` when stopped without a current track, e.g. after playlist
|
|
replacement, starts playback at the first track.
|
|
|
|
*BitMPC:*
|
|
|
|
- issues ``play 6`` without quotes around the argument.
|
|
"""
|
|
if tlid is None:
|
|
return context.core.playback.play().get()
|
|
elif tlid == -1:
|
|
return _play_minus_one(context)
|
|
|
|
try:
|
|
tl_track = context.core.tracklist.slice(tlid, tlid + 1).get()[0]
|
|
return context.core.playback.play(tl_track).get()
|
|
except IndexError:
|
|
raise exceptions.MpdArgError('Bad song index')
|
|
|
|
|
|
def _play_minus_one(context):
|
|
if (context.core.playback.state.get() == PlaybackState.PLAYING):
|
|
return # Nothing to do
|
|
elif (context.core.playback.state.get() == PlaybackState.PAUSED):
|
|
return context.core.playback.resume().get()
|
|
elif context.core.playback.current_tl_track.get() is not None:
|
|
tl_track = context.core.playback.current_tl_track.get()
|
|
return context.core.playback.play(tl_track).get()
|
|
elif context.core.tracklist.slice(0, 1).get():
|
|
tl_track = context.core.tracklist.slice(0, 1).get()[0]
|
|
return context.core.playback.play(tl_track).get()
|
|
else:
|
|
return # Fail silently
|
|
|
|
|
|
@protocol.commands.add('playid', tlid=protocol.INT)
|
|
def playid(context, tlid):
|
|
"""
|
|
*musicpd.org, playback section:*
|
|
|
|
``playid [SONGID]``
|
|
|
|
Begins playing the playlist at song ``SONGID``.
|
|
|
|
*Clarifications:*
|
|
|
|
- ``playid "-1"`` when playing is ignored.
|
|
- ``playid "-1"`` when paused resumes playback.
|
|
- ``playid "-1"`` when stopped with a current track starts playback at the
|
|
current track.
|
|
- ``playid "-1"`` when stopped without a current track, e.g. after playlist
|
|
replacement, starts playback at the first track.
|
|
"""
|
|
if tlid == -1:
|
|
return _play_minus_one(context)
|
|
tl_tracks = context.core.tracklist.filter(tlid=[tlid]).get()
|
|
if not tl_tracks:
|
|
raise exceptions.MpdNoExistError('No such song')
|
|
return context.core.playback.play(tl_tracks[0]).get()
|
|
|
|
|
|
@protocol.commands.add('previous')
|
|
def previous(context):
|
|
"""
|
|
*musicpd.org, playback section:*
|
|
|
|
``previous``
|
|
|
|
Plays previous song in the playlist.
|
|
|
|
*MPD's behaviour when affected by repeat/random/single/consume:*
|
|
|
|
Given a playlist of three tracks numbered 1, 2, 3, and a currently
|
|
playing track ``c``. ``previous_track`` is defined at the track
|
|
that will be played upon ``previous`` calls.
|
|
|
|
Tests performed on MPD 0.15.4-1ubuntu3.
|
|
|
|
====== ====== ====== ======= ===== ===== =====
|
|
Inputs previous_track
|
|
------------------------------- -------------------
|
|
repeat random single consume c = 1 c = 2 c = 3
|
|
====== ====== ====== ======= ===== ===== =====
|
|
T T T T Rand? Rand? Rand?
|
|
T T T . 3 1 2
|
|
T T . T Rand? Rand? Rand?
|
|
T T . . 3 1 2
|
|
T . T T 3 1 2
|
|
T . T . 3 1 2
|
|
T . . T 3 1 2
|
|
T . . . 3 1 2
|
|
. T T T c c c
|
|
. T T . c c c
|
|
. T . T c c c
|
|
. T . . c c c
|
|
. . T T 1 1 2
|
|
. . T . 1 1 2
|
|
. . . T 1 1 2
|
|
. . . . 1 1 2
|
|
====== ====== ====== ======= ===== ===== =====
|
|
|
|
- If :attr:`time_position` of the current track is 15s or more,
|
|
``previous`` should do a seek to time position 0.
|
|
|
|
"""
|
|
return context.core.playback.previous().get()
|
|
|
|
|
|
@protocol.commands.add('random', state=protocol.BOOL)
|
|
def random(context, state):
|
|
"""
|
|
*musicpd.org, playback section:*
|
|
|
|
``random {STATE}``
|
|
|
|
Sets random state to ``STATE``, ``STATE`` should be 0 or 1.
|
|
"""
|
|
context.core.tracklist.random = state
|
|
|
|
|
|
@protocol.commands.add('repeat', state=protocol.BOOL)
|
|
def repeat(context, state):
|
|
"""
|
|
*musicpd.org, playback section:*
|
|
|
|
``repeat {STATE}``
|
|
|
|
Sets repeat state to ``STATE``, ``STATE`` should be 0 or 1.
|
|
"""
|
|
context.core.tracklist.repeat = state
|
|
|
|
|
|
@protocol.commands.add('replay_gain_mode')
|
|
def replay_gain_mode(context, mode):
|
|
"""
|
|
*musicpd.org, playback section:*
|
|
|
|
``replay_gain_mode {MODE}``
|
|
|
|
Sets the replay gain mode. One of ``off``, ``track``, ``album``.
|
|
|
|
Changing the mode during playback may take several seconds, because
|
|
the new settings does not affect the buffered data.
|
|
|
|
This command triggers the options idle event.
|
|
"""
|
|
raise exceptions.MpdNotImplemented # TODO
|
|
|
|
|
|
@protocol.commands.add('replay_gain_status')
|
|
def replay_gain_status(context):
|
|
"""
|
|
*musicpd.org, playback section:*
|
|
|
|
``replay_gain_status``
|
|
|
|
Prints replay gain options. Currently, only the variable
|
|
``replay_gain_mode`` is returned.
|
|
"""
|
|
return 'off' # TODO
|
|
|
|
|
|
@protocol.commands.add('seek', tlid=protocol.UINT, seconds=protocol.UINT)
|
|
def seek(context, tlid, seconds):
|
|
"""
|
|
*musicpd.org, playback section:*
|
|
|
|
``seek {SONGPOS} {TIME}``
|
|
|
|
Seeks to the position ``TIME`` (in seconds) of entry ``SONGPOS`` in
|
|
the playlist.
|
|
|
|
*Droid MPD:*
|
|
|
|
- issues ``seek 1 120`` without quotes around the arguments.
|
|
"""
|
|
tl_track = context.core.playback.current_tl_track.get()
|
|
if context.core.tracklist.index(tl_track).get() != tlid:
|
|
play(context, tlid)
|
|
context.core.playback.seek(seconds * 1000).get()
|
|
|
|
|
|
@protocol.commands.add('seekid', tlid=protocol.UINT, seconds=protocol.UINT)
|
|
def seekid(context, tlid, seconds):
|
|
"""
|
|
*musicpd.org, playback section:*
|
|
|
|
``seekid {SONGID} {TIME}``
|
|
|
|
Seeks to the position ``TIME`` (in seconds) of song ``SONGID``.
|
|
"""
|
|
tl_track = context.core.playback.current_tl_track.get()
|
|
if not tl_track or tl_track.tlid != tlid:
|
|
playid(context, tlid)
|
|
context.core.playback.seek(seconds * 1000).get()
|
|
|
|
|
|
@protocol.commands.add('seekcur')
|
|
def seekcur(context, time):
|
|
"""
|
|
*musicpd.org, playback section:*
|
|
|
|
``seekcur {TIME}``
|
|
|
|
Seeks to the position ``TIME`` within the current song. If prefixed by
|
|
'+' or '-', then the time is relative to the current playing position.
|
|
"""
|
|
if time.startswith(('+', '-')):
|
|
position = context.core.playback.time_position.get()
|
|
position += protocol.INT(time) * 1000
|
|
context.core.playback.seek(position).get()
|
|
else:
|
|
position = protocol.UINT(time) * 1000
|
|
context.core.playback.seek(position).get()
|
|
|
|
|
|
@protocol.commands.add('setvol', volume=protocol.INT)
|
|
def setvol(context, volume):
|
|
"""
|
|
*musicpd.org, playback section:*
|
|
|
|
``setvol {VOL}``
|
|
|
|
Sets volume to ``VOL``, the range of volume is 0-100.
|
|
|
|
*Droid MPD:*
|
|
|
|
- issues ``setvol 50`` without quotes around the argument.
|
|
"""
|
|
# NOTE: we use INT as clients can pass in +N etc.
|
|
context.core.playback.volume = min(max(0, volume), 100)
|
|
|
|
|
|
@protocol.commands.add('single', state=protocol.BOOL)
|
|
def single(context, state):
|
|
"""
|
|
*musicpd.org, playback section:*
|
|
|
|
``single {STATE}``
|
|
|
|
Sets single state to ``STATE``, ``STATE`` should be 0 or 1. When
|
|
single is activated, playback is stopped after current song, or
|
|
song is repeated if the ``repeat`` mode is enabled.
|
|
"""
|
|
context.core.tracklist.single = state
|
|
|
|
|
|
@protocol.commands.add('stop')
|
|
def stop(context):
|
|
"""
|
|
*musicpd.org, playback section:*
|
|
|
|
``stop``
|
|
|
|
Stops playing.
|
|
"""
|
|
context.core.playback.stop()
|