TUI Guide

The plexctl Interactive Interface (TUI) provides a rich, full-screen experience for navigating your Plex library.

Tab / Shift+Tab: Cycle through main tabs (Home, Libraries, History, etc.)
j / k (or Arrows): Move cursor up and down.
h / l (or Arrows): Move through horizontal lists or scroll columns.
Enter: Select an item or view details.
Esc: Go back or close overlays.
q: Quit the application.

Global Shortcuts

u: Switch User (Plex Home).
p: Play selected item.
ctrl+p: Play selected item in TCT mode (terminal-based video rendering).
/: Open global fuzzy search.
ctrl+l: Open library configuration (show/hide/icon picker).
ctrl+s: Open global settings (theme/icon type).
r: Refresh current view / trigger reindex (on search page).
x: Stop current playback.
h: Jump directly to Home tab.
u: Switch User (Plex Home).
?: Show help overlay.

Features

Fuzzy Search

Pressing / opens a global fuzzy search overlay. It searches across all indexed libraries for titles, actors, and directors. Results are updated instantly as you type.

Library Configuration

Pressing ctrl+l opens the configuration manager. Here you can:

Hide/Show specific library sections.
Assign Custom Icons using Emojis, Nerd Fonts, or ASCII.
Reorder how libraries appear in your sidebar.

Integrated Player

When playback is started, a playback bar appears at the bottom showing:

Current progress and duration.
Play/Pause status.
Media title. You can control the player directly from the TUI using space to pause/resume and x to stop.

User Switching (Plex Home)

Pressing u opens the “Who’s watching?” profile picker. This allows you to switch between managed users in your Plex Home.

PIN Protected Profiles: If a user has a PIN, you will be prompted to enter it. PINs are 4 digits and are masked for security.
Token Persistence: Once a user is selected and authenticated, plexctl stores the resulting access token in your configuration for subsequent launches.
Startup Picker: If multiple home users are detected and no active user is set, plexctl will automatically show the profile picker on startup.