Shanty/Main
1
0
Fork 0
Code Issues 18 Pull Requests Actions Packages Projects Releases Wiki Activity

Add TUI interface #32

New Issue
Open
opened 2026-03-17 16:47:27 -04:00 by connor · 0 comments
connor commented 2026-03-17 16:47:27 -04:00
Owner
Copy Link

Several crates were designed to have TUI (terminal user interface) capability. Implement a unified TUI using ratatui that provides an interactive terminal experience for managing Shanty without a web browser.

  1. Library browser — navigate artists/albums/tracks in the terminal
  2. Search — search for music and add to watchlist
  3. Download queue — view and manage downloads
  4. System status — overview of running tasks, library stats
  5. Key bindings — vim-style navigation

This is particularly useful for headless servers where users SSH in, or for users who prefer terminal workflows.

Acceptance Criteria

  • TUI launches with shanty tui or as the default for individual crate binaries
  • Library browsing works with keyboard navigation
  • Search and add-to-library flow works
  • Download queue is viewable and manageable
  • System status is displayed
  • Responsive to terminal size changes

Dependencies

  • Issue #2 (database)
  • Issue #9 (may share the backend API, or call library crates directly)
Several crates were designed to have TUI (terminal user interface) capability. Implement a unified TUI using `ratatui` that provides an interactive terminal experience for managing Shanty without a web browser. 1. **Library browser** — navigate artists/albums/tracks in the terminal 2. **Search** — search for music and add to watchlist 3. **Download queue** — view and manage downloads 4. **System status** — overview of running tasks, library stats 5. **Key bindings** — vim-style navigation This is particularly useful for headless servers where users SSH in, or for users who prefer terminal workflows. ### Acceptance Criteria - [ ] TUI launches with `shanty tui` or as the default for individual crate binaries - [ ] Library browsing works with keyboard navigation - [ ] Search and add-to-library flow works - [ ] Download queue is viewable and manageable - [ ] System status is displayed - [ ] Responsive to terminal size changes ### Dependencies - Issue #2 (database) - Issue #9 (may share the backend API, or call library crates directly)
connor added the LowPriority label 2026-03-19 12:31:13 -04:00
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
Clear labels
LowPriority
MediumPriority
HighPriority
MVP
No Label LowPriority
Milestone
No items
No Milestone
Projects
Clear projects
No project
Assignees
Clear assignees
connor
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: Shanty/Main#32
Delete Branch "%!s()"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?