lushapp 2.0.0

package/src/lush/ui.py

@@ -0,0 +1,690 @@
+# LUSH - User Interface and Main View
+import time
+import curses
+import pyperclip
+from .constants import (
+    LOGO_LINES, COMPACT_LOGO, SIDEBAR_SECTIONS, ALL_SIDEBAR_ITEMS,
+    AMBIENT_PRESETS, VISUALIZER_MODES, VISUALIZER_LABELS,
+    SHIMMER_PALETTES, DEFAULT_THEMES
+)
+from .state import PlayerState, save_stations, save_favorites, save_config
+from .ui_helpers import get_source_tag, trim, apply_theme, get_shimmer_color_pair
+from .modals import (
+    show_age_verification_modal,
+    show_headphone_warning_modal,
+    show_add_station_modal,
+    show_settings_modal,
+    show_ambient_modal,
+    show_theme_selector,
+    show_help_modal,
+    show_welcome_modal,
+    show_insights_modal
+)
+
+def render_now_playing_deck(stdscr, box2_y, right_start_x, right_w, box2_h, state, playing, t_now):
+    max_h, max_w = stdscr.getmaxyx()
+    def safe_add(y, x, text, attr=0):
+        if 0 <= y < max_h and 0 <= x < max_w:
+            avail = max_w - x
+            if avail > 0:
+                try:
+                    stdscr.addstr(y, x, text[:avail], attr)
+                except Exception:
+                    pass
+
+    deck_style = getattr(state, "deck_style", "vinyl")
+    cur_station = state.stations[state.idx] if (0 <= state.idx < len(state.stations)) else {"name": "LUSH Radio", "genre": "Various"}
+    cur_track = state.current_track or cur_station["name"]
+
+    # Outer Box Frame
+    deck_title = "TECHNICS DIRECT-DRIVE VINYL" if deck_style == "vinyl" else "NAKAMICHI STUDIO CASSETTE"
+    title = f" NOW PLAYING STUDIO • {deck_title} "
+    top_line = f"┌─[{title}]" + "─" * max(0, right_w - len(title) - 5) + "┐"
+    safe_add(box2_y, right_start_x, trim(top_line, right_w), curses.color_pair(8))
+
+    for y_rel in range(1, box2_h - 1):
+        safe_add(box2_y + y_rel, right_start_x, "│", curses.color_pair(8))
+        safe_add(box2_y + y_rel, right_start_x + right_w - 1, "│", curses.color_pair(8))
+
+    bot_line = "└" + "─" * (right_w - 2) + "┘"
+    safe_add(box2_y + box2_h - 1, right_start_x, trim(bot_line, right_w), curses.color_pair(8))
+
+    inner_w = max(10, right_w - 4)
+    inner_x = right_start_x + 2
+
+    # 1. VINYL TURNTABLE DECK
+    if deck_style == "vinyl":
+        spindles = ['◴', '◵', '◶', '◷']
+        spin_ch = spindles[int(t_now * 4.5) % 4] if playing else '◴'
+        strobe_status = "● LOCKED" if playing else "○ STANDBY"
+        tonearm_status = "ENGAGED" if playing else "RESTING"
+
+        vinyl_lines = [
+            "   . ──'   ░▒▓████████████████▓▒░   '── .       \\===[O]",
+            " .´  ░▒▓████▀▀▀▀        ▀▀▀▀████▓▒░  `.    \\",
+            "/ ░▒▓███▀          ╭────────╮       ▀███▓▒░ \\    \\",
+            ": ░▒▓██│    ●       │ LUSH ♫ │    ●   │██▓▒░ :     │",
+            f": ░▒▓███.           ╰───({spin_ch})──╯        .███▓▒░ :     │",
+            "\\ ░▒▓███▄          VINYL LP         ▄███▓▒░ /     ╱ \\",
+            " `.  ░▒▓████▄▄▄▄        ▄▄▄▄████▓▒░ .´      ╱   [▮]",
+            "   `── .   ░▒▓████████████████▓▒░   . ──´    ╱     •needle"
+        ]
+        start_deck_y = box2_y + 1
+        for r_i, v_l in enumerate(vinyl_lines):
+            draw_y = start_deck_y + r_i
+            if draw_y >= box2_y + box2_h - 5: break
+            safe_add(draw_y, inner_x + max(0, (inner_w - len(v_l)) // 2), trim(v_l, inner_w), curses.color_pair(2) | curses.A_BOLD)
+
+        stat_y = start_deck_y + len(vinyl_lines)
+        if stat_y < box2_y + box2_h - 4:
+            strobe_bar = f"SPEED: [33⅓ RPM]  STROBE: {strobe_status}        TONEARM: [{tonearm_status}]"
+            safe_add(stat_y, inner_x + max(0, (inner_w - len(strobe_bar)) // 2), trim(strobe_bar, inner_w), curses.color_pair(6))
+
+    # 2. CASSETTE MASTER DECK
+    else:
+        reels = ['✸', '✹', '✶', '✦']
+        reel_ch = reels[int(t_now * 5.0) % 4] if playing else '✸'
+        time_sec = int(t_now) % 3600
+        counter_str = f"{time_sec // 60:02d} : {time_sec % 60:02d}"
+
+        cassette_lines = [
+            "╔═══════════════════════════════════════════════════════╗",
+            "║ [A] LUSH MASTER TAPE  •  70µs EQ  •  NR: [DOLBY B-C]  ║",
+            "║ ┌───────────────────────────────────────────────────┐ ║",
+            "║ │  ╭───╮   ▓▓▓▓▓▓▓▓▓\\           /░░░░░   ╭───╮      │ ║",
+            f"║ │ │ ( {reel_ch} ) │  ══════════\\─[ ♫ ]─/═══════ │ ( {reel_ch} ) │     │ ║",
+            "║ │  ╰───╯   ◄◄ REEL-L             REEL-R ►►╰───╯     │ ║",
+            "║ └───────────────────[ O ═ █HEAD█ ═ O ]──────────────┘ ║",
+            f"║  [◀◀ REW]   [▶ PLAY]   [■ STOP]   COUNTER: [ {counter_str} ] ║",
+            "╚═══════════════════════════════════════════════════════╝"
+        ]
+        start_deck_y = box2_y + 1
+        for r_i, c_l in enumerate(cassette_lines):
+            draw_y = start_deck_y + r_i
+            if draw_y >= box2_y + box2_h - 5: break
+            safe_add(draw_y, inner_x + max(0, (inner_w - len(c_l)) // 2), trim(c_l, inner_w), curses.color_pair(2) | curses.A_BOLD)
+
+        stat_y = start_deck_y + len(cassette_lines)
+        if stat_y < box2_y + box2_h - 4 and hasattr(state, "cava") and state.cava:
+            bars = list(state.cava.bars)
+            half = len(bars) // 2
+            l_amp = max(bars[:half]) if half > 0 else 0
+            r_amp = max(bars[half:]) if half > 0 else 0
+            l_bar = '█' * int((l_amp / 8.0) * 12) + '░' * (12 - int((l_amp / 8.0) * 12))
+            r_bar = '█' * int((r_amp / 8.0) * 12) + '░' * (12 - int((r_amp / 8.0) * 12))
+            vu_str = f"CH-L: [{l_bar}] -{max(0, 8 - l_amp)}dB    CH-R: [{r_bar}] -{max(0, 8 - r_amp)}dB"
+            safe_add(stat_y, inner_x + max(0, (inner_w - len(vu_str)) // 2), trim(vu_str, inner_w), curses.color_pair(6) | curses.A_BOLD)
+
+    # Info line
+    info_y = box2_y + box2_h - 4
+    if info_y > box2_y + 4:
+        tr_info = f"→ Track  : {cur_track} ({cur_station.get('genre', 'Music')})"
+        safe_add(info_y, inner_x, trim(tr_info, inner_w), curses.color_pair(4) | curses.A_BOLD)
+
+    # CAVA Spectrum line
+    cava_y = box2_y + box2_h - 3
+    if cava_y > box2_y + 5 and hasattr(state, "cava") and state.cava:
+        spec_str = f"→ CAVA   : {state.cava.get_spectrum_str(min(42, inner_w - 14), playing)}"
+        safe_add(cava_y, inner_x, trim(spec_str, inner_w), curses.color_pair(2) | curses.A_BOLD)
+
+    # Hotkey hints
+    hint_y = box2_y + box2_h - 2
+    if hint_y > box2_y + 6:
+        other_deck = "Cassette Deck" if deck_style == "vinyl" else "Vinyl Turntable"
+        hint_text = f" [Space:Play/Pause]  [d:Switch to {other_deck}]  [b:Favs]  [c:Copy Track]  [r:Record FLAC] "
+        safe_add(hint_y, inner_x + max(0, (inner_w - len(hint_text)) // 2), trim(hint_text, inner_w), curses.A_DIM)
+
+
+def curses_main(stdscr, state: PlayerState):
+    curses.curs_set(0)
+    stdscr.timeout(0)
+    stdscr.keypad(True)
+    try:
+        curses.set_escdelay(25)
+    except Exception:
+        pass
+
+    if curses.has_colors():
+        curses.start_color()
+        try:
+            curses.use_default_colors()
+        except Exception:
+            pass
+
+    apply_theme(state.theme_name, state.themes)
+
+    def draw():
+        stdscr.erase()
+        h, w = stdscr.getmaxyx()
+
+        def safe_addstr(y, x, s, attr=curses.A_NORMAL):
+            if 0 <= y < h and 0 <= x < w:
+                try:
+                    stdscr.addstr(y, x, trim(s, w - x - 1), attr)
+                except Exception:
+                    pass
+        apply_theme(state.theme_name, state.themes)
+
+        # -------------------------------------------------------------
+        # 1. TOP HEADER & LUSH LOGO WITH LIVE SHIMMER WAVE
+        # -------------------------------------------------------------
+        t_now = time.time()
+        shimmer_eff = getattr(state, "shimmer_effect", "wave")
+
+        if h >= 22:
+            for row_i, l_text in enumerate(LOGO_LINES):
+                for c_idx, ch in enumerate(l_text):
+                    if ch == " ": continue
+                    x_norm = c_idx / max(1, len(l_text) - 1)
+                    cava_bars = list(state.cava.bars) if (hasattr(state, "cava") and state.cava) else None
+                    p_id = get_shimmer_color_pair(shimmer_eff, x_norm, c_idx, row_i, t_now, cava_bars=cava_bars, is_playing=state.playing)
+                    attr = curses.color_pair(p_id) | curses.A_BOLD
+                    stdscr.addstr(1 + row_i, 2 + c_idx, ch, attr)
+            main_start_y = 4
+        else:
+            for c_idx, ch in enumerate(COMPACT_LOGO):
+                x_norm = c_idx / max(1, len(COMPACT_LOGO) - 1)
+                cava_bars = list(state.cava.bars) if (hasattr(state, "cava") and state.cava) else None
+                p_id = get_shimmer_color_pair(shimmer_eff, x_norm, c_idx, 0, t_now, cava_bars=cava_bars, is_playing=state.playing)
+                attr = curses.color_pair(p_id) | curses.A_BOLD
+                stdscr.addstr(0, 2 + c_idx, ch, attr)
+            main_start_y = 2
+
+        # Right side stats: Real Live Network Speeds (↓ Down / ↑ Up) + Bitrate + Rec
+        with state.lock:
+            st_count = len(state.stations)
+            playing = state.playing
+            current_station = state.stations[state.idx]
+            current_track = state.current_track
+            filtered_stations = state.get_filtered_stations_unlocked()
+            fav_count = len(state.favorites)
+            hist_count = len(state.history)
+            vol_str = f"Vol: {state.volume}%"
+            rec_on = state.audio.recording
+            rec_dur = int(time.time() - state.audio.rec_start_time) if rec_on else 0
+            amb_preset = state.ambient_preset
+            net_down = state.net_down_str
+            net_up = state.net_up_str
+            stream_br = state.stream_bitrate
+
+        status_tag = f"▶ {stream_br}" if playing else "■ PAUSED"
+        hud_elements = [f"{net_down}  {net_up}", status_tag]
+
+        if rec_on:
+            rec_blink = "● REC" if int(t_now * 2) % 2 == 0 else "○ REC"
+            rec_str = f"{rec_blink} [{rec_dur//60:02d}:{rec_dur%60:02d}]"
+            hud_elements.append(rec_str)
+
+        if amb_preset != "none":
+            amb_name = next((p["name"].split()[0] for p in AMBIENT_PRESETS if p["id"] == amb_preset), "FX")
+            hud_elements.append(f"{amb_name} {state.ambient_volume}%")
+
+        hud_elements.append(vol_str)
+        hud_elements.append(f"{st_count} stns")
+
+        header_stats = "  │  ".join(hud_elements)
+        header_y = 1 if h >= 22 else 0
+        if w > len(LOGO_LINES[0]) + len(header_stats) + 4:
+            stat_x = w - len(header_stats) - 2
+            stdscr.addstr(header_y, stat_x, header_stats, curses.color_pair(4))
+            if rec_on:
+                rec_match = f"REC [{rec_dur//60:02d}:{rec_dur%60:02d}]"
+                r_pos = header_stats.find("REC")
+                if r_pos != -1:
+                    stdscr.addstr(header_y, stat_x + r_pos - 2, "● " + rec_match, curses.color_pair(15) | curses.A_BOLD)
+
+        # -------------------------------------------------------------
+        # 2. LEFT SIDEBAR (DISCOVER / TRANSFERS / CONFIG)
+        # -------------------------------------------------------------
+        sidebar_w = 17
+        right_start_x = sidebar_w + 3
+        right_w = max(25, w - right_start_x - 2)
+
+        sb_y = main_start_y
+        flat_idx = 0
+
+        for sec in SIDEBAR_SECTIONS:
+            if sb_y >= h - 1: break
+            safe_addstr(sb_y, 2, sec["title"], curses.color_pair(2) | curses.A_BOLD)
+            sb_y += 1
+
+            for item in sec["items"]:
+                if sb_y >= h - 1:
+                    flat_idx += 1
+                    continue
+                is_selected_section = (item["key"] == state.section_key)
+                is_focused_sb = (state.region == "sidebar" and flat_idx == state.sidebar_idx)
+
+                count_str = ""
+                if item["key"] == "bookmarks":
+                    count_str = f"({fav_count})"
+                elif item["key"] == "history":
+                    count_str = f"({hist_count})"
+                elif item["key"] == "insights":
+                    count_str = f"({state.stats.total_scrobbles})" if hasattr(state, "stats") else ""
+                elif item["key"] == "ambient_fx":
+                    count_str = "ON" if amb_preset != "none" else "OFF"
+
+                if is_focused_sb:
+                    prefix = "→ "
+                    attr = curses.color_pair(6) | curses.A_BOLD
+                elif is_selected_section:
+                    prefix = "→ "
+                    attr = curses.color_pair(2) | curses.A_BOLD
+                else:
+                    prefix = "  "
+                    attr = curses.A_NORMAL
+
+                display_text = f"{prefix}{item['label']}"
+                safe_addstr(sb_y, 2, trim(display_text, sidebar_w - 4), attr)
+                if count_str and len(display_text) + len(count_str) + 1 <= sidebar_w:
+                    safe_addstr(sb_y, 2 + sidebar_w - len(count_str), count_str, curses.color_pair(9))
+
+                sb_y += 1
+                flat_idx += 1
+
+            if h >= 26:
+                sb_y += 1
+
+        # -------------------------------------------------------------
+        # 3. RIGHT MAIN PANELS (LUSH Bracketed Frame Boxes + Visualizer)
+        # -------------------------------------------------------------
+        # Box 1: [ NOW PLAYING / SEARCH / REAL-TIME CAVA VISUALIZER ]
+        search_box_y = main_start_y
+        search_box_h = 3
+
+        b1_title = " SEARCH " if state.search_active else " NOW PLAYING "
+        b1_frame_top = f"┌─[{b1_title}]" + "─" * max(0, right_w - len(b1_title) - 5) + "┐"
+        stdscr.addstr(search_box_y, right_start_x, trim(b1_frame_top, right_w), curses.color_pair(8))
+
+        stdscr.addstr(search_box_y + 1, right_start_x, "│", curses.color_pair(8))
+        if state.search_active:
+            search_line = f" → Search: {state.search_query}█"
+            stdscr.addstr(search_box_y + 1, right_start_x + 1, trim(search_line, right_w - 2), curses.color_pair(4) | curses.A_BOLD)
+        elif state.search_query:
+            search_line = f" → Filter: {state.search_query} (Press / to edit, ESC to clear)"
+            stdscr.addstr(search_box_y + 1, right_start_x + 1, trim(search_line, right_w - 2), curses.color_pair(4))
+        else:
+            status_icon = "▶" if playing else "■"
+            track_prefix = f" {status_icon} [{current_station['name']}] {current_track}"
+
+            vis_mode = state.visualizer_mode
+            if vis_mode != "off" and right_w > 50:
+                vis_w = min(34, max(12, right_w - len(track_prefix) - 6))
+                stdscr.addstr(search_box_y + 1, right_start_x + 1, trim(track_prefix, right_w - vis_w - 5), curses.color_pair(4) | curses.A_BOLD)
+                vis_start_x = right_start_x + right_w - vis_w - 1
+
+                max_draw_x = right_start_x + right_w - 2
+                elements = None
+                vis_art = None
+
+                if vis_mode == "shimmer_string":
+                    elements = state.cava.get_shimmer_string_elements(vis_w, playing, t_now)
+                elif vis_mode == "harmonic_strings":
+                    elements = state.cava.get_harmonic_strings_elements(vis_w, playing, t_now)
+                elif vis_mode == "laser_cords":
+                    elements = state.cava.get_laser_cords_elements(vis_w, playing, t_now)
+                elif vis_mode == "quantum_strings":
+                    elements = state.cava.get_quantum_strings_elements(vis_w, playing, t_now)
+                elif vis_mode == "aurora_ribbon":
+                    elements = state.cava.get_aurora_ribbon_elements(vis_w, playing, t_now)
+                elif vis_mode == "stereo_harp":
+                    elements = state.cava.get_stereo_harp_elements(vis_w, playing, t_now)
+                elif vis_mode == "shimmer_spectrum":
+                    elements = state.cava.get_shimmer_spectrum_elements(vis_w, playing, t_now)
+                elif vis_mode == "mirrored_butterfly":
+                    elements = state.cava.get_mirrored_butterfly_elements(vis_w, playing, t_now)
+                elif vis_mode == "matrix_rain":
+                    elements = state.cava.get_matrix_rain_elements(vis_w, playing, t_now)
+                elif vis_mode == "frequency_beams":
+                    elements = state.cava.get_frequency_beams_elements(vis_w, playing, t_now)
+                elif vis_mode == "sine_interference":
+                    elements = state.cava.get_sine_interference_elements(vis_w, playing, t_now)
+                elif vis_mode == "braille_oscilloscope":
+                    elements = state.cava.get_braille_oscilloscope_elements(vis_w, playing, t_now)
+                elif vis_mode == "radial_shock_burst":
+                    elements = state.cava.get_radial_shock_burst_elements(vis_w, playing, t_now)
+                elif vis_mode == "starlight_constellation":
+                    elements = state.cava.get_starlight_constellation_elements(vis_w, playing, t_now)
+                elif vis_mode == "waveform":
+                    vis_art = state.cava.get_waveform_str(vis_w, playing)
+                elif vis_mode == "vu":
+                    vis_art = state.cava.get_stereo_vu_str(vis_w, playing)
+                elif vis_mode == "dots":
+                    elements = state.cava.get_peak_dots_elements(vis_w, playing, t_now)
+                else: # hud
+                    vis_art = f"[{state.cava.get_spectrum_str(8, playing)}]"
+
+                if elements:
+                    for col_i, (ch, p_id) in enumerate(elements):
+                        draw_x = vis_start_x + col_i
+                        if draw_x <= max_draw_x:
+                            stdscr.addstr(search_box_y + 1, draw_x, ch, curses.color_pair(p_id) | curses.A_BOLD)
+                elif vis_art:
+                    max_w = max_draw_x - vis_start_x + 1
+                    if max_w > 0:
+                        stdscr.addstr(search_box_y + 1, vis_start_x, trim(vis_art, max_w), curses.color_pair(2) | curses.A_BOLD)
+            else:
+                stdscr.addstr(search_box_y + 1, right_start_x + 1, trim(track_prefix, right_w - 2), curses.color_pair(4) | curses.A_BOLD)
+
+        stdscr.addstr(search_box_y + 1, right_start_x + right_w - 1, "│", curses.color_pair(8))
+
+        b1_frame_bot = "└" + "─" * (right_w - 2) + "┘"
+        stdscr.addstr(search_box_y + 2, right_start_x, trim(b1_frame_bot, right_w), curses.color_pair(8))
+
+        # Box 2: [ LATEST - N ]
+        box2_y = search_box_y + 3
+        box2_h = max(6, h - box2_y - 3)
+
+        cur_item = state.get_current_sidebar_item()
+        if cur_item["key"] == "playing":
+            render_now_playing_deck(stdscr, box2_y, right_start_x, right_w, box2_h, state, playing, t_now)
+        else:
+            b2_title = f" {cur_item['label'].upper()} • {len(filtered_stations)} "
+            b2_top_line = f"┌─[{b2_title}]" + "─" * max(0, right_w - len(b2_title) - 5) + "┐"
+            stdscr.addstr(box2_y, right_start_x, trim(b2_top_line, right_w), curses.color_pair(8))
+
+            # Subheader line with active Music Quick-Tabs
+            sub_title = f"Category: {cur_item['label']}"
+            stdscr.addstr(box2_y + 1, right_start_x, "│", curses.color_pair(8))
+
+            # Music & Radio Quick-Tabs (1:TOP 2:GENZ 3:LEGENDS 4:NEWAGE 5:ALL 0:RADIO)
+            tabs_def = [
+                ("1:TOP", "top_artists"),
+                ("2:GENZ", "artist_genz"),
+                ("3:LEGENDS" if right_w >= 66 else "3:LEG", "artist_legends"),
+                ("4:NEWAGE" if right_w >= 66 else "4:NEW", "artist_newage"),
+                ("5:ALL", "music"),
+                ("0:RADIO" if right_w >= 66 else "0:RAD", "all_radio")
+            ]
+
+            tab_tokens = []
+            for tag, k in tabs_def:
+                if cur_item["key"] == k:
+                    tab_tokens.append((f"[{tag}]", True))
+                else:
+                    tab_tokens.append((f" {tag} ", False))
+
+            tot_tab_len = sum(len(txt) for txt, _ in tab_tokens)
+            avail_sub = right_w - tot_tab_len - 4
+
+            if avail_sub > 8:
+                stdscr.addstr(box2_y + 1, right_start_x + 2, trim(sub_title, avail_sub), curses.color_pair(2))
+                tx = right_start_x + right_w - tot_tab_len - 1
+                for txt, is_act in tab_tokens:
+                    attr = (curses.color_pair(6) | curses.A_BOLD) if is_act else curses.color_pair(7)
+                    stdscr.addstr(box2_y + 1, tx, txt, attr)
+                    tx += len(txt)
+            else:
+                stdscr.addstr(box2_y + 1, right_start_x + 2, trim(sub_title, right_w - 4), curses.color_pair(2))
+
+            stdscr.addstr(box2_y + 1, right_start_x + right_w - 1, "│", curses.color_pair(8))
+
+            # Table Column Headers
+            stdscr.addstr(box2_y + 2, right_start_x, "│", curses.color_pair(8))
+            hdr_name = "TRACK TITLE" if cur_item["key"] == "history" else ("TOP ARTIST" if cur_item["key"] == "top_artists" else ("ARTIST DISC" if cur_item["key"] in ("artist_genz", "artist_legends", "artist_newage", "music") else "STATION NAME"))
+            stdscr.addstr(box2_y + 2, right_start_x + 2, "  ", curses.A_NORMAL)
+            stdscr.addstr(box2_y + 2, right_start_x + 4, f"{'#':>3}", curses.color_pair(2) | curses.A_BOLD)
+            stdscr.addstr(box2_y + 2, right_start_x + 7, "   ", curses.A_NORMAL)
+            stdscr.addstr(box2_y + 2, right_start_x + 10, hdr_name, curses.color_pair(2) | curses.A_BOLD)
+
+            col_hdr_right = "STATION          TIME   STATUS" if cur_item["key"] == "history" else ("GENRE            SRC    STATUS")
+            if right_w > 50:
+                stdscr.addstr(box2_y + 2, right_start_x + right_w - len(col_hdr_right) - 3, col_hdr_right, curses.color_pair(2) | curses.A_BOLD)
+            stdscr.addstr(box2_y + 2, right_start_x + right_w - 1, "│", curses.color_pair(8))
+
+            # Stations Rows
+            max_rows = box2_h - 4
+            total_st = len(filtered_stations)
+
+            if total_st == 0:
+                stdscr.addstr(box2_y + 4, right_start_x + 4, "No stations found in this category / search.", curses.A_DIM)
+            else:
+                state.cursor_idx = max(0, min(state.cursor_idx, total_st - 1))
+
+                if total_st <= max_rows:
+                    scroll_offset = 0
+                else:
+                    scroll_offset = max(0, min(state.cursor_idx - max_rows // 2, total_st - max_rows))
+
+                visible_rows = filtered_stations[scroll_offset:scroll_offset + max_rows]
+
+                for row_rel, (orig_i, st) in enumerate(visible_rows):
+                    cur_item_idx = scroll_offset + row_rel
+                    is_selected = (cur_item_idx == state.cursor_idx and state.region == "content")
+                    is_now_playing = (orig_i == state.idx)
+                    is_favorite = (st["name"] in state.favorites)
+
+                    arrow = "→ " if is_selected else "  "
+                    num_str = f"{orig_i + 1:>3}"
+                    fav_mark = "* " if is_favorite else "  "
+                    prefix = f"{arrow}{num_str} {fav_mark}"  # Strictly 8 characters
+
+                    name_max_w = max(10, right_w - 40)
+                    name_str = trim(st['name'], name_max_w)
+
+                    if cur_item["key"] == "history":
+                        genre_str = f"{trim(st.get('station', st.get('genre', '')), 14):<14}"
+                        src_str = f"{trim(st.get('time', 'RECENT'), 6):<6}"
+                    else:
+                        genre_str = f"{trim(st.get('genre', ''), 14):<14}"
+                        src_str = f"{get_source_tag(st.get('url', '')):<6}"
+                    status_text = "▶ PLAYING" if (is_now_playing and playing) else ("■ PAUSED" if is_now_playing else "  READY")
+
+                    draw_y = box2_y + 3 + row_rel
+                    stdscr.addstr(draw_y, right_start_x, "│", curses.color_pair(8))
+
+                    row_left = f"{prefix}{name_str}"
+                    row_right = f"{genre_str} {src_str} {status_text}"
+
+                    if is_selected:
+                        full_line = f"{row_left:<{right_w - len(row_right) - 4}} {row_right}"
+                        stdscr.addstr(draw_y, right_start_x + 2, trim(full_line, right_w - 4), curses.color_pair(6) | curses.A_BOLD)
+                    elif is_now_playing:
+                        full_line = f"{row_left:<{right_w - len(row_right) - 4}} {row_right}"
+                        stdscr.addstr(draw_y, right_start_x + 2, trim(full_line, right_w - 4), curses.color_pair(5) | curses.A_BOLD)
+                    else:
+                        stdscr.addstr(draw_y, right_start_x + 2, arrow, curses.A_NORMAL)
+                        stdscr.addstr(draw_y, right_start_x + 4, num_str, curses.color_pair(4))
+                        stdscr.addstr(draw_y, right_start_x + 7, " ", curses.A_NORMAL)
+                        stdscr.addstr(draw_y, right_start_x + 8, fav_mark, curses.color_pair(4) | curses.A_BOLD if is_favorite else curses.A_NORMAL)
+                        stdscr.addstr(draw_y, right_start_x + 10, name_str, curses.color_pair(7))
+                        if right_w > 50:
+                            stdscr.addstr(draw_y, right_start_x + right_w - len(row_right) - 3, row_right, curses.color_pair(7))
+
+                    stdscr.addstr(draw_y, right_start_x + right_w - 1, "│", curses.color_pair(8))
+
+                for empty_r in range(len(visible_rows), max_rows):
+                    draw_y = box2_y + 3 + empty_r
+                    stdscr.addstr(draw_y, right_start_x, "│" + " " * (right_w - 2) + "│", curses.color_pair(8))
+
+            # Bottom bracket
+            b2_frame_bot = "└" + "─" * (right_w - 2) + "┘"
+            stdscr.addstr(box2_y + box2_h - 1, right_start_x, trim(b2_frame_bot, right_w), curses.color_pair(8))
+
+        # -------------------------------------------------------------
+        # 4. BOTTOM ACTION / HOTKEY BAR
+        # -------------------------------------------------------------
+        footer_y = h - 2
+
+        if state.toast_msg and time.time() < state.toast_time:
+            toast_text = f" {state.toast_msg} "
+            stdscr.addstr(footer_y, 2, toast_text, curses.color_pair(2) | curses.A_REVERSE | curses.A_BOLD)
+        else:
+            hk_items = [
+                ("↑↓←→", "Move"),
+                ("SPACE", "Play/Pause"),
+                ("ENTER", "Play"),
+                ("v", "Vis"),
+                ("e/E", "Ambient"),
+                ("R", "Record FLAC"),
+                ("b", "Fav"),
+                ("1-5", "Music"),
+                ("0", "Radio"),
+                ("/", "Search"),
+                ("+/-", "Vol"),
+                ("s", "Settings"),
+                ("I", "Insights"),
+                ("tab", "Switch"),
+                ("?", "Keys"),
+                ("q", "Quit")
+            ]
+            cx = 2
+            for k_code, k_desc in hk_items:
+                if cx + len(k_code) + len(k_desc) + 3 >= w:
+                    break
+                stdscr.addstr(footer_y, cx, k_code, curses.color_pair(2) | curses.A_BOLD)
+                cx += len(k_code) + 1
+                stdscr.addstr(footer_y, cx, k_desc, curses.A_NORMAL)
+                cx += len(k_desc) + 2
+
+        stdscr.refresh()
+
+    # Main interaction loop (~33fps smooth animation)
+    draw()
+    while not state.quit:
+        try:
+            ch = stdscr.getch()
+        except Exception:
+            ch = -1
+        if ch != -1:
+            h, width = stdscr.getmaxyx()
+
+            # --- SEARCH INPUT MODE ---
+            if state.search_active:
+                if ch in (27,):  # ESC cancels search
+                    state.search_active = False
+                    state.search_query = ""
+                elif ch in (ord('\n'), curses.KEY_ENTER, 10, 13):
+                    state.search_active = False
+                    state.region = "content"
+                elif ch in (curses.KEY_BACKSPACE, 127, 8):
+                    if state.search_query:
+                        state.search_query = state.search_query[:-1]
+                elif 32 <= ch <= 126:
+                    state.search_query += chr(ch)
+                draw()
+                continue
+
+            # --- GLOBAL SHORTCUTS ---
+            if ch in (ord('q'), ord('Q')):
+                state.quit = True
+                break
+            elif ch in (9,):  # TAB key: toggle focus between Sidebar and Content
+                state.region = "sidebar" if state.region == "content" else "content"
+            elif ch in (ord('/'),):
+                state.search_active = True
+                state.search_query = ""
+            elif ch in (ord(' '),):
+                state.toggle_play()
+            elif ch in (ord('v'), ord('V')):
+                state.cycle_visualizer()
+            elif ch == ord('e'):
+                state.toggle_ambient()
+            elif ch == ord('E'):
+                show_ambient_modal(stdscr, state); draw()
+            elif ch in (ord('r'), ord('R')):  # R / r for Lossless FLAC Recording
+                state.toggle_recording()
+            elif ch in (ord('+'), ord('=')):
+                state.adjust_volume(5)
+            elif ch in (ord('-'), ord('_')):
+                state.adjust_volume(-5)
+            elif ch in (ord(']'),):
+                state.adjust_ambient_volume(5)
+            elif ch in (ord('['),):
+                state.adjust_ambient_volume(-5)
+            elif ch in (ord('p'), ord('P')):
+                state.select_section("playing")
+                state.region = "content"
+            elif ch in (ord('d'), ord('D')):
+                state.cycle_deck()
+            elif ch in (ord('b'), ord('B')):
+                state.toggle_favorite()
+            elif ch in (ord('c'), ord('C')):
+                with state.lock:
+                    pyperclip.copy(state.current_track)
+                state.set_toast(f"Copied track: {state.current_track}")
+            elif ch in (ord('?'),):
+                show_help_modal(stdscr, state); draw()
+            elif ch == ord('t'):
+                state.cycle_theme()
+            elif ch == ord('T'):
+                show_theme_selector(stdscr, state); draw()
+            elif ch == ord('s'):
+                show_settings_modal(stdscr, state); draw()
+            elif ch == ord('S'):
+                state.cycle_shimmer()
+            elif ch in (ord('a'), ord('A')):
+                show_add_station_modal(stdscr, state); draw()
+            elif ch in (ord('I'),):
+                show_insights_modal(stdscr, state); draw()
+            elif ord('0') <= ch <= ord('9'):
+                music_shortcuts = {
+                    ord('1'): "top_artists",
+                    ord('2'): "artist_genz",
+                    ord('3'): "artist_legends",
+                    ord('4'): "artist_newage",
+                    ord('5'): "music",
+                    ord('0'): "all_radio"
+                }
+                sel_sec = music_shortcuts.get(ch)
+                if sel_sec:
+                    state.select_section(sel_sec)
+                    state.region = "content"
+            elif ch in (ord('m'), ord('M'), ord('*')):
+                state.select_section("top_artists" if ch == ord('*') else "music")
+                state.region = "content"
+
+            # --- NAVIGATION IN SIDEBAR (FIXED: Cursor moves visual focus only, Enter applies) ---
+            elif state.region == "sidebar":
+                if ch in (curses.KEY_UP, ord('k'), ord('K')):
+                    state.sidebar_idx = (state.sidebar_idx - 1) % len(ALL_SIDEBAR_ITEMS)
+                elif ch in (curses.KEY_DOWN, ord('j'), ord('J')):
+                    state.sidebar_idx = (state.sidebar_idx + 1) % len(ALL_SIDEBAR_ITEMS)
+                elif ch in (ord('\n'), curses.KEY_ENTER, 10, 13, curses.KEY_RIGHT, ord('l'), ord('L')):
+                    sel_item = ALL_SIDEBAR_ITEMS[state.sidebar_idx]
+                    if sel_item["key"] == "themes":
+                        show_theme_selector(stdscr, state); draw()
+                    elif sel_item["key"] == "ambient_fx":
+                        show_ambient_modal(stdscr, state); draw()
+                    elif sel_item["key"] == "settings":
+                        show_settings_modal(stdscr, state); draw()
+                    elif sel_item["key"] == "insights":
+                        show_insights_modal(stdscr, state); draw()
+                    else:
+                        if sel_item["key"] == "lush" and not state.headphone_warned_session:
+                            show_headphone_warning_modal(stdscr, state)
+                            state.headphone_warned_session = True
+                        state.select_section(sel_item["key"])
+                        state.region = "content"
+
+            # --- NAVIGATION IN CONTENT / STATIONS LIST ---
+            elif state.region == "content":
+                filtered = state.get_filtered_stations()
+                if ch in (curses.KEY_UP, ord('k'), ord('K')):
+                    if filtered:
+                        state.cursor_idx = (state.cursor_idx - 1) % len(filtered)
+                elif ch in (curses.KEY_DOWN, ord('j'), ord('J')):
+                    if filtered:
+                        state.cursor_idx = (state.cursor_idx + 1) % len(filtered)
+                elif ch in (curses.KEY_LEFT, ord('h'), ord('H')):
+                    state.region = "sidebar"
+                elif ch in (ord('\n'), curses.KEY_ENTER, 10, 13):
+                    if filtered and state.cursor_idx < len(filtered):
+                        target_orig_idx = filtered[state.cursor_idx][0]
+                        state.play_station(target_orig_idx)
+                elif ch in (ord('a'), ord('A')):
+                    show_add_station_modal(stdscr, state)
+                    draw()
+
+            draw()
+        else:
+            t_frame_start = time.perf_counter()
+            draw()
+            fps = getattr(state, "framerate", 144)
+            interval = 1.0 / max(30, min(240, fps))
+            elapsed = time.perf_counter() - t_frame_start
+            sleep_dur = max(0.001, interval - elapsed)
+            time.sleep(sleep_dur)
+
+    state.shutdown()