Command line

What it is for

Start Kaveo from a terminal.

Give Kaveo a path: it plays a video, or shows a photo.
```
kaveo "Big Buck Bunny.mkv"
```
Give it a web address — a stream or a video page — and it plays.
```
kaveo https://example.com/film.m3u8
```
Add --play-folder, and it plays every video in that folder, in file-name order.
```
kaveo --play-folder "Season 1"
```
Add --enqueue, and the file joins the running Kaveo’s queue, or plays if none runs.
```
kaveo --enqueue "Season 1/Episode 2.mkv"
```
Add --translate, and the files and folders you name join the translation queue; nothing plays.
```
kaveo --translate "Season 1" "Film (2016).mkv"
```
Add --loop, and a video, folder or playlist plays over and over, even after a restart; --fullscreen starts it, or a file, full screen.
```
kaveo --loop --fullscreen "Shop music"
```
With Kaveo closed, --restore and a backup file restore it before Kaveo opens.
```
kaveo --restore "kaveo-backup-2026-10-08-1200.zip"
```

Only the first Kaveo owns your library, history and settings. A second one brings that window forward; given a file, it plays it and reports where you stopped; given a web address, that window plays it.
Translating asks nothing; Already translated decides.
kaveo --version prints the version. There is no help option, and an unknown option is ignored.
Everything but translating is also in your file manager’s Kaveo menu — see From your file manager.