YouTube Audio Extractor Pro

English Version | 한국어 버전

---

1. Overview

A desktop application that extracts audio from YouTube videos and saves specific segments as WAV files using a waveform-based UI.

2. Key Features

• Audio Download: High-speed extraction utilizing yt-dlp.
• Segment Editing: Select sections via click and drag on the waveform UI (minimum 0.1 sec precision).
• Lossless Cutting: Zero-crossing snap technology prevents popping noise at cut boundaries.
• Utilities: Loop playback, volume control, and mouse wheel zoom.
• History Management: Automatically saves and recalls recently used URLs.

3. System Requirements

• OS: Windows, macOS, Linux
• Python: 3.8+ (Verified on Python 3.14)
• Required Engine: FFmpeg (for audio transcoding and segment extraction). Must be added to the system PATH or placed in the same directory as the executable.

4. Installation & Execution

4.1. Install Dependencies

pip install PyQt6 yt-dlp numpy

4.2. Run Application

python main.py

5. Controls

• Left Click: Move playhead.
• Drag: Select audio segment (minimum 100ms).
• Marker Drag: Fine-tune start/end points of the selection.
• Mouse Wheel: Horizontal zoom in/out on the waveform.
• Spacebar: Play / Pause.
• L Key: Toggle loop playback.

6. Build Guide (PyInstaller)

6.1. Standard Build (Excludes FFmpeg)

python -m PyInstaller --noconsole --onefile --add-data "icon.ico;." --icon="icon.ico" main.py

6.2. Standalone Build (Includes FFmpeg, Recommended)

python -m PyInstaller --noconsole --onefile --add-data "icon.ico;." --add-binary "ffmpeg.exe;." --icon="icon.ico" main.py

---

1. 개요

유튜브 영상의 오디오를 추출하고 파형(Waveform) 기반 UI를 통해 지정 구간을 WAV 파일로 저장하는 데스크톱 애플리케이션임.

2. 주요 기능

• 오디오 다운로드: yt-dlp 기반 음원 고속 추출.
• 구간 편집: 파형 UI 클릭 및 드래그를 통한 구간 선택 (최소 0.1초 단위).
• 무손실 컷팅: Zero-crossing 스냅 기술로 절단면 팝핑 노이즈(Popping noise) 발생 방지.
• 부가 기능: 선택 구간 반복 재생(Loop), 볼륨 조절, 마우스 휠 줌(Zoom).
• 히스토리 관리: 최근 사용 URL 자동 저장 및 재호출 지원.

3. 시스템 요구사항

• OS: Windows, macOS, Linux
• Python: 3.8 이상 (Python 3.14 환경 호환성 확인 완료)
• 필수 엔진: FFmpeg (오디오 트랜스코딩 및 구간 추출용). 시스템 PATH에 등록되어 있거나 실행 파일과 동일한 경로에 위치해야 함.

4. 설치 및 실행

4.1. 필수 라이브러리 설치

pip install PyQt6 yt-dlp numpy

4.2. 프로그램 실행

python main.py

5. 조작 방법 및 단축키

• 좌클릭: 재생 헤드 이동.
• 드래그: 오디오 구간 선택 (100ms 이상).
• 마커 드래그: 선택 구간 시작/종료점 미세 조정.
• 마우스 휠: 파형 가로 확대/축소.
• Space: 재생 / 일시정지.
• L: 구간 반복 재생(Loop) 토글.

6. 빌드 가이드 (PyInstaller)

6.1. 기본 빌드 (FFmpeg 미포함)

python -m PyInstaller --noconsole --onefile --add-data "icon.ico;." --icon="icon.ico" main.py

6.2. 독립형 빌드 (FFmpeg 포함, 권장)

python -m PyInstaller --noconsole --onefile --add-data "icon.ico;." --add-binary "ffmpeg.exe;." --icon="icon.ico" main.py