Community이미지github.com

ASCII 아트

이미지, GIF, 비디오를 ASCII 아트나 ASCII 애니메이션(일반 텍스트, 트루컬러 터미널 출력, HTML, PNG, GIF, WebP, MP4)으로 변환합니다. 정지 이미지에 매트릭스 비, 디코드, 스캔, 글리치, 웨이브 효과를 적용할 수도 있습니다. 또한 '달리는 말' 같은 짧은 설명으로 Wikimedia Commons의 자유 라이선스 클립을 사용해 ASCII 애니메이션을 만듭니다.

ASCII 아트란 무엇인가요?

ASCII 아트 스킬은 이미지, GIF, 비디오를 다양한 형식의 ASCII 아트로 변환하는 강력한 도구입니다. `scripts/ascii.py`는 정지 이미지를, `scripts/animate.py`는 애니메이션을 처리하며, 둘 다 Python 3.9+와 Pillow만 필요합니다. 비디오 처리를 위해 ffmpeg가 선택적으로 필요합니다. `uv`가 설치되어 있으면 `uv run`이 Pillow를 자동으로 설치하므로 별도 설정이 필요 없습니다. 다양한 출력 형식(텍스트, HTML, PNG, GIF, WebP, MP4)과 여러 모드(ramp, shape, braille, halfblock, words, tiles)를 지원하며, 매트릭스 비, 디코드, 스캔, 글리치, 웨이브와 같은 특수 효과도 제공합니다. Claude Code, Cursor, Codex 등 모든 AI 에이전트 플랫폼에서 실행할 수 있으며, 사용자가 ASCII 아트, ASCII 애니메이션, 이미지의 텍스트 아트 버전, 로고로 만든 터미널 배너, 또는 '매트릭스'/레트로 텍스트 느낌을 요청할 때 특히 유용합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/rasabaq/ascii-skill/tree/HEAD

Installed? Explore more 이미지 skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

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

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

문서

ASCII 아트은(는) 무엇을 하나요?

scripts/ascii.py는 정지 이미지를, scripts/animate.py는 애니메이션을 만듭니다 ("애니메이션" 참조). 둘 다 Python 3.9+와 Pillow만 필요합니다 (비디오는 ffmpeg 추가 필요). uv가 설치되어 있으면 uv run이 Pillow를 자동으로 가져옵니다.

uv run scripts/ascii.py IMAGE [옵션]          # 또는: python3 scripts/ascii.py (pillow 필요)

아래 경로는 이 스킬의 폴더 기준입니다.

단계

  1. 이미지 경로를 가져옵니다. URL인 경우 curl -L -o /tmp/in.img URL로 먼저 다운로드합니다.
  2. 출력 방식을 선택합니다. 채팅에 아트를 표시하려면 stdout 텍스트를 사용합니다. 사용자가 공유할 파일을 원하면 -o file.png 또는 -o file.html을 사용합니다.
  3. 실행하고 결과를 확인합니다. PNG의 경우 이미지를 열어 확인합니다.
  4. 주제를 보기 어려우면 설정을 조정하고 다시 실행합니다 ("약한 결과 수정" 참조).

옵션

옵션설명
-w 100문자 너비 (1–1000). 채팅에는 60–80, PNG/HTML에는 120–200, 텍스트 스크린샷에는 120+를 사용합니다.
-c standard문자 램프: standard, detailed, blocks, terminal, minimal, binary, dots, 또는 밀집에서 빈 순서의 사용자 정의 문자열 (예: -c "#*. ").
-o out.png확장자로 출력: .txt, .html, .png, .jpg, .webp. -o가 없으면 plain text를 stdout에 출력합니다.
--bg black배경: black (기본값), white, none (투명 PNG/HTML), 또는 모든 색상. 어두운 배경에서는 밝은 픽셀에 밀집된 글리프가 사용됩니다. 밝은 배경에서는 어두운 픽셀에 사용됩니다.
--fg matrix단일 잉크 색상: matrix, amber, cyan, magenta, mint, 또는 모든 CSS 색상이나 hex 값. 지정하지 않으면 PNG/HTML은 사진의 원래 색상을 사용합니다.
--color텍스트 출력 (stdout 또는 .txt)에서 트루컬러 ANSI 이스케이프 코드를 사용합니다. --fg가 있으면 해당 색상을, 없으면 사진 색상을 사용합니다.
--invert밝음과 어두움을 바꿉니다.
--contrast 1.0 --brightness 1.0자동 대비 확장에 추가되는 계수입니다. 1.0은 변화 없음을 의미합니다.
--ditherFloyd-Steinberg 디더링. 부드러운 그라데이션과 짧은 램프(blocks나 minimal 등)에 좋습니다.
--mode rampramp (기본값): 픽셀당 하나의 글리프, 밝기로 선택. shape: ramp와 비슷하지만, 가장자리를 같은 모양의 기호(`/ \
--sharpen축소하기 전에 가장자리를 선명하게 합니다. 얼굴과 미세한 디테일에 도움이 되며, 특히 braille 모드에서 효과적입니다.
--aspect 0.5문자 너비를 높이로 나눈 값입니다. 아트가 찌그러져 보이면 값을 높입니다.
--font-size 12PNG/HTML용 글리프 크기 (px).
--glow 0.8PNG, HTML, 애니메이션에서 글리프 주변의 부드러운 빛 (0-1), 오래된 화면의 빛과 같습니다. 어두운 배경에서 가장 좋습니다.

약한 결과 수정

스크립트는 모든 이미지를 전체 명암 범위로 자동 늘리므로 대부분의 이미지는 조정 없이도 괜찮게 보입니다.

  • 사진: -c blocks --dither은 가장 인식하기 쉬운 얼굴과 동물을 만듭니다.
  • 어두운 피사체 (검은 개, 밤 장면)가 검은 배경에서 사라짐: --bg white를 사용합니다. --brightness 1.5를 높이는 것도 도움이 됩니다. 대비를 높이면 어두운 장면이 더 나빠집니다.
  • 흰 배경의 어두운 로고가 단색 블록으로 보임: --bg white를 추가합니다 (터미널 출력의 경우 --invert).
  • 같은 너비에서 더 많은 디테일을 원함: 선화 스타일은 --mode braille --dither --sharpen, 컬러 사진은 --mode halfblock.
  • 노이즈가 너무 많음: 더 적은 열이나 더 짧은 램프를 사용합니다 (-c minimal).
  • 그라데이션에 밴딩이 있음: --dither를 추가합니다.
  • 채팅 출력: 이스케이프 코드가 쓰레기로 나타나므로 --color를 사용하지 마십시오. 텍스트를 코드 블록으로 감쌉니다.
  • SVG는 지원되지 않습니다. 먼저 PNG로 변환하십시오 (rsvg-convert -w 800 logo.svg -o logo.png).

모드 요약

  • braille은 -c를 무시합니다. 사진에는 --dither와 함께, 로고에는 없이 사용합니다. 색상은 사진 또는 --fg를 따릅니다.
  • halfblock은 색상이 그림 자체이므로 -c, --dither, --fg를 무시합니다. 일반 텍스트(--color 없음)는 색상이 없으므로 각 셀이 밝기에 따라 음영 블록 █▓▒░이 됩니다. --bg none은 투명하게 만들지 않습니다: 투명 픽셀은 검은색이 됩니다.
  • 터미널은 점자를 작게 그리므로 PNG보다 거기서 더 어둡게 보입니다.

타일 포스터

--mode tiles는 포스터를 만듭니다: 차콜색 페이지 위에 각각 하나의 글리프가 있는 몇 가지 차분한 색상의 정사각형 타일 격자입니다. 이미지가 페이지 색상에 가까운 셀은 타일이 아니라 희미한 글리프를 표시하여 격자가 모든 곳에 계속됩니다.

uv run scripts/ascii.py photo.jpg --mode tiles -w 36 -o poster.png
  • 타일 모드 기본값: 정사각형 셀 (--aspect 1), --font-size 80 (48 px 타일), --gap 1, --bg "#1d1f22". 텍스트 출력은 --aspect 0.5를 유지합니다.
  • --palette 8: 타일 색상의 수, 피사체에서 한 번 선택됩니다. 더 평평하고 차분한 느낌을 위해 4–6을 사용합니다.
  • 글리프는 무작위입니다. --seed N은 다른 세트를 선택합니다. 대신 램프 글리프를 사용하려면 -c를 지정합니다.
  • 밝은 배경의 사진: --bg "#ecebe6"처럼 밝은 페이지를 사용합니다. 그러면 어두운 부분이 타일이 됩니다.
  • animate.py에서도 작동합니다. 글리프와 색상은 프레임마다 동일하게 유지됩니다.

단어 포스터

--mode words는 캔버스를 대문자 단어로 채우며, 단어 사이는 한 칸 띄웁니다. 각 행은 자체 오프셋에서 시작하여 양쪽 가장자리 밖으로 이어집니다. 이미지는 각 단어의 밝기를 통해서만 보입니다: 단어당 하나의 레벨, 그 아래 이미지의 평균에서 비롯됩니다. 어두운 부분은 희미한 단어를, 밝은 피사체는 밝은 단어를 제공합니다.

  • --words "A B C"는 어휘를 설정합니다 (공백 또는 쉼표로 구분). 기본값은 짧은 유형 및 픽셀 단어 목록입니다.
  • --accent "#f28c28"는 가장 다채로운 단어 뒤에 어두운 텍스트가 있는 단색 상자를 놓습니다. --accent-level 0.5 (0-1)는 단어가 얼마나 다채로워야 하는지입니다. 회색 사진은 상자가 없습니다. 완전히 채색된 로고는 많은 상자를 얻으므로 레벨을 높이십시오.
  • 배경 기본값은 #1d1f22입니다. --gap은 쌓인 행에서 상자 사이의 px를 설정합니다. --seed는 다른 레이아웃을 선택합니다. --fg는 무시됩니다.
  • 어두운 배경에 밝고 단순한 피사체에 가장 잘 작동합니다. 밝은 사진에 어두운 피사체가 있으면 --invert를 추가합니다.
  • animate.py에서는 레이아웃이 모든 프레임에서 동일하게 유지됩니다. 밝기만 변경됩니다.

프리셋: --mode words -w 110 --font-size 16 --accent "#f28c28" -o poster.png

프리셋

  • 매트릭스: -c binary --fg matrix --glow 0.8 -o out.png
  • 레트로 호박색 터미널: -c terminal --fg amber -o out.png
  • 컬러 포토 모자이크: -c detailed -w 160 -o out.html
  • 터미널 최고의 컬러 사진: --mode halfblock --color
  • 미세 점 그림: --mode braille --dither --sharpen -o out.png
  • 필름 누아르: --fg "#e8e6df" --contrast 1.35 --bg "#050505" --glow 0.7 -o out.png
  • 인쇄 친화적: --bg white -o out.png
  • 타일 포스터: --mode tiles -w 36 -o poster.png

애니메이션

scripts/animate.py는 ASCII 애니메이션을 만듭니다. ascii.py와 동일한 외형 옵션 (-w, -c, --mode, --sharpen, --bg, --fg, --invert, --contrast, --brightness, --font-size, --aspect, --gap, --glow, 단어 및 타일 포스터 옵션)을 사용합니다. 비디오 입력과 .mp4 출력에는 ffmpeg가 필요합니다. GIF와 WebP는 필요하지 않습니다.

uv run scripts/animate.py cat.gif                          # 터미널에서 재생, Ctrl-C로 중지
uv run scripts/animate.py cat.gif -o out.gif               # .webp, .mp4, 또는 .html (재생/일시정지 플레이어가 있는 단일 파일)도 가능
uv run scripts/animate.py clip.mp4 -o out.html --start 2 --duration 4 --fps 12
uv run scripts/animate.py photo.jpg --effect matrix -o intro.gif   # 정지 이미지 애니메이션화
  • 입력: 애니메이션 GIF, WebP 또는 APNG, ffmpeg가 읽는 모든 비디오, 또는 --effect가 있는 정지 이미지.
  • 프레임 타이밍은 소스에서 가져옵니다. --fps는 리샘플링합니다. --start와 --duration은 초 단위로 구간을 선택합니다.
  • 기본적으로 300프레임에서 중지하고 그렇게 알립니다. 더 긴 클립은 --max-frames를 높이거나 --fps를 낮춥니다.
  • 모든 프레임에 대해 하나의 명암 범위 (그리고 braille의 경우 하나의 점 임계값)이 사용되므로 밝기가 변하지 않습니다.
  • 정지 영역은 깜빡이지 않습니다: 픽셀은 값이 --steady (기본값 6, 255 중) 이상 변경될 때까지 값을 유지합니다. 거친 필름의 경우 16 이상으로 높이십시오. --steady 0은 이를 끕니다.
  • 인터레이스 비디오는 디인터레이스되고, 정사각형이 아닌 픽셀이 있는 비디오는 실제 모양을 유지합니다.
  • 애니메이션에는 --dither를 피하십시오: 프레임마다 글리프가 움직이게 만듭니다.
  • GIF는 약 50fps보다 빠르게 재생될 수 없으므로 빠른 비디오는 .gif에서 일부 프레임을 잃습니다. 부드러운 60fps를 위해 .mp4 또는 .webp를 사용하십시오.

단색 배경의 인물

밝은 배경의 어두운 인물 (예: Muybridge의 달리는 말)의 경우 --bg white를 사용하십시오. 그러면 인물이 잉크를 받고 페이지는 깨끗하게 유지됩니다. --mode braille은 가장 선명한 움직이는 인물을 제공하고, --mode halfblock은 사진의 색조를 유지합니다.

uv run scripts/animate.py horse.gif --mode braille --bg white -o horse.gif
uv run scripts/animate.py juggler.webm --start 17 --duration 4 --mode braille --subject -o juggler.gif

--subject는 움직이는 것만 유지하고 나머지는 빈 페이지로 칠합니다 (--bg를 설정하지 않으면 배경이 밝을 때 흰색). 고정 카메라가 필요합니다: 최대 25프레임의 중앙값에서 배경을 가져옵니다. 참고:

  • 대부분의 클립에서 정지해 있는 부분 (예: 머리)은 배경으로 간주되어 사라집니다.
  • 그림의 가장자리가 계속 변경되면 카메라가 움직이는 것입니다: 그렇게 알리고 프레임을 그대로 둡니다. 느린 패닝은 항상 포착되지는 않으며 윤곽선을 남깁니다.
  • 각 프레임이 다른 사진인 클립 (Muybridge의 말과 버팔로)에서는 대신 --bg white를 사용하십시오.
  • --subject-cut (기본값 40, 255 중)은 픽셀이 배경과 얼마나 달라야 하는지입니다. 희미한 인물의 경우 낮추고, 노이즈가 많은 비디오의 경우 높이십시오.

정지 이미지 효과

--effect NAME은 하나의 이미지를 2~3.2초 인트로 (25fps)로 바꾸며, 완성된 아트로 끝나고 1.5초 동안 유지합니다. 모든 효과가 모든 모드와 함께 작동합니다.

  • matrix: 밝은 머리를 가진 글리프 기둥이 떨어지며 뒤에 아트를 남깁니다.
  • decode: 셀이 무작위 글리프를 통해 스크램블되어 잠기며, 왼쪽에서 오른쪽으로 휩쓸립니다.
  • scan: 밝은 CRT 라인이 아래로 휩쓸며 각 행을 입력하고, 짧은 광택이 있습니다.
  • glitch: 찢어진 행, 글리프 교체, 빨간색/시안색 밴드의 짧은 버스트. 루프가 잘 됩니다.
  • wave: 행이 부풀었다가 가라앉는 사인파에 의해 옆으로 흔들립니다. 루프가 잘 됩니다.

장면

--scene NAME은 코드에서 루핑 애니메이션을 그리므로 입력 파일이 필요 없습니다. 각 루프는 2~3.2초이며, 마지막 프레임이 첫 번째 프레임으로 이어집니다. 모든 모드, 색상 옵션 및 출력이 작동합니다. --seed N은 다른 변형을 제공하고 (불, 파도, 별, 비), --fps는 부드러움을 변경하지만 루프 길이는 유지합니다.

uv run scripts/animate.py --scene fire -o fire.gif                       # 솟아오르는 불꽃, 따뜻한 색상
uv run scripts/animate.py --scene donut -o donut.gif                     # 회전하고, 빛나고, 설탕이 뿌려진 도넛
uv run scripts/animate.py --scene cube --mode braille -o cube.gif        # 밝은 가장자리가 있는 넘어지는 큐브
uv run scripts/animate.py --scene waves --mode halfblock -o waves.gif    # 달 아래 바다의 파도
uv run scripts/animate.py --scene stars -o stars.gif                     # 별바다를 통과하는 비행
uv run scripts/animate.py --scene walker --mode braille -o run.gif       # 제자리에서 달리는 막대기 인물
uv run scripts/animate.py --scene rain --mode braille -o rain.gif        # 튀는 물방울이 있는 비
uv run scripts/animate.py --scene bounce --mode halfblock -o ball.gif    # 튕길 때 찌그러지는 공
uv run scripts/animate.py --scene text --mode halfblock -o text.gif      # 단어 ASCII가 무지개 파도를 타고
  • -w 60에서 -w 100을 사용하십시오. --mode halfblock은 최상의 색상을 제공하고, --mode braille은 가장 선명한 선을 제공합니다.
  • -o 없이 장면은 터미널에서 재생됩니다.
  • 장면은 scripts/scenes.py의 일반 함수입니다: scene(w, h, n, seed)는 루프되는 n개의 이미지를 반환합니다. 추가하려면 함수를 작성하고 @scene(width, height, frames, fps) 라인을 지정하십시오.

설명에서

사용자가 파일 대신 움직이는 것을 설명할 때 ("달리는 말") 먼저 무료 클립을 찾으십시오. scripts/fetch.py는 Wikimedia Commons에서 자유 라이선스가 있는 애니메이션 GIF와 짧은 비디오를 검색하여 가장 일치하는 것을 다운로드합니다.

  1. 클립 가져오기: uv run scripts/fetch.py "running horse" -o /tmp/clip. 올바른 확장자 (.gif, .webm)를 추가한 다음 저장된 경로와 저작자 표시 줄을 출력합니다. 직접 선택하려면 먼저 --list로 실행한 다음 --pick N을 사용하십시오.
  2. 출력된 경로 변환: uv run scripts/animate.py /tmp/clip.gif --mode braille -w 80 --bg white -o out.gif. 모든 프리셋이 작동합니다. 긴 비디오의 경우 --duration 5를 추가합니다.
  3. 결과의 한 프레임을 확인합니다. 피사체를 보기 어려우면 다른 결과로 --pick을 시도하십시오.
  4. 결과와 함께 사용자에게 저작자 표시 줄을 제공합니다. 대부분의 라이선스 (CC BY, CC BY-SA)는 이를 요구합니다.

피사체와 움직임에 대해 짧고 간단한 영어 단어로 검색하십시오. 단색 배경의 선화, 실루엣 및 클립이 ASCII로 가장 잘 읽힙니다. 복잡한 실제 비디오는 종종 그렇지 않습니다.

적합한 것을 찾을 수 없으면 대신 코드로 그린 장면을 사용하십시오: animate.py --scene NAME ("장면" 참조).

Python 사용

import sys; sys.path.insert(0, "scripts")
from PIL import Image
from ascii import convert, to_text, to_png
grid = convert(Image.open("cat.jpg"), width=80, charset="blocks", dither=True)
# 셀은 (char, (r, g, b))입니다. mode="halfblock"인 경우 (char, top_rgb, bottom_rgb)입니다.
# mode="tiles"인 경우 타일 셀은 (char, ink_rgb, tile_rgb)입니다.
print(to_text(grid))
to_png(grid).save("cat_ascii.png")

from effects import frames  # 그리드 목록; 마지막 것은 `grid`
intro = [to_png(g) for g in frames(grid, "decode")]

관련 스킬