kodi-send
sends commands to Kodi media center
TLDR
SYNOPSIS
kodi-send [options]
DESCRIPTION
kodi-send is a command-line tool for remotely controlling a Kodi media center instance over the network. It communicates using the Kodi EventClient UDP protocol on port 9777 by default, sending action commands that simulate remote control button presses, navigation events, and media playback operations.The tool supports a wide range of built-in Kodi actions including playback control (play, pause, stop, skip), volume adjustment, menu navigation (directional movement and selection), and media loading via URLs or file paths. Because it operates entirely from the command line, kodi-send is well suited for scripting automated media workflows, integrating Kodi with home automation systems, or building custom remote control interfaces.
PARAMETERS
-a, --action ACTION
Action to send. Can be specified multiple times to create a macro.--button BUTTON
Send a key press event. Can be specified multiple times.--host HOST
Kodi host address (default localhost).--port PORT
Kodi EventClient port (default 9777).--notification MESSAGE
Send a notification to Kodi.--log MESSAGE
Send a log message to Kodi.--loglevel LEVEL
Log level when using --log (default LOGDEBUG).--mouse X,Y
Send mouse position to Kodi.-d, --delay T
Wait for T milliseconds. Can be used between actions to create macros.--keymap KEYMAP
Specify a custom keymap.--help
Display help information.
CAVEATS
Requires Kodi EventClient enabled. Network access needed. Part of kodi-eventclients.
HISTORY
kodi-send is part of Kodi (formerly XBMC) event client tools for remote media center control.
SEE ALSO
curl(1)
