summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorwm4 <wm4@nowhere>2014-02-05 19:01:06 +0100
committerwm4 <wm4@nowhere>2014-02-12 22:32:04 +0100
commitf99f48684b535d4f3fedc1f4a9077b012fa79727 (patch)
tree1a567c0f25533e46bdb452d64b992a81f773fd11
parent25864a5539447227ca8a5ba3ca8b440e67b04c07 (diff)
downloadmpv-f99f48684b535d4f3fedc1f4a9077b012fa79727.tar.bz2
mpv-f99f48684b535d4f3fedc1f4a9077b012fa79727.tar.xz
umpv: improve description
-rwxr-xr-xTOOLS/umpv20
1 files changed, 11 insertions, 9 deletions
diff --git a/TOOLS/umpv b/TOOLS/umpv
index 892221f8d1..162b4de467 100755
--- a/TOOLS/umpv
+++ b/TOOLS/umpv
@@ -3,15 +3,14 @@
"""
This script emulates "unique application" functionality on Linux. When starting
playback with this script, it will try to reuse an already running instance of
-mpv (but only if that was started with umpv).
+mpv (but only if that was started with umpv). Other mpv instances (not started
+by umpv) are ignored, and the script doesn't know about them.
-This script only uses mpv instances started with umpv. Other instances are
-ignored, and don't exist for the script.
-
-This only takes filenames as arguments. If mpv is already running, they are
-appended to mpv's internal playlist. If the file does not exist or is otherwise
-not playable, mpv will skip the playlist entry when attempting to play it (from
-the GUI perspective, it's silently ignored).
+This only takes filenames as arguments. Custom options can't be used; the script
+interprets them as filenames. If mpv is already running, the files passed to
+umpv are appended to mpv's internal playlist. If a file does not exist or is
+otherwise not playable, mpv will skip the playlist entry when attempting to
+play it (from the GUI perspective, it's silently ignored).
If mpv isn't running yet, this script will start mpv and let it control the
current terminal.
@@ -26,7 +25,10 @@ Note that you can control the mpv instance by writing to the command fifo:
Warning:
The script attempts to make sure the FIFO is safely created (i.e. not world-
-readable, not trying to open a bogus
+writable), and checks that it's really a FIFO. This is important for security,
+because the FIFO allows anyone with write access to run arbitrary commands
+in mpv's context using the "run" input command. If you are worried about
+security, you should verify that the code handles these concerns correctly.
"""
import sys