fqscfqj/Y2A-Auto

Y2A‑Auto – YouTube → AcFun / Bilibili 자동 재업로드 도구

기능 개요 – Y2A‑Auto는 자체 호스팅 가능한 Python 애플리케이션으로, YouTube 채널이나 키워드 검색을 모니터링하여 새로운 동영상을 자동으로 다운로드하고, 선택적으로 음성 인식(Whisper 또는 Voxtral)을 실행하며, OpenAI 모델을 사용한 자막 번역/품질 검사, 제목/태그 생성, 콘텐츠 모더레이션 검사 후 최종적으로 AcFun, Bilibili 또는 양쪽에 동영상을 업로드합니다. 모든 단계는 웹 대시보드를 통해 조율되며 완전히 자동으로 실행될 수 있습니다.

주요 구성 요소

• 다운로더 – yt‑dlp를 사용하여 동영상, 썸네일 이미지, 그리고 선택적 자동 생성된 YouTube 자막을 가져옵니다.
• ASR 및 자막 파이프라인 – 음성 인식에는 Whisper 또는 Voxtral, 번역 및 품질 검사는 OpenAI 기반, 규칙 기반 정제, 그리고 선택적 AI 기반 품질 검사를 포함합니다.
• AI 생성 메타데이터 – OpenAI의 채팅 모델을 통해 제목, 설명, 태그, 파티션 추천을 생성합니다.
• 콘텐츠 모더레이션 – 선택적으로 Alibaba Cloud Green 서비스를 사용하여 부적절한 텍스트를 필터링합니다.
• 업로드 엔진 – AcFun 및 Bilibili용 QR 코드 로그인 또는 쿠키 기반 인증을 지원하며, FFmpeg를 사용해 자막을 자동으로 번들링합니다.
• 관리 UI – Flask 기반 대시보드로 작업 큐, 수동 검토, 설정, 로그를 관리할 수 있습니다.
• 자동화 도구 – YouTube 모니터링(채널/키워드 폴링), CookieCloud 동기화를 통한 YouTube 쿠키 관리, 다중 채널 알림(WeChat Work, Server‑Chan, message‑pusher), 보안 기능(비밀번호 보호, 5회 실패 시 블록, 30분 세션 타임아웃, 경로 탐색 방지)을 포함합니다.

실행 방법

1. Docker(권장) – docker compose up -d로 사전 빌드된 이미지(fqscfqj/y2a-auto:latest)를 다운로드합니다.
2. 로컬 – Python 3.11 가상 환경을 생성하고 requirements.txt를 설치, FFmpeg와 yt‑dlp가 PATH에 포함되어 있는지 확인한 후 python app.py를 실행합니다.
3. Windows 포터블 – 제공된 빌드 도구를 사용하며, 릴리스 번들에는 이미 FFmpeg가 포함되어 있습니다.

초기 설정

• YouTube, AcFun, Bilibili 쿠키를 cookies/ 폴더에 배치합니다 (YouTube는 yt_cookies.txt, 나머지는 JSON 형식).
• http://localhost:5000을 열고 원하는 경우 비밀번호 보호를 활성화하고 API 키(YouTube Data API, OpenAI, Alibaba Cloud, 알림 웹훅 등)를 설정합니다.
• AUTO_MODE_ENABLED를 활성화하여 수동 개입 없이 시스템이 자동으로 작동하도록 합니다.

설정 요약 (모두 config/config.json에 있음)

• 동영상 처리 – VIDEO_ENCODER (auto|cpu|nvidia|intel|amd), 하드웨어 가속 HEVC를 권장하며, 대체로 H.264를 사용합니다.
• 자막 워크플로우 – SUBTITLE_TRANSLATION_ENABLED, SUBTITLE_QC_ENABLED를 전환하고, 원본/대상 언어, 배치 크기, 동시성 설정을 지정합니다.
• ASR – SPEECH_RECOGNITION_ENABLED를 활성화하고, 제공자(whisper 또는 voxtral)를 선택하며, VAD 및 언어 설정을 조정합니다.
• AI 메타데이터 – OPENAI_API_KEY를 제공하고, 모델 이름을 지정하며, 생성 플래그(TRANSLATE_TITLE, GENERATE_TAGS 등)를 활성화합니다.
• 모니터링 – YouTube Data API 키를 제공하고, 채널 또는 키워드를 정의하며, latest 또는 historical 모드를 설정합니다.
• 알림 – NOTIFY_CHANNELS에 채널을 나열하고, 해당 웹훅/키를 채웁니다.
• 보안 – 비밀번호 보호, 5회 실패 시 블록, 30분 세션 타임아웃, 시크릿 키 지속성.

왜 중요한가

• 수동 다운로드, 음성 인식, 번역, 재업로드가 필요했던 완전한 엔드투엔드 파이프라인을 자동화합니다.
• 최신 AI 모델(Whisper/Voxtral 음성 인식, OpenAI 번역 및 콘텐츠 생성)을 활용하면서도 운영자가 세밀한 제어와 선택적 인간 검토를 가능하게 합니다.
• AcFun 또는 Bilibili에서 YouTube 콘텐츠를 재사용하고자 하는 중국어 중심의 크리에이터를 위한 설계로, 내장된 준수 검사 기능을 갖추고 있습니다.

라이선스 – GNU GPL v3.

---

모든 세부 정보는 리포지토리의 README에서 직접 가져왔으며, 추가 기능은 추측되지 않았습니다.