feat: dedicated s/S for season/show jumps. add ctrl for configs

Signed-off-by: ygelfand <yuri@shlitz.com>

Author: ygelfand

docs/content/config.mdx

@@ -1,6 +1,6 @@
 # Configuration Reference
 
-`plexctl` stores its configuration in a YAML file at `~/.plexctl.yaml`. While many of these settings are managed through the TUI (pressing `s` or `l`), you can gain granular control by editing the file directly.
+`plexctl` stores its configuration in a YAML file at `~/.plexctl.yaml`. While many of these settings are managed through the TUI (pressing `ctrl+s` or `ctrl+l`), you can gain granular control by editing the file directly.
 
 ## Full Example
 
@@ -128,14 +128,14 @@ Force a specific view mode (`list` or `poster`) for this library, overriding the
 
 While you can edit `~/.plexctl.yaml` manually, most common settings can be managed directly within the `plexctl` TUI using dedicated configuration overlays.
 
-### Global Settings (`s`)
-Pressing **`s`** at any time opens the Global Settings overlay. From here you can:
+### Global Settings (`ctrl+s`)
+Pressing **`ctrl+s`** at any time opens the Global Settings overlay. From here you can:
 - **Change Theme:** Cycle through available color palettes (Nord, Dracula, etc.) and see changes instantly.
 - **Set Icon Type:** Switch between Nerd Fonts, Emojis, and ASCII icons.
 - **Sidebar Layout:** Adjust the `library_name_format` to show or hide icons and names.
 
-### Library Management (`l`)
-Pressing **`l`** opens the Library Configuration overlay. This allows you to manage the appearance of your sidebar:
+### Library Management (`ctrl+l`)
+Pressing **`ctrl+l`** opens the Library Configuration overlay. This allows you to manage the appearance of your sidebar:
 - **Hide Libraries:** Toggle the visibility of specific libraries (e.g., hide a "Photos" or "Home Movies" section).
 - **Custom Icons:** Browse and pick icons for each specific library using an integrated icon picker (supports Emoji and Nerd Fonts).
 - **Reorder Sidebar:** Use **`K`** and **`J`** (Shift+Up/Down) to drag and drop libraries into your preferred order.

docs/content/tui.mdx

@@ -17,8 +17,8 @@ The plexctl Interactive Interface (TUI) provides a rich, full-screen experience
 - **`p`**: Play selected item.
 - **`ctrl+p`**: Play selected item in TCT mode (terminal-based video rendering).
 - **`/`**: Open global fuzzy search.
-- **`l`**: Open library configuration (show/hide/icon picker).
-- **`s`**: Open global settings (theme/icon type).
+- **`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.
@@ -31,7 +31,7 @@ The plexctl Interactive Interface (TUI) provides a rich, full-screen experience
 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 `l` opens the configuration manager. Here you can:
+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.

internal/tui/tui.go

@@ -231,9 +231,9 @@ func (c *Controller) Update(msg tea.Msg) (tea.Model, tea.Cmd) {
 				return c, c.player.Stop()
 			}
 			return c, tea.Quit
-		case "s":
+		case "ctrl+s":
 			return c, c.navigator.Push(settings.NewSettingsOverlayModel(c.theme))
-		case "l":
+		case "ctrl+l":
 			return c, c.navigator.Push(tuiconfig.NewConfigOverlayModel(c.data.Libraries))
 		case "h":
 			return c, c.tabManager.SetActive(0)
@@ -332,15 +332,29 @@ func (c *Controller) handleSelectMedia(msg ui.SelectMediaMsg) tea.Cmd {
 }
 
 func (c *Controller) handleJumpToDetail(msg ui.JumpToDetailMsg) tea.Cmd {
-	for i, tab := range c.tabManager.tabModels {
-		if libTab, ok := tab.(*view.MediaView); ok {
-			if libTab.GetSectionID() == msg.SectionID {
-				initCmd := c.tabManager.SetActive(i)
-				c.returnTabIdx = msg.ReturnTabIdx
-				return tea.Batch(initCmd, libTab.ShowDetail(msg.RatingKey, msg.Type))
+	slog.Debug("Controller: handleJumpToDetail", "key", msg.RatingKey, "type", msg.Type, "section", msg.SectionID)
+
+	// 1. If SectionID is specified, find that specific tab
+	if msg.SectionID != "" {
+		for i, tab := range c.tabManager.tabModels {
+			if libTab, ok := tab.(*view.MediaView); ok {
+				if libTab.GetSectionID() == msg.SectionID {
+					slog.Debug("Controller: Found matching library tab", "idx", i)
+					initCmd := c.tabManager.SetActive(i)
+					c.returnTabIdx = msg.ReturnTabIdx
+					return tea.Batch(initCmd, libTab.ShowDetail(msg.RatingKey, msg.Type))
+				}
 			}
 		}
 	}
+
+	// 2. Fallback: If no section specified OR not found, try the active tab
+	if activeTab, ok := c.tabManager.ActiveModel().(*view.MediaView); ok {
+		slog.Debug("Controller: Applying jump to active library tab")
+		return activeTab.ShowDetail(msg.RatingKey, msg.Type)
+	}
+
+	slog.Warn("Controller: No matching library tab found for jump", "section", msg.SectionID)
 	return nil
 }
 
@@ -456,8 +470,8 @@ func (c *Controller) showHelp() tea.Cmd {
 	keys := []ui.HelpKey{
 		{Key: "tab", Desc: "Switch Library"},
 		{Key: "h", Desc: "Home"},
-		{Key: "s", Desc: "Global Settings"},
-		{Key: "l", Desc: "Libraries"},
+		{Key: "ctrl+s", Desc: "Global Settings"},
+		{Key: "ctrl+l", Desc: "Libraries"},
 		{Key: "u", Desc: "Switch User"},
 		{Key: "p", Desc: "Play Selected"},
 		{Key: "x", Desc: "Stop Playback"},
@@ -524,7 +538,7 @@ func (c *Controller) renderBaseView() string {
 		Background(c.theme.BrightBlack()).
 		Foreground(c.theme.White()).
 		Padding(0, 1).
-		Render(" q: quit | tab: switch lib | h: home | s: settings | l: libs | u: user | p: play | x: stop ")
+		Render(" q: quit | tab: switch lib | h: home | ctrl+s: settings | ctrl+l: libs | u: user | p: play | x: stop ")
 
 	return lipgloss.JoinVertical(lipgloss.Left, mainArea, footer)
 }

internal/tui/view/detail/episode_detail.go

@@ -60,6 +60,24 @@ func (v *EpisodeDetailView) Update(msg tea.Msg) (tea.Model, tea.Cmd) {
 		switch msg.String() {
 		case "esc", "backspace":
 			return v, func() tea.Msg { return BackMsg{} }
+		case "s":
+			if v.Metadata != nil && v.Metadata.ParentRatingKey != nil {
+				return v, func() tea.Msg {
+					return ui.JumpToDetailMsg{
+						RatingKey: *v.Metadata.ParentRatingKey,
+						Type:      "season",
+					}
+				}
+			}
+		case "S":
+			if v.Metadata != nil && v.Metadata.GrandparentRatingKey != nil {
+				return v, func() tea.Msg {
+					return ui.JumpToDetailMsg{
+						RatingKey: *v.Metadata.GrandparentRatingKey,
+						Type:      "show",
+					}
+				}
+			}
 		}
 	}
 
@@ -72,6 +90,8 @@ func (v *EpisodeDetailView) Update(msg tea.Msg) (tea.Model, tea.Cmd) {
 func (v *EpisodeDetailView) HelpKeys() []ui.HelpKey {
 	return []ui.HelpKey{
 		{Key: "esc", Desc: "Back"},
+		{Key: "s", Desc: "Go to Season"},
+		{Key: "S", Desc: "Go to Show"},
 		{Key: "j/up", Desc: "Scroll Synopsis Up"},
 		{Key: "k/down", Desc: "Scroll Synopsis Down"},
 	}
@@ -121,5 +141,5 @@ func (v *EpisodeDetailView) View() string {
 	mainLayout := v.RenderPosterAndInfo(infoSection)
 
 	return lipgloss.NewStyle().Padding(1, 2).Render(mainLayout) +
-		"\n\n " + dimStyle.Render("[p] Play | [esc] Back | [↑/↓] Scroll Synopsis")
+		"\n\n " + dimStyle.Render("[p] Play | [s] Season | [S] Show | [esc] Back | [↑/↓] Scroll Synopsis")
 }

internal/tui/view/detail/manager.go

@@ -26,7 +26,6 @@ func (m *DetailManager) Update(msg tea.Msg) (tea.Cmd, bool) {
 		return nil, false
 	}
 
-	// Handle Back navigation globally for detail views
 	if _, ok := msg.(BackMsg); ok {
 		if rc, ok := m.View.(ui.RootChecker); !ok || rc.IsAtRoot() {
 			m.View = nil
@@ -42,10 +41,12 @@ func (m *DetailManager) Update(msg tea.Msg) (tea.Cmd, bool) {
 	var cmd tea.Cmd
 	m.View, cmd = m.View.Update(msg)
 
-	// Everything is handled by the detail view EXCEPT library data messages.
 	if _, ok := msg.(ui.MediaPageMsg); ok {
 		return cmd, false
 	}
+	if _, ok := msg.(ui.JumpToDetailMsg); ok {
+		return cmd, false
+	}
 
 	return cmd, true
 }

internal/tui/view/detail/season_detail.go

@@ -99,6 +99,15 @@ func (v *SeasonDetailView) Update(msg tea.Msg) (tea.Model, tea.Cmd) {
 			}
 		case "esc", "backspace":
 			return v, func() tea.Msg { return BackMsg{} }
+		case "S":
+			if v.Metadata != nil && v.Metadata.ParentRatingKey != nil {
+				return v, func() tea.Msg {
+					return ui.JumpToDetailMsg{
+						RatingKey: *v.Metadata.ParentRatingKey,
+						Type:      "show",
+					}
+				}
+			}
 		}
 	}
 
@@ -120,6 +129,7 @@ func (v *SeasonDetailView) HelpKeys() []ui.HelpKey {
 	}
 	return []ui.HelpKey{
 		{Key: "enter", Desc: "View Episode Details"},
+		{Key: "S", Desc: "Go to Show"},
 		{Key: "esc", Desc: "Back"},
 		{Key: "j/up", Desc: "Move Up / Scroll"},
 		{Key: "k/down", Desc: "Move Down / Scroll"},
@@ -165,5 +175,5 @@ func (v *SeasonDetailView) View() string {
 		Render(v.episodeList.View())
 
 	return lipgloss.NewStyle().Padding(1, 2).Render(lipgloss.JoinVertical(lipgloss.Left, mainLayout, listContent)) +
-		"\n\n " + lipgloss.NewStyle().Foreground(v.Theme.BrightBlack()).Render("[enter] View Details | [p] Play | [esc] Back")
+		"\n\n " + lipgloss.NewStyle().Foreground(v.Theme.BrightBlack()).Render("[enter] Details | [p] Play | [S] Show | [esc] Back")
 }

internal/tui/view/media.go

@@ -301,6 +301,8 @@ func (v *MediaView) ShowDetail(ratingKey, mediaType string) tea.Cmd {
 	switch mediaType {
 	case "show":
 		dv = detail.NewShowDetailView(ratingKey, v.theme)
+	case "season":
+		dv = detail.NewSeasonDetailView(ratingKey, v.theme)
 	case "episode":
 		dv = detail.NewEpisodeDetailView(ratingKey, v.theme)
 	default: