yQuant

YT 자막 다운로더 (ytcapt)

유튜브 자동 생성 자막을 다운로드하고 읽기 쉬운 문장으로 정제. 웹 UI와 CLI 제공, 다국어 지원 및 7일 캐싱

Python Bottle YouTube NLP CLI Web-UI

유튜브 자동 생성 자막을 다운로드하고 읽기 쉬운 문장으로 정제하는 도구입니다. 편리한 자막 처리를 위해 CLI와 웹 애플리케이션 인터페이스를 모두 제공합니다.

#주요 기능

  • 웹 인터페이스: BottlePico CSS를 사용한 깔끔하고 가벼운 웹 UI
  • 자막 정제: 조각난 라인을 완전한 문장과 문단으로 병합
  • 캐싱: 효율성 향상을 위한 7일 데이터 캐싱
  • 다국어 지원: 한국어 정제 규칙 및 기본 영어 지원
  • 표준화된 구조: Scripter 표준 프로젝트 구조 및 배포 방식 준수

#사용법

#명령줄 인터페이스 (CLI)

# 기본 사용법 (한국어)
./scripts/run.sh "https://www.youtube.com/watch?v=XXXXXXXXXXX"

# 언어 지정 (영어)
./scripts/run.sh "https://www.youtube.com/watch?v=XXXXXXXXXXX" -l en

#웹 애플리케이션

# 웹 서버 실행
./scripts/run.sh

# 메인 서비스로 설치 (Linux/systemd)
./scripts/install-systemd.sh

접속: http://localhost:9822/ytcapt/

#프로젝트 구조

ytcapt/
├── src/
│   ├── app.py          # 웹 애플리케이션 엔트리포인트
│   ├── ytcapt.py       # 핵심 로직 및 CLI 모듈
│   ├── main.py         # 리포팅 통합 CLI 래퍼
│   ├── refiners/       # 언어별 정제 규칙
│   └── views/          # 웹 템플릿
├── tests/              # 테스트 코드
├── scripts/            # 실행 및 배포 스크립트
└── requirements.txt    # 의존성

#기술 스택

  • Python 3.12+ - 코어 언어
  • Bottle - 웹 프레임워크
  • Pico CSS - UI 스타일링
  • 자막 처리 - 문장 병합을 위한 커스텀 NLP 규칙

Share this post