Search movies or series by name through the public Cinemeta catalog.

Get full metadata for a title by IMDb id, including the episode list for a series.

Browse the public Cinemeta top catalog, optionally filtered by genre.

Fetch a Stremio addon's manifest and summarize what it can do.

Ask one specific addon for the streams it has for a movie or episode.

Ask every stream addon on the account for a title, all at once.

This is what Stremio itself does when you open a title: it queries the installed addons in order and merges the results. Addons that fail or have nothing are reported separately rather than silently dropped.

Sign in to a Stremio account with an email and password.

The auth key is kept for this server's lifetime and, with remember, also cached in the user state directory so later runs stay signed in. Accounts created through Facebook or Google cannot use this; set STREMIO_AUTH_KEY for those.

Forget the stored Stremio auth key on this machine.

Report whether a Stremio account is reachable and who is signed in.

List the account's library titles.

include_removed also lists soft-deleted entries, which is where watch history lives. content_type filters to 'movie' or 'series'. watched is 'any', 'yes' or 'no'.

List part-watched titles with their resume positions, most recent first.

This is the row Stremio shows on its home board. position_ms is where playback stopped, so it can be handed straight to a player.

Add a movie or series to the account library by IMDb id.

Re-adding a title that was removed restores it with its watch state.

Remove a title from the account library. Watch state is kept.

Mark a library title watched or unwatched across every signed-in device.

Marking it watched also clears the resume position so it leaves the continue-watching row.

List the addons installed on the Stremio account.

These are the addons every signed-in device sees, including Stremio desktop on macOS, Windows and Linux. Order matters: for a given stream request Stremio queries addons top to bottom.

Search the official Stremio addon directory for addons to install.

Leave query empty to list the directory. Pass a returned transportUrl to stremio_install_addon. Addons flagged configuration_required must be configured in a browser first, which produces the real manifest URL.

Install an addon onto the Stremio account by its manifest URL.

It shows up on every signed-in device: Stremio desktop on macOS, Windows and Linux, Android TV, mobile and web. Reinstalling an already-present addon upgrades it in place. position places the addon in the query order (0 is queried first); -1 appends.

Remove an addon from the account by its manifest URL or its addon id.

Set the order Stremio queries addons in, highest priority first.

Pass the addon ids you care about; anything you leave out keeps its relative order behind them. Stream results follow this order, so moving a preferred stream provider to the front changes what plays first.

Reinstall Stremio's seven default addons onto the account.

Use this when the addon list is empty or broken. keep_installed keeps any other addon already on the account and only fills in the missing defaults; pass false to reset the account to a stock addon list.

Run a configurable addon's browser setup and install its result.

First call with a directory addon id, name or transport URL. The tool reports the page fields and opens the configuration page. Complete that page, then call again with the configured manifest URL it produces.

Save the account's current ordered addon collection under a name.

List saved addon profiles and the ordered addon ids in each one.

Replace the account addon collection with a saved named profile.

The protected-addon guard and automatic backup are applied before the account write.

Link Trakt in the browser, then install or refresh Stremio's Trakt addon.

On the first call, the account-specific authorization page opens. After authorizing Trakt, run the tool again to sync the first-party addon.

List episodes releasing soon for series in the account library.

Resolve the first unwatched regular episode using synced library history.

Search every installed addon catalog that declares search support.

Fetch a hash-matched OpenSubtitles result and serve it through add_subtitle.

Pass a playable video_url while Stremio desktop is running so its server calculates the hash, or provide video_hash and video_size directly.

Report whether Stremio desktop is installed and running on this machine.

Works on macOS, Windows and Linux. The streaming server is the local component that turns torrents into playable HTTP streams; it only answers while the desktop app is open.

Launch Stremio desktop on this machine and wait for its streaming server.

Run this before asking the desktop app to play something, and after installing addons so the app pulls the new collection from the account.

Open a title, or a named page, in Stremio desktop on this machine.

Pass an imdb_id like 'tt1375666' to open its detail page, adding season and episode for a series. Or pass page as one of 'addons', 'library', 'board', 'search', 'settings' to jump straight there.

Open an addon's install page in Stremio desktop so it can be reviewed.

Use this for addons that need configuring by hand. For a headless install that also reaches every other device, use stremio_install_addon instead.

Download the Stremio desktop installer for this machine's OS and CPU.

Reads the official downloads page, picks the macOS .dmg, the Windows .exe or the Linux .deb that matches the architecture, and saves it to the Downloads folder. Pass target_platform as 'Darwin', 'Windows' or 'Linux' to fetch an installer for a different machine. Running the installer is left to you because it needs an admin password.

Select an installed-addon stream and start it in Stremio desktop.

Streams follow installed addon order, then each addon's result order. stream_index selects from that merged list. For a continue-watching item, pass its video_id so Stremio restores the account's saved timeOffset.

Check every installed addon's manifest reachability and latency.

Compare installed addon versions with live manifests and optionally apply upgrades.

Leave apply false to inspect. Set apply true to reinstall every newer manifest in one guarded account collection update.

Pair adb with an Android 11+ TV using its six-digit wireless code.

pairing_port is the port shown beside the pairing code. host defaults to ANDROID_TV_HOST. Pass connect_port when the TV shows a separate wireless debugging port and the tool will connect after pairing.

Discover Chromecast and DLNA renderers through Stremio desktop.

Play an HTTP stream or local torrent engine file on Chromecast or DLNA.

device accepts a discovered id or exact name. Pass stream_url, or pass info_hash and file_index for a torrent active in Stremio desktop.

Read or control cast playback with status, pause, resume, stop, seek or volume.

List active torrent engines, transfer rates and per-file download progress.

The Stremio desktop app must be running. Pass an info_hash to inspect one engine, or leave it empty to inspect every active torrent.

Show the desktop streaming server's cache limit, usage and torrent entries.

Delete cached torrent data after stopping the matching torrent engines.

Set confirm=true. Pass one info_hash to purge that torrent, or leave it empty to purge the complete desktop torrent cache.

Serve a subtitle file for a title through the MCP subtitle addon.

subtitle_url is an http(s) link to an .srt file. Give season and episode to attach it to one episode; without them it covers the whole title. The subtitle then shows up in Stremio's subtitle picker on any device that can reach this machine on the LAN.

List every subtitle currently served by the MCP subtitle addon.

Stop serving subtitles for a title. Omit subtitle_id to remove them all.

Install the MCP subtitle addon onto the Stremio account.

Run this if the addon is missing from the subtitle picker. Every other installed addon is left untouched.

Open a movie or series episode in Stremio on the Android TV.

imdb_id like 'tt1375666'. For series pass season and episode. After the detail page opens, presses OK to start the highlighted stream.

Control the TV: category is 'volume' | 'playback' | 'navigate' | 'power'.

volume: up/down/mute/status, or set with value in the device's own range. playback: play/pause/toggle/stop/next/previous/forward/rewind. navigate: up/down/left/right/select/back/home. power: wake/sleep/toggle/status.

Push an SRT subtitle file to the Android TV Downloads folder.

subtitle_url_or_path: URL to download the SRT from, or a local absolute path. filename: name for the file on the TV (must end in .srt). Set clear_player_default to also forget Stremio's chosen video app, so Android asks again on the next play and an external player like VLC can take over. For subtitles inside Stremio itself, use add_subtitle.

Report what Stremio is playing on the TV: title, state, position, duration (ms).

Report the TV: model, Android version, installed Stremio version, power and volume.

Run this first when a TV tool misbehaves; it proves whether adb can reach the device at all.

Type text into whatever field is focused on the TV, such as Stremio's search box.

Capture what the TV is showing and save it as a PNG on this machine.

Use it to see which item the remote is sitting on before pressing select.