GN⁺: MeTube: 셀프 호스팅 YouTube 다운로드 프로그램

• 32비트 ARM 빌드 중단

  • 새로운 Node 버전이 32비트 ARM을 지원하지 않음
  • 보안 업데이트와 종속성 문제로 64비트 OS로 마이그레이션 필요

• MeTube 소개

  • youtube-dl의 웹 GUI (yt-dlp 포크 사용)
  • YouTube 및 여러 사이트에서 비디오 다운로드 지원

Docker로 실행

• Docker 명령어

  docker run -d -p 8081:8081 -v /path/to/downloads:/downloads ghcr.io/alexta69/metube
  

• docker-compose 예제

  version: "3"
  services:
    metube:
      image: ghcr.io/alexta69/metube
      container_name: metube
      restart: unless-stopped
      ports:
        - "8081:8081"
      volumes:
        - /path/to/downloads:/downloads
  

환경 변수로 설정

• UID: MeTube가 실행될 사용자 ID (기본값: 1000)
• GID: MeTube가 실행될 그룹 ID (기본값: 1000)
• UMASK: umask 값 (기본값: 022)
• DEFAULT_THEME: 기본 테마 (light, dark, auto, 기본값: auto)
• DOWNLOAD_DIR: 다운로드 저장 경로 (기본값: /downloads)
• AUDIO_DOWNLOAD_DIR: 오디오 전용 다운로드 저장 경로 (기본값: DOWNLOAD_DIR)
• DOWNLOAD_DIRS_INDEXABLE: 다운로드 디렉토리 인덱싱 가능 여부 (기본값: false)
• CUSTOM_DIRS: 사용자 지정 디렉토리 다운로드 활성화 여부 (기본값: true)
• CREATE_CUSTOM_DIRS: 디렉토리 자동 생성 지원 여부 (기본값: true)
• STATE_DIR: 큐 지속성 파일 저장 경로 (기본값: /downloads/.metube)
• TEMP_DIR: 중간 다운로드 파일 저장 경로 (기본값: /downloads)
• DELETE_FILE_ON_TRASHCAN: UI에서 삭제된 파일 서버에서 삭제 여부 (기본값: false)
• URL_PREFIX: 웹 서버의 기본 경로 (기본값: /)
• PUBLIC_HOST_URL: UI에서 표시되는 다운로드 링크의 기본 URL
• PUBLIC_HOST_AUDIO_URL: 오디오 다운로드 링크의 기본 URL
• OUTPUT_TEMPLATE: 다운로드 파일 이름 템플릿 (기본값: %(title)s.%(ext)s)
• OUTPUT_TEMPLATE_CHAPTER: 챕터로 나눈 비디오 파일 이름 템플릿 (기본값: %(title)s - %(section_number)s %(section_title)s.%(ext)s)
• YTDL_OPTIONS: youtube-dl에 전달할 추가 옵션 (JSON 형식)
• YTDL_OPTIONS_FILE: YTDL_OPTIONS를 채우기 위한 JSON 파일 경로

브라우저 쿠키 사용

• docker-compose.yml에 추가

  volumes:
    - /path/to/cookies:/cookies
  environment:
    - YTDL_OPTIONS={"cookiefile":"/cookies/cookies.txt"}
  

• 쿠키 추출 확장 프로그램 설치

  • Firefox
  • Chrome

브라우저 확장 프로그램

• Chrome: Google Chrome Webstore에서 설치 가능
• Firefox: Firefox Addons에서 설치 가능

iOS 단축키

• iOS 단축키: Safari에서 URL을 MeTube로 전송
• 서버 주소 및 포트 입력 필요

iOS 호환성

• iOS 비디오 파일 요구 사항: h264 또는 h265 비디오 코덱 및 aac 오디오 코덱 필요
• MP4 형식 다운로드 시 "Best (iOS)" 옵션 선택 가능

북마클릿

• Chrome 북마클릿: 현재 열린 웹페이지를 MeTube로 전송
• HTTPS 페이지에서 사용 시 HTTPS 역방향 프록시 필요

역방향 프록시 뒤에서 실행

• NGINX 설정 예제

  location /metube/ {
    proxy_pass http://metube:8081;
    proxy_http_version 1.1;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection "upgrade";
    proxy_set_header Host $host;
  }
  

• Apache 설정 예제

  <Location /metube/>
    ProxyPass http://localhost:8081/ retry=0 timeout=30
    ProxyPassReverse http://localhost:8081/
  </Location>
  <Location /metube/socket.io>
    RewriteEngine On
    RewriteCond %{QUERY_STRING} transport=websocket [NC]
    RewriteRule /(.*) ws://localhost:8081/socket.io/$1 [P,L]
    ProxyPass http://localhost:8081/socket.io retry=0 timeout=30
    ProxyPassReverse http://localhost:8081/socket.io
  </Location>
  

• Caddy 설정 예제

  example.com {
    route /metube/* {
      uri strip_prefix metube
      reverse_proxy metube:8081
    }
  }
  

yt-dlp 업데이트

• 자동 야간 빌드: 새로운 yt-dlp 버전이 있으면 자동으로 빌드 및 Docker 이미지 업데이트
• watchtower 설치 및 설정 권장

문제 해결 및 이슈 제출

• MeTube는 yt-dlp의 UI: yt-dlp 관련 문제는 MeTube 프로젝트에 제출하지 않음
• yt-dlp 명령어 직접 사용 권장: 옵션 테스트 후 YTDL_OPTIONS에 적용

로컬 빌드 및 실행

• 필요한 도구: node.js 및 Python 3.11

  cd metube/ui
  npm install
  node_modules/.bin/ng build
  cd ..
  pip3 install pipenv
  pipenv install
  pipenv run python3 app/main.py
  

• Docker 이미지 로컬 빌드

  docker build -t metube .
  

개발 노트

• Windows, macOS, Linux에서 작동
• VSCode에서 서버 실행 시 다운로드 폴더는 사용자의 Downloads 폴더

GN⁺의 정리

• MeTube는 youtube-dl의 웹 GUI로, 여러 사이트에서 비디오를 다운로드할 수 있는 기능을 제공함
• Docker를 사용하여 쉽게 배포 및 설정할 수 있으며, 다양한 환경 변수를 통해 사용자 맞춤 설정이 가능함
• 브라우저 확장 프로그램과 iOS 단축키를 통해 편리하게 비디오를 다운로드할 수 있음
• yt-dlp의 최신 버전을 자동으로 업데이트하여 항상 최신 상태를 유지함
• 유사한 기능을 제공하는 프로젝트로는 JDownloader, Video DownloadHelper 등이 있음