바이브코딩Python

[Vibe Coding] YouTube 다운로더 프로그램

Chae-hyeon Kim
2025년 8월 19일

프로젝트 소개

  1. GitHub URL

    https://github.com/chdev-kr/2025-youtube-downloader

구현 화면 및 기능

  • 메인 화면

image.png


프로젝트명

YouTube 다운로더(yt-dlp를 사용한 사용자 친화적인 YouTube 동영상 다운로더입니다.)


사용 기술 및 기술 스택

사용된 라이브러리

  • yt-dlp: YouTube 다운로드 엔진
  • tkinter: GUI 프레임워크
  • PyInstaller: 실행 파일 생성
  • threading: 비동기 다운로드 처리

사용된 언어

  • Python

주요 특징

  • 간편한 GUI: 직관적인 인터페이스로 누구나 쉽게 사용
  • 다양한 품질 옵션: 최고화질부터 저화질까지 선택 가능
  • 오디오 추출: MP3 형태로 오디오만 추출 가능
  • 실시간 진행률: 다운로드 진행 상황을 실시간으로 확인
  • 크로스 플랫폼: Windows와 macOS에서 모두 사용 가능

개발 배경

주변에서 YouTube 영상을 다운로드해야 할 때마다 CLI 기반 도구를 대신 다뤄주는 일이 잦았습니다. 명령어 환경에 익숙하지 않은 일반 사용자에게는 높은 진입 장벽이 있었기 때문입니다. 반복되는 비효율을 개선하고 바이브코딩 경험을 시도해보고자, Cursor AI를 활용해 Python 기반의 누구나 쉽게 사용할 수 있는 YouTube 영상 다운로더를 제작했습니다.

기존 문제점

  • 터미널 환경에 대한 기술적 이해 필요
  • 복잡한 명령어 구문과 옵션 설정
  • 비개발자들의 접근성 제한
  • 반복적인 수동 다운로드 요청 처리

해결 방안

  • 이러한 기술적 격차를 해소하고 사용자 경험을 개선하고자, 직관적인 GUI 환경을 제공하여 기술적 배경지식 없이도 누구나 쉽게 YouTube 콘텐츠를 다운로드할 수 있는 사용자 중심의 솔루션을 개발하였습니다.

사용법

기본 사용법

  1. YouTube URL 입력: 다운로드하고 싶은 YouTube 영상의 URL을 입력합니다.
  2. 다운로드 폴더 선택: 파일을 저장할 위치를 선택합니다.
  3. 옵션 설정:
    • 비디오 품질: best720p480p360pworst 중 선택
    • 다운로드 타입: 비디오 또는 오디오만 선택
  4. 다운로드 시작: "다운로드 시작" 버튼을 클릭합니다.

지원되는 URL 형식

  • 일반 YouTube 동영상: https://www.youtube.com/watch?v=VIDEO_ID
  • 짧은 URL: https://youtu.be/VIDEO_ID
  • 재생목록: https://www.youtube.com/playlist?list=PLAYLIST_ID

품질 옵션 설명

  • best: 가장 높은 화질
  • 720p: HD 화질
  • 480p: 표준 화질
  • 360p: 저화질
  • worst: 가장 낮은 화질

오디오 추출

"오디오만" 옵션을 선택하면:

  • MP3 형식으로 추출됩니다
  • 비트레이트: 192kbps
  • 파일 크기가 작아집니다