plex-tui Plex, from the terminal

Keyboard-first Plex client

plex-tui

for macOS • Linux

Plex, from the terminal.

A small terminal-first client for browsing a media collection and launching playback through mpv.

Install Source

What it is

A media browser that belongs in the shell.

Browse without leaving

Move through Plex libraries from the terminal you already use.

Decide with context

Posters, progress, metadata, and playback state stay in view.

Play through mpv

Plex remains the server; plex-tui is the quiet command surface.

Install

Choose the path that fits your system.

macOS / homebrew

One-shot install

The Homebrew formula installs mpv automatically. Homebrew 6 asks non-official taps to be trusted before use. 

brew trust --tap so1omon563/plex-tui
brew tap so1omon563/plex-tui
brew install plex-tui
plex-tui --smoke

cross-platform

PyPI with pipx

Recommended when you want isolated Python dependencies. Install mpv separately with your platform package manager. 

pipx install plex-tui
plex-tui --smoke
plex-tui

arch linux

AUR

The AUR package depends on mpv. Any AUR helper can be used; paru is only an example. 

paru -S plex-tui
plex-tui --smoke

Requirements: Python 3.11 or newer, mpv available on PATH, and a Plex account/server.