Plexbar

Plexbar is a keyboard-driven terminal music player for Plex. It gives you a simple Textual TUI for browsing and playing your Plex music library without opening a web browser.

PlexBar screenshot

Features

First-run Plex connection setup
Browse by Artists, Albums, Tracks, Playlists, and Genres
Search your Plex music library
Queue tracks, albums, artists, playlists, and genres
Show cover art for the currently playing track or album
Show live song progress with elapsed and total time
Play, pause/resume, stop, and skip with keyboard shortcuts
Local playback through mpv

Requirements

Python 3.12+
uv
mpv installed and available on PATH
A Plex server with at least one music library
A Plex account that can access your Plex server

Installation

Install Plexbar as a standalone command with uv:

uv tool install plexbar

Run Plexbar:

plexbar

Installation for development

Clone the repository and sync dependencies with uv:

git clone git@github.com:feoh/plexbar.git
cd plexbar
uv sync

Run Plexbar from the project checkout:

uv run plexbar

First-run setup

If ~/.config/plexbar/config.toml does not exist, Plexbar opens a setup screen and prompts for:

Plex base URL, for example http://puppy:32400 or http://127.0.0.1:32400
Plex sign-in authorization in your browser
Default music library

The config file is written to:

~/.config/plexbar/config.toml

Plexbar writes this file with user-only permissions where supported. During setup, Plexbar receives a Plex token from Plex after browser authorization and saves only that token. It does not ask for or store your Plex password. Do not commit or share your Plex token.

Usage

The top-level browser contains:

Artists
Albums
Tracks
Playlists
Genres

Press Enter to drill down into artists, albums, playlists, and genres. Genre browsing offers "By Artist" and "By Album" groupings before listing tracks. Press Enter on a track to enqueue it.

Keybindings

Key	Action
`/`	Search Plex music
`Enter`	Select/drill down, or enqueue focused track
`p`	Play the queue
`P`	Replace the queue with the focused track/album/artist/playlist/genre artist/genre album
`a`	Append focused track/album/artist/playlist/genre artist/genre album to queue
`Space`	Pause/resume
`n`	Next track
`s`	Stop playback
`f`	Toggle full-screen now-playing/cover art, including from the queue view
`Q`	Toggle the full-screen queue; use arrows, Page Up/Down, Home, or End to scroll
`Ctrl+p`	Open the command palette
`q`	Quit

In the command palette, type to filter commands, use Up/Down (or Page Up/Page Down) to move, press Enter to run a command, and press Escape to close it. The palette's Keys command opens a context-sensitive key reference alongside Plexbar; continue using the app normally while it is open, or press Escape to close it.

Local validation

uv run ruff check .
uv run ruff format --check .
uv run pytest
uv run mypy src/plexbar tests

Playback

Plexbar keeps a persistent mpv process running and controls it through mpv's JSON IPC interface for responsive pause/resume, stop, track changes, and live playback progress updates.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

plexbar-1.2.8.tar.gz (16.3 kB view details)

Uploaded Sep 4, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

plexbar-1.2.8-py3-none-any.whl (19.3 kB view details)

Uploaded Sep 4, 2026 Python 3

File details

Details for the file plexbar-1.2.8.tar.gz.

File metadata

Download URL: plexbar-1.2.8.tar.gz
Upload date: Sep 4, 2026
Size: 16.3 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for plexbar-1.2.8.tar.gz
Algorithm	Hash digest
SHA256	`349b743968237863ec251c84f876b0bee5b4f0f05e6b74bb070d5bf1a5c1e299`
MD5	`f86b239b5b332cd7224ec84bf9dc90a3`
BLAKE2b-256	`440c75cccd986dc9b1b0b731850efd9027f7f714e1f74cda07a65b87cb0b05da`

See more details on using hashes here.

Provenance

The following attestation bundles were made for plexbar-1.2.8.tar.gz:

Publisher: publish.yml on feoh/plexbar

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: plexbar-1.2.8.tar.gz
- Subject digest: 349b743968237863ec251c84f876b0bee5b4f0f05e6b74bb070d5bf1a5c1e299
- Sigstore transparency entry: 2717082854
- Sigstore integration time: Sep 4, 2026
Source repository:
- Permalink: feoh/plexbar@abc2806ba3907ad98d01ae1f186113b047bfc9b9
- Branch / Tag: refs/tags/v1.2.8
- Owner: https://github.com/feoh
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: publish.yml@abc2806ba3907ad98d01ae1f186113b047bfc9b9
- Trigger Event: release