Add clipboard support

DOCS/man/input.rst

@@ -402,6 +402,12 @@ Remember to quote string arguments in input.conf (see `Flat command syntax`_).
     Like all input command parameters, the filename is subject to property
     expansion as described in `Property Expansion`_.
 
+``screenshot-to-clipboard [<flags>]``
+    Take a screenshot and save it to the system clipboard.
+
+    The ``flags`` argument is like the first argument to ``screenshot`` and
+    supports ``subtitles``, ``video``, ``window``.
+
 ``playlist-next <flags>``
     Go to the next entry on the playlist.
 
@@ -3573,6 +3579,35 @@ Property list
 ``current-ao``
     Current audio output driver (name as used with ``--ao``).
 
+``clipboard`` (RW)
+    Access to the system clipboard as a key/value map of types and data.
+
+    Sub-paths can be accessed directly; e.g. ``clipboard/text`` can be read, written,
+    or observed.
+
+    Writing a string to the root ``clipboard`` property will write to the text clipboard
+    as a shortcut.
+
+    Converting this property to a string will give a JSON representation of all types.
+    Unset types will be null.
+
+    Writing to one type may cause other types to also be updated.
+
+    Currently, the following types are available:
+
+    ``text``
+        Arbitrary plain text
+
+    ``url``
+        A URL; if ``path`` is populated, this will be a corresponding file:// URL
+
+    ``paths``
+        A list of absolute paths to files on disk.
+
+    ``path``
+        A single absolute path to a file on disk.
+        Exposed for convenience and not included in the top-level map.
+
 ``user-data`` (RW)
     This is a recursive key/value map of arbitrary nodes shared between clients for
     general use (i.e. scripts, IPC clients, host applications, etc).

meson.build

@@ -405,7 +405,8 @@ cocoa = dependency('appleframeworks', modules: ['Cocoa', 'IOKit', 'QuartzCore'],
 features += {'cocoa': cocoa.found()}
 if features['cocoa']
     dependencies += cocoa
-    sources += files('osdep/language-mac.c',
+    sources += files('osdep/clipboard-mac.m',
+                     'osdep/language-mac.c',
                      'osdep/path-mac.m',
                      'osdep/utils-mac.c',
                      'osdep/mac/app_bridge.m')
@@ -540,6 +541,10 @@ else
     features += {'win32-smtc': false}
 endif
 
+if not features['cocoa']
+    sources += files('osdep/clipboard-dummy.c')
+endif
+
 features += {'glob-posix': cc.has_function('glob', prefix: '#include <glob.h>')}
 
 features += {'glob-win32': win32 and not features['glob-posix']}

osdep/clipboard-dummy.c

@@ -0,0 +1,35 @@
+/*
+ * Dummy implementations of clipboard access routines
+ *
+ * This file is part of mpv.
+ *
+ * mpv is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU Lesser General Public
+ * License as published by the Free Software Foundation; either
+ * version 2.1 of the License, or (at your option) any later version.
+ *
+ * mpv is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public
+ * License along with mpv.  If not, see <http://www.gnu.org/licenses/>.
+ */
+
+#include "clipboard.h"
+
+int m_clipboard_set(struct MPContext *ctx, const struct m_clipboard_item* item)
+{
+    return CLIPBOARD_FAILED;
+}
+
+int m_clipboard_get(struct MPContext *ctx, struct m_clipboard_item* item)
+{
+    return CLIPBOARD_FAILED;
+}
+
+bool m_clipboard_poll(struct MPContext *ctx)
+{
+    return false;
+}