Metadata-Version: 1.1
Name: obs-websocket-py
Version: 0.1
Summary: Python library to communicate with an obs-websocket server.
Home-page: https://github.com/Elektordi/obs-websocket-py
Author: Guillaume "Elektordi" Genty
Author-email: elektordi@elektordi.net
License: MIT
Download-URL: https://github.com/Elektordi/obs-websocket-py/archive/0.1.tar.gz
Description: obs-websocket-py
        ================
        
        Python library to communicate with an
        `obs-websocket <https://github.com/Palakis/obs-websocket>`__ server.
        
        *Licensed under the MIT License*
        
        Project pages
        -------------
        
        GitHub project: https://github.com/Elektordi/obs-websocket-py
        
        PyPI package: https://pypi.python.org/pypi/obs-websocket-py
        
        Installation
        ------------
        
        Just run ``pip install obs-websocket-py`` in your Python venv or
        directly on your system.
        
        For manual install, git clone the github repo and copy the directory
        **obswebsocket** in your python project root.
        
        **Requires**: websocket-client (from pip)
        
        Usage
        -----
        
        See python scripts in the
        `samples <https://github.com/Elektordi/obs-websocket-py/tree/master/samples>`__
        directory.
        
        Or take a look at the documentation below:
        
        *Output of ``pydoc obswebsocket``:*
        
        ::
        
            NAME
                obswebsocket - Python library to communicate with an obs-websocket server.
        
            PACKAGE CONTENTS
                base_classes
                core
                events
                exceptions
                requests
        
            CLASSES
                obsws
                
                class obsws
                 |  Wrapper class for using obs-websocket-py
                 |  
                 |  Simple usage:
                 |      >>> import obswebsocket, obswebsocket.requests
                 |      >>> client = obswebsocket.obsws("localhost", 4444, "secret")
                 |      >>> client.connect()
                 |      >>> client.call(obswebsocket.requests.GetVersion()).getObsWebsocketVersion()
                 |      u'4.1.0'
                 |      >>> client.disconnect()
                 |      
                 |  For advanced usage, including events callback, see the 'samples' directory.
                 |  
                 |  Methods defined here:
                 |  
                 |  __init__(self, host, port=4444, password='')
                 |      Construct a new obsws wrapper
                 |      
                 |      :param host: Hostname to connect to
                 |      :param port: TCP Port to connect to (Default is 4444)
                 |      :param password: Password for the websocket server (Leave this field empty if no auth enabled
                 |          on the server)
                 |  
                 |  call(self, obj)
                 |      Make a call to the OBS server through the Websocket.
                 |      
                 |      :param obj: Request (class from obswebsocket.requests module) to send to the server.
                 |      :return: Request object populated with response data.
                 |  
                 |  connect(self)
                 |      Connect to the websocket server
                 |      
                 |      :return: Nothing
                 |  
                 |  disconnect(self)
                 |      Disconnect from websocket server
                 |      
                 |      :return: Nothing
                 |  
                 |  register(self, function, event=None)
                 |      Register a new hook in the websocket client
                 |      
                 |      :param function: Callback function pointer for the hook
                 |      :param event: Event (class from obswebsocket.events module) to trigger the hook on.
                 |          Default is None, which means trigger on all events.
                 |      :return: Nothing
                 |  
                 |  send(self, data)
                 |      **DEPRACATED***
                 |      Make a raw json call to the OBS server through the Websocket.
                 |      
                 |      :param obj: Request (python dict) to send to the server. Do not include field "message-id".
                 |      :return: Response (python dict) from the server.
                 |  
                 |  unregister(self, function, event=None)
                 |      Unregister a new hook in the websocket client
                 |      
                 |      :param function: Callback function pointer for the hook
                 |      :param event: Event (class from obswebsocket.events module) which triggered the hook on.
                 |          Default is None, which means unregister this function for all events.
                 |      :return: Nothing
        
        Problems?
        ---------
        
        Please check on `Github project
        issues <https://github.com/Elektordi/obs-websocket-py/issues>`__, and if
        nobody else have experienced it before, you can `file a new
        issue <https://github.com/Elektordi/obs-websocket-py/issues/new>`__.
        
Keywords: obs,obs-studio,websocket
Platform: UNKNOWN
Classifier: License :: OSI Approved :: MIT License
Classifier: Environment :: Plugins
Classifier: Intended Audience :: Developers
Classifier: Topic :: Software Development :: Libraries
Classifier: Development Status :: 4 - Beta
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.7
