mytunes-pro 2.0.5__tar.gz → 2.1.0__tar.gz

{mytunes_pro-2.0.5 → mytunes_pro-2.1.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mytunes-pro
-Version: 2.0.5
+Version: 2.1.0
 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,14 +18,14 @@ Requires-Dist: yt-dlp
 Requires-Dist: pusher
 Dynamic: license-file
 
-# 🎵 MyTunes Pro - Professional TUI Edition v2.0.5
+# 🎵 MyTunes Pro - Professional TUI Edition v2.1.0
 
-## 🚀 Terminal-based Media Workflow Experiment v2.0.5
+## 🚀 Terminal-based Media Workflow Experiment v2.1.0
 
 > [!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. 
+> **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.
 
 MyTunes Pro is a developer-focused **CLI Media Tool** for experimenting with terminal-based media workflows.
@@ -39,6 +39,8 @@ leveraging the `mpv` engine for local media processing and playback.
 ![Python](https://img.shields.io/badge/Python-3.9%2B-blue.svg)
 ![License](https://img.shields.io/badge/License-MIT-green.svg)
 
+---
+
 ## 📸 Screenshots
 | | |
 | :---: | :---: |
@@ -68,6 +70,180 @@ leveraging the `mpv` engine for local media processing and playback.
 
 ---
 
+## 🚀 Quick Install
+
+We strongly recommend using **`pipx`** on modern macOS/Linux systems (PEP 668).
+
+### 1. Recommended Method (pipx)
+Automatically creates an isolated environment and registers the command.
+
+```bash
+# Ensure ensuredpath is run to register the command after pipx install!
+pipx install mytunes-pro
+pipx ensurepath
+source ~/.zshrc  # or source ~/.bashrc (apply immediately to current terminal)
+```
+
+### 2. Standard pip Method
+If you encounter the `externally-managed-environment` error, add the following flag:
+
+```bash
+pip install mytunes-pro --break-system-packages
+```
+
+After installation, type **`mp`** anywhere in the terminal to run!
+
+### 🔄 Update
+If already installed, simply use the command below to update to the latest features:
+
+```bash
+pipx upgrade mytunes-pro
+```
+
+---
+
+## 🛠 Prerequisites
+
+Please install the necessary tools for your operating system before running.
+
+### macOS (Using 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 (WSL Guide)
+
+Guide for Windows users where Korean search might not work or installation is difficult.
+
+> **❓ What is WSL?**  
+> It allows you to run Linux environments directly on Windows. MyTunes works perfectly in this environment.
+
+1. **Install WSL**:
+   - Right-click `Start` -> Run `Terminal (Admin)`.
+   - Enter the command below and **Reboot**:
+     ```powershell
+     wsl --install -d Debian
+     ```
+
+2. **Install Essentials**:
+   ```bash
+   sudo apt update && sudo apt install mpv python3-pip pipx -y
+   ```
+
+3. **Install MyTunes**:
+   ```bash
+   pipx install mytunes-pro
+   pipx ensurepath
+   source ~/.bashrc  # Apply settings immediately
+   ```
+
+---
+
+## 🧑‍💻 Manual Installation (For Developers)
+
+Follow these steps to modify source code or use the development version.
+
+1. **Clone Repository**:
+   ```bash
+   git clone https://github.com/postgresql-co-kr/mytunes.git
+   cd mytunes
+   ```
+
+2. **Setup Virtual Environment**:
+   ```bash
+   python3 -m venv venv
+   source venv/bin/activate  # macOS/Linux
+   pip install -r requirements.txt
+   ```
+
+3. **Run**:
+   ```bash
+   python3 mytune.py
+   ```
+
+---
+
+## ⌨️ Controls
+
+**MyTunes Pro** is controlled entirely by keyboard.  
+We recommend using **Number Keys** for lag-free operation even in multi-language input modes.
+
+### ⚡️ Instant Hotkeys (Number Keys)
+Executes immediately without worrying about input language status.
+
+| Key | Function | Description |
+| :--- | :--- | :--- |
+| **`1`** | **Search** | Open music search (Same as `S`) |
+| **`2`** | **Favorites** | View favorites list (Same as `F`) |
+| **`3`** | **History** | View recently played 100 tracks (Same as `R`) |
+| **`4`** | **Main** | Return to main screen (Same as `M`) |
+| **`5`** | **Add/Del** | Toggle favorite for selected track (Same as `A`) |
+| **`+`** | **Vol UP** | Volume +5% (Same as `=`) |
+| **`-`** | **Vol DOWN** | Volume -5% (Same as `_`) |
+| **`F7`** | **Open YouTube** | View current track in browser |
+| **`E`** | **Equalizer** | Cycle EQ presets (Auto/Flat/Pop/Rock/Jazz/etc.) |
+| **`6`** | **Back** | Go to previous screen (Same as `Q`, `h`) |
+| **`L`** | **Forward** | Go forward to previous screen (`Right Arrow`) |
+| **`ESC`** | **Background** | **Exit without stopping music** (Background Play) |
+
+### 🧭 Basic Navigation
+| Key | Action |
+| :--- | :--- |
+| `↑` / `↓` / `k` / `j` | Move selection Up/Down (Vim keys supported) |
+| `Enter` / `l` | **Select / Play** |
+| `Space` | Play / Pause |
+| `-` / `+` | **Volume Control** |
+| `,` / `.` | Rewind / Forward 10s |
+| `<` / `>` | Rewind / Forward 30s (Shift) |
+| `Backspace` / `h` / `q` | Go Back / Clear Search |
+| `L` | **Go Forward** |
+| `/` | **Search** (Vim Style) |
+
+---
+
+## 📂 Data Storage
+- Favorites and playback history are permanently saved in `~/.pymusic_data.json` in your home directory.
+- Data is preserved even after restarting the program.
+
+---
+---
+
+# 🎵 MyTunes Pro (Experimental Media Tool - KR)
+
+## 🚀 터미널 기반 미디어 워크플로우 실험 v2.1.0
+
+> [!IMPORTANT]
+> **법적 면책 고지:** 본 프로젝트는 개발자 교육 및 연구를 목적으로 하는 개인적, 비상업적 실험입니다. 
+> 본 소프트웨어는 어떠한 미디어 콘텐츠도 직접 호스팅하거나 배포하지 않습니다. 
+> 모든 미디어 소스는 사용자의 로컬 환경에서 직접 구성되고 접근되며, 사용자는 외부 플랫폼의 이용 약관을 준수할 책임이 있습니다.
+
+MyTunes Pro는 개발자를 위해 설계된 **CLI 미디어 실험 도구**입니다.
+Python `curses` 라이브러리를 통해 터미널 환경에서 미디어 URL을 로드하고 관리하며, 
+사용자가 설치한 `mpv` 등의 외부 도구와 연동하여 미디어 워크플로우를 테스트할 수 있습니다.
+
+## ✨ 주요 특징
+
+- **미디어 핸들링**: 외부 추출 도구를 사용한 미디어 URL 로드 및 처리 지원.
+- **TUI 워크플로우**: `curses` 라이브러리 기반의 효율적인 터미널 인터페이스.
+- **작업 유지**: 순차적 미디어 로딩 및 마지막 작업 상태 복원 기능.
+- **환경 연동**: 사용자에 의해 구성된 외부 미디어 도구와의 연동 지원. (본 소프트웨어는 외부 도구를 포함하여 배포하지 않습니다.)
+
+---
+
+## 📸 스크린샷 (Screenshots)
+| | |
+| :---: | :---: |
+| ![Main](https://raw.githubusercontent.com/postgresql-co-kr/mytunes/master/screenshots/screenshot_1.webp) | ![Search](https://raw.githubusercontent.com/postgresql-co-kr/mytunes/master/screenshots/screenshot_2.webp) |
+| ![Play](https://raw.githubusercontent.com/postgresql-co-kr/mytunes/master/screenshots/screenshot_3.webp) | ![List](https://raw.githubusercontent.com/postgresql-co-kr/mytunes/master/screenshots/screenshot_4.webp) |
+
+---
+
 ## 🚀 빠른 설치 (Quick Install)
 
 최신 macOS/Linux 시스템(PEP 668)에서는 **`pipx`** 사용을 강력히 권장합니다.
@@ -129,12 +305,12 @@ Windows 환경에서 한글 검색이 안 되거나 설치가 어려운 분들
      wsl --install -d Debian
      ```
 
-3. **필수 도구 설치**:
+2. **필수 도구 설치**:
    ```bash
    sudo apt update && sudo apt install mpv python3-pip pipx -y
    ```
 
-4. **MyTunes 설치**:
+3. **MyTunes 설치**:
    ```bash
    pipx install mytunes-pro
    pipx ensurepath
@@ -185,6 +361,7 @@ Windows 환경에서 한글 검색이 안 되거나 설치가 어려운 분들
 | **`+`** | **볼륨 UP** | 볼륨 +5% (단축키 `=`와 동일) |
 | **`-`** | **볼륨 DOWN** | 볼륨 -5% (단축키 `_`와 동일) |
 | **`F7`** | **유튜브 열기** | 현재 곡을 브라우저에서 보기 |
+| **`E`** | **이퀄라이저** | EQ 프리셋 전환 (Auto/Flat/Pop/Rock/Jazz 등) |
 | **`6`** | **뒤로가기** | 이전 화면으로 이동 (단축키 `Q`, `h`와 동일) |
 | **`L`** | **앞으로** | 이전 화면에서 앞화면으로 다시 이동 (`Right Arrow`) |
 | **`ESC`** | **배경재생** | **음악 끄지 않고 나가기** (백그라운드 재생) |
@@ -211,32 +388,31 @@ Windows 환경에서 한글 검색이 안 되거나 설치가 어려운 분들
 ---
 ---
 
----
-
-# 🎵 MyTunes Pro (Experimental Media Tool - KR)
-
-## 🚀 터미널 기반 미디어 워크플로우 실험 v2.0.5
-
-> [!IMPORTANT]
-> **법적 면책 고지:** 본 프로젝트는 개발자 교육 및 연구를 목적으로 하는 개인적, 비상업적 실험입니다. 
-> 본 소프트웨어는 어떠한 미디어 콘텐츠도 직접 호스팅하거나 배포하지 않습니다. 
-> 모든 미디어 소스는 사용자의 로컬 환경에서 직접 구성되고 접근되며, 사용자는 외부 플랫폼의 이용 약관을 준수할 책임이 있습니다.
-
-MyTunes Pro는 개발자를 위해 설계된 **CLI 미디어 실험 도구**입니다.
-Python `curses` 라이브러리를 통해 터미널 환경에서 미디어 URL을 로드하고 관리하며, 
-사용자가 설치한 `mpv` 등의 외부 도구와 연동하여 미디어 워크플로우를 테스트할 수 있습니다.
-
-## ✨ 주요 특징
-
-- **미디어 핸들링**: 외부 추출 도구를 사용한 미디어 URL 로드 및 처리 지원.
-- **TUI 워크플로우**: `curses` 라이브러리 기반의 효율적인 터미널 인터페이스.
-- **작업 유지**: 순차적 미디어 로딩 및 마지막 작업 상태 복원 기능.
-- **환경 연동**: 사용자에 의해 구성된 외부 미디어 도구와의 연동 지원. (본 소프트웨어는 외부 도구를 포함하여 배포하지 않습니다.)
-
----
-
 ## 🔄 Changelog
 
+### 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.
+- **Cache System**: Added 200-entry EQ genre cache to skip redundant keyword matching for repeated tracks.
+
+### v2.0.6 (2026-02-02)
+- **10-Band Equalizer**: Added professional-grade 10-band EQ with presets (Flat, Pop, Rock, Jazz, Classical, Full Bass, Dance, Club, Live, Soft).
+- **Auto EQ Detection**: Intelligent genre detection from track title/channel info automatically applies optimal EQ preset.
+- **Keyboard Shortcut**: Press `E` to cycle through EQ presets in real-time without interrupting playback.
+- **Multilingual Genre Keywords**: Auto EQ supports genre detection in 12 languages including Korean, Japanese, Chinese, Spanish, and more.
+
 ### v2.0.5 (2026-02-01)
 - **Input Feedback Refinement**: Transitioned from blinking warnings to a static Bold Yellow status message for better accessibility and premium feel.
 - **Auto-clear Optimization**: Implemented a 5-second auto-clear timer for all transient status messages.

{mytunes_pro-2.0.5 → mytunes_pro-2.1.0}/README.md

@@ -1,11 +1,11 @@
-# 🎵 MyTunes Pro - Professional TUI Edition v2.0.5
+# 🎵 MyTunes Pro - Professional TUI Edition v2.1.0
 
-## 🚀 Terminal-based Media Workflow Experiment v2.0.5
+## 🚀 Terminal-based Media Workflow Experiment v2.1.0
 
 > [!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. 
+> **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.
 
 MyTunes Pro is a developer-focused **CLI Media Tool** for experimenting with terminal-based media workflows.
@@ -19,6 +19,8 @@ leveraging the `mpv` engine for local media processing and playback.
 ![Python](https://img.shields.io/badge/Python-3.9%2B-blue.svg)
 ![License](https://img.shields.io/badge/License-MIT-green.svg)
 
+---
+
 ## 📸 Screenshots
 | | |
 | :---: | :---: |
@@ -48,6 +50,180 @@ leveraging the `mpv` engine for local media processing and playback.
 
 ---
 
+## 🚀 Quick Install
+
+We strongly recommend using **`pipx`** on modern macOS/Linux systems (PEP 668).
+
+### 1. Recommended Method (pipx)
+Automatically creates an isolated environment and registers the command.
+
+```bash
+# Ensure ensuredpath is run to register the command after pipx install!
+pipx install mytunes-pro
+pipx ensurepath
+source ~/.zshrc  # or source ~/.bashrc (apply immediately to current terminal)
+```
+
+### 2. Standard pip Method
+If you encounter the `externally-managed-environment` error, add the following flag:
+
+```bash
+pip install mytunes-pro --break-system-packages
+```
+
+After installation, type **`mp`** anywhere in the terminal to run!
+
+### 🔄 Update
+If already installed, simply use the command below to update to the latest features:
+
+```bash
+pipx upgrade mytunes-pro
+```
+
+---
+
+## 🛠 Prerequisites
+
+Please install the necessary tools for your operating system before running.
+
+### macOS (Using 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 (WSL Guide)
+
+Guide for Windows users where Korean search might not work or installation is difficult.
+
+> **❓ What is WSL?**  
+> It allows you to run Linux environments directly on Windows. MyTunes works perfectly in this environment.
+
+1. **Install WSL**:
+   - Right-click `Start` -> Run `Terminal (Admin)`.
+   - Enter the command below and **Reboot**:
+     ```powershell
+     wsl --install -d Debian
+     ```
+
+2. **Install Essentials**:
+   ```bash
+   sudo apt update && sudo apt install mpv python3-pip pipx -y
+   ```
+
+3. **Install MyTunes**:
+   ```bash
+   pipx install mytunes-pro
+   pipx ensurepath
+   source ~/.bashrc  # Apply settings immediately
+   ```
+
+---
+
+## 🧑‍💻 Manual Installation (For Developers)
+
+Follow these steps to modify source code or use the development version.
+
+1. **Clone Repository**:
+   ```bash
+   git clone https://github.com/postgresql-co-kr/mytunes.git
+   cd mytunes
+   ```
+
+2. **Setup Virtual Environment**:
+   ```bash
+   python3 -m venv venv
+   source venv/bin/activate  # macOS/Linux
+   pip install -r requirements.txt
+   ```
+
+3. **Run**:
+   ```bash
+   python3 mytune.py
+   ```
+
+---
+
+## ⌨️ Controls
+
+**MyTunes Pro** is controlled entirely by keyboard.  
+We recommend using **Number Keys** for lag-free operation even in multi-language input modes.
+
+### ⚡️ Instant Hotkeys (Number Keys)
+Executes immediately without worrying about input language status.
+
+| Key | Function | Description |
+| :--- | :--- | :--- |
+| **`1`** | **Search** | Open music search (Same as `S`) |
+| **`2`** | **Favorites** | View favorites list (Same as `F`) |
+| **`3`** | **History** | View recently played 100 tracks (Same as `R`) |
+| **`4`** | **Main** | Return to main screen (Same as `M`) |
+| **`5`** | **Add/Del** | Toggle favorite for selected track (Same as `A`) |
+| **`+`** | **Vol UP** | Volume +5% (Same as `=`) |
+| **`-`** | **Vol DOWN** | Volume -5% (Same as `_`) |
+| **`F7`** | **Open YouTube** | View current track in browser |
+| **`E`** | **Equalizer** | Cycle EQ presets (Auto/Flat/Pop/Rock/Jazz/etc.) |
+| **`6`** | **Back** | Go to previous screen (Same as `Q`, `h`) |
+| **`L`** | **Forward** | Go forward to previous screen (`Right Arrow`) |
+| **`ESC`** | **Background** | **Exit without stopping music** (Background Play) |
+
+### 🧭 Basic Navigation
+| Key | Action |
+| :--- | :--- |
+| `↑` / `↓` / `k` / `j` | Move selection Up/Down (Vim keys supported) |
+| `Enter` / `l` | **Select / Play** |
+| `Space` | Play / Pause |
+| `-` / `+` | **Volume Control** |
+| `,` / `.` | Rewind / Forward 10s |
+| `<` / `>` | Rewind / Forward 30s (Shift) |
+| `Backspace` / `h` / `q` | Go Back / Clear Search |
+| `L` | **Go Forward** |
+| `/` | **Search** (Vim Style) |
+
+---
+
+## 📂 Data Storage
+- Favorites and playback history are permanently saved in `~/.pymusic_data.json` in your home directory.
+- Data is preserved even after restarting the program.
+
+---
+---
+
+# 🎵 MyTunes Pro (Experimental Media Tool - KR)
+
+## 🚀 터미널 기반 미디어 워크플로우 실험 v2.1.0
+
+> [!IMPORTANT]
+> **법적 면책 고지:** 본 프로젝트는 개발자 교육 및 연구를 목적으로 하는 개인적, 비상업적 실험입니다. 
+> 본 소프트웨어는 어떠한 미디어 콘텐츠도 직접 호스팅하거나 배포하지 않습니다. 
+> 모든 미디어 소스는 사용자의 로컬 환경에서 직접 구성되고 접근되며, 사용자는 외부 플랫폼의 이용 약관을 준수할 책임이 있습니다.
+
+MyTunes Pro는 개발자를 위해 설계된 **CLI 미디어 실험 도구**입니다.
+Python `curses` 라이브러리를 통해 터미널 환경에서 미디어 URL을 로드하고 관리하며, 
+사용자가 설치한 `mpv` 등의 외부 도구와 연동하여 미디어 워크플로우를 테스트할 수 있습니다.
+
+## ✨ 주요 특징
+
+- **미디어 핸들링**: 외부 추출 도구를 사용한 미디어 URL 로드 및 처리 지원.
+- **TUI 워크플로우**: `curses` 라이브러리 기반의 효율적인 터미널 인터페이스.
+- **작업 유지**: 순차적 미디어 로딩 및 마지막 작업 상태 복원 기능.
+- **환경 연동**: 사용자에 의해 구성된 외부 미디어 도구와의 연동 지원. (본 소프트웨어는 외부 도구를 포함하여 배포하지 않습니다.)
+
+---
+
+## 📸 스크린샷 (Screenshots)
+| | |
+| :---: | :---: |
+| ![Main](https://raw.githubusercontent.com/postgresql-co-kr/mytunes/master/screenshots/screenshot_1.webp) | ![Search](https://raw.githubusercontent.com/postgresql-co-kr/mytunes/master/screenshots/screenshot_2.webp) |
+| ![Play](https://raw.githubusercontent.com/postgresql-co-kr/mytunes/master/screenshots/screenshot_3.webp) | ![List](https://raw.githubusercontent.com/postgresql-co-kr/mytunes/master/screenshots/screenshot_4.webp) |
+
+---
+
 ## 🚀 빠른 설치 (Quick Install)
 
 최신 macOS/Linux 시스템(PEP 668)에서는 **`pipx`** 사용을 강력히 권장합니다.
@@ -109,12 +285,12 @@ Windows 환경에서 한글 검색이 안 되거나 설치가 어려운 분들
      wsl --install -d Debian
      ```
 
-3. **필수 도구 설치**:
+2. **필수 도구 설치**:
    ```bash
    sudo apt update && sudo apt install mpv python3-pip pipx -y
    ```
 
-4. **MyTunes 설치**:
+3. **MyTunes 설치**:
    ```bash
    pipx install mytunes-pro
    pipx ensurepath
@@ -165,6 +341,7 @@ Windows 환경에서 한글 검색이 안 되거나 설치가 어려운 분들
 | **`+`** | **볼륨 UP** | 볼륨 +5% (단축키 `=`와 동일) |
 | **`-`** | **볼륨 DOWN** | 볼륨 -5% (단축키 `_`와 동일) |
 | **`F7`** | **유튜브 열기** | 현재 곡을 브라우저에서 보기 |
+| **`E`** | **이퀄라이저** | EQ 프리셋 전환 (Auto/Flat/Pop/Rock/Jazz 등) |
 | **`6`** | **뒤로가기** | 이전 화면으로 이동 (단축키 `Q`, `h`와 동일) |
 | **`L`** | **앞으로** | 이전 화면에서 앞화면으로 다시 이동 (`Right Arrow`) |
 | **`ESC`** | **배경재생** | **음악 끄지 않고 나가기** (백그라운드 재생) |
@@ -191,32 +368,31 @@ Windows 환경에서 한글 검색이 안 되거나 설치가 어려운 분들
 ---
 ---
 
----
-
-# 🎵 MyTunes Pro (Experimental Media Tool - KR)
-
-## 🚀 터미널 기반 미디어 워크플로우 실험 v2.0.5
-
-> [!IMPORTANT]
-> **법적 면책 고지:** 본 프로젝트는 개발자 교육 및 연구를 목적으로 하는 개인적, 비상업적 실험입니다. 
-> 본 소프트웨어는 어떠한 미디어 콘텐츠도 직접 호스팅하거나 배포하지 않습니다. 
-> 모든 미디어 소스는 사용자의 로컬 환경에서 직접 구성되고 접근되며, 사용자는 외부 플랫폼의 이용 약관을 준수할 책임이 있습니다.
-
-MyTunes Pro는 개발자를 위해 설계된 **CLI 미디어 실험 도구**입니다.
-Python `curses` 라이브러리를 통해 터미널 환경에서 미디어 URL을 로드하고 관리하며, 
-사용자가 설치한 `mpv` 등의 외부 도구와 연동하여 미디어 워크플로우를 테스트할 수 있습니다.
-
-## ✨ 주요 특징
-
-- **미디어 핸들링**: 외부 추출 도구를 사용한 미디어 URL 로드 및 처리 지원.
-- **TUI 워크플로우**: `curses` 라이브러리 기반의 효율적인 터미널 인터페이스.
-- **작업 유지**: 순차적 미디어 로딩 및 마지막 작업 상태 복원 기능.
-- **환경 연동**: 사용자에 의해 구성된 외부 미디어 도구와의 연동 지원. (본 소프트웨어는 외부 도구를 포함하여 배포하지 않습니다.)
-
----
-
 ## 🔄 Changelog
 
+### 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.
+- **Cache System**: Added 200-entry EQ genre cache to skip redundant keyword matching for repeated tracks.
+
+### v2.0.6 (2026-02-02)
+- **10-Band Equalizer**: Added professional-grade 10-band EQ with presets (Flat, Pop, Rock, Jazz, Classical, Full Bass, Dance, Club, Live, Soft).
+- **Auto EQ Detection**: Intelligent genre detection from track title/channel info automatically applies optimal EQ preset.
+- **Keyboard Shortcut**: Press `E` to cycle through EQ presets in real-time without interrupting playback.
+- **Multilingual Genre Keywords**: Auto EQ supports genre detection in 12 languages including Korean, Japanese, Chinese, Spanish, and more.
+
 ### v2.0.5 (2026-02-01)
 - **Input Feedback Refinement**: Transitioned from blinking warnings to a static Bold Yellow status message for better accessibility and premium feel.
 - **Auto-clear Optimization**: Implemented a 5-second auto-clear timer for all transient status messages.

{mytunes_pro-2.0.5 → mytunes_pro-2.1.0}/pyproject.toml

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