유튜브 썸네일 고화질 추출 & 레터박스 수정 가이드
그누보드나 아미나/나리야 빌더에서 유튜브 동영상 링크를 게시글에 첨부하면 게시판 목록에서 썸네일 상하단에 검은색 바(레터박스)가 생기거나 저해상도로 흐릿하게 출력되는 문제가 자주 발생합니다. 유튜브의 해상도별 공식 썸네일 이미지 주소 규칙과 그누보드 라이브러리(apms.lib.php) 소스를 수정하여 1080p 고화질 16:9 와이드 썸네일로 깔끔하게 추출하는 법을 정리했습니다.
1280x720 원본 해상도 추출 | 상하 검은 레터박스 완벽 제거 | 그누보드·아미나 완벽 적용
▲ hqdefault(검은 레터박스 발생) vs maxresdefault(정상 16:9 와이드) 비교
유튜브 공식 썸네일 URL 주소 체계
| 품질 등급 | 해상도 / 비율 | 이미지 파일명 | 특징 및 검은 바 여부 |
|---|---|---|---|
| 최대 고화질 (권장) | 1280 x 720 (16:9) | maxresdefault.jpg |
검은 바 없음 가장 선명한 원본 |
| 고화질 (HQ) | 480 x 360 (4:3) | hqdefault.jpg |
상하 검은 바 발생 주의 필요 |
| 중간 화질 (MQ) | 320 x 180 (16:9) | mqdefault.jpg |
검은 바 없으나 모바일용 저해상도 |
| 표준 화질 (SD) | 640 x 480 (4:3) | sddefault.jpg |
4:3 비율 영상용 썸네일 |
그누보드 라이브러리(apms.lib.php) 1줄 수정법
서버의 /lib/apms.lib.php 파일 약 969번째 줄의 썸네일 추출 코드를 찾아 아래와 같이 수정합니다:
$imgurl = 'https://img.youtube.com/vi/' . $vid . '/hqdefault.jpg';
// 수정 코드 (선명한 16:9 와이드 고화질):
$imgurl = 'https://img.youtube.com/vi/' . $vid . '/maxresdefault.jpg';
자주 묻는 질문 (FAQ)
Q. 유튜브 영상 URL에서 고유 비디오 ID(vid)는 어떻게 확인하나요?
유튜브 주소창의 https://www.youtube.com/watch?v=7ZlLTb0tars에서 v= 뒤에 오는 11자리 영문/숫자 조합이 고유 영상 ID입니다. 이를 https://img.youtube.com/vi/7ZlLTb0tars/maxresdefault.jpg 형태로 대입하면 브라우저에서 바로 고화질 이미지를 열 수 있습니다.
Q. maxresdefault.jpg 이미지가 없는 영상도 있나요?
업로더가 720p 미만의 저해상도로 영상을 올렸거나 별도 맞춤 썸네일을 등록하지 않은 아주 오래된 영상의 경우 maxresdefault가 존재하지 않을 수 있습니다. 이 경우 차선책으로 mqdefault.jpg를 폴백(Fallback)하도록 스크립트를 구성하면 안전합니다.
Q. 추출한 썸네일을 블로그 대표 이미지로 사용해도 되나요?
영상 리뷰나 소개 목적의 공정이용(Fair use) 범위 내에서는 출처와 원본 영상 링크를 명시하여 썸네일을 인용하는 것이 관례적으로 널리 허용됩니다.