유튜브 컨텐츠를 MP3로 다운로드 | PlaylistDL + Docker 완벽 설정

매번 눌러 듣기 귀찮았다면?

아이들 동요, 운동 루틴, 운전 중 들을 강의까지…
유튜브에서 검색하고 일일이 눌러 듣는 건 손이 많이 가고, 데이터도 아깝다.
그래서 대부분 “유튜브 프리미엄”을 떠올리지만, 대안이 있다.

바로, PlaylistDL을 이용하면 된다.
이 프로그램은 유튜브 컨텐츠의 공유 링크 URL 하나만 붙여넣으면,
유튜브에서 오디오로만 듣고싶은 컨텐츠를 다운로드받고 FFmpeg로 MP3로 변환까지 자동으로 처리한다.

• 광고 없음
• 로그인 없이 작동
• 오디오 품질 손실 최소

📌 “영상 스트리밍”이 아닌 오픈 API + FFmpeg 기반 다운로드이기 때문에 가능한 구조다.

위 처럼링크만 복붙하면 유튜브컨텐츠를 mp3로 다운로드가 가능하다.
단, PlaylistDL은 유튜브의 브라우저 스트리밍이 아니라
오픈 API + FFmpeg 기반 추출 방식이다.
PlaylistDL은 유튜브에서 공유 가능한 공개 영상의 링크를 기반으로,
개인 감상용으로 오디오를 백업할 수 있도록 도와준다.
저작권이 있는 음원은 다운로드나 배포 대상이 아니다.

🧩 PlaylistDL을 Docker로 돌리면 생기는 마법

PlaylistDL을 Docker 컨테이너로 실행하면
관리와 업데이트가 단순해지고, NAS와도 완벽하게 연동된다.

즉, “한 번 저장 → NAS에 자동 반영 → Emby / Navidrome 음악 서버에서 바로 재생”.
이건 단순한 다운로드가 아니라 음악 보관과 재생이 통합된 자동화 시스템이다.

💬 Emby나 Navidrome은 멜론·FLO처럼 작동하는 개인 음악 스트리밍 서버다.
다음 포스트에서 Emby/Navidrome 연동 가이드도 자세히 다룰 예정이다.

🧱 전체 구조 요약

🐳 Docker Compose 완전 버전

version: "3.8"
services:
  playlistdl:
    image: tanner23456/playlistdl:v2           # PlaylistDL 웹 UI 이미지
    container_name: playlistdl
    restart: unless-stopped
    # ▶ Healthcheck: 5000 포트 정상 응답 확인
    healthcheck:
      test: ["CMD-SHELL", "nc -z 127.0.0.1 5000 || exit 1"]
      interval: 10s
      timeout: 5s
      retries: 3
      start_period: 90s
    # ▶ 포트: http://서버IP:28401 로 접속
    ports:
      - "28401:5000"
    environment:
      # 관리자 계정 (반드시 변경 or .env 로 분리)
      ADMIN_USERNAME: "${PLDL_ADMIN_USER}"     # ex) sysadmin
      ADMIN_PASSWORD: "${PLDL_ADMIN_PASS}"     # ex) StrongPass2025!
      
      # 다운로드 경로 (컨테이너 내부 기준)
      AUDIO_DOWNLOAD_PATH: "/downloads"
      # 정리 주기 (초 단위, 기본 300초 = 5분)
      CLEANUP_INTERVAL: "300"
      # 타임존
      TZ: "Asia/Seoul"
      # (선택) 고음질 인코딩 옵션
      # FFMPEG_ARGS: "-q:a 0"     # 최고 음질(VBR)
    volumes:
      # NAS 공유 폴더를 컨테이너 내부 /downloads 로 마운트
      - /mnt/music:/downloads:rw
      # 구성파일, 로그 저장소
      - /mnt/docker/playlistdl/config:/config:rw
      - /mnt/docker/playlistdl/logs:/logs:rw

.env 예시:

PLDL_ADMIN_USER=ytmusic
PLDL_ADMIN_PASS=StrongPass_!2025

🎧 FFmpeg MP3 변환의 진짜 장점

PlaylistDL의 핵심은 FFmpeg이다.
단순한 오디오 추출이 아니라, 음질·볼륨·태그까지 완벽히 정리한다.

결과적으로 플레이리스트 전체가 균일한 볼륨의 고음질 MP3 컬렉션으로 정리된다.

💡 Emby / Navidrome 연동 (예고)

현재는 PlaylistDL이 다운로드와 변환을 담당하지만,
다음 포스트에서는 이를 Emby 또는 Navidrome과 연결해
자동 라이브러리 업데이트 → 모든 기기에서 음악 스트리밍까지 확장하는 방법을 다룰 예정이다.

🚫 유튜브 컨텐츠를 MP3로 다운로드

PlaylistDL은 유튜브의 브라우저 스트리밍이 아니라
오픈 API + FFmpeg 기반 추출 방식이다.
PlaylistDL은 유튜브에서 공유 가능한 공개 영상의 링크를 기반으로,
개인 감상용으로 오디오를 백업할 수 있도록 도와준다.
저작권이 있는 음원은 다운로드나 배포 대상이 아니다.

✅ 로그인 불필요
✅ 광고 없음
✅ 고음질 유지
✅ 재생 제한 없음

⚠️ 단, 개인 백업·합법적 이용 범위 내에서만 사용해야 하며
상업 음원이나 저작권 보호 음원은 공유나 재배포 금지다.

⚙️ 실행 & 운영 팁

1. docker compose up -d → 실행
2. 브라우저에서 http://서버IP:28401 접속
3. 유튜브 플레이리스트 URL 붙여넣기 → “Download” 클릭
4. 변환 완료 시 NAS /mnt/music 경로에 MP3 자동 생성
5. Emby/Navidrome에서 라이브러리 스캔 시 자동 반영

🔒 보안 & 유지관리 팁

🧩 마무리

PlaylistDL은 단순한 유튜브 다운로드 툴이 아니다.
**“자동화된 개인 음악 수집기”**다.
프리미엄 없이도, 광고 없이, 내가 원하는 모든 음원을
고음질 MP3로 자동 정리하고 보관할 수 있다.

이 시스템을 구축해두면,

🎧 “언제든 들을 수 있고, 사라지지 않는 나만의 라이브러리”
가 완성된다.

다음 글에서는
👉 Emby/Navidrome 자동 연동 + 스마트폰·스피커 스트리밍 구성
가이드를 자세히 다룰 예정이니 기대해도 좋다.

참고:미니PC+NAS셋팅가이드

관련글:PlaylistDL공식홈페이지