Totem Player API | Official Documentation

General Information

The server runs locally on the Android TV device.

Default Port: 8085
Base Prefix: /v1
Base URL: http://<TV_IP>:8085/v1

1. Play Content

Starts video playback. If something is playing, it interrupts it immediately.

POST /play

Body (JSON):

{ "url": "https://...", // Required "title": "Big Buck Bunny", // Optional "posterUrl": "https://...", // Optional (Background) "userAgent": "TotemClient/1.0", // Optional "metadata": "Extra info", // Optional "startPosition": "0" // Optional }

2. Remote Control

Sends transport and configuration commands to the active player.

POST /command

Body (JSON):

{ "command": "PLAY", "value": "" // Optional depending on command }

Supported Commands:

Command	Value (value)	Description
PLAY	-	Resumes playback.
PAUSE	-	Pauses playback.
STOP	-	Stops and returns to start.
SEEK	Long (ms)	Jumps to position (e.g., "15000").
FORWARD	-	Forward 10 seconds.
REWIND	-	Rewind 10 seconds.
METADATA	String	Change image subtitle.
MESSAGE	String	Send message to screen.
VOLUME	Float (0.0 - 1.0)	Set volume (e.g., "0.5").
SPEED	Float	Set speed (e.g., "1.5").
POSTER	String	Change main image URL.
VIDEO	String (iso)	Change video track (e.g., "es", "en").
AUDIO	String (iso)	Change audio track (e.g., "es", "en").
SUBTITLE	String (iso)	Change subtitle (e.g., "en", "off").

3. Get Status

Polling to synchronize your remote control interface.

GET /status

Success Response (200 OK):

{ "state": "PLAYING", // IDLE, BUFFERING, PLAYING, PAUSED... "currentPosition": 15000,// current ms "duration": 60000, // total ms "isLive": false, "volume": 1.0, "speed": 1.0, "title": "Big Buck Bunny", "audioTracks": List_TrackDefinition, "subtitleTracks": List_TrackDefinition, "videoQualities": List_TrackDefinition }

Error 503: If the player is not initialized.