pablostanley/yoinks
TypeScript0 / 0
터미널에서 yt-dlp와 ffmpeg를 자동 관리하여 YouTube·Instagram·TikTok 등 1,800+ 사이트의 동영상을 인터랙티브 또는 인수 모드로 내려받는 Node 18 기반 CLI 도구이다.
TL;DR
yoinks는 Node 18 환경에서 실행되는 터미널용 동영상 다운로드 CLI로서 yt-dlp를 내부적으로 사용하고 첫 실행에 독립형 yt-dlp 바이너리를 ~/.yoinks/bin에 내려받아 Python 의존성을 제거한다. ffmpeg가 PATH에 있으면 이를 사용하고 없을 경우 ffmpeg-static 번들을 대체제로 활용하여 스트림 병합과 mp3 추출을 처리하며 Ink 기반의 풀스크린 UI로 링크 붙여넣기 후 해상도나 오디오 전용 선택만으로 파일을 ~/Downloads에 저장한다. 1,800개 이상의 사이트를 지원한다는 점과 설치 없이 npx로 즉시 실행 가능한 옵션이 제공되며 일부 자동화 플래그와 출력 디렉터리 지정 등은 로드맵에 남아 있어 스크립트화 기능은 향후 확장이 필요하다.
핵심 포인트
- 종속 바이너리를 자동으로 내려받아 Python 설치 없이 yt-dlp를 사용할 수 있게 한다. README는 첫 실행 시 ~/.yoinks/bin에 standalone yt-dlp를 저장한다고 명시되어 있어 환경 의존성을 낮춘다고 적시되어 있다. 이 점은 Python 환경을 요구하는 기존 yt-dlp 사용 흐름과 차별화된다.
- 풀스크린 Ink 기반 UI를 제공하여 터미널에서 포맷 선택과 마우스 클릭이 모두 가능하도록 설계되었다. 키보드 단축키와 마우스 상호작용을 병행하여 인터랙티브한 사용성과 스크립트화된 실행을 동시에 지원한다. GUI를 띄우지 않고도 시각적 선택 경험을 제공하는 점이 특징이다.
- ffmpeg를 시스템 PATH에서 우선적으로 사용하고 ffmpeg-static을 번들로 제공하여 병합 및 오디오 추출 실패를 줄인다. 이로 인해 사용자는 로컬 ffmpeg 설치 유무에 관계없이 일관된 출력 포맷을 얻을 수 있다. 번들 대체제는 설치 장애 환경에서의 가용성을 높인다.
- 동영상을 바로 내려받는다. 링크를 붙여넣으면 포맷 선택 화면이 표시되고 키보드·마우스로 해상도나 오디오 전용 추출을 선택할 수 있다. 완료 시 파일이 ~/Downloads에 저장되며 저장 경로가 터미널에 출력된다.
이미지 분석


1.3k
Stars
120
Forks
+204
Trending
0
조회수
1.3k watchers12 open issues
관련 토론
아직 관련 토론이 없습니다.
댓글
댓글을 작성하려면 로그인이 필요합니다.