반응형
YouTube 음악을 MP3로 다운로드하는 Python 프로그램 만들기: 단계별 가이드
오늘은 Python을 사용하여 YouTube 동영상의 오디오를 MP3 파일로 다운로드하는 프로그램을 만드는 방법을 단계별로 알아보겠습니다. 이 프로그램은 사용하기 쉬운 GUI 인터페이스를 갖추고 있어 누구나 쉽게 사용할 수 있습니다.
이번에도 광고가 붙은 웹사이트 기능 중에 활용도가 높은 기능을 선택했습니다. 그것이 바로 YouTube 음악 MP3 추출입니다. 많은 사이트에서 제공하는 이 기능을 직접 만들어 더 안전하고 효율적으로 사용해 보세요.
목차
- 프로그램 기능 미리보기
- 1단계: 필요한 라이브러리 설치하기
- 2단계: 기본 파일 구조 설정
- 3단계: 필요한 바이너리 다운로드 스크립트 작성하기
- 4단계: YouTube MP3 다운로드 모듈 작성하기
- 5단계: 메인 애플리케이션 작성하기
- 6단계: FFmpeg 및 yt-dlp 다운로드하기
- 7단계: 프로그램 실행하기
- 8단계: 독립 실행형 EXE 파일로 빌드하기
- 저작권 관련 주의사항
프로그램 기능 미리보기
- YouTube 또는 YouTube Music 링크를 입력하여 MP3로 변환
- 여러 URL을 한 번에 대기열에 추가하고 일괄 처리
- 다운로드 진행 상황 실시간 표시
- 다운로드 완료 후 자동으로 폴더 열기 기능
- 단일 EXE 파일로 배포 가능
1단계: 필요한 라이브러리 설치하기
시작하기 전에 필요한 라이브러리를 설치해야 합니다. 명령 프롬프트에서 다음 명령어를 실행하세요:
pip install customtkinter
또한 다음과 같은 두 개의 외부 도구가 필요합니다:
- FFmpeg: 오디오 변환에 사용됩니다
- yt-dlp: YouTube 동영상 다운로드에 사용됩니다
이 도구들은 나중에 프로그램에서 자동으로 다운로드할 수 있도록 코드를 작성할 것입니다.
2단계: 기본 파일 구조 설정
다음과 같은 구조로 프로젝트를 설정하겠습니다:
youtube_mp3_downloader/
├── main.py # 메인 애플리케이션 파일
├── export_youtube_mp3.py # YouTube MP3 다운로드 모듈
├── download_binaries.py # FFmpeg 및 yt-dlp 다운로드 스크립트
├── bin/ # 바이너리 파일 저장 폴더
│ ├── ffmpeg.exe # 다운로드할 FFmpeg
│ └── yt-dlp.exe # 다운로드할 yt-dlp
└── walrus.ico # 애플리케이션 아이콘 (선택사항)
먼저 프로젝트 폴더를 만들고, 그 안에 필요한 파일들을 하나씩 작성해 나갈 것입니다.
3단계: 필요한 바이너리 다운로드 스크립트 작성하기
가장 먼저 download_binaries.py 파일을 만들어 필요한 외부 도구를 자동으로 다운로드할 수 있게 합니다:
import os
import sys
import urllib.request
import zipfile
import shutil
def download_file(url, filepath):
"""파일 다운로드"""
print(f"다운로드 중: {url} -> {filepath}")
try:
urllib.request.urlretrieve(url, filepath)
print(f"다운로드 완료: {filepath}")
return True
except Exception as e:
print(f"다운로드 실패: {e}")
return False
def download_ffmpeg():
"""FFmpeg 다운로드 및 압축 해제"""
print("FFmpeg 다운로드 시작...")
# 임시 zip 파일 경로
temp_zip = "ffmpeg_temp.zip"
# FFmpeg 다운로드 URL (최신 버전)
ffmpeg_url = "https://github.com/BtbN/FFmpeg-Builds/releases/download/latest/ffmpeg-master-latest-win64-gpl.zip"
# 다운로드
success = download_file(ffmpeg_url, temp_zip)
if not success:
print("FFmpeg 다운로드 실패")
return False
# 압축 해제 및 ffmpeg.exe 추출
try:
print("FFmpeg 압축 해제 중...")
with zipfile.ZipFile(temp_zip, 'r') as zip_ref:
zip_ref.extractall("ffmpeg_temp")
ffmpeg_exe = None
for root, dirs, files in os.walk("ffmpeg_temp"):
if "ffmpeg.exe" in files:
ffmpeg_exe = os.path.join(root, "ffmpeg.exe")
break
if not ffmpeg_exe:
print("압축 파일에서 ffmpeg.exe를 찾을 수 없습니다.")
return False
# bin 폴더에 복사
os.makedirs("bin", exist_ok=True)
shutil.copy2(ffmpeg_exe, "bin/ffmpeg.exe")
# 임시 파일 정리
if os.path.exists(temp_zip):
os.remove(temp_zip)
if os.path.exists("ffmpeg_temp"):
shutil.rmtree("ffmpeg_temp")
print("FFmpeg 다운로드 및 설치 완료")
return True
except Exception as e:
print(f"FFmpeg 압축 해제 중 오류 발생: {e}")
return False
def download_ytdlp():
"""yt-dlp 다운로드"""
print("yt-dlp 다운로드 시작...")
# yt-dlp 다운로드 URL (최신 버전)
ytdlp_url = "https://github.com/yt-dlp/yt-dlp/releases/latest/download/yt-dlp.exe"
# bin 폴더에 다운로드
os.makedirs("bin", exist_ok=True)
success = download_file(ytdlp_url, "bin/yt-dlp.exe")
if success:
print("yt-dlp 다운로드 및 설치 완료")
return True
else:
print("yt-dlp 다운로드 실패")
return False
if __name__ == "__main__":
print("필요한 바이너리 다운로드 중...")
download_ffmpeg()
download_ytdlp()
print("완료! 엔터 키를 눌러 종료하세요.")
input()
이 스크립트는 FFmpeg와 yt-dlp를 자동으로 다운로드하여 bin 폴더에 설치합니다. urllib.request 모듈을 사용하여 파일을 다운로드하고, zipfile 모듈로 압축을 해제합니다.
4단계: YouTube MP3 다운로드 모듈 작성하기
다음으로 export_youtube_mp3.py 파일을 작성합니다. 이 파일은 YouTube 링크를 MP3로 변환하는 핵심 기능을 담고 있습니다:
import os
import re
import threading
import subprocess
import sys
import urllib.request
import customtkinter as ctk
from tkinter import filedialog, messagebox
class YoutubeMP3Tab:
def __init__(self, parent):
self.parent = parent
self.output_path = os.path.expanduser("~/Downloads") # 기본 다운로드 경로
self.download_queue = []
self.is_downloading = False
# FFmpeg 경로 설정
self.ffmpeg_path = self.get_ffmpeg_path()
# yt-dlp 경로 설정
self.ytdlp_path = self.get_ytdlp_path()
if not self.ytdlp_path:
self.download_ytdlp()
self.ytdlp_path = self.get_ytdlp_path()
self.setup_ui()
def get_ffmpeg_path(self):
"""FFmpeg 바이너리 경로 가져오기"""
# 먼저 여러 가능한 위치 확인
possible_paths = [
# 1. PyInstaller 번들된 경로
os.path.join(sys._MEIPASS, 'bin', 'ffmpeg.exe') if getattr(sys, 'frozen', False) else None,
# 2. 현재 스크립트 디렉토리 기준 상대 경로
os.path.join(os.path.dirname(os.path.dirname(os.path.abspath(__file__))), 'bin', 'ffmpeg.exe'),
# 3. 프로젝트 루트 디렉토리의 ffmpeg.exe
os.path.join(os.path.dirname(os.path.dirname(os.path.abspath(__file__))), 'ffmpeg.exe'),
# 4. 현재 작업 디렉토리의 ffmpeg.exe
os.path.join(os.getcwd(), 'ffmpeg.exe'),
# 5. bin 폴더의 ffmpeg.exe
os.path.join(os.getcwd(), 'bin', 'ffmpeg.exe'),
# 6. 시스템 PATH의 ffmpeg
'ffmpeg.exe' if sys.platform.startswith('win') else 'ffmpeg'
]
# 가능한 경로들에서 존재하는 첫 번째 경로 반환
for path in possible_paths:
if path and os.path.exists(path):
print(f"FFmpeg 찾음: {path}")
return path
# 찾지 못한 경우 기본값 반환
print("ffmpeg.exe를 찾을 수 없어 시스템 PATH에서 찾습니다.")
return 'ffmpeg.exe' if sys.platform.startswith('win') else 'ffmpeg'
def get_ytdlp_path(self):
"""yt-dlp 바이너리 경로 가져오기"""
# 먼저 여러 가능한 위치 확인
possible_paths = [
# 1. PyInstaller 번들된 경로
os.path.join(sys._MEIPASS, 'bin', 'yt-dlp.exe') if getattr(sys, 'frozen', False) else None,
# 2. 현재 스크립트 디렉토리 기준 상대 경로
os.path.join(os.path.dirname(os.path.dirname(os.path.abspath(__file__))), 'bin', 'yt-dlp.exe'),
# 3. 프로젝트 루트 디렉토리의 yt-dlp.exe
os.path.join(os.path.dirname(os.path.dirname(os.path.abspath(__file__))), 'yt-dlp.exe'),
# 4. 현재 작업 디렉토리의 yt-dlp.exe
os.path.join(os.getcwd(), 'yt-dlp.exe'),
# 5. bin 폴더의 yt-dlp.exe
os.path.join(os.getcwd(), 'bin', 'yt-dlp.exe'),
]
# 가능한 경로들에서 존재하는 첫 번째 경로 반환
for path in possible_paths:
if path and os.path.exists(path):
print(f"yt-dlp 찾음: {path}")
return path
# 찾지 못한 경우 None 반환
print("yt-dlp.exe를 찾을 수 없습니다.")
return None
def download_ytdlp(self):
"""yt-dlp 바이너리 다운로드"""
try:
self.update_progress("yt-dlp 바이너리 다운로드 중...")
print("yt-dlp 바이너리 다운로드 중...")
# 다운로드 URL (최신 Windows 버전)
url = "https://github.com/yt-dlp/yt-dlp/releases/latest/download/yt-dlp.exe"
# 다운로드할 위치
os.makedirs("bin", exist_ok=True)
download_path = os.path.join(os.getcwd(), "bin", "yt-dlp.exe")
# 다운로드
urllib.request.urlretrieve(url, download_path)
# 파일이 존재하는지 확인
if os.path.exists(download_path):
print(f"yt-dlp 다운로드 성공: {download_path}")
self.update_progress("yt-dlp 다운로드 완료")
return download_path
else:
print("yt-dlp 다운로드 실패")
self.update_progress("yt-dlp 다운로드 실패")
return None
except Exception as e:
print(f"yt-dlp 다운로드 오류: {e}")
self.update_progress(f"yt-dlp 다운로드 오류: {e}")
return None
def setup_ui(self):
"""GUI 컴포넌트 설정"""
# 메인 프레임
self.main_frame = ctk.CTkFrame(self.parent)
self.main_frame.pack(fill="both", expand=True, padx=10, pady=10)
# 상단 프레임 (URL 입력 및 추가 버튼)
self.top_frame = ctk.CTkFrame(self.main_frame)
self.top_frame.pack(fill="x", padx=10, pady=10)
# URL 입력 필드
self.url_label = ctk.CTkLabel(self.top_frame, text="YouTube URL:")
self.url_label.pack(side="left", padx=5, pady=5)
self.url_entry = ctk.CTkEntry(self.top_frame, width=400)
self.url_entry.pack(side="left", padx=5, pady=5, fill="x", expand=True)
# URL 추가 버튼
self.add_button = ctk.CTkButton(self.top_frame, text="추가", command=self.add_url)
self.add_button.pack(side="left", padx=5, pady=5)
# 중간 프레임 (URL 리스트)
self.middle_frame = ctk.CTkFrame(self.main_frame)
self.middle_frame.pack(fill="both", expand=True, padx=10, pady=10)
# URL 리스트 레이블
self.list_label = ctk.CTkLabel(self.middle_frame, text="다운로드 대기열")
self.list_label.pack(anchor="w", padx=5, pady=5)
# URL 리스트박스
self.list_frame = ctk.CTkFrame(self.middle_frame)
self.list_frame.pack(fill="both", expand=True, padx=5, pady=5)
self.url_listbox = ctk.CTkTextbox(self.list_frame)
self.url_listbox.pack(fill="both", expand=True, padx=5, pady=5)
# 하단 프레임 (출력 경로 및 다운로드 버튼)
self.bottom_frame = ctk.CTkFrame(self.main_frame)
self.bottom_frame.pack(fill="x", padx=10, pady=10)
# 출력 경로 설정
self.path_label = ctk.CTkLabel(self.bottom_frame, text="저장 경로:")
self.path_label.pack(side="left", padx=5, pady=5)
self.path_entry = ctk.CTkEntry(self.bottom_frame, width=300)
self.path_entry.pack(side="left", padx=5, pady=5, fill="x", expand=True)
self.path_entry.insert(0, self.output_path)
self.browse_button = ctk.CTkButton(self.bottom_frame, text="찾아보기", command=self.browse_output)
self.browse_button.pack(side="left", padx=5, pady=5)
self.download_button = ctk.CTkButton(self.bottom_frame, text="다운로드 시작", command=self.start_download)
self.download_button.pack(side="left", padx=5, pady=5)
# 진행 상황
self.progress_label = ctk.CTkLabel(self.main_frame, text="")
self.progress_label.pack(anchor="w", padx=10, pady=5)
self.progress_bar = ctk.CTkProgressBar(self.main_frame)
self.progress_bar.pack(fill="x", padx=10, pady=5)
self.progress_bar.set(0)
def browse_output(self):
"""출력 폴더 선택 다이얼로그"""
folder = filedialog.askdirectory()
if folder:
self.output_path = folder
self.path_entry.delete(0, "end")
self.path_entry.insert(0, folder)
def add_url(self):
"""URL을 대기열에 추가"""
url = self.url_entry.get().strip()
if url:
# YouTube 또는 YouTube Music URL 검사
if "youtube.com" in url or "youtu.be" in url or "music.youtube.com" in url:
self.download_queue.append(url)
self.url_listbox.insert("end", f"{url}\n")
self.url_entry.delete(0, "end")
self.update_progress(f"{len(self.download_queue)}개의 URL이 대기열에 있습니다.")
else:
messagebox.showerror("오류", "유효한 YouTube URL이 아닙니다.")
def download_with_ytdlp(self, url, output_path):
"""yt-dlp를 사용하여 YouTube URL에서 MP3 다운로드"""
try:
if not self.ytdlp_path:
self.update_progress("yt-dlp를 찾을 수 없습니다.")
return False
self.update_progress(f"다운로드 준비 중: {url}")
# 출력 폴더가 없으면 생성
if not os.path.exists(output_path):
os.makedirs(output_path)
# 출력 템플릿
output_template = os.path.join(output_path, "%(title)s.%(ext)s")
# yt-dlp 명령어 구성
cmd = [
self.ytdlp_path,
"--extract-audio",
"--audio-format", "mp3",
"--audio-quality", "0", # 최상 품질
"--ffmpeg-location", os.path.dirname(self.ffmpeg_path) if os.path.dirname(self.ffmpeg_path) else ".",
"--progress",
"--newline", # 각 진행 상황을 새 줄에 출력
"--no-playlist", # 단일 동영상만 다운로드
"-o", output_template,
url
]
self.update_progress(f"다운로드 시작: {url}")
print(f"실행 명령어: {' '.join(cmd)}")
# Windows에서 콘솔 창 숨기기
startupinfo = None
if sys.platform.startswith('win'):
startupinfo = subprocess.STARTUPINFO()
startupinfo.dwFlags |= subprocess.STARTF_USESHOWWINDOW
startupinfo.wShowWindow = 0 # SW_HIDE
# 프로세스 실행
process = subprocess.Popen(
cmd,
stdout=subprocess.PIPE,
stderr=subprocess.PIPE,
text=True,
universal_newlines=True,
bufsize=1, # 라인 버퍼링
startupinfo=startupinfo # Windows에서 콘솔 창 숨기기
)
# 출력 실시간 처리
for line in process.stdout:
line = line.strip()
print(f"yt-dlp 출력: {line}")
# 진행 상황 추출 및 표시
if "[download]" in line and "%" in line:
try:
# 진행 상황 파싱 시도
percent_str = line.split("%")[0].split()[-1]
percent = float(percent_str) / 100
self.progress_bar.set(percent)
self.update_progress(f"다운로드 중: {percent_str}%")
except Exception as e:
print(f"진행률 파싱 오류: {e}")
# 다운로드 완료 메시지 표시
elif "[ExtractAudio]" in line:
self.update_progress("오디오 변환 중...")
# 파일명 추출
elif "Destination:" in line:
filename = line.split("Destination:", 1)[1].strip()
self.update_progress(f"파일 저장 중: {os.path.basename(filename)}")
# 다운로드 100% 감지
elif "100% of" in line and "in" in line and "at" in line:
self.update_progress("다운로드 완료")
# 최대 10초 동안만 프로세스 완료 대기
try:
process.wait(timeout=10)
except subprocess.TimeoutExpired:
print("프로세스 대기 시간 초과, 강제 종료합니다.")
process.kill()
# 오류 확인
if process.returncode not in [0, None]:
error = process.stderr.read() if process.stderr else ""
raise Exception(f"yt-dlp 오류 (코드 {process.returncode}): {error}")
self.update_progress("변환 완료")
return True
except Exception as e:
self.update_progress(f"다운로드 오류: {str(e)}")
print(f"yt-dlp 오류: {str(e)}")
return False
def process_download_queue(self):
"""다운로드 대기열 처리"""
self.is_downloading = True
total_urls = len(self.download_queue)
successful = 0
try:
# FFmpeg 확인
try:
# FFmpeg 경로 재확인
print(f"FFmpeg 경로: {self.ffmpeg_path}")
if not os.path.exists(self.ffmpeg_path):
ffmpeg_cmd = "ffmpeg" # 시스템 PATH 사용 시도
else:
ffmpeg_cmd = self.ffmpeg_path
# Windows에서 콘솔 창 숨기기
startupinfo = None
if sys.platform.startswith('win'):
startupinfo = subprocess.STARTUPINFO()
startupinfo.dwFlags |= subprocess.STARTF_USESHOWWINDOW
startupinfo.wShowWindow = 0 # SW_HIDE
self.update_progress("FFmpeg 확인 중...")
subprocess_result = subprocess.run([ffmpeg_cmd, '-version'],
check=True,
capture_output=True,
text=True,
startupinfo=startupinfo)
print(f"FFmpeg 버전: {subprocess_result.stdout.split('\\n')[0]}")
# yt-dlp 경로 확인
if not self.ytdlp_path or not os.path.exists(self.ytdlp_path):
self.update_progress("yt-dlp를 찾을 수 없습니다. 다운로드를 시도합니다...")
self.ytdlp_path = self.download_ytdlp()
if not self.ytdlp_path:
raise Exception("yt-dlp를 다운로드할 수 없습니다.")
# yt-dlp 버전 확인
try:
self.update_progress("yt-dlp 버전 확인 중...")
# Windows에서 콘솔 창 숨기기
startupinfo = None
if sys.platform.startswith('win'):
startupinfo = subprocess.STARTUPINFO()
startupinfo.dwFlags |= subprocess.STARTF_USESHOWWINDOW
startupinfo.wShowWindow = 0 # SW_HIDE
ytdlp_version = subprocess.run([self.ytdlp_path, '--version'],
check=True,
capture_output=True,
text=True,
startupinfo=startupinfo)
print(f"yt-dlp 버전: {ytdlp_version.stdout.strip()}")
except Exception as e:
raise Exception(f"yt-dlp 버전 확인 실패: {str(e)}")
except Exception as e:
error_msg = f"FFmpeg 또는 yt-dlp 확인 중 오류 발생: {str(e)}"
self.update_progress(error_msg)
messagebox.showerror("오류", error_msg)
self.is_downloading = False
return
self.progress_bar.set(0)
self.update_progress("다운로드 시작...")
print("다운로드 시작...")
# 복사본을 만들어 순회 (원본이 변경되는 문제 방지)
queue_copy = self.download_queue.copy()
for idx, url in enumerate(queue_copy):
# 진행률 표시
progress = (idx / total_urls) if total_urls > 0 else 0
self.progress_bar.set(progress)
# URL 다운로드
print(f"다운로드 중: {url}")
# yt-dlp로 다운로드
result = self.download_with_ytdlp(url, self.output_path)
if result:
successful += 1
# 처리된 URL 제거
if url in self.download_queue:
self.download_queue.remove(url)
# 다운로드 완료
self.progress_bar.set(1)
self.update_progress(f"다운로드 완료: {successful}/{total_urls} 성공")
self.url_listbox.delete("1.0", "end")
# 다운로드 폴더 열기 옵션 제공
if successful > 0 and messagebox.askyesno("다운로드 완료", f"다운로드가 완료되었습니다. 다운로드 폴더를 열겠습니까?"):
self.open_output_
이어서 open_output_folder 메서드와 start_download, check_download_status, update_progress 메서드를 구현하겠습니다:
def open_output_folder(self):
"""출력 폴더 열기"""
try:
if sys.platform.startswith('win'):
os.startfile(self.output_path)
elif sys.platform.startswith('darwin'): # macOS
subprocess.call(['open', self.output_path],
startupinfo=subprocess.STARTUPINFO() if hasattr(subprocess, 'STARTUPINFO') else None)
else: # Linux
subprocess.call(['xdg-open', self.output_path],
startupinfo=subprocess.STARTUPINFO() if hasattr(subprocess, 'STARTUPINFO') else None)
except Exception as e:
print(f"폴더 열기 오류: {e}")
def start_download(self):
"""다운로드 시작"""
if self.is_downloading:
messagebox.showinfo("정보", "이미 다운로드가 진행 중입니다.")
return
if not self.download_queue:
messagebox.showinfo("정보", "다운로드할 URL이 없습니다.")
return
# 다운로드 버튼 비활성화
self.download_button.configure(state="disabled", text="다운로드 중...")
# 출력 경로 확인
self.output_path = self.path_entry.get().strip()
if not os.path.exists(self.output_path):
try:
os.makedirs(self.output_path)
self.update_progress(f"폴더 생성됨: {self.output_path}")
except Exception as e:
messagebox.showerror("오류", f"출력 경로를 생성할 수 없습니다: {str(e)}")
self.download_button.configure(state="normal", text="다운로드 시작")
return
# 별도 스레드에서 다운로드 시작
try:
self.download_thread = threading.Thread(target=self.process_download_queue)
self.download_thread.daemon = True
self.download_thread.start()
# 다운로드 버튼 상태를 주기적으로 업데이트하기 위한 체크
self.parent.after(100, self.check_download_status)
# 디버깅 로그
print(f"다운로드 쓰레드 시작됨: {self.download_thread.is_alive()}")
except Exception as e:
messagebox.showerror("오류", f"다운로드 쓰레드를 시작할 수 없습니다: {str(e)}")
self.download_button.configure(state="normal", text="다운로드 시작")
def check_download_status(self):
"""다운로드 상태 확인 및 UI 업데이트"""
if hasattr(self, 'download_thread') and self.download_thread.is_alive():
# 다운로드가 아직 진행 중
self.parent.after(100, self.check_download_status)
else:
# 다운로드가 완료됨 (또는 시작되지 않음)
self.download_button.configure(state="normal", text="다운로드 시작")
def update_progress(self, message):
"""진행 상황 업데이트 (쓰레드 안전)"""
try:
# UI 요소 업데이트를 메인 스레드에서 수행 (쓰레드 안전)
self.parent.after(0, lambda: self.progress_label.configure(text=message))
print(message) # 콘솔에도 출력하여 디버깅 용이하게
# 앱의 상태 바 업데이트 (있는 경우)
if hasattr(self.parent.master.master, 'update_status'):
self.parent.after(0, lambda m=message: self.parent.master.master.update_status(m))
except Exception as e:
print(f"상태 업데이트 중 오류: {e}") # 오류 발생 시 콘솔에 출력
이것으로 export_youtube_mp3.py 파일의 모든 중요한 메서드가 구현되었습니다.
5단계: 메인 애플리케이션 작성하기
마지막으로 main.py 파일을 작성하여 전체 애플리케이션을 구성합니다:
import customtkinter as ctk
import platform
import os
from export_youtube_mp3 import YoutubeMP3Tab
# CustomTkinter 테마 설정
ctk.set_appearance_mode("dark") # "dark" 또는 "light"
ctk.set_default_color_theme("blue") # "blue", "green", "dark-blue"
# 전체 앱 클래스
class App(ctk.CTk):
def __init__(self):
super().__init__()
self.title("YouTube MP3 다운로더")
# 창 크기 설정
self.geometry("800x600")
# 운영체제별 창 최대화 설정
self.after(100, self.maximize_window)
# 아이콘 설정
icon_path = "walrus.ico"
if os.path.exists(icon_path):
self.iconbitmap(icon_path)
# 상태 바
self.status_var = ctk.StringVar()
self.status_var.set("준비됨")
self.status_bar = ctk.CTkLabel(self, textvariable=self.status_var, anchor="w")
self.status_bar.pack(side="bottom", fill="x", padx=10, pady=5)
# 탭 컨트롤
self.tabview = ctk.CTkTabview(self)
self.tabview.pack(fill="both", expand=True, padx=10, pady=10)
# YouTube MP3 다운로드 탭 추가
self.tabview.add("YouTube MP3 다운로더")
self.youtube_mp3 = YoutubeMP3Tab(self.tabview.tab("YouTube MP3 다운로더"))
def update_status(self, message):
"""상태 표시줄 메시지 업데이트"""
self.status_var.set(message)
def maximize_window(self):
"""운영체제에 따라 창 최대화"""
current_os = platform.system()
if current_os == "Windows":
# Windows에서는 'zoomed' 상태 사용
self.state('zoomed')
elif current_os == "Linux":
# Linux에서는 '-zoomed' 속성 사용
try:
self.attributes('-zoomed', True)
except:
# 일부 윈도우 매니저에서는 작동하지 않을 수 있음
pass
elif current_os == "Darwin": # macOS
# macOS에서는 별도의 명령 필요 없음
pass
# 애플리케이션 실행
if __name__ == "__main__":
app = App()
app.mainloop()
이 메인 애플리케이션은 YouTube MP3 다운로드 탭이 있는 창을 만들고, 상태 표시줄을 추가하여 다운로드 진행 상황을 표시합니다.
6단계: FFmpeg 및 yt-dlp 다운로드하기
프로그램을 처음 실행하기 전에 필요한 바이너리를 다운로드해야 합니다. 다음 명령을 실행하세요:
python download_binaries.py
이렇게 하면 FFmpeg와 yt-dlp가 자동으로 다운로드되고 bin 폴더에 설치됩니다.
7단계: 프로그램 실행하기
이제 프로그램을 실행할 수 있습니다:
python main.py
프로그램이 실행되면 다음과 같은 작업을 수행할 수 있습니다:
- YouTube URL을 입력하고 "추가" 버튼을 클릭하여 다운로드 대기열에 추가합니다.
- 여러 URL을 계속 추가할 수 있습니다.
- "찾아보기" 버튼을 클릭하여 MP3 파일을 저장할 위치를 선택합니다.
- "다운로드 시작" 버튼을 클릭하여 다운로드를 시작합니다.
- 진행 상황이 실시간으로 표시됩니다.
- 다운로드가 완료되면 다운로드 폴더를 열 수 있는 옵션이 제공됩니다.
8단계: 독립 실행형 EXE 파일로 빌드하기
프로그램을 다른 사람과 공유하기 위해 독립 실행형 EXE 파일로 빌드할 수 있습니다. 이를 위해 PyInstaller를 사용합니다:
pip install pyinstaller
그런 다음 다음 명령을 실행하여 EXE 파일을 생성합니다:
pyinstaller --onefile --windowed --icon=walrus.ico --clean --name=youtube_mp3_downloader --add-data="bin/ffmpeg.exe;bin" --add-data="bin/yt-dlp.exe;bin" main.py
이 명령어는 다음을 수행합니다:
- --onefile: 모든 종속성을 포함한 단일 실행 파일 생성
- --windowed: 콘솔 창 숨기기 (GUI 전용)
- --icon=walrus.ico: 지정된 아이콘 사용
- --clean: 빌드 전 임시 파일 정리
- --name=youtube_mp3_downloader: 출력 파일 이름 지정
- --add-data="bin/ffmpeg.exe;bin": ffmpeg.exe 포함
- --add-data="bin/yt-dlp.exe;bin": yt-dlp.exe 포함
빌드가 완료되면 dist 폴더에 youtube_mp3_downloader.exe 파일이 생성됩니다. 이 파일은 독립 실행형이므로 다른 컴퓨터에 복사하여 실행할 수 있습니다.
저작권 관련 주의사항
이 프로그램을 사용할 때는 저작권법을 준수해주시기 바랍니다:
- 개인적 사용 제한: 다운로드한 음악은 개인적인 용도로만 사용해야 합니다. 상업적 사용, 재배포, 공유는 법적 문제를 야기할 수 있습니다.
- 아티스트 지원: 좋아하는 음악을 발견했다면 정식 음원 구매, 스트리밍 서비스 이용, 콘서트 참여 등을 통해 아티스트를 지원해 주세요.
- 공정 이용(Fair Use): 교육, 비평, 연구, 보도 등의 목적으로 일부 저작물을 사용하는 것은 '공정 이용'에 해당할 수 있으나, 국가별로 관련 법규가 다를 수 있습니다.
- Creative Commons 및 저작권 프리 콘텐츠: 가능하면 Creative Commons 라이선스가 적용된 콘텐츠나 저작권 제한이 없는 콘텐츠를 사용하는 것이 좋습니다.
이 프로그램은 교육 및 학습 목적으로 제공되며, 저작권이 보호된 콘텐츠의 불법 다운로드를 장려하지 않습니다. 항상 콘텐츠 제작자의 권리를 존중하고 저작권법을 준수하는 범위 내에서 사용해 주시기 바랍니다.
자주 묻는 질문 (FAQ)
Q: 이 프로그램은 어떤 YouTube 링크를 지원하나요? A: 일반 YouTube 링크(youtube.com), YouTube Music 링크(music.youtube.com), 단축 URL(youtu.be)을 모두 지원합니다.
Q: 다운로드 속도가 느려요. 어떻게 해야 하나요? A: 다운로드 속도는 인터넷 연결 속도와 YouTube 서버의 응답 속도에 따라 달라집니다. 인터넷 연결을 확인하세요.
Q: 오류가 발생해요. 어떻게 해결하나요? A: 대부분의 오류는 올바른 경로에 FFmpeg와 yt-dlp가 있는지 확인하는 것으로 해결할 수 있습니다. 오류 메시지를 확인하고 필요한 경우 다시 download_binaries.py를 실행해 보세요.
Q: 이 프로그램은 어떤 운영체제에서 실행되나요? A: Windows, macOS, Linux 모두에서 실행됩니다. EXE 파일은 Windows 전용이지만, 소스 코드는 모든 운영체제에서 실행할 수 있습니다.
검색 키워드: Python YouTube MP3 다운로더, YouTube 음악 추출기, MP3 변환 프로그램, GUI 오디오 다운로더, FFmpeg yt-dlp Python 예제, CustomTkinter 애플리케이션, YouTube 오디오 추출, PyInstaller EXE 빌드, Python 멀티미디어 프로그래밍, YouTube Music 다운로드
참고 사이트
다음은 이 프로젝트를 더 발전시키거나 관련 기술을 학습하는 데 도움이 될 수 있는 참고 사이트입니다:
- CustomTkinter 공식 문서 - GUI 개발에 사용된 CustomTkinter 라이브러리 문서
- yt-dlp GitHub 저장소 - 더 많은 옵션과 최신 업데이트 확인
- FFmpeg 공식 웹사이트 - 오디오/비디오 변환 도구 문서
- PyInstaller 사용 가이드 - EXE 파일 생성 옵션 및 문제 해결
- Python Threading 문서 - 멀티스레딩 기술에 대한 이해
- Creative Commons 라이선스 - 저작권 제한이 없는 콘텐츠 검색
- Python 공식 문서 - Python 언어 레퍼런스
이 링크들은 본 프로젝트에 사용된 기술과 도구에 대한 자세한 정보를 제공합니다. 프로그램을 개선하거나 새로운 기능을 추가하려는 경우 이 자료들을 참고하시기 바랍니다.
반응형
'Python' 카테고리의 다른 글
| Python을 활용한 업무 자동화 예제 [Excel 파일 생성, 데이터 to Excel] (2) | 2025.03.19 |
|---|---|
| Python을 활용한 업무 자동화 예제 [폴더 정리 기능] (1) | 2025.03.18 |
| [Python] Selenium 사용법 정리 (0) | 2023.09.18 |
| Pandas IO File Format (0) | 2022.03.27 |
| Pandas map, apply 예제 (0) | 2022.02.16 |