유튜브 썸네일 추출·타임스탬프

어떤 주소를 써야 하나 — hqdefault가 안전한 이유

이 도구가 만드는 다섯 개 주소는 모두 실재하는 유튜브 규칙이지만, 모든 영상에 다섯 개가 다 있는 것은 아닙니다.

maxresdefault(1280×720)는 업로더가 고화질 썸네일을 직접 등록했을 때만 생깁니다. 등록하지 않고 유튜브가 영상 프레임에서 자동 추출한 경우에는 만들어지지 않습니다. 없는 주소를 부르면 404가 아니라 120×90짜리 회색 이미지가 돌아오기 때문에, 코드에서 처리할 때 특히 골치가 아픕니다.

maxres가 있는지 코드로 확인하기

웹사이트에 유튜브 썸네일을 걸어야 하는데 maxres 유무를 매번 손으로 확인할 수는 없습니다. 회색 대체 이미지의 크기가 항상 120×90이라는 점을 이용하면 자동으로 걸러 낼 수 있습니다.

// maxres 가 없으면 유튜브는 120x90 회색 이미지를 준다
function ytThumb(id) {
  return new Promise(function (resolve) {
    var base = "https://i.ytimg.com/vi/" + id + "/";
    var img = new Image();
    img.onload = function () {
      var ok = img.naturalWidth > 120;   // 회색 대체 이미지 걸러내기
      resolve(base + (ok ? "maxresdefault" : "hqdefault") + ".jpg");
    };
    img.onerror = function () {
      resolve(base + "hqdefault.jpg");
    };
    img.src = base + "maxresdefault.jpg";
  });
}

남의 썸네일을 가져다 쓰기 전에

주소를 얻는 것과 그 이미지를 써도 되는 것은 다른 문제입니다. 썸네일은 영상 제작자가 만든 저작물이고, 유튜브에 올렸다고 해서 누구나 가져다 쓸 수 있게 되지는 않습니다.

• 리뷰·소개 글에서 어떤 영상인지 밝히며 인용하는 것 — 출처와 링크를 함께 두면 정당한 인용으로 볼 여지가 큽니다.
• 내 사이트 배너나 광고 소재로 쓰는 것 — 문제가 됩니다. 제작자 허락이 필요합니다.
• 썸네일만 모아 놓은 페이지를 만들어 광고를 붙이는 것 — 저작권 문제에 더해 유튜브 약관에도 걸립니다.
• 내가 올린 내 영상의 썸네일을 가져오는 것 — 자유롭습니다. 원본 파일을 잃어버렸을 때 이 도구가 유용합니다.

타임스탬프로 챕터 만들기

아래쪽 타임스탬프 도구는 두 가지 용도가 있습니다. 하나는 "이 부분부터 보세요"라고 공유할 링크를 만드는 것이고, 다른 하나는 영상 설명란에 넣을 챕터 목록을 만드는 것입니다.

챕터는 유튜브가 조건을 모두 만족했을 때만 자동으로 생깁니다. 하나라도 어긋나면 그냥 텍스트로만 남고 재생바가 나뉘지 않습니다.

1. 유튜브 링크를 위에 붙여넣습니다.
2. 시·분·초를 넣거나 "3:20", "200s" 처럼 직접 입력합니다.
3. "현재 시각 추가"를 누르면 0:00 형식으로 목록에 쌓입니다.
4. 각 줄 뒤에 챕터 제목을 적습니다. 첫 줄은 0:00 으로 시작하도록 맞춥니다.
5. 완성된 목록을 복사해 영상 설명란에 붙여넣습니다.

• 첫 챕터는 반드시 0:00 이어야 합니다. 0:15부터 시작하면 챕터가 전혀 만들어지지 않습니다.
• 챕터는 최소 3개여야 합니다.
• 각 챕터의 길이는 10초 이상이어야 합니다.
• 시간순으로 오름차순 정렬돼야 합니다.
• 설명란에 넣어야 합니다. 댓글에 적은 시간은 링크로만 동작하고 재생바에는 반영되지 않습니다.

ID를 못 찾는다고 나올 때

유튜브 영상 ID는 정확히 11자입니다. 이 도구는 watch·youtu.be·shorts·embed·live 등 알려진 형식을 모두 훑고, 그래도 못 찾으면 마지막 경로 조각에서 11자를 한 번 더 찾아봅니다. 그럼에도 실패한다면 대개 아래 중 하나입니다.

• 채널 주소나 재생목록 주소를 넣은 경우 — 영상 ID가 없습니다. 재생목록에서 영상 하나를 연 뒤 그 주소를 넣으세요.
• 메신저에서 복사하다가 주소가 잘린 경우 — 링크 전체를 다시 복사하세요.
• 단축 URL 서비스를 거친 경우 — 브라우저에서 한 번 열어 최종 주소를 확인해야 합니다.
• 앞뒤에 한글이나 따옴표가 붙은 경우 — 대개는 걸러 내지만, 안 되면 주소만 남기고 지우세요.