yt-dlp nsig 에러 해결 방법 (버전 문제)

최근에 유튜브 영상 하나 다운받고 싶은게 있어서 오랜만에 yt-dlp를 이용해서 영상 다운로드를 실행해보았다.

근데 평상시처럼 다운로드가 되지않고 경고와 에러코드가 주르륵 뜨면서 다운이 안되는것이 아닌가...

그래서 에러 코드를 잘 읽어보고 문제를 파악해보았더니, 유튜브 측에서 URL에 담겨있는 n 파라미터 암호화 기술이 달라졌다고 한다.

이 문제는 갑자기 생긴것은 아니고 유튜브 측에서 가끔가다가 보안적 목적으로 암호화 코드(base.js)를 바꿔주는 일이 발생하는데, 그에 맞춰서 yt-dlp의 복호화 기능도 업데이트 해줘야 하는 경우라고 한다.

업데이트라고 뭐 복잡하게 복호화 파일을 다운받아서 넣는 그런게아니라 yt-dlp측에서 주기적으로 프로그램 업그레이드 방식을 통해 배포한다는걸 알게되었다.

현재 내가 사용하는 버전은 stable@2025.03.31 버전이고 현재 이 글을 쓰는 최신 버전은 stable@2025.05.22 버전이다.

즉 5월 22일 버전으로 업그레이드를 해줘야 영상 다운로드시 문제가 발생하지 않는 것이다.

나는 이전에 맥에서 사용할 수 있는 brew 패키지를 통해 yt-dlp를 설치했으니 아래와 같은 명령어 한줄로 쉽게 yt-dlp를 업데이트 할 수 있다.

brew upgrade yt-dlpCopy

설치가 완료된 이후에 아래 명령어로 yt-dlp가 제대로 버전업 되어있는지 확인하면 버전 업그레이드가 완료된다.

~ yt-dlp --version
2025.05.22Copy

이후 다시 행복 유튜브 다운로드 생활을 즐기면 되는것이다!