mytunes-pro 2.0.7__tar.gz → 2.1.1__tar.gz

{mytunes_pro-2.0.7/src/mytunes_pro.egg-info → mytunes_pro-2.1.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mytunes-pro
-Version: 2.0.7
+Version: 2.1.1
 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
@@ -18,9 +18,9 @@ Requires-Dist: yt-dlp
 Requires-Dist: pusher
 Dynamic: license-file
 
-# 🎵 MyTunes Pro - Professional TUI Edition v2.0.7
+# 🎵 MyTunes Pro - Professional TUI Edition v2.1.1
 
-## 🚀 Terminal-based Media Workflow Experiment v2.0.7
+## 🚀 Terminal-based Media Workflow Experiment v2.1.1
 
 > [!IMPORTANT]
 > **Legal Disclaimer:** This project is a personal, non-commercial research experiment for developer education.
@@ -216,7 +216,7 @@ Executes immediately without worrying about input language status.
 
 # 🎵 MyTunes Pro (Experimental Media Tool - KR)
 
-## 🚀 터미널 기반 미디어 워크플로우 실험 v2.0.7
+## 🚀 터미널 기반 미디어 워크플로우 실험 v2.1.0
 
 > [!IMPORTANT]
 > **법적 면책 고지:** 본 프로젝트는 개발자 교육 및 연구를 목적으로 하는 개인적, 비상업적 실험입니다. 
@@ -390,6 +390,22 @@ Windows 환경에서 한글 검색이 안 되거나 설치가 어려운 분들
 
 ## 🔄 Changelog
 
+### v2.1.1 (2026-02-02)
+- **WSL UI Polish**: Hides Equalizer (EQ) labels and status in the TUI when running on WSL to avoid confusion, as the feature is disabled in that environment for stability.
+- **Improved Feedback**: Provides a clear status message when the 'E' key is pressed on WSL.
+
+### v2.1.0 (2026-02-02)
+- **Zero-Freeze IPC Resilience**: Implemented a "Fast-Fail" mechanism that detects mpv process death within 0.1ms via `poll()`, preventing TUI freezes.
+- **Fail-Early Polling**: Main loop now aborts all remaining IPC property checks immediately if any call fails, maintaining a smooth 5fps even on broken connections.
+- **Connection Throttling**: Added a 1.5-second "cool-down" period for reconnection attempts to minimize blocking time on Windows/WSL environments.
+- **Multibyte Harmony**: Explicitly configured `locale.setlocale` to ensure stable emoji and CJK character rendering across different terminal environments.
+- **Improved Autoplay Stability**: Autoplay logic now skips status checks when the socket is unhealthy to prevent feedback loops.
+
+### v2.0.8 (2026-02-02)
+- **Windows/WSL Socket Recovery**: Fixed UI freezing when mpv socket disconnects during window switching.
+- **IPC Resilience**: Added socket pre-check and failure counter to prevent blocking on broken connections.
+- **Automatic Recovery**: New playback automatically restarts mpv if socket is unhealthy.
+
 ### v2.0.7 (2026-02-02)
 - **Performance Optimization**: Improved keyboard responsiveness on Windows/WSL by implementing EQ detection caching.
 - **Data Management**: Limited resume data to 500 entries with automatic FIFO cleanup to prevent JSON bloat.

{mytunes_pro-2.0.7 → mytunes_pro-2.1.1}/README.md

@@ -1,6 +1,6 @@
-# 🎵 MyTunes Pro - Professional TUI Edition v2.0.7
+# 🎵 MyTunes Pro - Professional TUI Edition v2.1.1
 
-## 🚀 Terminal-based Media Workflow Experiment v2.0.7
+## 🚀 Terminal-based Media Workflow Experiment v2.1.1
 
 > [!IMPORTANT]
 > **Legal Disclaimer:** This project is a personal, non-commercial research experiment for developer education.
@@ -196,7 +196,7 @@ Executes immediately without worrying about input language status.
 
 # 🎵 MyTunes Pro (Experimental Media Tool - KR)
 
-## 🚀 터미널 기반 미디어 워크플로우 실험 v2.0.7
+## 🚀 터미널 기반 미디어 워크플로우 실험 v2.1.0
 
 > [!IMPORTANT]
 > **법적 면책 고지:** 본 프로젝트는 개발자 교육 및 연구를 목적으로 하는 개인적, 비상업적 실험입니다. 
@@ -370,6 +370,22 @@ Windows 환경에서 한글 검색이 안 되거나 설치가 어려운 분들
 
 ## 🔄 Changelog
 
+### v2.1.1 (2026-02-02)
+- **WSL UI Polish**: Hides Equalizer (EQ) labels and status in the TUI when running on WSL to avoid confusion, as the feature is disabled in that environment for stability.
+- **Improved Feedback**: Provides a clear status message when the 'E' key is pressed on WSL.
+
+### v2.1.0 (2026-02-02)
+- **Zero-Freeze IPC Resilience**: Implemented a "Fast-Fail" mechanism that detects mpv process death within 0.1ms via `poll()`, preventing TUI freezes.
+- **Fail-Early Polling**: Main loop now aborts all remaining IPC property checks immediately if any call fails, maintaining a smooth 5fps even on broken connections.
+- **Connection Throttling**: Added a 1.5-second "cool-down" period for reconnection attempts to minimize blocking time on Windows/WSL environments.
+- **Multibyte Harmony**: Explicitly configured `locale.setlocale` to ensure stable emoji and CJK character rendering across different terminal environments.
+- **Improved Autoplay Stability**: Autoplay logic now skips status checks when the socket is unhealthy to prevent feedback loops.
+
+### v2.0.8 (2026-02-02)
+- **Windows/WSL Socket Recovery**: Fixed UI freezing when mpv socket disconnects during window switching.
+- **IPC Resilience**: Added socket pre-check and failure counter to prevent blocking on broken connections.
+- **Automatic Recovery**: New playback automatically restarts mpv if socket is unhealthy.
+
 ### v2.0.7 (2026-02-02)
 - **Performance Optimization**: Improved keyboard responsiveness on Windows/WSL by implementing EQ detection caching.
 - **Data Management**: Limited resume data to 500 entries with automatic FIFO cleanup to prevent JSON bloat.

{mytunes_pro-2.0.7 → mytunes_pro-2.1.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "mytunes-pro"
-version = "2.0.7"
+version = "2.1.1"
 authors = [
   { name = "loxo", email = "loxo5432@gmail.com" },
 ]

{mytunes_pro-2.0.7 → mytunes_pro-2.1.1}/src/mytunes/app.py

@@ -44,7 +44,21 @@ 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.7"
+APP_VERSION = "2.1.1"
+
+# Initial Locale Setup for WSL/Windows Multibyte/Emoji Harmony
+try:
+    locale.setlocale(locale.LC_ALL, '')
+except:
+    pass
+
+# WSL Detection: EQ/IPC robustness logic
+IS_WSL = False
+if hasattr(os, 'uname'):
+    try:
+        IS_WSL = "microsoft" in os.uname().release.lower()
+    except: pass
+
 
 # === [Strings & Localization] ===
 STRINGS = {
@@ -304,6 +318,11 @@ class Player:
         self.current_proc = None
         self.loading = False
         self.loading_ts = 0
+        self.socket_fail_count = 0  # Track consecutive IPC failures
+        self.socket_ok = True       # Socket health flag
+        self.last_socket_warn = 0   # Rate limit for socket error warnings
+        self.socket_retry_ts = 0    # Cool-down for reconnection attempts
+
         
         # Cleanup pre-existing instance if any
         # self.cleanup_orphaned_mpv() # Moved to play() per user request
@@ -339,6 +358,9 @@ class Player:
 
         # 2. Fallback: Clean up and start fresh (Aggressive)
         self.cleanup_orphaned_mpv()
+        # Reset socket health for fresh start
+        self.socket_fail_count = 0
+        self.socket_ok = True
         
         self.stop()
         self.loading = True
@@ -355,10 +377,11 @@ class Player:
             "--idle=yes"
         ]
         
-        # Inject Initial EQ (0ms Latency)
-        eq_af = self._get_eq_af_string(initial_eq_preset)
-        if eq_af:
-            cmd.append(f"--af={eq_af}")
+        # Inject Initial EQ (0ms Latency) - Skip on WSL (causes freezing)
+        if not IS_WSL:
+            eq_af = self._get_eq_af_string(initial_eq_preset)
+            if eq_af:
+                cmd.append(f"--af={eq_af}")
             
         cmd.append(url)
         
@@ -423,10 +446,29 @@ class Player:
         self.send_cmd(["add", "volume", delta])
 
     def send_cmd(self, command):
-        """Send raw command list to MPV via JSON IPC."""
+        """Send raw command list to MPV via JSON IPC with resilience."""
+        # 1. Fast-Detect Process Death
+        if self.current_proc and self.current_proc.poll() is not None:
+            self.socket_ok = False
+            self.current_proc = None
+            return None
+
+        # 2. Re-connection Cool-down (Throttle blocking connect() calls)
+        now = time.time()
+        if not self.socket_ok and now < self.socket_retry_ts:
+            return None
+
+        # 3. Pre-check: Skip if socket file doesn't exist (e.g. killed elsewhere)
+        if not os.path.exists(MPV_SOCKET):
+            self.socket_fail_count += 1
+            if self.socket_fail_count >= 2:
+                self.socket_ok = False
+                self.socket_retry_ts = now + 1.5 # 1.5s cool-down
+            return None
+            
         try:
             client = socket.socket(socket.AF_UNIX, socket.SOCK_STREAM)
-            client.settimeout(0.5) # Fast timeout (Optimization for Sleep/Wake resilience)
+            client.settimeout(0.5) # Fast timeout (Optimization for Sleep/Wake/WSL resilience)
             client.connect(MPV_SOCKET)
             cmd_str = json.dumps({"command": command}) + "\n"
             client.send(cmd_str.encode('utf-8'))
@@ -440,17 +482,29 @@ class Player:
                 if b"\n" in chunk: break
             
             client.close()
+            # Success: Fully Restore health
+            self.socket_fail_count = 0
+            self.socket_ok = True
             return json.loads(response.decode('utf-8'))
         except:
+            self.socket_fail_count += 1
+            if self.socket_fail_count >= 2:
+                self.socket_ok = False
+                self.socket_retry_ts = now + 1.5 # 1.5s cool-down
             return None
 
     def get_property(self, prop):
+        """Skip IPC if health is bad to prevent TUI freezing."""
+        if not self.socket_ok:
+            return None
         res = self.send_cmd(["get_property", prop])
         if res and "data" in res:
             return res["data"]
         return None
         
     def set_property(self, prop, value):
+        if not self.socket_ok:
+            return
         self.send_cmd(["set_property", prop, value])
 
     def toggle_pause(self):
@@ -476,6 +530,8 @@ class Player:
 
     def set_equalizer(self, preset_name):
         """Apply 10-band equalizer preset using lavfi."""
+        if IS_WSL:
+            return  # Skip EQ on WSL (causes freezing)
         af_str = self._get_eq_af_string(preset_name)
         self.set_property("af", af_str)
 
@@ -622,24 +678,29 @@ class MyTunesApp:
     def update_playback_state(self):
         # Poll MPV for state with throttling to reduce CPU/IPC overhead
         try:
+            # 0. Health Check: If socket is known-bad, exit immediately to keep TUI responsive
+            if not self.player.socket_ok:
+                return
+
             # 1. Mandatory every loop: Current time (for progress bar)
             t = self.player.get_property("time-pos")
-            if t is not None: 
-                self.playback_time = float(t)
-                if self.player.loading and self.playback_time >= 0:
-                    self.player.loading = False
-                
-                # Update Resume Data (Memory) - Throttle save logic
-                if self.current_track and self.playback_duration > 30:
-                    if self.playback_time / self.playback_duration > 0.99:
-                        self.dm.set_progress(self.current_track['url'], 0)
-                    elif self.playback_time > 10:
-                        self.dm.set_progress(self.current_track['url'], self.playback_time)
+            if t is None:
+                # If even time-pos fails, bail out immediately to prevent cascaded delay
+                return 
 
+            self.playback_time = float(t)
+            if self.player.loading and self.playback_time >= 0:
+                self.player.loading = False
+            
+            # Update Resume Data (Memory) - Throttle save logic
+            if self.current_track and self.playback_duration > 30:
+                if self.playback_time / self.playback_duration > 0.99:
+                    self.dm.set_progress(self.current_track['url'], 0)
+                elif self.playback_time > 10:
+                    self.dm.set_progress(self.current_track['url'], self.playback_time)
 
 
             # Safety: If loading takes too long (> 8s), force reset to allow error handling/skip
-            # Consolidated redundancy checks into a single clean block
             now = time.time()
             if self.player.loading and (now - self.player.loading_ts > 8):
                 self.player.loading = False
@@ -669,6 +730,7 @@ class MyTunesApp:
             if time.time() - getattr(self, 'last_save_time', 0) > 10:
                 self.dm.save_data()
                 self.last_save_time = time.time()
+
                  
         except: pass
 
@@ -849,7 +911,10 @@ class MyTunesApp:
             self.stop_on_exit = False; self.running = False
 
         elif cmd == "CYCLE_EQ":
-            self.cycle_equalizer()
+            if IS_WSL:
+                self.show_feedback("⚠️ EQ is disabled on WSL for stability" if self.lang=="en" else "⚠️ WSL 안정성을 위해 EQ 기능이 비활성화되었습니다")
+            else:
+                self.cycle_equalizer()
 
         elif isinstance(cmd, tuple) and cmd[0] == "UNKNOWN":
             key = cmd[1]
@@ -1603,6 +1668,10 @@ class MyTunesApp:
 
         # Row 2: Actions
         r2 = self.t("header_r2")
+        if IS_WSL:
+             # Remove "[E]이퀄라이저" or "[E]EQ"
+             r2 = r2.replace("[E]이퀄라이저 ", "").replace("[E]이퀄라이저", "").replace("[E]EQ ", "").replace("[E]EQ", "")
+             
         gap2 = w - 4 - self.get_display_width(r2)
         if gap2 < 2: gap2 = 2
         line2 = f"{' '*gap2}{r2}"
@@ -1629,17 +1698,15 @@ class MyTunesApp:
              status_icon = "❚❚" if self.is_paused else "▶"
              
              # Prepare EQ Info for Title Line
-             current_eq = EQUALIZER_KEYS[self.current_eq_index]
-             
-             # Show effective EQ with Mode Indicator
-             # Auto Mode: "🎚 Auto: Jazz"
-             # Manual Mode: "🎚 EQ: Pop"
-             if current_eq == "Auto":
-                 eq_display = f"🎚 Auto: {self.auto_preset_name}"
-             else:
-                 eq_display = f"🎚 EQ: {current_eq}"
+             eq_display = ""
+             if not IS_WSL:
+                 current_eq = EQUALIZER_KEYS[self.current_eq_index]
+                 if current_eq == "Auto":
+                     eq_display = f"🎚 Auto: {self.auto_preset_name}"
+                 else:
+                     eq_display = f"🎚 EQ: {current_eq}"
              
-             eq_info = f"  [{eq_display}]" # Right side content
+             eq_info = f"  [{eq_display}]" if eq_display else "" # Right side content
              
              # Calculate space for Title
              # Total Width - margins(2) - Icon(2) - Space(1) - EQ Info - Branding(Maybe separate line, but here we just need fit)
@@ -1804,8 +1871,10 @@ class MyTunesApp:
 
     def check_autoplay(self):
         # Auto-play next track from Global Queue
-        # Guard: Don't autoplay if we are currently loading a track
+        if not self.running: return
         if self.player.loading: return
+        # Logic check: Skip if playback just started or socket is dead to prevent feedback loops
+        if not self.player.socket_ok: return
 
         try:
             is_idle = self.player.get_property("idle-active")

{mytunes_pro-2.0.7 → mytunes_pro-2.1.1/src/mytunes_pro.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mytunes-pro
-Version: 2.0.7
+Version: 2.1.1
 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
@@ -18,9 +18,9 @@ Requires-Dist: yt-dlp
 Requires-Dist: pusher
 Dynamic: license-file
 
-# 🎵 MyTunes Pro - Professional TUI Edition v2.0.7
+# 🎵 MyTunes Pro - Professional TUI Edition v2.1.1
 
-## 🚀 Terminal-based Media Workflow Experiment v2.0.7
+## 🚀 Terminal-based Media Workflow Experiment v2.1.1
 
 > [!IMPORTANT]
 > **Legal Disclaimer:** This project is a personal, non-commercial research experiment for developer education.
@@ -216,7 +216,7 @@ Executes immediately without worrying about input language status.
 
 # 🎵 MyTunes Pro (Experimental Media Tool - KR)
 
-## 🚀 터미널 기반 미디어 워크플로우 실험 v2.0.7
+## 🚀 터미널 기반 미디어 워크플로우 실험 v2.1.0
 
 > [!IMPORTANT]
 > **법적 면책 고지:** 본 프로젝트는 개발자 교육 및 연구를 목적으로 하는 개인적, 비상업적 실험입니다. 
@@ -390,6 +390,22 @@ Windows 환경에서 한글 검색이 안 되거나 설치가 어려운 분들
 
 ## 🔄 Changelog
 
+### v2.1.1 (2026-02-02)
+- **WSL UI Polish**: Hides Equalizer (EQ) labels and status in the TUI when running on WSL to avoid confusion, as the feature is disabled in that environment for stability.
+- **Improved Feedback**: Provides a clear status message when the 'E' key is pressed on WSL.
+
+### v2.1.0 (2026-02-02)
+- **Zero-Freeze IPC Resilience**: Implemented a "Fast-Fail" mechanism that detects mpv process death within 0.1ms via `poll()`, preventing TUI freezes.
+- **Fail-Early Polling**: Main loop now aborts all remaining IPC property checks immediately if any call fails, maintaining a smooth 5fps even on broken connections.
+- **Connection Throttling**: Added a 1.5-second "cool-down" period for reconnection attempts to minimize blocking time on Windows/WSL environments.
+- **Multibyte Harmony**: Explicitly configured `locale.setlocale` to ensure stable emoji and CJK character rendering across different terminal environments.
+- **Improved Autoplay Stability**: Autoplay logic now skips status checks when the socket is unhealthy to prevent feedback loops.
+
+### v2.0.8 (2026-02-02)
+- **Windows/WSL Socket Recovery**: Fixed UI freezing when mpv socket disconnects during window switching.
+- **IPC Resilience**: Added socket pre-check and failure counter to prevent blocking on broken connections.
+- **Automatic Recovery**: New playback automatically restarts mpv if socket is unhealthy.
+
 ### v2.0.7 (2026-02-02)
 - **Performance Optimization**: Improved keyboard responsiveness on Windows/WSL by implementing EQ detection caching.
 - **Data Management**: Limited resume data to 500 entries with automatic FIFO cleanup to prevent JSON bloat.