A complete Python client for the Kodi JSON-RPC API
Because JSON-RPC is one of the trickier communication schemes to write for. And if you want to code for it, then you're probably going to get into bit of a dysfunctional relationship with the documentation.
A native-Python JSON-RPC client. Loads all the methods from your Kodi instance each time it gets instantiated, so you know you're never behind. And, it puts it in some semblance of a reasonable object structure.
Future updates will bundle a carefully-manicured static hive that will give you a better object structure at the cost of not always being completely up-to-date.
.. code:: python
>>> from kodipydent import Kodi
>>> my_kodi = Kodi('192.168.1.1')
>>> movies = my_kodi.VideoLibrary.GetMovies()
Simple as that. beekeeper makes it easy to use and easy to learn; if you don't know the name of the method you want to use, just do this:
.. code:: python
>>> print(my_kodi)
and you'll get a printout of all the methods available, and all the variables each one takes.
.. code:: bash
$ pip install kodipydent
kodipydent is driven by beekeeper, the family-friendly, object-oriented Python REST library. With beekeeper, even JSON-RPC clients are relatively simple to write. Don't believe me? Read the code. And you can check out kodipydent/hive.json
to see what a full hive looks like.
Here's the full signature of the method to create your API:
.. code:: python
Kodi(hostname[, port=8080, username='kodi', password=None])
kodipydent supports Kodi installations that have usernames and passwords set up. If you've created a password for web access, then simply construct your kodipydent instance as follows:
.. code:: python
Kodi('localhost', username='kodi', password='myawesomepassword')