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.
Next: Command Line - every option, and what each one takes.