Node.js wrapper for the Kodi JSONRPC API
- A simple API using promises or async/await
- Handles reconnection and timeouts
All Kodi API methods available here: http://kodi.wiki/view/JSON-RPC_API/v8
Install (not released on npm yet):
npm install git://github.com/tillbaks/node-kodi.git#master
Use:
// The options below are the defaults
const kodi = require('kodi')
// Connect to Kodi with spcified options
kodi.connect({
host: "kodi",
port: 9090,
reconnect: false,
reconnectSleep: 3000,
connectionTimeout: 10000,
sendTimeout: undefined
})
// Lets you know when we are connected
kodi.on('connect', function () {
console.log("connected to kodi!")
})
// Run any Kodi API command and get the results
// NOTE: If you are not connected an error will be thrown
const result = await kodi.send("VideoLibrary.GetTVShows", {limits: {start: 0, end: 2}})
console.log(result)
// Get notified on specific notifications
kodi.on("Application.OnVolumeChanged", function (data) {
console.log(data)
})
// Get notified on any notifications
kodi.on("notification", function ({ method, params }) {
console.log('Notification for method:', method)
console.log('Parameters:', params)
})
// Changes connection options which will be used on next reconnection
kodi.setOptions({
host: 'pi',
port: 9090,
reconnect: false,
reconnectSleep: 3000,
connectionTimeout: 10000,
sendTimeout: 3000
})
// Closes the connection to Kodi
kodi.close()See tests for more usage examples