Communitygithub.com

christian-byrne/comfy-skills

ASCII 아트 비디오 제작 파이프라인입니다. 비디오를 ASCII로 변환, 오디오 반응형 비주얼, 생성형 장면, TTS 내레이션을 지원합니다. ASCII 비디오 생성, 비디오를 ASCII로 변환, 또는 터미널 기반 비디오 아트 제작 요청 시 사용하세요.

comfy-skills란 무엇인가요?

이 스킬은 기존 영상이나 오디오 파일을 ASCII 아트 비디오로 변환하거나, 완전히 생성적인 ASCII 애니메이션을 제작할 수 있는 포괄적인 파이프라인입니다. Video-to-ASCII, 오디오 반응형, 생성형, 하이브리드, 가사/텍스트, TTS 내레이션 등 6가지 모드를 지원하여 다양한 창작 요구를 충족합니다. Python과 ffmpeg를 기반으로 하며, 입력된 비디오/오디오를 분석하고 프레임별로 ASCII 문자로 매핑한 후 최종 비디오로 렌더링하는 일련의 단계(INPUT → ANALYZE → SCENE_FN → TONEMAP → SHADE → ENCODE)를 따릅니다. 사용자는 밝기 기반 ASCII 문자 램프(기본, 확장, 블록 문자)를 선택하고, 해상도(80-120열 권장)와 프레임 레이트(15-60fps)를 조정하여 원하는 스타일을 구현할 수 있습니다. 각 프레임의 독립적 완성도, 구간별 캐릭터 세트 변화, 일관된 미적 스타일 유지 등 창의적 기준을 강조하여 터미널 기반 비디오 아트를 전문적으로 제작할 수 있습니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/christian-byrne/comfy-skills/tree/HEAD/skills/ascii-video

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

ASCII 비디오 제작 파이프라인

기존 영상 또는 오디오 파일로부터 ASCII 아트 비디오를 생성하거나, 완전히 새로운 ASCII 애니메이션을 제작합니다.

사전 요구사항

pip install numpy scipy pillow
# 또한 필요: ffmpeg
# macOS: brew install ffmpeg
# Linux: apt install ffmpeg

모드

모드설명
Video-to-ASCII기존 비디오를 ASCII 표현으로 변환
오디오 반응형오디오 입력에 따라 시각적 요소가 반응
생성형절차적 ASCII 장면 및 패턴 생성
하이브리드비디오 변환과 생성형 오버레이 혼합
가사/텍스트오디오와 동기화된 애니메이션 텍스트
TTS 내레이션텍스트를 음성으로 변환하고 시각적 장면과 함께 재생

파이프라인

입력 → 분석 → 장면_함수 → 톤매핑 → 음영처리 → 인코딩
  1. 입력 — 비디오 파일, 오디오 파일, 또는 생성 파라미터
  2. 분석 — 프레임 추출(비디오) 또는 오디오 특징 추출(반응형)
  3. 장면_함수 — 프레임별 ASCII 프레임 콘텐츠 생성
  4. 톤매핑 — 픽셀 밝기를 ASCII 문자 램프에 매핑
  5. 음영처리 — 문자 집합 적용 및 선택적 ANSI 색상 적용
  6. 인코딩 — ffmpeg를 통해 비디오로 렌더링

ASCII 문자 램프

# 밝음 → 어두움 (기본)
RAMP = " .:-=+*#%@"

# 확장
RAMP_EXT = " .'`^\",:;Il!i><~+_-?][}{1)(|\\/tfjrxnuvczXYUJCLQ0OZmwqpdbkhao*#MW&8%B@$"

# 블록 문자 (최고 대비)
RAMP_BLOCK = " ░▒▓█"

비디오를 ASCII로 변환

import subprocess
import numpy as np
from PIL import Image
import io

def video_to_ascii(video_path, width=120, fps=15):
    """프레임을 추출하고 ASCII로 변환."""
    cmd = [
        'ffmpeg', '-i', video_path,
        '-vf', f'fps={fps},scale={width}:-1',
        '-f', 'image2pipe', '-vcodec', 'rawvideo', '-pix_fmt', 'gray', '-'
    ]
    # 프레임 처리...
    proc = subprocess.Popen(cmd, stdout=subprocess.PIPE, stderr=subprocess.DEVNULL)
    # 프레임 데이터를 읽고 각 픽셀을 램프에서 ASCII 문자로 변환

비디오로 렌더링

# ASCII 프레임을 ffmpeg로 비디오 렌더링
# 1. 프레임 이미지 생성 (PIL/Pillow, 고정폭 폰트 사용)
# 2. 인코딩:
ffmpeg -framerate 30 -i frames/frame_%04d.png -c:v libx264 -pix_fmt yuv420p output.mp4

# 오디오 트랙 추가:
ffmpeg -i video.mp4 -i audio.mp3 -c:v copy -c:a aac -shortest output_with_audio.mp4

창작 기준

  • 첫 렌더링 완성도 — 각 프레임이 독립적으로 보기에 좋아야 함
  • 구간별 변주 — 구간마다 문자 집합, 밀도, 효과를 다양하게 적용
  • 일관된 미학 — 작품 내에서 일관된 스타일 유지
  • 프레임 레이트 — 레트로 느낌은 15fps, 부드러움은 30fps, 유동감은 60fps
  • 해상도 — 가독성을 위한 최적 컬럼 수는 80-120열

관련 스킬