jiji262/douyin-downloader
Python0 / 0
Douyin 콘텐츠를 CLI와 Desktop GUI로 일괄 저장하는 Python downloader
TL;DR
이 레포는 Douyin의 영상·이미지 노트·合集·음악·profile 콘텐츠를 CLI로 일괄 저장하는 Python 도구이며, 같은 backend를 쓰는 Douzy Desktop GUI와 TikTok·YouTube workspace도 제공합니다. 링크를 유형별로 파싱하고 API pagination 또는 Playwright browser fallback으로 항목을 수집한 뒤, watermark-free·최고 bitrate 소스를 골라 동시 다운로드와 재시도, 무결성 검사를 수행합니다. SQLite history와 로컬 파일 검사를 통한 중복 방지, 댓글·자막·metadata 저장, REST API·Docker·알림 연동까지 갖춰 개인 아카이브나 자동화 서버에 맞습니다. 반면 cookie와 플랫폼 접근 조건이 필요하고 pagination 차단 및 CAPTCHA에 영향을 받으며, 일부 browser fallback과 live HLS 처리는 제한적이므로 서비스 안정성이 절대적으로 필요한 수집 시스템에는 별도 검증이 필요합니다.
핵심 포인트
- 이 레포는 Python으로 만든 Douyin 전용 standalone CLI 도구이며, 같은 backend를 사용하는 Douzy Desktop GUI도 제공합니다. 영상·이미지 노트·合集·음악과 creator profile 일괄 다운로드를 한 설정 파일에서 처리합니다. Douyin뿐 아니라 Douzy를 통해 TikTok과 YouTube 다운로드 workspace도 함께 사용할 수 있습니다.
- 입력 링크를 유형별로 파싱한 뒤 API pagination과 필요 시 Playwright 기반 browser fallback으로 콘텐츠를 수집합니다. watermark-free 소스와 최고 bitrate를 선택하고, 동시 다운로드·지수 backoff 재시도·Content-Length 검증·불완전 파일 정리를 거칩니다. SQLite 기록과 로컬 파일을 함께 확인해 중복을 줄이며 댓글 JSON, metadata, cover, music, transcript 같은 부가 파일도 선택적으로 저장합니다.
- Python 3.8 이상에서 macOS·Linux·Windows와 Docker를 지원하고 REST API 서버 모드와 Bark·Telegram·Webhook 알림도 제공합니다. 다만 cookie가 필요하고 Douyin의 pagination risk control에 따라 browser에서 수동 CAPTCHA를 처리해야 할 수 있습니다. live HLS는 재생 가능한 미디어가 아니라 playlist를 저장하며, `like`·`mix`·`music`의 browser fallback과 webcast room endpoint는 제한 또는 실험 단계이므로 안정적인 개인 백업과 자동화에 적합합니다.
이미지 분석




11.3k
STARS
1.7k
FORKS
+473
TRENDING
0
조회수
관련 토론
아직 관련 토론이 없습니다.
댓글
댓글을 작성하려면 로그인이 필요합니다.