treyturner/plexamp-tui
1
0
Fork 0
mirror of https://github.com/treyturner/plexamp-tui.git synced 2026-06-13 00:59:31 -05:00
Code Issues Projects Releases Packages Wiki Activity
A terminal UI program for controlling local network plexamp instances.
23 commits 3 branches 1 tag 301 KiB
  • Go 100%
Find a file
Exact
Trey Turner 35b7cbd4d7
 fix: https server connections (#18)
2026-04-25 11:20:56 -02:30
internal fix: https server connections (#18) 2026-04-25 11:20:56 -02:30
.gitignore Initial commit 2025-10-18 10:11:02 -02:30
config_example.json Plexamp tui 2025-10-18 10:29:32 -02:30
go.mod Switch favorites to use sqlite (#16) 2025-10-28 15:51:03 -02:30
go.sum Switch favorites to use sqlite (#16) 2025-10-28 15:51:03 -02:30
LICENSE Initial commit 2025-10-18 10:11:02 -02:30
main.go Switch favorites to use sqlite (#16) 2025-10-28 15:51:03 -02:30
playback_example.json Playback (#1) 2025-10-18 12:29:02 -02:30
PLAYBACK_FEATURE.md Playback (#1) 2025-10-18 12:29:02 -02:30
README.md Update repository URL in README.md (#10) 2025-10-22 17:30:19 -02:30

README.md

Plexamp TUI

Plexamp TUI is a terminal-based controller for Plexamp headless instances. It allows you to select a Plexamp server, view the currently playing track, playback state, progress, and control playback and volume directly from your terminal.

image

Features

  • Select and switch between multiple Plexamp instances.
  • Displays current track, playback state, progress, and volume.
  • Control playback: play/pause, next, previous.
  • Control volume: increase or decrease in 5% increments.

Installation

  1. Clone this repository:
git clone https://github.com/spiercey/plexamp-tui.git
cd plexamp-tui
  1. Build the Go program:
go build -o plexamp-tui
  1. Run the program with auth flag to authenticate with Plex:
./plexamp-tui --auth

  1. Follow the instructions to authenticate with Plex.

  2. Run the program normally:

./plexamp-tui

Use the Server Selector with 6 to select your server Use the Playback Selector with 7 to select your playback device.

Use 1, 2 or 3 to switch between Artist, Albums and Playlists to play.

Configuration

Default Configuration

By default, the program will create a configuration file at:

~/.config/plexamp-tui/config.json

Once in the TUI, you can select your server and playback device using the Server Selector by pressing 6 and Playback selector by pressing 7.

Custom Config Path

You can specify a custom config file with:

./plexamp-tui --config /path/to/config.json

License

This project is licensed under the MIT License.