charmbracelet/vhs

어떤 프로젝트인가요?

핵심 기능

• 01간단한 .tape 명령어 언어로 터미널 세션을 스크립트화합니다.
• 02GIF, MP4, WebM, PNG 프레임 시퀀스, 텍스트/ASCII 파일을 출력합니다.
• 03글꼴, 창 크기, 테마, 패딩, 여백, 창 제목 표시줄을 설정합니다.
• 04실시간 터미널 세션에서 tape 파일을 녹화합니다.
• 05통합 테스트에서 diff 비교에 사용할 ASCII 골든 파일을 생성합니다.
• 06SSH 서버로 실행해 원격 호스트에서 tape를 실행합니다.

활용 사례

• CI에서 README 데모 GIF를 다시 생성해 최신 상태로 유지합니다.
• 골든 파일과 텍스트 출력을 diff로 비교해 CLI를 통합 테스트합니다.
• 문서나 튜토리얼에 사용할 터미널 작업 흐름의 재현 가능한 스크린캐스트를 만듭니다.

빠른 시작

1. 1

   VHS가 PATH에서 필요로 하는 ttyd와 ffmpeg를 설치합니다

2. 2

   macOS 또는 Linux에서 Homebrew로 VHS를 설치합니다

   brew install vhs
3. 3

   새 tape 파일을 만듭니다

   vhs new demo.tape
4. 4

   tape 파일에서 GIF를 생성합니다

   vhs demo.tape

사용 전 알아둘 점

• !ttyd와 ffmpeg는 별도로 설치하고 PATH에서 사용할 수 있도록 설정해야 합니다.

포함된 컬렉션

토픽

자주 묻는 질문

vhs은(는) 무엇인가요?

스크립트로 작성한 .tape 파일을 재생해 터미널 세션을 GIF, 동영상 또는 ASCII 출력으로 녹화하는 Go CLI로, 데모와 통합 테스트에 활용할 수 있습니다. VHS는 터미널 녹화를 코드처럼 다룹니다. Type, Enter, Sleep, Wait 같은 명령을 나열한 .tape 파일을 작성하면 VHS가 가상 터미널에서 재생하고 결과를 GIF, MP4, WebM, PNG 시퀀스 또는 텍스트/ASCII 골든 파일로 렌더링합니다. 글꼴 종류와 크기, 창 크기 또는 열·행 수, 테마, 패딩, 여백, 창 제목 표시줄, 재생 속도를 설정할 수 있습니다.

vhs은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

vhs은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

vhs은(는) 아직 유지보수되고 있나요?

활발히 유지보수 중. vhs의 마지막 커밋은 2026년 11월 2일입니다.

vhs은(는) 어디에 사용할 수 있나요?

CI에서 README 데모 GIF를 다시 생성해 최신 상태로 유지합니다. 골든 파일과 텍스트 출력을 diff로 비교해 CLI를 통합 테스트합니다. 문서나 튜토리얼에 사용할 터미널 작업 흐름의 재현 가능한 스크린캐스트를 만듭니다.

vhs는 어떻게 설치하나요?

VHS가 PATH에서 필요로 하는 ttyd와 ffmpeg를 설치합니다 macOS 또는 Linux에서 Homebrew로 VHS를 설치합니다: brew install vhs 새 tape 파일을 만듭니다: vhs new demo.tape tape 파일에서 GIF를 생성합니다: vhs demo.tape

vhs은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/charmbracelet/vhs