plex-tui Plex, from the terminal
plex-tui showing a Plex movie library in a terminal interface with posters, metadata, and playback details.

Keyboard-first Plex client

plex-tui

for macOS • Linux

Plex, from the terminal.

A focused interface for browsing Plex libraries and launching playback through mpv.

Install Source

What it does

A small terminal-first Plex client.

01

Browse libraries

Move through Plex libraries from a focused terminal interface.

02

Keyboard-first

Navigate with explicit commands and predictable key flows.

03

Launch through mpv

Start playback with mpv while keeping Plex as the media source.

04

Diagnostics nearby

Keep supportability and app state close to the running interface.

05

Shell-native workflows

Built for macOS and Linux terminal habits.

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.