playfile
Start playback of a media file by its path. Uses Player.Open to play any reachable file and returns the player state snapshot.
Instructions
Play one file by path (e.g. a searchmedia result's file): Player.Open auto-selects the audio/video player. Works for any reachable path, in-library or not. A file missing from disk (stale library entry) is reported as an error. Returns the player-state snapshot { "state", "media", "id", "title", "artist", "time", "totaltime", … }.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| instance | No | Target Kodi instance. Omitted uses the default ("(null)"). | |
| file | Yes | Path of the file to play — the `file` field of a `searchmedia` result row. Any path Kodi can reach works, in-library or not. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| state | Yes | Playback state; "stopped" means nothing is loaded. | |
| type | No | The active player kind. | |
| media | No | Real media type (song/episode/movie/musicvideo/…); "unknown" for an off-library file. | |
| id | No | Library id of the playing item; -1 when off-library. | |
| file | No | Path of the playing item. | |
| label | No | Kodi's display label for the item. | |
| title | No | The item's title (may be empty). | |
| showtitle | No | TV episode: the show's name. | |
| season | No | TV episode: season number. | |
| episode | No | TV episode: episode number. | |
| album | No | Song: the album name. | |
| artist | No | Song: the performers, an array of strings. | |
| track | No | Song: track number on the album. | |
| time | No | Playback position { hours, minutes, seconds, milliseconds }. | |
| totaltime | No | The item's duration, same shape as time. |