mytunes-pro 2.0.2__py3-none-any.whl → 2.0.4__py3-none-any.whl

mytunes/app.py

@@ -1,7 +1,7 @@
 #!/usr/bin/env python3
 """
 MyTunes Pro - Professional TUI Edition v1.0
-Premium CLI Music Player with Curses Interface
+# Premium CLI Media Workflow Experiment with Curses Interface
 Enhanced with Context7-researched MPV IPC & Resize Handling
 """
 import curses
@@ -32,7 +32,7 @@ MPV_SOCKET = "/tmp/mpv_socket"
 LOG_FILE = "/tmp/mytunes_mpv.log"
 PID_FILE = "/tmp/mytunes_mpv.pid"
 APP_NAME = "MyTunes Pro"
-APP_VERSION = "2.0.2"
+APP_VERSION = "2.0.4"
 
 # === [Strings & Localization] ===
 STRINGS = {
@@ -52,10 +52,10 @@ STRINGS = {
         "fav_added": "★ 즐겨찾기에 추가됨",
         "fav_removed": "☆ 즐겨찾기 해제됨",
         "header_r1": "[S/1]검색 [F/2]즐겨찾기 [R/3]기록 [M/4]메인 [A/5]즐겨찾기추가 [Q/6]뒤로",
-        "header_r2": "[F7]유튜브 [F8]라이브 [F9]라이브공유 [SPC]Play/Stop [+/-]볼륨 [<>]빨리감기 [D/Del]삭제",
-        "help_guide": "[j/k]이동 [En]선택 [h/q]뒤로 [S/1]검색 [F/2]즐겨찾기 [R/3]기록 [M/4]메인 [F7]유튜브 [F8]라이브 [F9]라이브공유",
+        "header_r2": "[F7]유튜브 [SPC]Play/Stop [+/-]볼륨 [<>]빨리감기 [D/Del]삭제",
+        "help_guide": "[j/k]이동 [En]선택 [h/q]뒤로 [S/1]검색 [F/2]즐겨찾기 [R/3]기록 [M/4]메인 [F7]유튜브",
         "menu_main": "☰ 메인 메뉴",
-        "menu_search_results": "⌕ YouTube 음악 검색",
+        "menu_search_results": "⌕ 미디어 콘텐츠 검색",
         "menu_favorites": "★ 나의 즐겨찾기",
         "menu_history": "◷ 재생 기록",
         "menu_bg_play": "⧉ 백그라운드 재생 (나가기)",
@@ -81,10 +81,10 @@ STRINGS = {
         "fav_added": "★ Added to Favorites",
         "fav_removed": "☆ Removed from Favorites",
         "header_r1": "[S/1]Srch [F/2]Favs [R/3]Hist [M/4]Main [A/5]AddFav [Q/6]Back",
-        "header_r2": "[F7]YT [F8]Live [F9]LiveShare [SPC]Play/Stop [+/-]Vol [<>]Seek [D/Del]Del",
-        "help_guide": "[j/k]Move [En]Select [h/q]Back [S/1]Srch [F/2]Fav [R/3]Hist [M/4]Main [F7]YT [F8]Live [F9]Share",
+        "header_r2": "[F7]YT [SPC]Play/Stop [+/-]Vol [<>]Seek [D/Del]Del",
+        "help_guide": "[j/k]Move [En]Select [h/q]Back [S/1]Srch [F/2]Fav [R/3]Hist [M/4]Main [F7]YT",
         "menu_main": "☰ Main Menu",
-        "menu_search_results": "⌕ Search YouTube Music",
+        "menu_search_results": "⌕ Search Media Content",
         "menu_favorites": "★ My Favorites",
         "menu_history": "◷ History",
         "menu_bg_play": "⧉ Background Play (Leave)",
@@ -311,7 +311,7 @@ class Player:
             # 'accessory' hides Dock but allows system resources
             cmd.append("--macos-app-activation-policy=accessory")
             
-        # C. YouTube 403 Forbidden Bypass (Cross-platform robustness)
+        # C. Media Source 403 Forbidden Bypass (Cross-platform robustness)
         # This uses the Android player client which is currently the most stable
         # and avoids HLS segment blocks on both Linux and macOS.
         cmd.extend([
@@ -467,9 +467,6 @@ class MyTunesApp:
         curses.mousemask(curses.ALL_MOUSE_EVENTS | curses.REPORT_MOUSE_POSITION)
         print("\033[?1003h") # Enable mouse tracking
 
-        # Sharing Client (Serverless Proxy)
-        self.pusher = None # Deprecated: Direct Pusher client removed for security
-        self.share_api_url = "https://postgresql.co.kr/api/pusher/mytunes"
         self.sent_history = {}
 
 
@@ -585,332 +582,191 @@ class MyTunesApp:
         m, s = divmod(int(seconds), 60)
         return f"{m:02d}:{s:02d}"
 
-    def handle_input(self):
+    def get_next_event(self):
+        """Unified input collection and normalization (Unicode, special keys, macros)."""
         try:
-            # Use get_wch for Unicode support (captures Korean shortcuts)
             key = self.stdscr.get_wch()
-        except curses.error:
-            return
-        except:
-            return
-
-        if key == -1: return
+        except curses.error: return None
+        except: return None
 
-        # Reset Idle Timer
+        if key == -1: return None
         self.last_input_time = time.time()
 
-
-        # Handle formatting: invalid key might be int -1
-        
-        # Resize Info
+        # 1. Resize handling
         if key == curses.KEY_RESIZE:
             self.stdscr.clear()
             self.stdscr.refresh()
-            return
+            return "RESIZE"
 
-        # GLOBAL ESC: Background Play (Exit but keep music)
-        # get_wch returns int 27 or str '\x1b' depending on system/lib
-        # v2.0.1 MAC FIX: Check for Option+Backspace (ESC then 127) for Deletion
+        # 2. ESC / Combined sequences (Option+Backspace macro)
         if key == 27 or key == '\x1b':
-            # Peek for next key with very short timeout
-            self.stdscr.timeout(50)
+            self.stdscr.timeout(50) # Tiny peek timeout
             try:
-                next_key = self.stdscr.getch()
-                if next_key == 127: # Backspace
-                     # This is Option+Backspace -> Treat as DELETE
-                     key = curses.KEY_DC # Transform to Delete Key
-                else:
-                     # If valid key but not 127, put it back or handle? 
-                     # For simplicity, if it's not the sequence we want, we treat ESC as ESC
-                     # and if we consumed a key, well, generic ESC logic applies. 
-                     # Ideally ungetch if possible, but for now fallback to ESC behavior.
-                     # But if we consumed a legitimate key user typed fast, that's bad.
-                     # However, 50ms is very fast.
-                     if next_key != -1:
-                        curses.ungetch(next_key)
-                     
-                     # Proceed with standard ESC behavior
-                     self.stop_on_exit = False
-                     self.running = False
-                     return
-            except:
-                # Timeout / Error -> Just ESC
-                self.stop_on_exit = False
-                self.running = False
-                return
-            finally:
-                # Restore timeout
-                self.stdscr.timeout(1000 if (time.time() - getattr(self, 'last_input_time', 0) > 60 and self.is_paused) else 200)
+                nk = self.stdscr.getch()
+                if nk == 127: return "DELETE" # Option+Backspace as DELETE
+                if nk != -1: curses.ungetch(nk)
+            except: pass
+            finally: self.stdscr.timeout(200) # Reset to standard
+            return "EXIT_BKG" # Standard ESC
 
-        # Handle Mouse Click
+        # 3. Mouse Click
         if key == curses.KEY_MOUSE:
             try:
                 _, mx, my, _, bstate = curses.getmouse()
-                if bstate & curses.BUTTON1_CLICKED or bstate & curses.BUTTON1_RELEASED:
+                if bstate & (curses.BUTTON1_CLICKED | curses.BUTTON1_RELEASED):
                     h, w = self.stdscr.getmaxyx()
                     branding = "mytunes-pro.com/postgresql.co.kr"
-                    branding_len = len(branding)
-                    branding_x = w - 2 - branding_len
-                    
+                    branding_x = w - 2 - len(branding)
                     if my == h - 2 and branding_x <= mx < w - 2:
-                        # Check which part was clicked
-                        # mytunes-pro.com (first 15 chars)
-                        # / (1 char)
-                        # postgresql.co.kr (last 16 chars)
                         rel_x = mx - branding_x
-                        if rel_x < 15:
-                            url = "https://mytunes-pro.com"
-                            self.open_browser(url)
-                        elif rel_x > 15:
-                            url = "https://postgresql.co.kr"
-                            self.open_browser(url)
-            except:
-                pass
-            return
+                        if rel_x < 15: return "OPEN_HOME"
+                        if rel_x > 15: return "OPEN_PARTNER"
+            except: pass
+            return "MOUSE_CLICK"
+
+        # 4. Standard Keys Mapping
+        k_char = str(key).lower() if isinstance(key, str) else str(key)
+        mapping = {
+            str(curses.KEY_LEFT): "NAV_BACK", str(curses.KEY_BACKSPACE): "NAV_BACK", "127": "NAV_BACK",
+            "q": "NAV_BACK", "6": "NAV_BACK", "h": "NAV_BACK",
+            str(curses.KEY_RIGHT): "NAV_FORWARD", "l": "NAV_FORWARD",
+            str(curses.KEY_UP): "MOVE_UP", "k": "MOVE_UP",
+            str(curses.KEY_DOWN): "MOVE_DOWN", "j": "MOVE_DOWN",
+            "\n": "ACTIVATE", "\r": "ACTIVATE", "10": "ACTIVATE", "13": "ACTIVATE", str(curses.KEY_ENTER): "ACTIVATE",
+            "s": "SEARCH", "1": "SEARCH", "/": "SEARCH",
+            "f": "FAVORITES", "2": "FAVORITES",
+            "r": "HISTORY", "3": "HISTORY",
+            "m": "MAIN_MENU", "4": "MAIN_MENU",
+            " ": "TOGGLE_PAUSE",
+            "-": "VOL_DOWN", "_": "VOL_DOWN",
+            "+": "VOL_UP", "=": "VOL_UP",
+            ",": "SEEK_BACK_10", ".": "SEEK_FWD_10",
+            "<": "SEEK_BACK_30", ">": "SEEK_FWD_30",
+            "a": "TOGGLE_FAV", "5": "TOGGLE_FAV",
+            str(curses.KEY_F7): "OPEN_BROWSER",
+            str(curses.KEY_DC): "DELETE", "d": "DELETE"
+        }
+        return mapping.get(k_char)
+
+    def handle_input(self):
+        """Clean dispatcher: Get normalized command and execute it."""
+        cmd = self.get_next_event()
+        if not cmd: return
 
-        # Helper to normalize input for checking
-        k_char = str(key).lower() if isinstance(key, str) else ""
-        
         current_list = self.get_current_list()
 
-        # Navigation logic
-        # Back: Q, Left Arrow, Backspace, h, 6
-        # Fix: Removed Korean mappings ('ㅂ', 'ㅗ') to prevent IME ghost keys per user request
-        if key == curses.KEY_LEFT or key == curses.KEY_BACKSPACE or key == 127 or \
-           k_char in ['q', '6', 'h']:
+        # 1. Functional Commands (Require Logic)
+        if cmd == "NAV_BACK":
             if len(self.view_stack) > 1:
-                # Pop current view and push to forward stack
-                current_view = self.view_stack.pop()
-                self.forward_stack.append(current_view)
-                
-                self.selection_idx = 0; self.scroll_offset = 0
-                self.status_msg = "" 
-            # Else: Do nothing (Prevent Quit on Q)
-            return
-
-        # Forward: L, Right Arrow (Browser Style)
-        # Re-visit the view we just popped from
-        # Fix: Removed Korean mappings ('ㅣ') to prevent IME ghost keys
-        if k_char in ['l', 'L'] or key == curses.KEY_RIGHT:
+                self.forward_stack.append(self.view_stack.pop())
+                self.selection_idx = 0; self.scroll_offset = 0; self.status_msg = ""
+        
+        elif cmd == "NAV_FORWARD":
             if self.forward_stack:
-                next_view = self.forward_stack.pop()
-                self.view_stack.append(next_view)
-                self.selection_idx = 0; self.scroll_offset = 0
-                self.status_msg = ""
-            return
+                self.view_stack.append(self.forward_stack.pop())
+                self.selection_idx = 0; self.scroll_offset = 0; self.status_msg = ""
 
-            return
-
-        # Fix: Removed Korean mappings ('ㅏ', 'ㅓ') for stability
-        if key == curses.KEY_UP or k_char in ['k']:
+        elif cmd == "MOVE_UP":
             if self.selection_idx > 0:
                 self.selection_idx -= 1
                 if self.selection_idx < self.scroll_offset: self.scroll_offset = self.selection_idx
             elif current_list:
-                # v1.8.5 - Wrapping: Top to Bottom
                 self.selection_idx = len(current_list) - 1
                 h, _ = self.stdscr.getmaxyx()
-                # Maintain scroll consistency (h - 10 matches draw() layout)
-                list_area_height = h - 10
-                self.scroll_offset = max(0, self.selection_idx - list_area_height + 1)
-        elif key == curses.KEY_DOWN or k_char in ['j']:
+                self.scroll_offset = max(0, self.selection_idx - (h - 11))
+
+        elif cmd == "MOVE_DOWN":
             if self.selection_idx < len(current_list) - 1:
                 self.selection_idx += 1
                 h, _ = self.stdscr.getmaxyx()
-                list_area_height = h - 10
-                if self.selection_idx >= self.scroll_offset + list_area_height:
-                    self.scroll_offset = self.selection_idx - list_area_height + 1
+                if self.selection_idx >= self.scroll_offset + (h - 10):
+                    self.scroll_offset = self.selection_idx - (h - 10) + 1
             elif current_list:
-                # v1.8.5 - Wrapping: Bottom to Top
-                self.selection_idx = 0
-                self.scroll_offset = 0
-
-        # Enter / Select Logic
-        elif key in ['\n', '\r', 10, 13, curses.KEY_ENTER]:
-             # v2.0.3 Stability: Debounce Enter to prevent double-firing
-             if time.time() - getattr(self, 'last_enter_time', 0) > 0.3:
-                 self.last_enter_time = time.time()
-                 self.activate_selection(current_list)
-        
-        # Shortcuts: Number keys & English letters (Strict Mode)
-        # Search: S, 1, /
-        elif k_char in ['s', 'S', '1', '/'] and (not isinstance(key, str) or key.isprintable()): 
-            self.forward_stack = [] # Clear forward history on new navigation
-            self.prompt_search()
-        
-        # Favorites: F, 2
-        elif k_char in ['f', 'F', '2']:
+                self.selection_idx = 0; self.scroll_offset = 0
+
+        elif cmd == "ACTIVATE":
+            if time.time() - getattr(self, 'last_enter_time', 0) > 0.3:
+                self.last_enter_time = time.time()
+                self.activate_selection(current_list)
+
+        elif cmd == "SEARCH":
+            self.forward_stack = []; self.prompt_search()
+
+        elif cmd == "FAVORITES":
             if self.view_stack[-1] != "favorites":
-                self.forward_stack = [] 
-                self.view_stack.append("favorites")
-                self.selection_idx = 0
+                self.forward_stack = []; self.view_stack.append("favorites"); self.selection_idx = 0
             self.status_msg = self.t("favorites_info", DATA_FILE)
-            
-        # History: R, 3 (Changed from H to avoid Back conflict)
-        elif k_char in ['r', 'R', '3']:
+
+        elif cmd == "HISTORY":
             if self.view_stack[-1] != "history":
-                self.forward_stack = []
-                self.cached_history = list(self.dm.data['history']) # Snapshot
-                self.view_stack.append("history")
-                self.selection_idx = 0
+                self.forward_stack = []; self.cached_history = list(self.dm.data['history'])
+                self.view_stack.append("history"); self.selection_idx = 0
             self.status_msg = self.t("hist_info")
-            
-        # Main Menu: M, 4
-        elif k_char in ['m', 'M', '4']:
-            self.forward_stack = [] # Clear forward history
-            self.view_stack = ["main"]; self.selection_idx = 0; self.scroll_offset = 0; self.status_msg = ""
-            
-        # Play/Pause: Space
-        elif k_char == ' ': 
-            self.player.toggle_pause()
-
-        # Volume: 9/0 or [/] or -/+
-        elif k_char in ['-','_']:
-            self.player.change_volume(-5)
-            self.status_msg = "Volume -5"
-        elif k_char in ['+','=']:
-            self.player.change_volume(5)
-            self.status_msg = "Volume +5"
-
-        # Seek: ,/. (10s), </> (30s)
-        elif k_char == ',':
-            self.player.seek(-10)
-        elif k_char == '.':
-            self.player.seek(10)
-        elif k_char == '<':
-            self.player.seek(-30)
-            self.status_msg = "Rewind 30s"
-        elif k_char == '>':
-            self.player.seek(30)
-            self.status_msg = "Forward 30s"
-            
-        elif key == 27:
-            self.stop_on_exit = False
-            self.running = False
-            
-        # Share Track (F9): Real-time Publish
-        elif key == curses.KEY_F9:
-            if current_list and 0 <= self.selection_idx < len(current_list):
-                target_item = current_list[self.selection_idx]
-                url = target_item.get('url')
-                title = target_item.get('title', 'Unknown Title')
-                
-                if url:
-                    # If it's US, try to re-fetch country info one more time (maybe misdetected)
-                    if self.dm.get_country() == 'US':
-                        threading.Thread(target=self.dm.fetch_country, daemon=True).start()
-
-                    # Dedup Check: Using a time-based cooldown (e.g. 5 seconds) for same URL
-                    last_sent_time = self.sent_history.get(url, 0)
-                    if time.time() - last_sent_time < 5:
-                        self.status_msg = "⚠️  Already Shared Recently!"
-                    else:
-                        try:
-                            # Send to Serverless Proxy (Secure)
-                            payload = {
-                                "title": title,
-                                "url": url,
-                                "duration": target_item.get('duration', '--:--'),
-                                "country": self.dm.get_country(),
-                                "timestamp": time.time()
-                            }
-                            
-                            # v1.9.9 Security Update: Use centralized API with Auth Header
-                            # v2.0.0 Threading for Smoothness
-                            def send_share_async(payload, headers, url_to_share, title_to_share):
-                                try:
-                                    resp = requests.post(
-                                        self.share_api_url, 
-                                        json=payload, 
-                                        headers=headers, 
-                                        timeout=3
-                                    )
-                                    if resp.status_code == 200:
-                                        self.sent_history[url_to_share] = time.time()
-                                        safe_t = self.truncate(title_to_share, 50)
-                                        self.status_msg = f"🚀 Shared: {safe_t}..."
-                                    else:
-                                        self.status_msg = f"❌ Share Error: {resp.status_code}"
-                                except:
-                                    self.status_msg = "❌ Network Error (API)"
-
-                            headers = {
-                                "Content-Type": "application/json",
-                                "x-mytunes-secret": "mytunes-v1-secret-8822"
-                            }
-                            threading.Thread(target=send_share_async, args=(payload, headers, url, title), daemon=True).start()
-                                
-                        except Exception as e:
-                            self.status_msg = f"❌ Share Failed: {str(e)}"
 
-            
-        # Add to Favorites: A, 5
-        elif k_char in ['a', 'A', '5']:
+        elif cmd == "MAIN_MENU":
+            self.forward_stack = []; self.view_stack = ["main"]; self.selection_idx = 0; self.scroll_offset = 0; self.status_msg = ""
+
+        elif cmd == "TOGGLE_PAUSE": self.player.toggle_pause()
+        elif cmd == "VOL_DOWN": self.player.change_volume(-5); self.status_msg = "Volume -5"
+        elif cmd == "VOL_UP": self.player.change_volume(5); self.status_msg = "Volume +5"
+        elif cmd == "SEEK_BACK_10": self.player.seek(-10)
+        elif cmd == "SEEK_FWD_10": self.player.seek(10)
+        elif cmd == "SEEK_BACK_30": self.player.seek(-30); self.status_msg = "Rewind 30s"
+        elif cmd == "SEEK_FWD_30": self.player.seek(30); self.status_msg = "Forward 30s"
+        
+        elif cmd == "TOGGLE_FAV":
             if current_list and 0 <= self.selection_idx < len(current_list):
-                target_item = current_list[self.selection_idx]
-                # Ensure it's a valid track item (has url)
-                if "url" in target_item:
-                    is_added = self.dm.toggle_favorite(target_item)
+                target = current_list[self.selection_idx]
+                if "url" in target:
+                    is_added = self.dm.toggle_favorite(target)
                     self.status_msg = self.t("fav_added") if is_added else self.t("fav_removed")
 
-        # Open in Browser (YouTube): F7
-        elif key == curses.KEY_F7:
+        elif cmd == "DELETE":
+            self.handle_deletion(current_list)
+
+        elif cmd == "OPEN_BROWSER":
             if current_list and 0 <= self.selection_idx < len(current_list):
-                target_item = current_list[self.selection_idx]
-                url = target_item.get('url')
-                if url:
-                    if self.is_remote():
-                        self.show_copy_dialog("YouTube", url)
-                    else:
-                        self.open_browser(url)
+                url = current_list[self.selection_idx].get('url')
+                if url: (self.show_copy_dialog("Media", url) if self.is_remote() else self.open_browser(url))
 
-        # Open Live Station: F8
-        elif key == curses.KEY_F8:
-            homepage_url = "https://mytunes-pro.com"
-            if self.is_remote():
-                self.show_copy_dialog("MyTunes Home", homepage_url)
-                return
+        elif cmd in ["OPEN_HOME"]:
+            url = "https://mytunes-pro.com"
+            if self.is_remote(): self.show_copy_dialog("MyTunes Home", url)
+            else: self.open_browser(url, app_mode=False)
 
-            self.open_browser(homepage_url, app_mode=True)
+        elif cmd == "OPEN_PARTNER":
+            self.open_browser("https://postgresql.co.kr")
+
+
+        elif cmd == "RESIZE":
+            self.stdscr.clear()
+            self.stdscr.refresh()
+
+        elif cmd == "EXIT_BKG":
+            self.stop_on_exit = False; self.running = False
+
+    def handle_deletion(self, current_list):
+        """Sub-logic for DELETE command to keep dispatcher clean."""
+        if not current_list or not (0 <= self.selection_idx < len(current_list)): return
+        
+        view = self.view_stack[-1]
+        success = False
+        if view == "favorites":
+            success = self.dm.remove_favorite_by_index(self.selection_idx)
+            if success: self.status_msg = "🗑️ Deleted from Favorites"
+        elif view == "history":
+            success = self.dm.remove_history_by_index(self.selection_idx)
+            if success: self.cached_history = list(self.dm.data['history']); self.status_msg = "🗑️ Deleted from History"
+        elif view == "search":
+            if self.current_search_query is None:
+                success = self.dm.remove_search_history_by_index(self.selection_idx)
+                if success: self.search_results = self.dm.get_search_history(); self.status_msg = "🗑️ Deleted from Search History"
+            else:
+                try: self.search_results.pop(self.selection_idx); success = True; self.status_msg = "Removed from list"
+                except: pass
+        if success:
+             self.selection_idx = max(0, min(self.selection_idx, len(self.get_current_list()) - 1))
 
-        # Delete Item: DEL, d
-        elif key == curses.KEY_DC or k_char in ['d']:
-             if current_list and 0 <= self.selection_idx < len(current_list):
-                 view = self.view_stack[-1]
-                 success = False
-                 
-                 if view == "favorites":
-                     success = self.dm.remove_favorite_by_index(self.selection_idx)
-                     if success: self.status_msg = "🗑️ Deleted from Favorites"
-                     
-                 elif view == "history":
-                     success = self.dm.remove_history_by_index(self.selection_idx)
-                     if success: 
-                         self.cached_history = list(self.dm.data['history']) # Refresh view 
-                         self.status_msg = "🗑️ Deleted from History"
-                 
-                 elif view == "search":
-                     # If current_search_query is None, we are viewing Search History
-                     if self.current_search_query is None:
-                         success = self.dm.remove_search_history_by_index(self.selection_idx)
-                         if success:
-                             self.search_results = self.dm.get_search_history() # Refresh
-                             self.status_msg = "🗑️ Deleted from Search History"
-                     else:
-                         # Ephemeral removal from result list
-                         try:
-                             self.search_results.pop(self.selection_idx)
-                             self.status_msg = "Start new search"
-                             success = True
-                         except: pass
-
-                 if success:
-                     # Adjust selection index if out of bounds
-                     # If list became empty, idx will be 0 but len is 0.
-                     # We just need to ensure we don't crash next draw.
-                     # The draw logic (get_current_list) handles empty lists safely.
-                     if self.selection_idx >= len(self.get_current_list()):
-                         self.selection_idx = max(0, len(self.get_current_list()) - 1)
 
 
 
@@ -947,20 +803,26 @@ class MyTunesApp:
             curses.flushinp()
             
             while True:
-                k = win.getch()
-                if k == -1: continue
+                try:
+                    k = win.get_wch()
+                except curses.error:
+                    continue
                 
                 # ESC -> Background Play (Exit app)
-                if k == 27:
+                if k == 27 or k == '\x1b':
                     self.stop_on_exit = False
                     self.running = False
-                    res = False # Or irrelevant since we quit
+                    res = False
                     break
                 
-                if k in [10, 13, curses.KEY_ENTER, ord(' ')]: 
+                # Enter / Space -> Resume
+                if k in [10, 13, curses.KEY_ENTER, '\n', '\r', ' ']: 
                     res = True
                     break
-                if k in [ord('0'), ord('r'), ord('R')]: 
+                
+                # 0 / R -> Restart
+                k_char = str(k).lower() if isinstance(k, str) else ""
+                if k_char in ['0', 'r']: 
                     res = False
                     break
                     
@@ -1022,6 +884,12 @@ class MyTunesApp:
                 else:
                     # Linux or others
                     subprocess.Popen(['xdg-open', url], **popen_kwargs)
+                
+                # Feedback logic: Success message then auto-clear
+                self.status_msg = "✅ Browser Launched! (Check Browser)"
+                time.sleep(2.5)
+                if "Launched!" in self.status_msg:
+                    self.status_msg = ""
             except Exception as e:
                 # Log error silently to TUI status
                 self.status_msg = f"❌ Browser Error: {str(e)[:20]}"
@@ -1075,8 +943,12 @@ class MyTunesApp:
             
             # Wait for key
             while True:
-                k = win.getch()
-                if k in [10, 13, curses.KEY_ENTER, 27, ord(' ')]: 
+                try:
+                    k = win.get_wch()
+                except curses.error:
+                    continue
+
+                if k in [10, 13, curses.KEY_ENTER, 27, '\n', '\r', '\x1b', ' ']: 
                     break
         except: pass
         finally:

{mytunes_pro-2.0.2.dist-info → mytunes_pro-2.0.4.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mytunes-pro
-Version: 2.0.2
+Version: 2.0.4
 Summary: A lightweight, keyboard-centric terminal player for streaming YouTube music.
 Author-email: loxo <loxo5432@gmail.com>
 Project-URL: Homepage, https://github.com/postgresql-co-kr/mytunes
@@ -17,18 +17,23 @@ Requires-Dist: yt-dlp
 Requires-Dist: pusher
 Dynamic: license-file
 
-# 🎵 MyTunes Pro (Korean)
+# 🎵 MyTunes Pro - Professional TUI Edition v2.0.4
 
-## 🚀 Professional TUI Music Player v2.0.2
+## 🚀 Terminal-based Media Workflow Experiment v2.0.4
 
-MyTunes Pro는 **Context7**의 심층 리서치를 기반으로 제작된 **Premium CLI Music Player**입니다.
-Python `curses` 라이브러리를 사용하여 터미널 환경에서도 **GUI급의 유려한 UX**를 제공하며,
-`mpv` 플레이어의 강력한 IPC 제어 기능을 통해 끊김 없는 백그라운드 재생을 지원합니다.
+> [!IMPORTANT]
+> **Legal Disclaimer:** This project is a personal, non-commercial research experiment for developer education. 
+> It does not host, provide, or distribute any media content. 
+> All media sources are independently accessed and configured by the user. 
+> Users are solely responsible for ensuring that their usage complies with the terms of service of any third-party platforms accessed via this tool.
 
-> **💡 개발 배경**  
-> 이 프로그램은 하루 종일 터미널을 보는 개발자들이 **작업 흐름을 끊지 않고** 편하게 음악을 듣기 위해 만들어졌습니다.  
-> 특히 **모니터가 없는(Headless) 미니 PC (Debian Server)**를 거실이나 책상의 '뮤직 스테이션'으로 활용하고자 했던 개인적인 필요에서 시작되었습니다.  
-> 복잡한 설정 없이, 터미널 하나만 있으면 어디서든 당신만의 오디오 플레이어가 됩니다.
+MyTunes Pro is a developer-focused **CLI Media Tool** for experimenting with terminal-based media workflows.
+It utilizes the Python `curses` library to provide a structured TUI (Terminal User Interface) for handling media URLs, 
+leveraging the `mpv` engine for local media processing and playback.
+
+> **💡 Project Note**  
+> This tool was designed for personal research into how terminal users can interact with media sources without interrupting their developer workflow. 
+> It explores the integration between local CLI environments (like Headless Debian Servers) and external media handling utilities.
 
 ![Python](https://img.shields.io/badge/Python-3.9%2B-blue.svg)
 ![License](https://img.shields.io/badge/License-MIT-green.svg)
@@ -41,27 +46,24 @@ Python `curses` 라이브러리를 사용하여 터미널 환경에서도 **GUI
 
 ---
 
-## ✨ 주요 기능
+## ✨ Core Features
 
-- **강력한 검색**: `yt-dlp` 엔진을 사용하여 광고 없는 고음질 오디오 스트리밍.
-- **쾌적한 조작**: `curses` 기반 TUI로 빠르고 직관적인 인터페이스.
-- **연속 재생**: 한 곡이 끝나면 **리스트의 다음 곡을 자동으로 재생**합니다.
-- **이어듣기**: 중단된 위치부터 **이어서 재생**할지 선택할 수 있습니다.
-- **한글 최적화**: 한글 자소 조합 대기 시간 없이 즉시 반응하는 **숫자 단축키** 지원.
-- **스마트 기능**: 즐겨찾기, 재생 기록(최대 100곡), 자동 음악 필터링 검색.
-- **라이브 (F8)**: 전 세계 유저들과 함께 듣는 **실시간 음악 대시보드** (전용 팝업).
-- **공유 (F9)**: 내가 듣는 곡을 **라이브 스테이션에 즉시 송출**하여 함께 즐깁니다.
-- **비주얼**: 현대적인 심볼 아이콘(⌕, ★, ◷)과 깔끔한 디자인.
+- **Media Handling**: Support for loading and processing media URLs using external extraction tools.
+- **TUI Workflow**: Efficient, low-latency interface built on the `curses` library.
+- **Workflow Persistence**: Handles sequential media loading and state restoration.
+- **Terminal Optimization**: Performance-focused design that prioritizes keyboard-driven interactions.
+- **Smart Management**: Optional user-configured collections, interaction history, and metadata handling.
+- **External Integration**: Capabilities to load media links into external viewer/player environments.
 
 ---
 
-## 💻 구동 환경 안내
+## 💻 Environment & Integration
 
-**MyTunes Pro**는 터미널(CLI) 기반 애플리케이션입니다. 각 운영체제에서 고음질 오디오를 재생하기 위해 **`mpv`**라는 엔진을 사용합니다.
+**MyTunes Pro** is a CLI-based tool. It can integrate with externally installed media processing tools.
 
-- **macOS**: 터미널(iTerm2, Warp 추천) 지원. Python 3.9 이상 필요.
-- **Linux**: 우분투, 데비안 등 모든 리눅스 배포판 지원.
-- **Windows**: **WSL(Windows Subsystem for Linux)** 환경이 필요합니다. (아래 가이드를 참고하세요.)
+- **External Tools**: This project can interface with user-installed utilities like `mpv` and media extraction tools. No third-party tools are bundled with this software.
+- **macOS/Linux**: Native terminal support.
+- **Windows**: Recommended to use with **WSL (Windows Subsystem for Linux)**.
 
 ---
 
@@ -182,8 +184,6 @@ Windows 환경에서 한글 검색이 안 되거나 설치가 어려운 분들
 | **`+`** | **볼륨 UP** | 볼륨 +5% (단축키 `=`와 동일) |
 | **`-`** | **볼륨 DOWN** | 볼륨 -5% (단축키 `_`와 동일) |
 | **`F7`** | **유튜브 열기** | 현재 곡을 브라우저에서 보기 |
-| **`F8`** | **라이브 (Live)** | **실시간 음악 대시보드 열기** (전용 팝업창) |
-| **`F9`** | **공유 (Share)** | **현재 곡을 라이브 스테이션에 즉시 공유** |
 | **`6`** | **뒤로가기** | 이전 화면으로 이동 (단축키 `Q`, `h`와 동일) |
 | **`L`** | **앞으로** | 이전 화면에서 앞화면으로 다시 이동 (`Right Arrow`) |
 | **`ESC`** | **배경재생** | **음악 끄지 않고 나가기** (백그라운드 재생) |
@@ -210,100 +210,48 @@ Windows 환경에서 한글 검색이 안 되거나 설치가 어려운 분들
 ---
 ---
 
-# 🎵 MyTunes Pro (English)
-
-**Modern CLI YouTube Music Player (v2.0.2)**  
-A lightweight, keyboard-centric terminal player for streaming YouTube music.  
-
 ---
 
-## 💻 Environment Support
+# 🎵 MyTunes Pro (Experimental Media Tool - KR)
 
-**MyTunes Pro** is a Terminal-native application.
-
-- **macOS**: Native Terminal support. Python 3.9+ required.
-- **Linux**: Supports all distributions (Ubuntu, Debian, etc.).
-- **Windows**: Requires **WSL (Windows Subsystem for Linux)**.
-
----
+## 🚀 터미널 기반 미디어 워크플로우 실험 v2.0.3
 
-## 🚀 Quick Start
+> [!IMPORTANT]
+> **법적 면책 고지:** 본 프로젝트는 개발자 교육 및 연구를 목적으로 하는 개인적, 비상업적 실험입니다. 
+> 본 소프트웨어는 어떠한 미디어 콘텐츠도 직접 호스팅하거나 배포하지 않습니다. 
+> 모든 미디어 소스는 사용자의 로컬 환경에서 직접 구성되고 접근되며, 사용자는 외부 플랫폼의 이용 약관을 준수할 책임이 있습니다.
 
-On modern macOS/Linux systems (PEP 668), using **`pipx`** is highly recommended.
-
-### 1. Recommended (pipx)
-```bash
-pipx install mytunes-pro
-pipx ensurepath
-source ~/.zshrc  # or source ~/.bashrc to apply changes immediately
-```
+MyTunes Pro는 개발자를 위해 설계된 **CLI 미디어 실험 도구**입니다.
+Python `curses` 라이브러리를 통해 터미널 환경에서 미디어 URL을 로드하고 관리하며, 
+사용자가 설치한 `mpv` 등의 외부 도구와 연동하여 미디어 워크플로우를 테스트할 수 있습니다.
 
-### 2. Standard pip
-```bash
-pip install mytunes-pro --break-system-packages
-```
+## ✨ 주요 특징
 
-Run simply by typing **`mp`** in your terminal!
+- **미디어 핸들링**: 외부 추출 도구를 사용한 미디어 URL 로드 및 처리 지원.
+- **TUI 워크플로우**: `curses` 라이브러리 기반의 효율적인 터미널 인터페이스.
+- **작업 유지**: 순차적 미디어 로딩 및 마지막 작업 상태 복원 기능.
+- **환경 연동**: 사용자에 의해 구성된 외부 미디어 도구와의 연동 지원. (본 소프트웨어는 외부 도구를 포함하여 배포하지 않습니다.)
 
 ---
 
-## 🛠 Prerequisites
-
-### macOS (Homebrew)
-```bash
-brew install mpv python3 pipx
-```
-
-### Linux (Ubuntu/Debian)
-```bash
-sudo apt update
-sudo apt install mpv python3 python3-pip pipx python3-venv -y
-```
-
-### Windows (Beginner's WSL Guide)
-
-1. **Install WSL**:
-   ```powershell
-   wsl --install -d Debian
-   ```
-   **Restart your computer** after installation.
-
-2. **Install Core Tools**:
-   ```bash
-   sudo apt update && sudo apt install mpv python3-pip pipx -y
-   ```
-
-4. **Install MyTunes**:
-   ```bash
-   pipx install mytunes-pro
-   pipx ensurepath
-   source ~/.bashrc
-   ```
-
----
+## 🔄 Changelog
 
-## ⌨️ English Controls
+### v2.0.4 (2026-02-01)
+- **Legal Polish**: Comprehensive scrubbing of brand identifiers and service-oriented terminology across the ecosystem.
+- **Localization**: Fully localized Korean landing page and technical experiment descriptions.
+- **Educational Focus**: Added explicit project disclaimers to all web footers.
+- **Project Scope**: Solidified positioning as a "Media Handling Experiment" rather than a music player.
 
-| Key | Function | Description |
-| :--- | :--- | :--- |
-| **`1`** | **Search** | Open search bar (Same as `S`) |
-| **`2`** | **Favs** | View favorites list (Same as `F`) |
-| **`3`** | **Hist** | View history (Same as `R`) |
-| **`4`** | **Main** | Go to Main Menu (Same as `M`) |
-| **`5`** | **Add/Del** | Toggle Favorite (Same as `A`) |
-| **`+`** | **Vol Up** | Volume +5% (Same as `=`) |
-| **`-`** | **Vol Down** | Volume -5% (Same as `_`) |
-| **`6`** | **Back** | Go back (Same as `Q`, `h`) |
-| **`L`** | **Forward** | Go forward (`Right Arrow`) |
-| **`ESC`** | **Bg Play** | **Exit app but keep music playing** |
+### v2.0.3 (Input Handling & Unicode Stability)
 
----
-
-## 🔄 Changelog
+- **Input Logic**: Replaced legacy `getch()` with `get_wch()` in all UI dialogs (`ask_resume`, `show_copy_dialog`) for robust wide-character and Unicode support.
+- **Architecture**: Refactored the input handling system into a modular, command-based architecture (v2.0.3).
+- **Decoupling**: Separated input collection (`get_next_event`), event normalization, and command execution.
+- **Improved ESC Handling**: Enhanced detection of ESC and multi-byte sequences (including Option+Backspace) for smoother navigation.
 
 ### v2.0.2 (Stability & Browser Optimization)
 
-- **Browser Launch**: Switched to fully decoupled `subprocess.Popen` logic for browser opening. This eliminates occasional TUI freezes when launching YouTube (F7) or Live Station (F8) by bypassing `webbrowser` library limitations.
+- **Browser Launch**: Switched to fully decoupled `subprocess.Popen` logic for browser opening. This eliminates occasional TUI freezes when launching Media Links (F7) or Dashboard (F8) by bypassing `webbrowser` library limitations.
 - **App Mode Restore**: Fixed and improved Chrome/Brave App Mode (Popup) for the Live Station on macOS.
 - **Improved Remote Detection**: Refined SSH/WSL detection to ensure local browser features are correctly enabled where possible.
 
@@ -318,7 +266,6 @@ sudo apt install mpv python3 python3-pip pipx python3-venv -y
 
 - **Domain Migration**: Updated all branding and internal links to support `mytunes-pro.com`.
 - **Realtime Stability**: Fixed critical state-management bugs in the live dashboard that caused list clearing and duplicated track entries.
-- **Pusher Channel Synchronization**: Unified communication across the transition to ensure zero-latency sharing on the new `mytunes-pro` channel.
 - **Improved Empty State**: Redesigned the "SIGNAL LOST" screen into a more descriptive "READY TO RECEIVE" interface for better UX.
 
 ### v1.9.8 (Realtime Stabilization)
@@ -326,7 +273,7 @@ sudo apt install mpv python3 python3-pip pipx python3-venv -y
 - **UI Refinement**: Implemented in-list "Now Playing" sticky behavior with auto-scroll synchronization for a seamless browsing experience.
 - **Queue System Optimization**: Capped incoming track queue at 200 items with a "200+" notification indicator for high-traffic stability.
 - **Popup UI Consistency**: Unified Live Station popup dimensions to 620x900 across Web and TUI.
-- **Improved YouTube Playback**: Optimized the YouTube player hook to resolve initialization race conditions and syntax edge cases.
+- **Improved Media Playback**: Optimized the media player hook to resolve initialization race conditions and syntax edge cases.
 
 ### v1.9.7 (Analytics)
 
@@ -386,7 +333,7 @@ sudo apt install mpv python3 python3-pip pipx python3-venv -y
 ### v1.8.4
 
 - **Python Crash Fix (WSL)**: Eliminated premature termination by implementing `start_new_session=True` for browser launches, isolating them from the TUI process group.
-- **Hybrid Browser Strategy**: Switched to the standard `webbrowser` library for F7 (YouTube links) for maximum internal stability.
+- **Hybrid Browser Strategy**: Switched to the standard `webbrowser` library for F7 (Media links) for maximum internal stability.
 - **Global Error Protection**: Wrapped the main application loop in an exception guard to catch and log transient OS errors without crashing the entire app.
 - **Refined Process Cleanup**: Specialized the `pkill` logic to prevent accidental self-termination while maintaining reliable MPV management.
 
@@ -433,7 +380,7 @@ sudo apt install mpv python3 python3-pip pipx python3-venv -y
 ### v1.7.5
 
 - **WSL Integration**: Fully optimized browser launch from WSL by utilizing `cmd.exe` to trigger native Windows browsers.
-- **F7 Windows Resolve**: Fixed an issue where YouTube (F7) wouldn't open in WSL environments.
+- **F7 Windows Resolve**: Fixed an issue where Media links (F7) wouldn't open in WSL environments.
 - **F8 App Mode (WSL/Win)**: Enhanced flags to ensure "App Mode" (no address bar) works consistently even when launched from WSL.
 
 ### v1.7.4
@@ -443,7 +390,7 @@ sudo apt install mpv python3 python3-pip pipx python3-venv -y
 
 ### v1.7.3
 
-- **Windows Fixes**: Resolved issue where F7 (YouTube) failed to open browsers on Windows by implementing `os.startfile` logic.
+- **Windows Fixes**: Resolved issue where F7 (Media) failed to open browsers on Windows by implementing `os.startfile` logic.
 - **F8 Initialization**: Improved Live Station (F8) window sizing on Windows by forcing a clean session state.
 - **Robustness**: Enhanced cross-platform browser redirection logic to ensure consistent behavior.
 
@@ -463,7 +410,6 @@ sudo apt install mpv python3 python3-pip pipx python3-venv -y
 ### v1.6.0
 
 - **Global Version Synchronization**: Synchronized version 1.6.0 across CLI, README, and Web interface.
-- **Dependency Fix**: Ensured `pusher` dependency is correctly included for real-time features.
 
 ### v1.5.6
 

mytunes_pro-2.0.4.dist-info/RECORD

@@ -0,0 +1,8 @@
+mytunes/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+mytunes/app.py,sha256=iu9LN4WtJrSQLSMreBMZqnXYotm_9Bk5eoQVTxk6dCo,57463
+mytunes_pro-2.0.4.dist-info/licenses/LICENSE,sha256=lOrP0EIjxcgJia__W3f3PVDZkRd2oRzFkyH2g3LRRCg,1063
+mytunes_pro-2.0.4.dist-info/METADATA,sha256=H_ujUXf1ofYs1seveke-gV_ivc-VAPYU9kKJgpaCpdE,22542
+mytunes_pro-2.0.4.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+mytunes_pro-2.0.4.dist-info/entry_points.txt,sha256=6-MsC13nIgzLvrREaGotc32FgxHx_Iuu1z2qCzJs1_4,65
+mytunes_pro-2.0.4.dist-info/top_level.txt,sha256=KWzdFyNNG_sO7GT83-sN5fYArP4_DL5I8HYIwgazXyY,8
+mytunes_pro-2.0.4.dist-info/RECORD,,

mytunes_pro-2.0.2.dist-info/RECORD

@@ -1,8 +0,0 @@
-mytunes/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-mytunes/app.py,sha256=KlwbzDtBQ2lNg9KC4jhBXi5A-L4j5WkiJ67AatiGo9w,63780
-mytunes_pro-2.0.2.dist-info/licenses/LICENSE,sha256=lOrP0EIjxcgJia__W3f3PVDZkRd2oRzFkyH2g3LRRCg,1063
-mytunes_pro-2.0.2.dist-info/METADATA,sha256=u8SH6WZ5WKRf3ARn8M3TkPad0h5A91Yz3sdiHzTmlck,22830
-mytunes_pro-2.0.2.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
-mytunes_pro-2.0.2.dist-info/entry_points.txt,sha256=6-MsC13nIgzLvrREaGotc32FgxHx_Iuu1z2qCzJs1_4,65
-mytunes_pro-2.0.2.dist-info/top_level.txt,sha256=KWzdFyNNG_sO7GT83-sN5fYArP4_DL5I8HYIwgazXyY,8
-mytunes_pro-2.0.2.dist-info/RECORD,,