KeyNapper

YouTube 영상 URL을 받아 음악의 키를 감지하고, 키를 조절한 새 영상을 만들어주는 Python 프로젝트.

요구사항

• Python 3.10+
• ffmpeg (시스템에 설치 필요)

ffmpeg 설치:

# Ubuntu/Debian
sudo apt install ffmpeg

# macOS
brew install ffmpeg

설치

# 1. 저장소 클론
git clone https://github.com/your-username/KeyNapper.git
cd KeyNapper

# 2. 가상환경 생성 및 활성화
python -m venv venv
source venv/bin/activate

# 3. 의존성 설치
pip install -r requirements.txt

실행

# 가상환경 활성화
source venv/bin/activate

# 기본 사용법
python main.py <YouTube_URL> --semitones <반음_수>

예시

# 키를 2반음 내리기
python main.py https://www.youtube.com/watch?v=XXXXXXXXXXX --semitones -2

# 키를 3반음 올리기
python main.py https://www.youtube.com/watch?v=XXXXXXXXXXX --semitones 3

실행하면 다음 순서로 처리됩니다:

1. YouTube 영상 다운로드
2. 오디오 추출
3. 음악 키 감지 및 출력
4. 피치 조절
5. 새 영상 합성 → output/ 폴더에 저장

출력 파일명 예시: output/XXXXXXXXXXX_-2st.mp4

폴더 구조

KeyNapper/
├── main.py          # 진입점
├── analyzer.py      # 키 감지 (librosa)
├── processor.py     # 피치 조절 및 영상 합성
├── requirements.txt
├── temp/            # 처리 중 임시 파일
└── output/          # 완성된 영상 저장