Next: , Previous: , Up: Emacspeak Commands And Options   [Contents][Index]


12.116 emacspeak-m-player

Defines an Emacspeak front-end for interacting with mplayer. Program mplayer is a versatile media player capable of playing many streaming media formats. This module provides complete access to all mplayer functionality from a convenient Emacs interface.

12.116.1 Usage

The main entry-point is command emacspeak-multimedia bound to C-e ;. This prompts for and launches the desired media stream. Once a stream is playing, you can control it with single-letter keystrokes in the *M-Player* buffer. Alternatively, you can switch away from that buffer to do real work, And invoke m-player commands by first pressing C-e ;. As an example, pressing v in the *M-Player* buffer prompts for and sets the volume; When not in the *M-Player* buffer, you can achieve the same by pressing C-e ; v. Press C-h b in the *M-Player* buffer to list m-player keybindings.

12.116.2 emacspeak-m-player Commands

12.116.2.1 emacspeak-m-player

Command: emacspeak-m-player (resource &optional play-list)
        Play specified resource using m-player.  Optional prefix argument
play-list interprets resource as a play-list.  Second interactive
prefix arg adds option -allow-dangerous-playlist-parsing to mplayer.
Resource is a media resource or playlist containing media resources.
The player is placed in a buffer in emacspeak-m-player-mode.

(fn RESOURCE &optional PLAY-LIST)

12.116.2.2 emacspeak-m-player-add-autopan

Command: emacspeak-m-player-add-autopan
Add predefined autopan effect.

12.116.2.3 emacspeak-m-player-add-equalizer

Command: emacspeak-m-player-add-equalizer (&optional reset)
        Add equalizer to playing stream.  Equalizer is updated as each change
is made, and the final effect set by pressing RET.  Interactive prefix
arg ‘reset’ starts with all filters set to 0.

(fn &optional RESET)

12.116.2.4 emacspeak-m-player-add-filter

Command: emacspeak-m-player-add-filter (filter-name &optional edit)
        Adds specified filter. Prompts with one of several pre-defined
filters. Optional interactive prefix arg ‘edit’ enables editing the
selected filter before it is applied.

(fn FILTER-NAME &optional EDIT)

12.116.2.5 emacspeak-m-player-add-ladspa

Command: emacspeak-m-player-add-ladspa
Apply plugin to running MPlayer.

12.116.2.6 emacspeak-m-player-alt-src-step

Command: emacspeak-m-player-alt-src-step (step)
Move within an ASF playlist.

(fn STEP)

12.116.2.7 emacspeak-m-player-amark-add

Command: emacspeak-m-player-amark-add (name &optional prompt-position)
        Set AMark ‘name’ at current position in current audio stream.
Interactive prefix arg prompts for position.
As the default, use current position.

(fn NAME &optional PROMPT-POSITION)

12.116.2.8 emacspeak-m-player-amark-jump

Command: emacspeak-m-player-amark-jump
Jump to specified AMark.

12.116.2.9 emacspeak-m-player-apply-reverb-preset

Command: emacspeak-m-player-apply-reverb-preset (preset)
        Prompt for a predefined reverb preset and apply it.
You need to use mplayer built with ladspa support, and have package
tap-reverb already installed.

(fn PRESET)

12.116.2.10 emacspeak-m-player-backward-10min

Command: emacspeak-m-player-backward-10min
Move backward by ten minutes.

12.116.2.11 emacspeak-m-player-backward-10s

Command: emacspeak-m-player-backward-10s
Move back by 10 seconds.

12.116.2.12 emacspeak-m-player-backward-1min

Command: emacspeak-m-player-backward-1min
Move back by 1 minute.

12.116.2.13 emacspeak-m-player-balance

Command: emacspeak-m-player-balance
Set left/right balance.

12.116.2.14 emacspeak-m-player-beginning-of-track

Command: emacspeak-m-player-beginning-of-track
Move to beginning of track.

12.116.2.15 emacspeak-m-player-bind-accelerator

Command: emacspeak-m-player-bind-accelerator (directory key)
        Binds key to invoke m-player  on specified directory.

(fn DIRECTORY KEY)

12.116.2.16 emacspeak-m-player-clear-filters

Command: emacspeak-m-player-clear-filters
Clear all active filters

12.116.2.17 emacspeak-m-player-command

Command: emacspeak-m-player-command (key)
Invoke MPlayer commands.

(fn KEY)

12.116.2.18 emacspeak-m-player-customize-options

Command: emacspeak-m-player-customize-options
        Use Customize to manipulate MPlayer options.

12.116.2.19 emacspeak-m-player-delete-filter

Command: emacspeak-m-player-delete-filter (filter)
Delete filter.

(fn FILTER)

12.116.2.20 emacspeak-m-player-delete-ladspa

Command: emacspeak-m-player-delete-ladspa
Delete plugin from  running MPlayer.

12.116.2.21 emacspeak-m-player-display-metadata

Command: emacspeak-m-player-display-metadata
        Display metadata after refreshing it if needed.

12.116.2.22 emacspeak-m-player-display-percent

Command: emacspeak-m-player-display-percent
Display current percentage.

12.116.2.23 emacspeak-m-player-display-position

Command: emacspeak-m-player-display-position
        Display current position in track and its length.

12.116.2.24 emacspeak-m-player-double-speed

Command: emacspeak-m-player-double-speed
Scale speed by 2.0

12.116.2.25 emacspeak-m-player-edit-reverb

Command: emacspeak-m-player-edit-reverb
Edit  current ladspa reverb filter.
See option emacspeak-m-player-reverb-filter to customize reverb filter values.
You need to use mplayer built with ladspa support, and have package
tap-reverb already installed.

12.116.2.26 emacspeak-m-player-end-of-track

Command: emacspeak-m-player-end-of-track
Move to beginning of track.

12.116.2.27 emacspeak-m-player-equalizer-control

Command: emacspeak-m-player-equalizer-control (v)
        Manipulate values in specified vector using minibuffer.
Applies  the resulting value at each step.

(fn V)

12.116.2.28 emacspeak-m-player-equalizer-preset

Command: emacspeak-m-player-equalizer-preset (name)
        Prompts for  equalizer preset and applies it to current stream.

The following presets are available:
 
flat classical club dance full-bass full-bass-and-treble
 full-treble headphones large-hall live party pop reggae rock
 ska soft soft-rock techno 

(fn NAME)

12.116.2.29 emacspeak-m-player-faster

Command: emacspeak-m-player-faster
Speed up  playback.
This affects pitch.

12.116.2.30 emacspeak-m-player-forward-10min

Command: emacspeak-m-player-forward-10min
Move forward by ten minutes.

12.116.2.31 emacspeak-m-player-forward-10s

Command: emacspeak-m-player-forward-10s
Move forward by 10 seconds.

12.116.2.32 emacspeak-m-player-forward-1min

Command: emacspeak-m-player-forward-1min
Move forward by 1 minute.

12.116.2.33 emacspeak-m-player-from-media-history

Command: emacspeak-m-player-from-media-history (posn)
C-. h
C-' h
C-x @ s h
Play media from media-history.
Numeric arg ‘posn’ specifies position in history.

(fn POSN)

12.116.2.34 emacspeak-m-player-get-length

Command: emacspeak-m-player-get-length
Display length of track in seconds.

12.116.2.35 emacspeak-m-player-half-speed

Command: emacspeak-m-player-half-speed
Scale speed by 0.5.

12.116.2.36 emacspeak-m-player-left-channel

Command: emacspeak-m-player-left-channel
Play both channels on left channel.

12.116.2.37 emacspeak-m-player-load

Command: emacspeak-m-player-load (resource &optional append)
        Load specified resource into a running  m-player.
Interactive prefix arg appends the new resource to what is playing.

(fn RESOURCE &optional APPEND)

12.116.2.38 emacspeak-m-player-load-file

Command: emacspeak-m-player-load-file (f)
Load specified file.

(fn F)

12.116.2.39 emacspeak-m-player-load-playlist

Command: emacspeak-m-player-load-playlist (f)
Load specified playlist file.

(fn F)

12.116.2.40 emacspeak-m-player-locate-media

Command: emacspeak-m-player-locate-media (pattern)
C-. l
C-' l
C-x @ s l
        Locate media matching specified pattern.  The results can be
played as a play-list by pressing [RET] on the first line.
Pattern is first converted to a regexp that accepts common
punctuation separators (-,._’") in place of white-space.
Results are placed in a Locate buffer and can be played using
M-Player — use M-x emacspeak-dired-open-this-file locally bound to C-RET 
to play individual tracks.

(fn PATTERN)

12.116.2.41 emacspeak-m-player-mode

Command: emacspeak-m-player-mode
Major mode for m-player interaction. 

key             binding
—             ——-

C-l             ladspa
RET             emacspeak-m-player-load
ESC             Prefix Command
SPC             emacspeak-m-player-pause
%               emacspeak-m-player-display-percent
(               emacspeak-m-player-left-channel
)               emacspeak-m-player-right-channel
+               emacspeak-m-player-volume-up
,               emacspeak-m-player-backward-10s
-               emacspeak-m-player-volume-down
.               emacspeak-m-player-forward-10s
/               emacspeak-m-player-restore-process
1 .. 9          emacspeak-m-player-volume-set
;               emacspeak-m-player-pop-to-player
<            emacspeak-m-player-backward-1min
=               emacspeak-m-player-volume-up
>            emacspeak-m-player-forward-1min
?               emacspeak-m-player-display-position
A               emacspeak-m-player-amark-add
C               emacspeak-m-player-clear-filters
E               emacspeak-m-player-add-equalizer
G               emacspeak-m-player-seek-percentage
L               emacspeak-m-player-locate-media
M               emacspeak-m-player-display-metadata
O               emacspeak-m-player-reset-options
P               emacspeak-m-player-apply-reverb-preset
Q               emacspeak-m-player-quit
R               emacspeak-m-player-edit-reverb
S               emacspeak-amark-save
[               emacspeak-m-player-slower
\               emacspeak-m-player-persist-process
]               emacspeak-m-player-faster
a               emacspeak-m-player-add-autopan
b               emacspeak-wizards-view-buffers-filtered-by-m-player-mode
c               emacspeak-m-player-slave-command
d               emacspeak-m-player-delete-filter
e               emacspeak-m-player-equalizer-preset
f               emacspeak-m-player-add-filter
g               emacspeak-m-player-seek-absolute
i               emacspeak-m-player-stream-info
j               emacspeak-m-player-amark-jump
k               emacspeak-m-player-quit
l               emacspeak-m-player-get-length
m               emacspeak-m-player-speak-mode-line
n               emacspeak-m-player-next-track
o               emacspeak-m-player-customize-options
p               emacspeak-m-player-previous-track
q               bury-buffer
r               emacspeak-m-player-seek-relative
s               emacspeak-m-player-scale-speed
t               emacspeak-m-player-play-tracks-jump
u               emacspeak-m-player-url
v               emacspeak-m-player-volume-change
w               emacspeak-m-player-write-clip
x               emacspeak-m-player-pan
{               emacspeak-m-player-half-speed
}               emacspeak-m-player-double-speed
DEL             emacspeak-m-player-reset-speed
<down>            emacspeak-m-player-forward-1min
<end>             emacspeak-m-player-end-of-track
<home>            emacspeak-m-player-beginning-of-track
<left>            emacspeak-m-player-backward-10s
<next>            emacspeak-m-player-forward-10min
<prior>           emacspeak-m-player-backward-10min
<right>           emacspeak-m-player-forward-10s
<up>              emacspeak-m-player-backward-1min

M-,             emacspeak-m-player-set-clip-start
M-.             emacspeak-m-player-set-clip-end
M-l             emacspeak-m-player-load-playlist

In addition to any hooks its parent mode ‘comint-mode’ might have run,
this mode runs the hook ‘emacspeak-m-player-mode-hook’, as the final or penultimate step
during initialization.

12.116.2.42 emacspeak-m-player-next-track

Command: emacspeak-m-player-next-track
Move to next track.

12.116.2.43 emacspeak-m-player-pan

Command: emacspeak-m-player-pan
        Pan from left to right   and back from right to left one step at a time.

12.116.2.44 emacspeak-m-player-pause

Command: emacspeak-m-player-pause
Pause or unpause media player.

12.116.2.45 emacspeak-m-player-persist-process

Command: emacspeak-m-player-persist-process (&optional name)
        Persists current m-player process instance by renaming its buffer.
Optional interactive prefix arg prompts for name to use for  player.

(fn &optional NAME)

12.116.2.46 emacspeak-m-player-play-rss

Command: emacspeak-m-player-play-rss (rss-url)
        Play an RSS stream by converting to  an M3U playlist.

(fn RSS-URL)

12.116.2.47 emacspeak-m-player-play-tracks-jump

Command: emacspeak-m-player-play-tracks-jump (step)
Move within the play tree.

(fn STEP)

12.116.2.48 emacspeak-m-player-play-tree-up

Command: emacspeak-m-player-play-tree-up (step)
Move within the play tree.

(fn STEP)

12.116.2.49 emacspeak-m-player-pop-to-player

Command: emacspeak-m-player-pop-to-player
Pop to m-player buffer.

12.116.2.50 emacspeak-m-player-previous-track

Command: emacspeak-m-player-previous-track
Move to previous track.

12.116.2.51 emacspeak-m-player-quit

Command: emacspeak-m-player-quit
Quit media player.

12.116.2.52 emacspeak-m-player-reset-options

Command: emacspeak-m-player-reset-options
        Reset MPlayer options to initial defaults.

12.116.2.53 emacspeak-m-player-reset-speed

Command: emacspeak-m-player-reset-speed
Reset playing speed to normal.

12.116.2.54 emacspeak-m-player-restore-process

Command: emacspeak-m-player-restore-process
        Restore emacspeak-m-player-process from current buffer.
Check first if current buffer is in emacspeak-m-player-mode.

12.116.2.55 emacspeak-m-player-right-channel

Command: emacspeak-m-player-right-channel
Play on right channel.

12.116.2.56 emacspeak-m-player-scale-speed

Command: emacspeak-m-player-scale-speed (factor)
Scale speed by specified factor.

(fn FACTOR)

12.116.2.57 emacspeak-m-player-seek-absolute

Command: emacspeak-m-player-seek-absolute (pos)
        Seek  to absolute specified pos in seconds.

(fn POS)

12.116.2.58 emacspeak-m-player-seek-percentage

Command: emacspeak-m-player-seek-percentage (pos)
        Seek  to absolute specified pos in percent.

(fn POS)

12.116.2.59 emacspeak-m-player-seek-relative

Command: emacspeak-m-player-seek-relative (offset)
        Seek  by offset into stream from current position.

(fn OFFSET)

12.116.2.60 emacspeak-m-player-set-clip-end

Command: emacspeak-m-player-set-clip-end
Set end of clip marker.

12.116.2.61 emacspeak-m-player-set-clip-start

Command: emacspeak-m-player-set-clip-start
Set start of clip marker.

12.116.2.62 emacspeak-m-player-shuffle

Command: emacspeak-m-player-shuffle
C-e :
<fn> :
Launch M-Player with shuffle turned on.

12.116.2.63 emacspeak-m-player-slave-command

Command: emacspeak-m-player-slave-command (command)
        Dispatch slave command read from minibuffer.

(fn COMMAND)

12.116.2.64 emacspeak-m-player-slower

Command: emacspeak-m-player-slower
Slow down playback.
This affects pitch.

12.116.2.65 emacspeak-m-player-speak-mode-line

Command: emacspeak-m-player-speak-mode-line
Speak mode line

12.116.2.66 emacspeak-m-player-stream-info

Command: emacspeak-m-player-stream-info (&optional toggle-cue)
        Speak and display metadata if available.
Interactive prefix arg toggles automatic cueing of ICY info updates.

(fn &optional TOGGLE-CUE)

12.116.2.67 emacspeak-m-player-url

Command: emacspeak-m-player-url (url &optional playlist-p)
C-, u
C-x @ a u
        Call emacspeak-m-player with specified URL.

(fn URL &optional PLAYLIST-P)

12.116.2.68 emacspeak-m-player-using-hrtf

Command: emacspeak-m-player-using-hrtf
C-; '
C-x @ h '
        Add af resample=48000,hrtf to startup options.
This will work if the soundcard is set to 48000.

12.116.2.69 emacspeak-m-player-using-openal

Command: emacspeak-m-player-using-openal (resource &optional play-list)
C-; ;
C-x @ h ;
        Use openal as the audio output driver. Adding hrtf=true to
~/.alsoftrc gives HRTF. You need to have openal installed and have an
mplayer that has been compiled with openal support to use this
feature. Calling spec is like ‘emacspeak-m-player’.

(fn RESOURCE &optional PLAY-LIST)

12.116.2.70 emacspeak-m-player-volume-change

Command: emacspeak-m-player-volume-change (value)
        Change volume to specified absolute value.

(fn VALUE)

12.116.2.71 emacspeak-m-player-volume-down

Command: emacspeak-m-player-volume-down
Decrease volume.

12.116.2.72 emacspeak-m-player-volume-set

Command: emacspeak-m-player-volume-set (&optional arg)
Set Volume in steps from 1 to 9.

(fn &optional ARG)

12.116.2.73 emacspeak-m-player-volume-up

Command: emacspeak-m-player-volume-up
Increase volume.

12.116.2.74 emacspeak-m-player-write-clip

Command: emacspeak-m-player-write-clip
        Invoke mp3splt to clip selected range in current file.

12.116.2.75 emacspeak-m-player-youtube-player

Command: emacspeak-m-player-youtube-player (url)
C-, y
C-x @ a y
        Use youtube-dl and mplayer to stream the audio for YouTube content.

(fn URL)

12.116.2.76 emacspeak-multimedia

Command: emacspeak-multimedia
C-e ;
<fn> ;
        Start or control Emacspeak multimedia player.

Uses current context to prompt for media to play.
Controls media playback when already playing a stream.

key             binding
—             ——-

C-l             ladspa
RET             emacspeak-m-player-load
ESC             Prefix Command
SPC             emacspeak-m-player-pause
%               emacspeak-m-player-display-percent
(               emacspeak-m-player-left-channel
)               emacspeak-m-player-right-channel
+               emacspeak-m-player-volume-up
,               emacspeak-m-player-backward-10s
-               emacspeak-m-player-volume-down
.               emacspeak-m-player-forward-10s
/               emacspeak-m-player-restore-process
1 .. 9          emacspeak-m-player-volume-set
;               emacspeak-m-player-pop-to-player
<            emacspeak-m-player-backward-1min
=               emacspeak-m-player-volume-up
>            emacspeak-m-player-forward-1min
?               emacspeak-m-player-display-position
A               emacspeak-m-player-amark-add
C               emacspeak-m-player-clear-filters
E               emacspeak-m-player-add-equalizer
G               emacspeak-m-player-seek-percentage
L               emacspeak-m-player-locate-media
M               emacspeak-m-player-display-metadata
O               emacspeak-m-player-reset-options
P               emacspeak-m-player-apply-reverb-preset
Q               emacspeak-m-player-quit
R               emacspeak-m-player-edit-reverb
S               emacspeak-amark-save
[               emacspeak-m-player-slower
\               emacspeak-m-player-persist-process
]               emacspeak-m-player-faster
a               emacspeak-m-player-add-autopan
b               emacspeak-wizards-view-buffers-filtered-by-m-player-mode
c               emacspeak-m-player-slave-command
d               emacspeak-m-player-delete-filter
e               emacspeak-m-player-equalizer-preset
f               emacspeak-m-player-add-filter
g               emacspeak-m-player-seek-absolute
i               emacspeak-m-player-stream-info
j               emacspeak-m-player-amark-jump
k               emacspeak-m-player-quit
l               emacspeak-m-player-get-length
m               emacspeak-m-player-speak-mode-line
n               emacspeak-m-player-next-track
o               emacspeak-m-player-customize-options
p               emacspeak-m-player-previous-track
q               bury-buffer
r               emacspeak-m-player-seek-relative
s               emacspeak-m-player-scale-speed
t               emacspeak-m-player-play-tracks-jump
u               emacspeak-m-player-url
v               emacspeak-m-player-volume-change
w               emacspeak-m-player-write-clip
x               emacspeak-m-player-pan
{               emacspeak-m-player-half-speed
}               emacspeak-m-player-double-speed
DEL             emacspeak-m-player-reset-speed
<down>            emacspeak-m-player-forward-1min
<end>             emacspeak-m-player-end-of-track
<home>            emacspeak-m-player-beginning-of-track
<left>            emacspeak-m-player-backward-10s
<next>            emacspeak-m-player-forward-10min
<prior>           emacspeak-m-player-backward-10min
<right>           emacspeak-m-player-forward-10s
<up>              emacspeak-m-player-backward-1min

M-,             emacspeak-m-player-set-clip-start
M-.             emacspeak-m-player-set-clip-end
M-l             emacspeak-m-player-load-playlist

.

12.116.3 emacspeak-m-player Options

Variable: User Option emacspeak-m-player-options

Options passed to mplayer.

Variable: User Option emacspeak-m-player-program

Media player program.

Variable: User Option emacspeak-m-player-recent-amark-name

Name used to mark position where we quit a stream.

Variable: User Option emacspeak-m-player-reverb-filter

Tap Reverb Settings.

Variable: User Option emacspeak-m-player-youtube-dl

YouTube download tool

Variable: User Option emacspeak-media-location-bindings

*Map specific key sequences to launching MPlayer accelerators on a specific directory.


Next: , Previous: , Up: Emacspeak Commands And Options   [Contents][Index]