anime_downloader/outline.md

anime_downloader 플러그인 구조 분석

📌 개요

FlaskFarm용 애니메이션 다운로드 플러그인으로, 여러 애니메이션 스트리밍 사이트에서 콘텐츠를 검색하고 다운로드할 수 있는 기능을 제공합니다.

---

🏗️ 전체 구조

anime_downloader/
├── __init__.py           # 플러그인 초기화 (현재 비활성화됨)
├── setup.py              # 플러그인 설정 및 메뉴 구조, 모듈 로드
├── info.yaml             # 플러그인 메타데이터 (이름, 버전, 개발자)
├── mod_ohli24.py         # 애니24 사이트 모듈 (1,542줄)
├── mod_anilife.py        # 애니라이프 사이트 모듈 (1,322줄)
├── mod_linkkf.py         # 링크애니 사이트 모듈 (1,449줄)
├── lib/                  # 공용 라이브러리
│   ├── crawler.py        # 웹 크롤링 엔진 (Playwright, Selenium, Cloudscraper)
│   ├── ffmpeg_queue_v1.py# FFmpeg 다운로드 큐 관리
│   ├── util.py           # 유틸리티 함수 (파일명 정리, 타이밍 등)
│   └── misc.py           # 비동기 실행 헬퍼 함수
├── templates/            # HTML 템플릿 (18개 파일)
├── static/               # CSS, JS, 이미지 리소스
├── bin/                  # 플랫폼별 바이너리 (Darwin, Linux)
├── nest_api/             # 애니 API 관련 (서브디렉토리)
└── yommi_api/            # 커스텀 API 관련

---

🔧 핵심 컴포넌트

1. setup.py - 플러그인 엔트리포인트

항목	설명
__menu	3개 사이트별 서브메뉴 (설정, 요청, 큐, 검색, 목록)
setting	DB 사용, 기본 설정, 홈 모듈(ohli24) 지정
P	FlaskFarm 플러그인 인스턴스 생성
모듈 로드	LogicOhli24, LogicAniLife, LogicLinkkf

2. 사이트 모듈 (mod_*.py)

각 모듈은 동일한 구조를 따릅니다:

클래스	역할
LogicXxx	사이트별 비즈니스 로직 (검색, 시리즈 정보, 다운로드 추가)
XxxQueueEntity	다운로드 큐 항목 (에피소드 정보, 상태 관리)
ModelXxxItem	SQLAlchemy DB 모델 (다운로드 기록 저장)

LogicXxx 주요 메서드:

• process_menu() / process_ajax() - 웹 요청 처리
• get_series_info() - 시리즈/에피소드 정보 파싱
• get_anime_info() / get_search_result() - 목록/검색
• add() - 다운로드 큐에 추가
• scheduler_function() - 자동 다운로드 스케줄러
• plugin_load() / plugin_unload() - 생명주기 관리

3. lib/crawler.py - 웹 크롤링 엔진

메서드	기술
get_html_requests()	기본 requests 요청
get_html_playwright()	Playwright 비동기 (헤드리스 브라우저)
get_html_playwright_sync()	Playwright 동기
get_html_selenium()	Selenium WebDriver
get_html_cloudflare()	Cloudscraper (CF 우회)

4. lib/ffmpeg_queue_v1.py - 다운로드 큐

클래스	역할
FfmpegQueueEntity	개별 다운로드 항목 (URL, 파일경로, 상태)
FfmpegQueue	큐 관리자 (스레드 기반 다운로드, 동시 다운로드 수 제어)

---

🖥️ 지원 사이트 (3개)

모듈	사이트	URI
mod_ohli24.py	애니24 (ohli24)	/ohli24
mod_anilife.py	애니라이프	/anilife
mod_linkkf.py	링크애니	/linkkf

---

📄 템플릿 구조

각 사이트별로 6개 템플릿 제공:

• *_setting.html - 사이트 설정
• *_request.html - 다운로드 요청 페이지
• *_queue.html - 다운로드 큐 현황
• *_search.html - 검색 인터페이스
• *_list.html - 다운로드 목록
• *_category.html - 카테고리 탐색

---

🔄 동작 흐름

graph LR
    A[사용자] --> B[검색/탐색]
    B --> C[시리즈 선택]
    C --> D[에피소드 선택]
    D --> E[다운로드 큐 추가]
    E --> F[FfmpegQueue]
    F --> G[FFmpeg 다운로드]
    G --> H[DB 기록 저장]

---

⚠️ 주의사항

1. 개발 모드: setup.py에서 DEFINE_DEV = True로 설정되어 직접 모듈 import
2. __init__.py 비활성화: 현재 주석 처리되어 setup.py가 실제 엔트리포인트 역할
3. 크롤링 기술 혼용: Cloudflare 우회를 위해 Playwright, Selenium, cloudscraper 등 다양한 기술 사용