Move to fully FORMAT_NODE-based API

This will break lots of stuff.
* Use MPV_FORMAT_NODE mostly everywhere
* Dynamically discover properties instead of using a static list
* Modify encoding handling to be more versatile

1 files changed, 145 insertions, 325 deletions

diff --git a/mpv.py b/mpv.py
index ae200e2..27af879 100644
--- a/mpv.py
+++ b/mpv.py
@@ -170,34 +170,49 @@ class MpvEventID(c_int):
         return getattr(kls, s.upper().replace('-', '_'))
 
 
+identity_decoder = lambda b: b
+strict_decoder = lambda b: b.decode('utf-8')
+def lazy_decoder(b):
+    try:
+        return b.decode('utf-8')
+    except UnicodeDecodeError:
+        return b
+
 class MpvNodeList(Structure):
-    def array_value(self, decode_str=False):
-        return [ self.values[i].node_value(decode_str) for i in range(self.num) ]
+    def array_value(self, decoder=identity_decoder):
+        return [ self.values[i].node_value(decoder) for i in range(self.num) ]
+
+    def dict_value(self, decoder=identity_decoder):
+        return { self.keys[i].decode('utf-8'):
+                self.values[i].node_value(decoder) for i in range(self.num) }
+
+class MpvByteArray(Structure):
+    _fields_ = [('data', c_void_p),
+                ('size', c_size_t)]
 
-    def dict_value(self, decode_str=False):
-        return { self.keys[i].decode('utf-8'): self.values[i].node_value(decode_str) for i in range(self.num) }
+    def bytes_value(self):
+        return cast(self.data, POINTER(c_char))[:self.size]
 
 class MpvNode(Structure):
     _fields_ = [('val', c_longlong),
                 ('format', MpvFormat)]
 
-    def node_value(self, decode_str=False):
-        return MpvNode.node_cast_value(byref(c_void_p(self.val)), self.format.value, decode_str)
+    def node_value(self, decoder=identity_decoder):
+        return MpvNode.node_cast_value(byref(c_void_p(self.val)), self.format.value, decoder)
 
     @staticmethod
-    def node_cast_value(v, fmt, decode_str=False):
-        dwrap = lambda s: s.decode('utf-8') if decode_str else s
+    def node_cast_value(v, fmt=MpvFormat.NODE, decoder=identity_decoder):
         return {
             MpvFormat.NONE:         lambda v: None,
-            MpvFormat.STRING:       lambda v: dwrap(cast(v, POINTER(c_char_p)).contents.value),
+            MpvFormat.STRING:       lambda v: decoder(cast(v, POINTER(c_char_p)).contents.value),
             MpvFormat.OSD_STRING:   lambda v: cast(v, POINTER(c_char_p)).contents.value.decode('utf-8'),
             MpvFormat.FLAG:         lambda v: bool(cast(v, POINTER(c_int)).contents.value),
             MpvFormat.INT64:        lambda v: cast(v, POINTER(c_longlong)).contents.value,
             MpvFormat.DOUBLE:       lambda v: cast(v, POINTER(c_double)).contents.value,
-            MpvFormat.NODE:         lambda v: cast(v, POINTER(MpvNode)).contents.node_value(decode_str),
-            MpvFormat.NODE_ARRAY:   lambda v: cast(v, POINTER(POINTER(MpvNodeList))).contents.contents.array_value(decode_str),
-            MpvFormat.NODE_MAP:     lambda v: cast(v, POINTER(POINTER(MpvNodeList))).contents.contents.dict_value(decode_str),
-            MpvFormat.BYTE_ARRAY:   lambda v: cast(v, POINTER(c_char_p)).contents.value,
+            MpvFormat.NODE:         lambda v: cast(v, POINTER(MpvNode)).contents.node_value(decoder),
+            MpvFormat.NODE_ARRAY:   lambda v: cast(v, POINTER(POINTER(MpvNodeList))).contents.contents.array_value(decoder),
+            MpvFormat.NODE_MAP:     lambda v: cast(v, POINTER(POINTER(MpvNodeList))).contents.contents.dict_value(decoder),
+            MpvFormat.BYTE_ARRAY:   lambda v: cast(v, POINTER(POINTER(MpvByteArray))).contents.contents.bytes_value(),
             }[fmt](v)
 
 MpvNodeList._fields_ = [('num', c_int),
@@ -213,7 +228,7 @@ class MpvEvent(Structure):
                 ('reply_userdata', c_ulonglong),
                 ('data', c_void_p)]
 
-    def as_dict(self):
+    def as_dict(self, decoder=identity_decoder):
         dtype = {MpvEventID.END_FILE:               MpvEventEndFile,
                 MpvEventID.PROPERTY_CHANGE:         MpvEventProperty,
                 MpvEventID.GET_PROPERTY_REPLY:      MpvEventProperty,
@@ -224,15 +239,14 @@ class MpvEvent(Structure):
         return {'event_id': self.event_id.value,
                 'error': self.error,
                 'reply_userdata': self.reply_userdata,
-                'event': cast(self.data, POINTER(dtype)).contents.as_dict() if dtype else None}
+                'event': cast(self.data, POINTER(dtype)).contents.as_dict(decoder=decoder) if dtype else None}
 
 class MpvEventProperty(Structure):
     _fields_ = [('name', c_char_p),
                 ('format', MpvFormat),
                 ('data', c_void_p)]
-    def as_dict(self, decode_str=False):
-        proptype, _access = ALL_PROPERTIES.get(self.name, (str, None))
-        value = MpvNode.node_cast_value(self.data, self.format.value, decode_str or proptype in (str, _commalist))
+    def as_dict(self, decoder=identity_decoder):
+        value = MpvNode.node_cast_value(self.data, self.format.value, decoder)
         return {'name': self.name.decode('utf-8'),
                 'format': self.format,
                 'data': self.data,
@@ -243,7 +257,7 @@ class MpvEventLogMessage(Structure):
                 ('level', c_char_p),
                 ('text', c_char_p)]
 
-    def as_dict(self):
+    def as_dict(self, decoder=identity_decoder):
         return { 'prefix': self.prefix.decode('utf-8'),
                  'level':  self.level.decode('utf-8'),
                  'text':   self.text.decode('utf-8').rstrip() }
@@ -254,21 +268,21 @@ class MpvEventEndFile(c_int):
     ABORTED             = 2
     QUIT                = 3
 
-    def as_dict(self):
+    def as_dict(self, decoder=identity_decoder):
         return {'reason': self.value}
 
 class MpvEventScriptInputDispatch(Structure):
     _fields_ = [('arg0', c_int),
                 ('type', c_char_p)]
 
-    def as_dict(self):
+    def as_dict(self, decoder=identity_decoder):
         pass # TODO
 
 class MpvEventClientMessage(Structure):
     _fields_ = [('num_args', c_int),
                 ('args', POINTER(c_char_p))]
 
-    def as_dict(self):
+    def as_dict(self, decoder=identity_decoder):
         return { 'args': [ self.args[i].decode('utf-8') for i in range(self.num_args) ] }
 
 WakeupCallback = CFUNCTYPE(None, c_void_p)
@@ -322,8 +336,6 @@ _handle_func('mpv_initialize',              [],
 _handle_func('mpv_detach_destroy',          [],                                         None, errcheck=None)
 _handle_func('mpv_terminate_destroy',       [],                                         None, errcheck=None)
 _handle_func('mpv_load_config_file',        [c_char_p],                                 c_int, ec_errcheck)
-_handle_func('mpv_suspend',                 [],                                         None, errcheck=None)
-_handle_func('mpv_resume',                  [],                                         None, errcheck=None)
 _handle_func('mpv_get_time_us',             [],                                         c_ulonglong, errcheck=None)
 
 _handle_func('mpv_set_option',              [c_char_p, MpvFormat, c_void_p],            c_int, ec_errcheck)
@@ -332,6 +344,8 @@ _handle_func('mpv_set_option_string',       [c_char_p, c_char_p],
 _handle_func('mpv_command',                 [POINTER(c_char_p)],                        c_int, ec_errcheck)
 _handle_func('mpv_command_string',          [c_char_p, c_char_p],                       c_int, ec_errcheck)
 _handle_func('mpv_command_async',           [c_ulonglong, POINTER(c_char_p)],           c_int, ec_errcheck)
+_handle_func('mpv_command_node',            [POINTER(MpvNode), POINTER(MpvNode)],       c_int, ec_errcheck)
+_handle_func('mpv_command_async',           [c_ulonglong, POINTER(MpvNode)],            c_int, ec_errcheck)
 
 _handle_func('mpv_set_property',            [c_char_p, MpvFormat, c_void_p],            c_int, ec_errcheck)
 _handle_func('mpv_set_property_string',     [c_char_p, c_char_p],                       c_int, ec_errcheck)
@@ -363,9 +377,6 @@ _handle_gl_func('mpv_opengl_cb_report_flip',            [c_ulonglong],
 _handle_gl_func('mpv_opengl_cb_uninit_gl',              [],                                             c_int)
 
 
-def _ensure_encoding(possibly_bytes):
-    return possibly_bytes.decode('utf-8') if type(possibly_bytes) is bytes else possibly_bytes
-
 def _mpv_coax_proptype(value, proptype=str):
     """ Intelligently coax the given python value into something that can be understood as a proptype property """
     if type(value) is bytes:
@@ -429,7 +440,7 @@ def _event_generator(handle):
 def _event_loop(event_handle, playback_cond, event_callbacks, message_handlers, property_handlers, log_handler):
     for event in _event_generator(event_handle):
         try:
-            devent = event.as_dict() # copy data from ctypes
+            devent = event.as_dict(decoder=strict_decoder) # copy data from ctypes
             eid = devent['event_id']
             for callback in event_callbacks:
                 callback(devent)
@@ -438,9 +449,9 @@ def _event_loop(event_handle, playback_cond, event_callbacks, message_handlers,
                     playback_cond.notify_all()
             if eid == MpvEventID.PROPERTY_CHANGE:
                 pc = devent['event']
-                name, value, fmt = pc['name'], pc['value'], pc['format']
+                name, value, _fmt = pc['name'], pc['value'], pc['format']
 
-                for handler in property_handlers[name][fmt]:
+                for handler in property_handlers[name]:
                     handler(name, value)
             if eid == MpvEventID.LOG_MESSAGE and log_handler is not None:
                 ev = devent['event']
@@ -456,14 +467,59 @@ def _event_loop(event_handle, playback_cond, event_callbacks, message_handlers,
         except Exception as e:
             traceback.print_exc()
 
-class OSDPropertyProxy:
+class _Proxy:
     def __init__(self, mpv):
-        self.mpv = mpv
+        super().__setattr__('mpv', mpv)
+
+class _PropertyProxy(_Proxy):
+    def __dir__(self):
+        return super().__dir__() + [ name.replace('-', '_') for name in self.mpv.property_list ]
+
+class _FileLocalProxy(_Proxy):
+    def __getitem__(self, name):
+        return self.mpv.__getitem__(name, file_local=True)
+
+    def __setitem__(self, name, value):
+        return self.mpv.__setitem__(name, value, file_local=True)
+
+    def __iter__(self):
+        return iter(self.mpv)
+
+class _OSDPropertyProxy(_PropertyProxy):
+    def __getattr__(self, name):
+        return self.mpv._get_property(name, fmt=MpvFormat.OSD_STRING)
+
+    def __setattr__(self, _name, _value):
+        raise AttributeError('OSD properties are read-only. Please use the regular property API for writing.')
+
+class _DecoderPropertyProxy(_PropertyProxy):
+    def __init__(self, mpv, decoder):
+        super().__init__(mpv)
+        super().__setattr__('_decoder', decoder)
+
+    def __getattr__(self, name):
+        return self.mpv._get_property(name, decoder=self._decoder)
+
+    def __setattr__(self, name, value):
+        setattr(self.mpv, name, value)
 
 class MPV(object):
     """ See man mpv(1) for the details of the implemented commands. All mpv
     properties can be accessed as ```my_mpv.some_property``` and all mpv
-    options can be accessed as ```my_mpv['some-option']```. """
+    options can be accessed as ```my_mpv['some-option']```.
+
+    By default, properties are returned as decoded ```str``` and an error is thrown if the value does not contain valid
+    utf-8. To get a decoded ```str``` if possibly but ```bytes``` instead of an error if not, use
+    ```my_mpv.lazy.some_property```. To always get raw ```bytes```, use ```my_mpv.raw.some_property```.  To access a
+    property's decoded OSD value, use ```my_mpv.osd.some_property```.
+
+    To get API information on an option, use ```my_mpv.option_info('option-name')```. To get API information on a
+    property, use ```my_mpv.properties['property-name']```. Take care to use mpv's dashed-names instead of the
+    underscore_names exposed on the python object.
+
+    To make your program not barf hard the first time its used on a weird file system **always access properties
+    containing file names or file tags through ```MPV.raw```.
+    """
     def __init__(self, *extra_mpv_flags, log_handler=None, start_event_thread=True, loglevel=None, **extra_mpv_opts):
         """ Create an MPV instance.
 
@@ -482,9 +538,14 @@ class MPV(object):
         finally:
             _mpv_initialize(self.handle)
 
-        self.osd = OSDPropertyProxy(self)
+        self.osd = _OSDPropertyProxy(self)
+        self.file_local = _FileLocalProxy(self)
+        self.raw    = _DecoderPropertyProxy(self, identity_decoder)
+        self.strict = _DecoderPropertyProxy(self, strict_decoder)
+        self.lazy   = _DecoderPropertyProxy(self, lazy_decoder)
+
         self._event_callbacks = []
-        self._property_handlers = collections.defaultdict(lambda: collections.defaultdict(lambda: []))
+        self._property_handlers = collections.defaultdict(lambda: [])
         self._message_handlers = {}
         self._key_binding_handlers = {}
         self._playback_cond = threading.Condition()
@@ -499,6 +560,7 @@ class MPV(object):
             self._event_thread.start()
         else:
             self._event_thread = None
+        self.__setattr__ = lambda self, name, value: self._set_property(name, value)
 
     def wait_for_playback(self):
         """ Waits until playback of the current title is paused or done """
@@ -554,20 +616,30 @@ class MPV(object):
                 for arg in args if arg is not None ] + [None]
         _mpv_command(self.handle, (c_char_p*len(args))(*args))
 
+    def node_command(self, name, *args, decoder=strict_decoder):
+        _1, _2, _3, pointer = _make_node_str_list([name, *args])
+        out = cast(create_string_buffer(sizeof(MpvNode)), POINTER(MpvNode))
+        outptr = out #byref(out)
+        ppointer = cast(pointer, POINTER(MpvNode))
+        _mpv_command_node(self.handle, ppointer, outptr)
+        rv = MpvNode.node_cast_value(outptr, MpvFormat.NODE, decoder)
+        _mpv_free_node_contents(outptr)
+        return rv
+
     def seek(self, amount, reference="relative", precision="default-precise"):
         """ Mapped mpv seek command, see man mpv(1). """
         self.command('seek', amount, reference, precision)
 
     def revert_seek(self):
-        """ Mapped mpv seek command, see man mpv(1). """
+        """ Mapped mpv revert_seek command, see man mpv(1). """
         self.command('revert_seek');
 
     def frame_step(self):
-        """ Mapped mpv seek command, see man mpv(1). """
+        """ Mapped mpv frame_step command, see man mpv(1). """
         self.command('frame_step')
 
     def frame_back_step(self):
-        """ Mapped mpv seek command, see man mpv(1). """
+        """ Mapped mpv frame_back_step command, see man mpv(1). """
         self.command('frame_back_step')
 
     def _add_property(self, name, value=None):
@@ -580,11 +652,11 @@ class MPV(object):
         self.command('multiply_property', name, factor)
 
     def screenshot(self, includes='subtitles', mode='single'):
-        """ Mapped mpv seek command, see man mpv(1). """
+        """ Mapped mpv screenshot command, see man mpv(1). """
         self.command('screenshot', includes, mode)
 
     def screenshot_to_file(self, filename, includes='subtitles'):
-        """ Mapped mpv seek command, see man mpv(1). """
+        """ Mapped mpv screenshot_to_file command, see man mpv(1). """
         self.command('screenshot_to_file', filename.encode(fs_enc), includes)
 
     def playlist_next(self, mode='weak'):
@@ -687,15 +759,12 @@ class MPV(object):
         """ Mapped mpv seek command, see man mpv(1). """
         self.command('script_message_to', target, *args)
 
-    def observe_property(self, name, handler, *, force_fmt=None):
+    def observe_property(self, name, handler):
         """ Register an observer on the named property. An observer is a function that is called with the new property
         value every time the property's value is changed. The basic function signature is ```fun(property_name,
         new_value)``` with new_value being the decoded property value as a python object. This function can be used as a
         function decorator if no handler is given.
 
-        By default, you'll get whatever return type you'd get if you asked the regular property access API. To override
-        this behavior, you can specify a forced return type from ```MpvFormat``` in force_fmt
-
         To uunregister the observer, call either of ```mpv.unobserve_property(name, handler)```,
         ```mpv.unobserve_all_properties(handler)``` or the handler's ```unregister_mpv_properties``` attribute:
 
@@ -706,15 +775,14 @@ class MPV(object):
 
         my_handler.unregister_mpv_properties()
         ``` """
-        fmt = force_fmt or MpvFormat.NODE
-        self._property_handlers[name][fmt].append(handler)
-        _mpv_observe_property(self._event_handle, hash(name)&0xffffffffffffffff, name.encode('utf-8'), fmt)
+        self._property_handlers[name].append(handler)
+        _mpv_observe_property(self._event_handle, hash(name)&0xffffffffffffffff, name.encode('utf-8'), MpvFormat.NODE)
 
-    def property_observer(self, name, *, force_fmt=None):
+    def property_observer(self, name):
         """ Function decorator to register a property observer. See ```MPV.observe_property``` for details. """
         def wrapper(fun):
-            self.observe_property(name, fun, force_fmt=force_fmt)
-            fun.unobserve_mpv_properties = lambda: self.unobserve_property(None, fun)
+            self.observe_property(name, fun)
+            fun.unobserve_mpv_properties = lambda: self.unobserve_property(name, fun)
             return fun
         return wrapper
 
@@ -722,19 +790,8 @@ class MPV(object):
         """ Unregister a property observer. This requires both the observed property's name and the handler function
         that was originally registered as one handler could be registered for several properties. To unregister a
         handler from *all* observed properties see ```unobserve_all_properties```. """
-        fmts = self._property_handlers[name]
-        for fmt, handlers in fmts.items():
-            handlers.remove(handler)
-
-        # remove all properties that have no handlers
-        empty_props = [
-            fmt for fmt, handler in fmts.items() if not handler
-        ]
-
-        for fmt in empty_props:
-            del fmts[fmt]
-
-        if not fmts:
+        self._property_handlers[name].remove(handler)
+        if not self._property_handlers[name]:
             _mpv_unobserve_property(self._event_handle, hash(name)&0xffffffffffffffff)
 
     def unobserve_all_properties(self, handler):
@@ -934,54 +991,47 @@ class MPV(object):
         self.loadfile(filename, 'append', **options)
 
     # Property accessors
-    def _get_property(self, name, proptype=str, decode_str=False, force_format=None):
-        fmt = force_format or {int:         MpvFormat.INT64,
-               float:       MpvFormat.DOUBLE,
-               bool:        MpvFormat.FLAG,
-               str:         MpvFormat.STRING,
-               bytes:       MpvFormat.STRING,
-               _commalist:   MpvFormat.STRING,
-               MpvFormat.NODE: MpvFormat.NODE}[proptype]
-
+    def _get_property(self, name, decoder=strict_decoder, fmt=MpvFormat.NODE):
         out = cast(create_string_buffer(sizeof(c_void_p)), c_void_p)
         outptr = byref(out)
         try:
             cval = _mpv_get_property(self.handle, name.encode('utf-8'), fmt, outptr)
-            rv = MpvNode.node_cast_value(outptr, fmt, decode_str or proptype in (str, _commalist))
-
-            if proptype is _commalist:
-                rv = proptype(rv)
-
-            if proptype is str:
-                _mpv_free(out)
-            elif proptype is MpvFormat.NODE:
+            rv = MpvNode.node_cast_value(outptr, fmt, decoder)
+            if fmt is MpvFormat.NODE:
                 _mpv_free_node_contents(outptr)
-
             return rv
         except PropertyUnavailableError as ex:
             return None
 
-    def _set_property(self, name, value, proptype=str):
+    def _set_property(self, name, value):
         ename = name.encode('utf-8')
-        if proptype is MpvFormat.NODE:
-            if isinstance(value, (list, set, dict)):
-                _1, _2, _3, pointer = _make_node_str_list(value)
-                _mpv_set_property(self.handle, ename, MpvFormat.NODE, pointer)
-            else:
-                _mpv_set_property_string(self.handle, ename, _mpv_coax_proptype(value, str))
+        if isinstance(value, (list, set, dict)):
+            _1, _2, _3, pointer = _make_node_str_list(value)
+            _mpv_set_property(self.handle, ename, MpvFormat.NODE, pointer)
         else:
-            _mpv_set_property_string(self.handle, ename, _mpv_coax_proptype(value, proptype))
+            _mpv_set_property_string(self.handle, ename, _mpv_coax_proptype(value))
+
+    def __getattr__(self, name):
+        name = name.replace('_', '-')
+        return self._get_property(name, lazy_decoder)
+
+    def __dir__(self):
+        return super().__dir__() + [ name.replace('-', '_') for name in self.property_list ]
+
+    @property
+    def properties(self):
+        return { name: self.option_info(name) for name in self.property_list }
 
     # Dict-like option access
     def __getitem__(self, name, file_local=False):
         """ Get an option value """
         prefix = 'file-local-options/' if file_local else 'options/'
-        return self._get_property(prefix+name, proptype=MpvFormat.NODE)
+        return self._get_property(prefix+name, lazy_decoder)
 
     def __setitem__(self, name, value, file_local=False):
         """ Set an option value """
         prefix = 'file-local-options/' if file_local else 'options/'
-        return self._set_property(prefix+name, value, proptype=MpvFormat.NODE)
+        return self._set_property(prefix+name, value)
 
     def __iter__(self):
         """ Iterate over all option names """
@@ -989,238 +1039,8 @@ class MPV(object):
 
     def option_info(self, name):
         """ Get information on the given option """
-        return self._get_property('option-info/'+name)
-
-def _commalist(propval=''):
-    return str(propval).split(',')
-
-_node = MpvFormat.NODE
-
-ALL_PROPERTIES = {
-        'osd-level':                    (int,    'rw'),
-        'osd-scale':                    (float,  'rw'),
-        'loop':                         (str,    'rw'),
-        'loop-file':                    (str,    'rw'),
-        'speed':                        (float,  'rw'),
-        'filename':                     (bytes,  'r'),
-        'file-size':                    (int,    'r'),
-        'path':                         (bytes,  'r'),
-        'media-title':                  (bytes,  'r'),
-        'stream-pos':                   (int,    'rw'),
-        'stream-end':                   (int,    'r'),
-        'length':                       (float,  'r'), # deprecated for ages now
-        'duration':                     (float,  'r'),
-        'avsync':                       (float,  'r'),
-        'total-avsync-change':          (float,  'r'),
-#        'drop-frame-count':             (int,    'r'),
-        'decoder-frame-drop-count':     (int,    'r'),
-        'percent-pos':                  (float,  'rw'),
-#        'ratio-pos':                    (float,  'rw'),
-        'audio-pts':                    (float,  'r'),
-        'time-pos':                     (float,  'rw'),
-        'time-start':                   (float,  'r'),
-        'time-remaining':               (float,  'r'),
-        'playtime-remaining':           (float,  'r'),
-        'chapter':                      (int,    'rw'),
-        'edition':                      (str,    'rw'),
-        'disc-titles':                  (int,    'r'),
-        'disc-title':                   (str,    'rw'),
-#        'disc-menu-active':             (bool,   'r'),
-        'chapters':                     (int,    'r'),
-        'editions':                     (int,    'r'),
-        'angle':                        (int,    'rw'),
-        'pause':                        (bool,   'rw'),
-        'core-idle':                    (bool,   'r'),
-        'cache':                        (str,    'r'),
-        'cache-size':                   (int,    'rw'),
-        'cache-free':                   (int,    'r'),
-        'cache-used':                   (int,    'r'),
-        'cache-speed':                  (int,    'r'),
-        'cache-idle':                   (bool,   'r'),
-        'cache-buffering-state':        (int,    'r'),
-        'paused-for-cache':             (bool,   'r'),
-#        'pause-for-cache':              (bool,   'r'),
-        'eof-reached':                  (bool,   'r'),
-#        'pts-association-mode':         (str,    'rw'),
-        'hr-seek':                      (str,    'rw'),
-        'volume':                       (float,  'rw'),
-        'volume-max':                   (int,    'rw'),
-        'ao-volume':                    (float,  'rw'),
-        'mute':                         (bool,   'rw'),
-        'ao-mute':                      (bool,   'rw'),
-        'audio-speed-correction':       (float,  'r'),
-        'audio-delay':                  (float,  'rw'),
-        'audio-format':                 (str,    'r'),
-        'audio-codec':                  (str,    'r'),
-        'audio-codec-name':             (str,    'r'),
-        'audio-bitrate':                (float,  'r'),
-        'packet-audio-bitrate':         (float,  'r'),
-        'audio-samplerate':             (int,    'r'),
-        'audio-channels':               (str,    'r'),
-        'aid':                          (str,    'rw'),
-        'audio':                        (str,    'rw'), # alias for aid
-        'balance':                      (int,    'rw'),
-        'fullscreen':                   (bool,   'rw'),
-        'deinterlace':                  (str,    'rw'),
-        'colormatrix':                  (str,    'rw'),
-        'colormatrix-input-range':      (str,    'rw'),
-#        'colormatrix-output-range':     (str,    'rw'),
-        'colormatrix-primaries':        (str,    'rw'),
-        'ontop':                        (bool,   'rw'),
-        'border':                       (bool,   'rw'),
-        'framedrop':                    (str,    'rw'),
-        'gamma':                        (float,  'rw'),
-        'brightness':                   (int,    'rw'),
-        'contrast':                     (int,    'rw'),
-        'saturation':                   (int,    'rw'),
-        'hue':                          (int,    'rw'),
-        'hwdec':                        (str,    'rw'),
-        'panscan':                      (float,  'rw'),
-        'video-format':                 (str,    'r'),
-        'video-codec':                  (str,    'r'),
-        'video-bitrate':                (float,  'r'),
-        'packet-video-bitrate':         (float,  'r'),
-        'width':                        (int,    'r'),
-        'height':                       (int,    'r'),
-        'dwidth':                       (int,    'r'),
-        'dheight':                      (int,    'r'),
-        'container-fps':                (float,  'r'),
-        'estimated-vf-fps':             (float,  'r'),
-        'window-scale':                 (float,  'rw'),
-        'video-aspect':                 (str,    'rw'),
-        'osd-width':                    (int,    'r'),
-        'osd-height':                   (int,    'r'),
-        'osd-par':                      (float,  'r'),
-        'vid':                          (str,    'rw'),
-        'video':                        (str,    'rw'), # alias for vid
-        'video-align-x':                (float,  'rw'),
-        'video-align-y':                (float,  'rw'),
-        'video-pan-x':                  (float,  'rw'),
-        'video-pan-y':                  (float,  'rw'),
-        'video-zoom':                   (float,  'rw'),
-        'video-unscaled':               (bool,   'w'),
-        'video-speed-correction':       (float,  'r'),
-        'program':                      (int,    'w'),
-        'sid':                          (str,    'rw'),
-        'sub':                          (str,    'rw'), # alias for sid
-        'secondary-sid':                (str,    'rw'),
-        'sub-delay':                    (float,  'rw'),
-        'sub-pos':                      (int,    'rw'),
-        'sub-visibility':               (bool,   'rw'),
-        'sub-forced-only':              (bool,   'rw'),
-        'sub-scale':                    (float,  'rw'),
-        'sub-bitrate':                  (float,  'r'),
-        'sub-text':                     (str,    'r'),
-        'packet-sub-bitrate':           (float,  'r'),
-#        'ass-use-margins':              (bool,   'rw'),
-        'ass-vsfilter-aspect-compat':   (bool,   'rw'),
-        'ass-style-override':           (str,   'rw'),
-#        'stream-capture':               (str,    'rw'),
-        'tv-brightness':                (int,    'rw'),
-        'tv-contrast':                  (int,    'rw'),
-        'tv-saturation':                (int,    'rw'),
-        'tv-hue':                       (int,    'rw'),
-        'tv-freq':                      (float,  'rw'),
-        'tv-norm':                      (str,    'rw'),
-        'tv-scan':                      (bool,   'rw'),
-        'tv-channel':                   (str,    'rw'),
-        'dvb-channel':                  (_node,  'rw'),
-        'dvb-channel-name':             (str,    'rw'),
-        'playlist-pos':                 (int,    'rw'),
-        'playlist-pos-1':               (int,    'rw'), # ugh.
-        'playlist-count':               (int,    'r'),
-#        'quvi-format':                  (str,    'rw'),
-        'seekable':                     (bool,   'r'),
-        'seeking':                      (bool,   'r'),
-        'partially-seekable':           (bool,   'r'),
-        'playback-abort':               (bool,   'r'),
-        'cursor-autohide':              (str,    'rw'),
-        'audio-device':                 (str,    'rw'),
-        'current-vo':                   (str,    'r'),
-        'current-ao':                   (str,    'r'),
-        'audio-out-detected-device':    (str,    'r'),
-        'protocol-list':                (str,    'r'),
-        'mpv-version':                  (str,    'r'),
-        'mpv-configuration':            (str,    'r'),
-        'ffmpeg-version':               (str,    'r'),
-        'display-sync-active':          (bool,   'r'),
-        'stream-open-filename':         (bytes,   'rw'), # Undocumented
-        'file-format':                  (_commalist,'r'), # Be careful with this one.
-        'mistimed-frame-count':         (int,    'r'),
-        'vsync-ratio':                  (float,  'r'),
-#        'vo-drop-frame-count':          (int,    'r'),
-        'frame-drop-count':             (int,    'r'),
-        'vo-delayed-frame-count':       (int,    'r'),
-        'playback-time':                (float,  'rw'),
-        'demuxer-cache-duration':       (float,  'r'),
-        'demuxer-cache-time':           (float,  'r'),
-        'demuxer-cache-idle':           (bool,   'r'),
-        'demuxer-start-time':           (float,  'r'),
-        'demuxer-via-network':          (bool,   'r'),
-#        'idle':                         (bool,   'r'),
-        'idle-active':                  (bool,   'r'), # dat name
-        'disc-title-list':              (_commalist,'r'),
-        'field-dominance':              (str,    'rw'),
-        'taskbar-progress':             (bool,   'rw'),
-        'on-all-workspaces':            (bool,   'rw'),
-        'video-output-levels':          (str,    'r'),
-        'vo-configured':                (bool,   'r'),
-        'hwdec-current':                (str,    'r'),
-        'hwdec-interop':                (str,    'r'),
-        'estimated-frame-count':        (int,    'r'),
-        'estimated-frame-number':       (int,    'r'),
-        'sub-use-margins':              (bool,   'rw'),
-        'ass-force-margins':            (bool,   'rw'),
-        'video-rotate':                 (str,    'rw'),
-        'video-stereo-mode':            (str,    'rw'),
-        'ab-loop-a':                    (str,    'r'), # What a mess...
-        'ab-loop-b':                    (str,    'r'),
-        'dvb-channel':                  (str,    'w'),
-        'dvb-channel-name':             (str,    'rw'),
-        'window-minimized':             (bool,   'r'),
-        'display-names':                (_commalist, 'r'),
-        'display-fps':                  (float,  'r'), # access apparently misdocumented in the manpage
-        'estimated-display-fps':        (float,  'r'),
-        'vsync-jitter':                 (float,  'r'),
-        'profile-list':                 (_node,  'r', False),
-        'video-params':                 (_node,  'r', True),
-        'video-dec-params':             (_node,  'r', True),
-        'video-out-params':             (_node,  'r', True),
-        'track-list':                   (_node,  'r', False),
-        'playlist':                     (_node,  'r', False),
-        'chapter-list':                 (_node,  'r', False),
-        'vo-performance':               (_node,  'r', True),
-        'filtered-metadata':            (_node,  'r', False),
-        'metadata':                     (_node,  'r', False),
-        'chapter-metadata':             (_node,  'r', False),
-        'vf-metadata':                  (_node,  'r', False),
-        'af-metadata':                  (_node,  'r', False),
-        'edition-list':                 (_node,  'r', False),
-        'disc-titles':                  (_node,  'r', False),
-        'audio-params':                 (_node,  'r', True),
-        'audio-out-params':             (_node,  'r', True),
-        'audio-device-list':            (_node,  'r', True),
-        'video-frame-info':             (_node,  'r', True),
-        'decoder-list':                 (_node,  'r', True),
-        'encoder-list':                 (_node,  'r', True),
-        'vf':                           (_node,  'r', True),
-        'af':                           (_node,  'r', True),
-        'options':                      (_node,  'r', True),
-        'file-local-options':           (_node,  'r', True),
-        'vo-passes':                    (_node,  'r', True),
-        'property-list':                (_commalist,'r')}
-
-def _bindproperty(MPV, name, proptype, access, decode_str=False):
-    getter = lambda self: self._get_property(name, proptype, decode_str)
-    osdgetter = lambda osdself: osdself.mpv._get_property(name, force_format=MpvFormat.OSD_STRING)
-    setter = lambda self, value: self._set_property(name, value, proptype)
-
-    def barf(*args):
-        raise NotImplementedError('Access denied')
-
-    setattr(MPV, name.replace('-', '_'), property(getter if 'r' in access else barf, setter if 'w' in access else barf))
-    setattr(OSDPropertyProxy, name.replace('-', '_'), property(osdgetter if 'r' in access else barf, barf))
-
-for name, (proptype, access, *args) in ALL_PROPERTIES.items():
-    _bindproperty(MPV, name, proptype, access, *args)
+        try:
+            return self._get_property('option-info/'+name)
+        except AttributeError:
+            return None