좋아하는 TV 프로그램이나 최신 영화를 버퍼링 없이 시청할 수 있다면 얼마나 좋을까요? 이것을 가능하게 해주는 도구가 바로 Streamlink입니다. 여러 온라인 스트리밍 사이트를 일일이 방문하는 대신, Mac 사용자는 Streamlink 하나만으로 원하는 영상 콘텐츠를 편하게 감상할 수 있습니다.
Streamlink는 다양한 스트리밍 웹사이트에서 영상 콘텐츠를 가져오는 스크래퍼처럼 작동합니다. 수집된 영상은 사용자에게 전달되어 바로 재생할 수 있죠. 가장 큰 장점은 무엇일까요? 바로 광고가 없다는 점입니다. YouTube나 Dailymotion의 성가신 광고, 특히 영상 중간에 삽입되는 인비디오 광고를 건너뛰는 데 지치셨다면 이 도구가 딱입니다.
Streamlink 사용법도 간단합니다. 터미널에 명령어를 입력해 어디서 영상을 가져올지, 어떤 플레이어로 재생할지만 지시하면 됩니다. 그러면 선택한 스트림이 기본 미디어 플레이어로 자동 실행됩니다. 정말 쉬워 보이죠?
하지안 일부 Mac 사용자들은 생각보다 과정이 복잡하다고 느낍니다. 실제로 Mac에 Streamlink를 설치하는 데 어려움을 겪었다는 보고가 많습니다. 프로그래밍이나 코딩 경험이 없는 사용자에게는 특히 골칫거리일 수 있습니다. 설치 방법을 여러 가지 시도했는데도 실패하는 경우가 많고, 오류 원인이 저마다 달라 문제를 진단하기도 쉽지 않습니다. 각종 패키지를 다운로드하고 필요한 소프트웨어를 설치해 봤지만 소용이 없었던 사용자들도 있습니다.
Streamlink란 무엇인가?
Streamlink는 온라인 스트리밍 사이트의 플래시 기반 영상을 VLC 같은 컴퓨터의 비디오 플레이어로 전송(파이핑)하는 오픈소스 명령줄 유틸리티입니다. 핵심 목표는 CPU 부하가 큰 플래시 플러그인을 더 가벼운 형식으로 변환하는 것으로, Mac 사용자가 버그 많은 플러그인 없이도 다양한 스트리밍 콘텐츠를 즐길 수 있게 해줍니다.
Streamlink는 한동안 개발이 중단된 Livestreamer 프로젝트에서 포크되어 탄생했습니다. 플러그인 시스템 기반으로 설계되어 새로운 서비스를 손쉽게 추가할 수 있는 것이 특징입니다. Streamlink가 지원하는 주요 스트리밍 서비스는 다음과 같습니다:
- Dailymotion
- Livestream
- Twitch
- UStream
- YouTube
- Bloomberg
- Crunchyroll
- Reuters
- Vimeo
Streamlink는 Windows, macOS, Linux에서 모두 사용할 수 있습니다. VLC 미디어 플레이어와 가장 잘 호환되지만, Daum PotPlayer, MPC-HC, MPlayer, mpv, OMXPlayer 같은 다른 재생 앱에서도 활용할 수 있습니다.
Mac에 Streamlink 설치하는 방법
Mac에 Streamlink를 설치하려면 명령어 입력이 필요하므로 터미널(Terminal) 앱을 사용해야 합니다. Finder > 이동 > 응용 프로그램 > 유틸리티로 이동한 후 터미널을 클릭해 실행하세요.
Streamlink를 설치하려면 다음과 같은 의존성 패키지들이 필요합니다:
- Python – 최소 2.7 또는 3.4 버전 이상
- python-setuptools
- python-argparse – Python 2.7 미만 버전에서만 필요
- python-futures – Python 2.x에서만 필요
- python-requests – 최소 1.0 버전 이상
- python-singledispatch – Python 3.4 미만 버전에서만 필요
- pycryptodome – 일부 암호화된 스트림 재생에 필요
- iso-639 – 현지화 설정용 언어 정보 제공
- iso3166 – 현지화 설정용 국가 정보 제공
- RTMPDump – RTMP 스트림 재생에 필요
- ffmpeg – 오디오와 비디오가 분리된 스트림(예: YouTube 1080p 이상) 재생에 필요
대부분의 의존성 패키지는 설정 스크립트가 자동으로 다운로드하지만, Python과 python-setuptools는 예외입니다. 설치 오류를 방지하려면 최신 버전의 Python이 설치되어 있는지 반드시 확인하세요.
방법 1: Easy Install
위의 안내에 따라 터미널을 실행한 후 다음 명령어를 입력합니다:
sudo easy_install -U streamlink
방법 2: Homebrew 설치
Homebrew는 macOS와 Linux를 위한 필수 패키지 관리자입니다. 터미널에 다음 명령어를 입력하세요:
brew install streamlink
이 명령어들은 Streamlink 설치에 필요한 패키지들을 자동으로 다운로드하고 설치합니다. 만약 설치에 실패하거나 과정에서 문제가 발생한다면, 조금 더 복잡한 세 번째 방법을 시도해 볼 수 있습니다.
방법 3: PIP 설치
PIP 설치는 Python 패키지 설치 도구를 이용하는 방법으로, 더 많은 기술적 절차가 필요합니다. 이 방법은 Streamlink가 작동하기 위한 Python 헤더 패키지를 설치합니다. PIP 설치를 하려면 터미널 창에 다음 명령어를 입력하세요:
# pip install streamlink
Streamlink로 콘텐츠 스트리밍하는 방법
설치가 완료되면 실제로 스트림을 재생해 정상 작동하는지 확인해야 합니다. 예를 들어 다음 URL의 YouTube 영상을 시청하고 싶다고 가정해 보겠습니다:
https://www.youtube.com/watch?v=7wQkTV01hGU
Streamlink를 사용하려면 다시 터미널에서 명령어를 입력해야 합니다. Finder > 응용 프로그램 > 유틸리티로 이동해 터미널 창을 열고 다음 명령어를 입력하세요:
$ streamlink youtube.com/watch?v=7wQkTV01hGU
이 명령어는 유틸리티에게 스트리밍할 콘텐츠의 위치를 알려줍니다. URL에서 https 프로토콜 부분은 입력하지 않아도 되는데, 이 형식이 타이핑하기 더 간편하기 때문입니다.
명령어를 입력하면 선택 가능한 스트림 목록이 표시됩니다:
[cli][info] Found matching plugin twitch for URL youtube.com/watch?v=7wQkTV01hGU
Available streams: audio, high, low, medium, mobile (worst), source (best)
스트림을 선택해 재생하려면 명령어 두 번째 인수로 스트림 이름을 추가하면 됩니다:
$ streamlink youtube.com/watch?v=7wQkTV01hGU 1080p60
[cli][info] Opening stream: 1080p60 (hls)
[cli][info] Starting player: vlc
선택한 스트림은 Streamlink와 호환되는 기본 미디어 플레이어로 재생됩니다. 따라서 해당 미디어 플레이어가 Mac에 설치되어 있어야 합니다. 최고 화질로 시청하려면 'best', 대역폭을 아끼려면 'worst'를 선택할 수도 있습니다.
Streamlink 설치 오류 해결 방법
Streamlink가 설치되지 않는다면 필요한 소프트웨어가 없거나, Mac에 설치된 버전이 너무 오래되었을 가능성이 높습니다. 최신 패키지를 올바르게 갖추면 대부분의 문제가 해결됩니다.
그 전에 먼저 Mac 클리너 앱을 사용해 시스템을 청소하여 문제를 일으킬 수 있는 파일들을 제거하는 것이 좋습니다. 또한 소프트웨어 업데이트에서 대기 중인 업데이트를 모두 설치해 최신 macOS 버전을 유지하는 것도 권장합니다.
기본 준비가 끝났다면, 이제 Mac 사용자들이 Streamlink 설치 시 겪는 대표적인 오류들을 살펴보겠습니다.
오류 1: 오래된 Python 패키지
한 사용자는 다음과 같은 설치 오류를 겪었습니다:
pkg_resources.UnknownExtra: requests 2.9.1 has no such extra feature 'socks'
이 오류는 기기에 설치된 Python 패키지가 오래되었음을 의미합니다. 기존 Python 패키지를 제거한 후 최신 버전을 설치해야 합니다. 이 경우 다음 명령어를 사용할 수 있습니다:
$ sudo pip install -U PySocks
Successfully installed PySocks-1.6.7
오류 2: pyOpenSSL 제거 실패
또 다른 사용자는 오래된 pyOpenSSL 때문에 다음 오류 메시지를 마주했습니다:
ERROR: Cannot uninstall 'pyOpenSSL'. It is a distutils installed project and thus we cannot accurately determine which files belong to it which would lead to only a partial uninstall.
동일한 오류가 발생하면 다음 명령어로 해결할 수 있습니다:
pip install pyOpenSSL --upgrade --user
완료 후 Streamlink를 다시 설치해 보세요.
오류 3: 패키지 충돌 — 가상 환경 활용
시스템 전역 패키지가 시스템의 일반 패키지 관리자와 충돌해서 설치가 어렵다면, 가상 환경(virtualenv)을 이용한 설치를 시도해 보세요. 가상 환경은 Streamlink 전용으로 사용되는 사용자 소유의 Python 환경을 만들어 줍니다.
- 새 환경 생성:
virtualenv ~/myenv - 환경 활성화:
source ~/myenv/bin/activate - 환경 내에 Streamlink 설치:
pip install --upgrade streamlink - 환경 내에서 Streamlink 사용:
streamlink [원본 URL] - 환경 비활성화:
deactivate
마무리
Streamlink는 버퍼링과 성가신 광고 없이 온라인 영상을 스트리밍할 수 있는 매우 유용한 도구입니다. 위에서 소개한 명령어만으로도 비교적 쉽게 설치할 수 있습니다. 만약 오류가 발생한다면 어떤 의존성 패키지가 문제를 일으키는지 파악하고 해당 패키지를 업데이트하면 됩니다. 아니면 위의 안내에 따라 가상 환경을 만들어 설치하는 방법도 좋은 대안입니다.