Release v0.2.0: Fix package name, improve DB stability, support realtime youtube title update

README.md

@@ -1,71 +1,18 @@
-# gommi_download_manager (GDM)
+# Gommi Downloader Manager (GDM)
 
-FlaskFarm 범용 다운로더 큐 플러그인 (v0.2.0)
+FlaskFarm용 범용 다운로드 매니저 플러그인입니다.
+여러 다운로더 플러그인(YouTube, Anime 등)의 다운로드 요청을 통합 관리하고 큐(Queue)를 제공합니다.
 
-## 🆕 0.2.0 업데이트 (2026-01-06)
+## v0.2.0 변경사항
+- **패키지명 수정**: `gommi_download_manager` -> `gommi_downloader_manager`로 폴더명과 일치시켜 Bind Key 오류 해결.
+- **안정성 개선**: DB 테이블 생성 로직 강화 (`setup.py` 명시적 모델 import).
+- **YouTube 제목 지원**: `yt-dlp` 다운로드 시작 시 영상의 진짜 제목과 썸네일을 실시간으로 DB에 업데이트합니다.
+- **UI 개선**: 큐 리스트 템플릿 오류 수정.
 
-### 새 기능
-- **플러그인 콜백 시스템**: 다운로드 완료 시 호출 플러그인에 상태 알림
-- **외부 플러그인 통합 강화**: `caller_plugin`, `callback_id` 파라미터로 호출자 추적
-- **HLS ffmpeg 헤더 수정**: None 값 필터링으로 에러 방지
+## 설치 및 업데이트
+1. `git pull`
+2. FlaskFarm 재시작 (DB 마이그레이션 적용을 위해 필수)
 
-### 버그 수정
-- PluginManager API 호환성 수정 (`F.plugin_instance_list` → `F.PluginManager.all_package_list`)
-- 완료된 다운로드 진행률 100% 표시 수정
-- 큐 목록 URL 표시 제거 (깔끔한 UI)
-
-### UI 개선
-- 다크 메탈릭 디자인 유지
-- 완료 상태 표시 개선
-
----
-
-## 주요 기능
-
-- **YouTube/일반 사이트**: yt-dlp + aria2c 지원 (고속 분할 다운로드)
-- **스트리밍 사이트**: 애니24, 링크애니, Anilife (ffmpeg HLS / Camoufox) 지원
-- **중앙 집중식 관리**: 여러 플러그인의 다운로드 요청을 한곳에서 통합 관리
-- **전역 속도 제한 (Smart Limiter)**: 모든 다운로드에 공통 적용되는 속도 제한 기능
-
-## 외부 플러그인에서 사용하기
-
-```python
-from gommi_download_manager.mod_queue import ModuleQueue
-
-# 다운로드 추가 (콜백 지원)
-task = ModuleQueue.add_download(
-    url='https://www.youtube.com/watch?v=...',
-    save_path='/path/to/save',
-    filename='video.mp4',
-    source_type='auto',
-    caller_plugin='my_plugin_name',  # 콜백 호출 시 식별자
-    callback_id='unique_item_id',    # 콜백 데이터에 포함
-)
-```
-
-## 콜백 수신하기
-
-호출 플러그인에서 `plugin_callback` 메서드를 정의하면 다운로드 완료 시 자동 호출됩니다:
-
-```python
-class MyModule:
-    def plugin_callback(self, data):
-        # data = {'callback_id': ..., 'status': 'completed', 'filepath': ..., 'error': ...}
-        if data['status'] == 'completed':
-            print(f"다운로드 완료: {data['filepath']}")
-```
-
-## 설정 가이드
-
-웹 인터페이스 (`/gommi_download_manager/queue/setting`)에서 다음을 설정할 수 있습니다:
-- **속도 제한**: 네트워크 상황에 맞춰 최대 다운로드 속도 조절
-- **동시 다운로드 수**: 한 번에 몇 개를 받을지 설정
-- **기본 저장 경로**: 경로 미지정 요청에 대한 백업 경로
-
-## 성능 비교
-
-| 다운로더 | 방식 | 특징 |
-|---------|------|------|
-| **yt-dlp (Native)** | 안정적 | 속도 제한 기능 완벽 지원 |
-| **aria2c** | 고속 (분할) | 대용량 파일에 최적화 (현재 실험적 지원) |
-| **ffmpeg** | 스트림 | HLS/M3U8 영상 저장에 사용 |
+## 지원 플러그인
+- youtube-dl
+- anime_downloader (Ohli24, Linkkf 등)