gommi_downloader_manager/README.md

gommi_download_manager (GDM)

FlaskFarm 범용 다운로더 큐 플러그인 (v0.1.0)

🆕 0.1.0 업데이트 (Latest)

• 다운로드 속도 제한: 설정 페이지에서 대역폭 제한 설정 가능 (무제한, 1MB/s, 5MB/s...)
• UI 리뉴얼: 고급스러운 Dark Metallic 디자인 & 반응형 웹 지원
• 안정성 강화: 서버 재시작 시 대기 중인 다운로드 상태 복원 (Queue Persistence)
• 목록 관리: 전체 삭제 및 자동 목록 갱신 기능 (Flickr-free)

주요 기능

• YouTube/일반 사이트: yt-dlp + aria2c 지원 (고속 분할 다운로드)
• 스트리밍 사이트: 애니24, 링크애니, Anilife (ffmpeg HLS / Camoufox) 지원
• 중앙 집중식 관리: 여러 플러그인의 다운로드 요청을 한곳에서 통합 관리
• 전역 속도 제한 (Smart Limiter): 모든 다운로드에 공통 적용되는 속도 제한 기능

외부 플러그인에서 사용하기

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='youtube', # 호출자 식별
)

설정 가이드

웹 인터페이스 (/gommi_download_manager/queue/setting)에서 다음을 설정할 수 있습니다:

• 속도 제한: 네트워크 상황에 맞춰 최대 다운로드 속도 조절
• 동시 다운로드 수: 한 번에 몇 개를 받을지 설정
• 기본 저장 경로: 경로 미지정 요청에 대한 백업 경로

성능 비교

다운로더	방식	특징
yt-dlp (Native)	안정적	속도 제한 기능 완벽 지원
aria2c	고속 (분할)	대용량 파일에 최적화 (현재 실험적 지원)
ffmpeg	스트림	HLS/M3U8 영상 저장에 사용