jellyctl

jellyctl

A CLI for managing your Jellyfin server.

Installation

Precompiled Binaries

Binaries are available for all major platforms. See the releases page.

Homebrew

Using the Homebrew package manager for macOS:

brew install sj14/tap/jellyctl

Manually

It's also possible to install via go install:

go install github.com/sj14/jellyctl@latest

Usage

See the generated DOCS.md for more details.

NAME:
   jellyctl - Manage Jellyfin from the CLI

USAGE:
   jellyctl [global options] command [command options] 

VERSION:
   undefined

COMMANDS:
   activity  List activities
   system    Manage the system
   user      Manage users
   library   Manage media libraries
   key       Manage API keys
   task      Manage schedule tasks
   help, h   Shows a list of commands or help for one command

GLOBAL OPTIONS:
   --url value    URL of the Jellyfin server (default: "http://127.0.0.1:8096") [$JELLYCTL_URL]
   --token value  API token [$JELLYCTL_TOKEN]
   --help, -h     show help
   --version, -v  print the version

Generate an API token in the Jellyfin WebUI at Administration -> Overview -> Advanced -> API Token.

Backup and restore

Run jellyctl system backup to save users, watch state, and playlists in jellyctl-backup/<timestamp>. Restore them with jellyctl system restore <directory>.

Restore is experimental. Passwords are not backed up; newly created users receive a temporary password printed during restore. Unmatched items are reported and cause a nonzero exit. Playlist ownership may change. On Jellyfin 10.11.4, playback positions may be assigned to the wrong user.