블로그
Tips & Tricks

유튜브 링크·MP4만 넣으면 아스키(ASCII) 영상 애니메이션으로 자동 변환하기: 웹 히어로 적용과 사운드 동기화 팁

정훈 김2026.11.19읽는 시간 9분

픽셀디자인 메인 히어로 섹션에 유튜브 영상이나 MP4 파일을 컬러 아스키(ASCII) 애니메이션으로 변환해 사운드와 함께 재생하는 파이프라인을 적용했습니다. 이번 글에서는 단발성 작업으로 끝내지 않고, 앞으로 유튜브 링크나 MP4 파일만 넣으면 동일한 품질의 웹용 아스키 애니메이션과 사운드 파일을 자동으로 뽑아낼 수 있는 전체 작업 방법과 실무 팁을 정리합니다.

전체 자동화 파이프라인 한눈에 보기

유튜브 URL 또는 로컬 MP4 파일을 입력받아 웹 히어로에 바로 붙일 수 있는 에셋(frames.js + audio.mp3)으로 만드는 과정은 크게 3단계로 나뉩니다.

  1. 소스 수집 및 오디오 분리: yt-dlp로 영상을 받고 ffmpeg로 배경음악(MP3)과 raw RGB 프레임 스트림을 추출합니다.
  2. 아스키 프레임 인코딩 (Python): 3×3 서브픽셀 윤곽선 보존, 입체 음영(Puff Shading), RGB444 델타 인코딩을 거쳐 경량 JS 데이터로 변환합니다.
  3. 웹 캔버스 렌더링 & 사운드 동기화: 4096색 룩업 테이블로 GC 부담 없이 캔버스에 그리고, 오디오 재생 위치(bgm.currentTime)에 프레임을 맞춥니다.

1. 유튜브 링크·MP4 입력 자동 처리 팁 (yt-dlp + ffmpeg)

매번 수동으로 영상을 자르고 변환하지 않으려면 입력값이 URL인지 로컬 파일인지 판별하는 래퍼(Wrapper)를 앞단에 두면 편리합니다. 특히 영상을 이미지 파일(PNG 수천 장)로 디스크에 풀지 않고 ffmpeg의 pipe:1로 바로 파이썬 numpy 배열에 흘려보내면 변환 속도가 압도적으로 빨라집니다.

# 1) 유튜브 링크인 경우 MP4 다운로드
yt-dlp -f "bv*[ext=mp4]+ba[ext=m4a]/b[ext=mp4]" -o "_source.mp4" "<YOUTUBE_URL>"

# 2) 오디오 트랙만 MP3로 분리
ffmpeg -y -i _source.mp4 -vn -q:a 2 output-audio.mp3

# 3) Python subprocess에서 3배 해상도(COLS*3 x ROWS*3) RGB 스트림 직접 수신
ffmpeg -v error -i _source.mp4 -vf "fps=24,scale=504:174:flags=area" -f rawvideo -pix_fmt rgb24 pipe:1
  • 팁 — flags=area 리사이징: 아스키 그리드처럼 픽셀을 크게 축소할 때는 bilinear보다 area 필터를 쓰는 편이 색 번짐이 적고 선이 또렷합니다.
  • 팁 — 3×3 서브픽셀 해상도: 목표 그리드가 168×58이라면 ffmpeg에서는 가로·세로 3배인 504×174로 추출한 뒤 파이썬에서 셀 단위로 분석합니다.

2. 선명한 컬러 아스키를 만드는 파이썬 변환 팁

일반적인 밝기 기반 아스키 변환은 캐릭터의 검은 외곽선과 흰 털/배경이 평균값으로 섞여 흐릿해지는 단점이 있습니다. 실제 build_ascii.py에서는 아래 4가지 기법으로 원작 느낌을 살렸습니다.

① 외곽선(Ink)과 배경 색상의 분리

3×3(9개) 서브픽셀 중 어두운 픽셀(lum < 96)이 3개 이상이면 해당 셀을 외곽선(is_ink)으로 판정해 0 문자로 고정합니다. 반대로 외곽선이 아닌 셀의 색상을 구할 때는 어두운 서브픽셀을 제외하고 평균 RGB를 계산해 흰색 캐릭터가 칙칙해지는 것을 막았습니다.

② 역할이 구분된 문자 램프(Ramp)와 Puff Shading

RAMP = " .:-=+*ZLCQ0000$$$$"

외곽선과 눈에는 밀도가 높은 0을, 밝은 하이라이트에는 $를 배치하고 숲·하늘 배경에는 .:-=+*ZLCQ 같은 중간 톤 문자를 배정했습니다. 또한 캐릭터 영역에 5단계 침식(erosion) 기반의 depth_puff()와 가상의 광원 벡터를 적용해 2D 애니메이션에 은은한 입체감을 더했습니다.

③ 패닝 장면의 문자 깜빡임(Jitter) 억제

카메라가 천천히 이동할 때 경계선 문자가 매 프레임 바르르 떨리는 현상을 막기 위해, 이전 프레임과 목표 밝기 차이가 0.045 이하이면 이전 문자를 그대로 유지하는 히스테리시스(Hysteresis)를 적용했습니다.

④ RGB444 패킹 + 델타 인코딩으로 파일 경량화

모든 프레임의 전체 그리드를 JSON으로 저장하면 수십 MB를 훌쩍 넘습니다. 이를 해결하기 위해 각 셀의 문자 인덱스(6bit) + R4(4bit) + G4(4bit) + B4(4bit)를 하나의 uint32 정수로 묶고, 직전 프레임과 값이 달라진 셀의 [인덱스, 값]만 기록했습니다. 덕분에 24fps 56.75초(1,362프레임) 분량을 별도 압축 없이도 웹에서 바로 로드할 수 있는 JS 파일 하나로 만들 수 있었습니다.

3. 유튜브/MP4 원클릭 변환 스크립트 구조

앞으로 새로운 영상을 아스키 애니메이션으로 바꾸고 싶을 때는 아래처럼 입력 경로(URL 또는 MP4)만 넘기는 엔트리포인트를 만들어 두면 재사용이 매우 쉽습니다.

import os, sys, subprocess

def prepare_source(input_src: str, work_dir: str) -> str:
    if input_src.startswith(("http://", "https://")):
        mp4_path = os.path.join(work_dir, "_yt_source.mp4")
        subprocess.run([
            "yt-dlp", "-f", "bv*[ext=mp4]+ba[ext=m4a]/b[ext=mp4]",
            "-o", mp4_path, input_src
        ], check=True)
        return mp4_path
    return input_src # 로컬 MP4 파일 그대로 사용

# 이후 output-audio.mp3 추출 + convert_frames() 호출

4. 웹 히어로 적용 및 사운드 재생/끄기 구현 팁

① 제로 GC(Garbage Collection) 캔버스 렌더링

프레임마다 rgb(r,g,b) 문자열을 새로 만들면 가비지 컬렉션으로 프레임 드랍이 생길 수 있습니다. 초기화 시점에 4096가지 RGB444 색상 문자열 배열(COLOR_LUT)을 미리 생성해 두면 24fps/60fps에서도 CPU 점유율이 매우 낮게 유지됩니다.

② 오디오 타임라인과 프레임 동기화

브라우저 탭 전환이나 스크롤로 애니메이션 루프가 잠시 멈추더라도 소리와 화면이 어긋나지 않도록, 사운드가 켜져 있을 때는 dt 누적 대신 오디오의 현재 재생 위치를 그대로 시간축으로 사용합니다.

if (audioOn && bgm && !bgm.paused) {
  currentTime = bgm.currentTime % DURATION;
} else {
  currentTime = (currentTime + dt) % DURATION;
}

③ 자동재생 차단 대응과 접근성 토글 버튼

  • 최신 브라우저는 사용자 제스처 없이 소리가 포함된 audio.play()를 차단할 수 있습니다. 페이지 로드 시 우선 재생을 시도하되, 차단되면 버튼 상태를 사운드 켜기(OFF)로 유지하고 스테이지 클릭 또는 토글 버튼 클릭 시 즉시 현재 프레임 시간에 맞춰 사운드를 켭니다.
  • 버튼에는 aria-pressed와 aria-label을 동적으로 갱신해 스크린 리더 사용자도 현재 음소거 여부를 정확히 알 수 있게 구성했습니다.

④ 풀블리드(여백 없는 꽉 찬 화면) 히어로 레이아웃

아스키 캔버스가 모바일/PC 컬럼 좌우 폭에 여백 없이 꽉 차도록 히어로 래퍼의 좌우 패딩과 둥근 모서리를 제거하고, 캔버스에 object-fit: cover; object-position: center;를 적용해 세로 높이를 넉넉하게 확보했습니다.

마무리: 시즌별 히어로 교체를 위한 아카이빙

이전에 사용하던 시즌용 아스키 애니메이션(예: 수능 응원 히어로)도 테마 내 assets/archive/ 폴더에 보관해 두면, 필요할 때 functions.php의 enqueue 분기만 교체해 언제든 다시 꺼내 쓸 수 있습니다. 영상 변환부터 웹 적용까지 한 번 파이프라인을 갖춰 두면, 앞으로 어떤 유튜브 영상이나 MP4든 몇 분 안에 브랜드 히어로용 아스키 애니메이션으로 탈바꿈시킬 수 있습니다.

이 글이 도움이 되었나요?

새 글을 메일로 받아보세요

한 달에 두세 번, 업데이트 소식과 팁만 보냅니다.

이어서 읽기

2026.11.18 · 읽는 시간 16분컬러 아스키 애니메이션 만들기: 기타 치는 하치와레 영상으로 배우는 파이썬 변환 팁 2026.11.09 · 읽는 시간 8분컨벤션 행사에 WorldVerse 부스를 연다면: 출석, 부스 소개, 방명록, 그리고 오프라인 전광판 연동 2026.11.09 · 읽는 시간 11분PHP2Shell 취재 노트: 패치하지 않으면 벌어지는 일, 그리고 공유 호스팅 사이트가 더 위험한 이유
프로젝트를 이야기해 주세요

어떤 사이트인지, 언제까지 필요한지만 적어 주셔도 됩니다.

프로젝트 문의

댓글 0