Documentation › Integrations

Advanced Integration

Anything that can spawn another process can hand a video to TinePlayer: a shortcut, a script, a file manager, another media application.

Opening a Video

tineplayer "/home/you/Videos/video.mkv"

See Running it on each platform for specifics per platform. A URL such as http:// or smb:// works in place of a path.

From Another Application

Add --external when launching from another application that expects to regain control after a video is finished:

tineplayer "/home/you/Videos/video.mkv" --external --fullscreen

This puts TinePlayer into a "guest" mode where it disables certain features:

  • It plays only the video it was given, with no file browser.
  • It closes itself when the video ends, handing control back to the launching application.
  • It does not confirm when quitting.
  • The playback controls gain a Stop button beside Back, which ends the playback and closes TinePlayer, returning control to the launching application.

A video path is required. Passing --external with an invalid video path will result in an error.

Passing --fullscreen alongside --external will lock TinePlayer into fullscreen mode and disable all fullscreen toggles.

Passing --play will launch into playback immediately, skipping the media page and track selection. See below.

Choosing Tracks Up Front

By default, TinePlayer opens the video's media page so tracks can be chosen. To skip that and start playing, pass --play, which also requires a video path. To pick the tracks as well:

tineplayer video.mkv --primary en --secondary ru --subtitle en --play

The --primary and --secondary arguments each take a track number, a language code, ad for a described track, en:ad for a described track in a language, 0 for nothing on that output, or the path to an external audio file.

The --subtitle argument takes a track number, a language code, the name of a subtitle file beside the video, one of the preference names, or 0 for none.

Pass --restart to ignores any saved position and starts from the beginning.

See the command line for more details about all options.