소개
Lux는 Go로 작성된 빠르고 간단한 비디오 다운로더 CLI 도구입니다. YouTube, Bilibili 등 다양한 사이트에서 비디오, 이미지, 오디오 콘텐츠를 다운로드할 수 있으며, 재생목록 다운로드, 멀티스레드 지원, 프록시 및 쿠키 사용 등 고급 기능을 제공합니다. 개인 사용자부터 개발자까지 다양한 사용자가 콘텐츠 수집 및 오프라인 시청을 위해 활용할 수 있습니다.
상세정보
다양한 사이트 지원
YouTube, Bilibili, Facebook, Instagram, Twitter, Vimeo 등 주요 플랫폼에서 비디오 다운로드를 지원하며, 이미지와 오디오도 일부 사이트에서 다운로드 가능합니다.
재생목록 및 다중 입력 지원
-p 옵션으로 전체 재생목록 다운로드가 가능하며, 여러 URL을 한 번에 입력하여 순차적으로 다운로드할 수 있습니다. -F 옵션으로 파일에 저장된 URL 목록을 읽어 자동 다운로드도 지원합니다.
고급 다운로드 옵션
-f로 특정 스트림 선택, -n/-m으로 멀티스레드 수 조절, -c로 쿠키 제공, -r로 Referrer 지정, –proxy 또는 환경 변수로 프록시 설정, -d로 디버그 모드 활성화, -j로 추출된 데이터를 JSON 형식으로 출력할 수 있습니다.
재시도 및 이어받기 기능
다운로드 실패 시 자동 재시도(기본 100회)를 수행하며, Ctrl+C로 중단된 다운로드는 동일한 인수로 재실행 시 이어받기가 가능합니다.
다운로드·설치 방법
Windows 사용자는 Chocolatey 또는 Scoop을 통해 간단히 설치할 수 있습니다. Chocolatey의 경우 관리자 권한으로 PowerShell 또는 CMD를 열고 다음 명령을 실행합니다:
choco install lux
Scoop을 사용하는 경우:
scoop install lux
또한 Go가 설치된 환경에서는 go install 명령으로 직접 빌드할 수 있습니다:
go install github.com/iawia002/lux@latest
설치 후 lux 명령이 PATH에 등록되어 터미널에서 바로 사용 가능합니다.
기본 사용법/명령어
기본 형식은 다음과 같습니다:
lux [OPTIONS] URL [URL...]
예를 들어 YouTube 영상을 다운로드하려면:
lux "https://www.youtube.com/watch?v=dQw4w9WgXcQ"
다운로드 전에 이용 가능한 화질 목록을 보려면 -i 옵션을 사용합니다:
lux -i "https://www.youtube.com/watch?v=dQw4w9WgXcQ"
특정 스트림으로 다운로드하려면 -f 옵션에 스트림 ID를 지정합니다(예: -f 248).
이런 경우에 유용합니다
오프라인 시청을 위해 강의 영상이나 튜토리얼을 미리 저장하고 싶은 사용자에게 유용합니다. 재생목록 기능을 통해 시리즈물이나 강의 전체를 한 번에 다운로드할 수 있어 시간 절약에 도움이 됩니다. 또한 개발자는 -j 옵션으로 추출된 메타데이터를 JSON 형태로 얻어 스크립트 자동화에 활용할 수 있습니다.
지원 환경·시스템 요구사항
Windows, macOS, Linux에서 실행 가능하며, 비디오 병합을 위해 FFmpeg가 별도로 설치되어야 합니다. FFmpeg는 다운로드 과정에 영향을 주지 않으며,仅最終 파일 결합 단계에서만 사용됩니다.
최신 버전·업데이트
현재 버전은 0.11.0이며, 최신 업데이트 정보는 GitHub 저장소의リリース 페이지에서 확인할 수 있습니다.
시스템 요구사항
별도의 시스템 요구사항이 등록되지 않았습니다.


