[SJVA] 크롬 확장프로그램 이용해서 마우스 우클릭시 youtube_dl 연동 - 1

SJVA에는 youtube_dl 플러그인이 존재한다.
youtube_dl은  유튜브, 네이버TV 등 동영상 사이트 영상을 다운로드할 수 있는 플러그인 인데, 이를 SJVA에 플러그인 형태로 만든것.

플러그인 주소 : https://sjva.me/bbs/board.php?bo_table=sjva_plugin&wr_id=127

SJVA.ME

 

플러그인 개발자분 깃헙에 보면, 활용할 수 있는 API 명세가 적혀있다.
https://github.com/joyfuI/youtube-dl#api

joyfuI/youtube-dl

이 API를 이용해서, youtube 페이지에서 마우스 우클릭으로 간편하게 영상을 다운로드 시켜볼 것이다.

(오늘은 1편. 플러그인 활용법)

명세를 보면, 다양한 API 종류가 있는데, 
사용할 핵심 API는 다음과 같다.

- /youtube-dl/api/download 
(다운로드 준비를 요청하는 API)

Request

키	설명	필수여부	타입
plugin	플러그인 이름	O	String
key	임의의 키. 이후 다운로드를 제어할 때 이 키가 필요함	O	String
url	동영상 주소	O	String
filename	파일명. 템플릿 규칙은 https://github.com/ytdl-org/youtube-dl/blob/master/README.md#output-template 참고. 미지정 시 사용자 설정	X	String
temp_path	임시 폴더 경로. 미지정 시 사용자 설정	X	String
save_path	저장 폴더 경로. 미지정 시 사용자 설정	X	String
format_code	동영상 포맷. 포맷 지정은 https://github.com/ytdl-org/youtube-dl/blob/master/README.md#format-selection 참고. 미지정 시 최고 화질	X	String
preferedformat	변환할 비디오 포맷. 가능한 포맷은 https://ffmpeg.org/general.html#File-Formats 참고. 미지정 시 변환하지 않음	X	String
preferredcodec	추출할 오디오 코덱. 가능한 값은 "best", "mp3", "aac", "flac", "m4a", "opus", "vorbis", "wav". 미지정 시 추출하지 않음	X	String
preferredquality	추출한 오디오의 비트레이트. 0 ~ 9 사이의 VBR 퀄리티 값(0에 가까울수록 좋음) 혹은 특정 비트레이트 값. preferredcodec 키가 있을 때만 유효. 기본값: 192	X	Integer
start	다운로드 준비 후 바로 다운로드를 시작할지 여부. 기본값: false	X	Boolean

 

파라미터가 뭔가 많아 보이는데, 필수적인 파라미터만 확인해보자.
- plugin : 플러그인 이름
- key : 임의의 키 (이후 다운로드 제어시 필요)
- url : 동영상 주소
이렇게 3가지 필수 파라미터중에 plugin은 고정값으로 채워주고 (ex: sjva_youtube_dl_extension),
key는 동영상마다 고유해야하니, url과 동일하게 채워주고, 
url은 동영상이 뜬 페이지의 url을 넣어주면 될것이다.

먼저, API가 정상적으로 작동하는지 테스트를 해본다. (API 테스트는 POSTMAN 프로그램을 사용하였음)

이렇게, errorCode와 index 번호가 반환되었다. (명세를 보니 errorCode 0은 성공, 문제없음 이라는 뜻이라고 한다.)
그리고나서, SJVA의 youtube-dl 플러그인 > 목록에 가보면, 다음과 같이 대기열에 올라가있음을 확인할 수 있다.

그런데 상태값이 '준비' 라고 적혀있다. 
다시 API 명세를 보면, 필수가 아닌 값 중에 다음과 같이 적혀있다.

- start : 다운로드 준비 후 바로 다운로드를 시작할지 여부. 기본값: false

start에 true를 넣어주지 않아서 자동 다운로드가 false로 설정되었나보다.

 이번에는 start 값을 true로 설정해 요청 보내보았다.

2번째 대기열을 보면 자동으로 다운로드가 시작되었음을 알 수 있다.

참고로 위 대기열에서 IDX값은 반환받은 index번호+1 이다.

다운로드가 완료되었으면, 파일을 확인해본다. (저장 경로는 따로 요청하지 않았기 때문에 플러그인에 설정되어있는 기본 경로)

 

지금까지 SJVA의 youtube-dl 플러그인의 활용법에 대하여 알아보았다.
다음 포스팅에서는, 크롬 확장프로그램을 추가하여, 다음과 같이 작동하도록 만들어 보자. 
(맛보기)

동영상열고, 아무대나 마우스 우클릭 클릭하고 확장프로그램 앱을 클릭하면,

다운로드 완료

자주 써보고 있는데, 확실히 매우 편하다.