homeport/termshot
터미널 명령을 실행하고 ANSI 색상 출력을 창 스타일의 PNG 스크린샷으로 렌더링하는 CLI입니다.
- 스타
- 976
- 포크
- 42
- 열린 이슈
- 37
- 마지막 커밋
- 지난달
어떤 프로젝트인가요?
termshot은 명령을 pseudo terminal에서 실행하고, ANSI 색상 및 서식 코드를 포함한 출력을 캡처해 터미널 창처럼 보이는 이미지로 렌더링합니다. 붙여 넣은 텍스트에 구문 강조를 적용하는 도구와 달리, 명령 자체가 출력하는 이스케이프 코드를 사용하므로 ls, figlet, lolcat 같은 도구의 출력도 원래 색상을 유지합니다.
사용법은 간단합니다. 명령 앞에 termshot을 붙이면 기본적으로 out.png 파일을 생성합니다. 플래그로 창 장식, 그림자, 여백, 패딩, 줄바꿈, 명령 표시 등 모양을 조정하고, 출력 파일 경로나 지원 플랫폼의 시스템 클립보드를 지정할 수 있습니다. 또한 캡처한 출력에서 민감한 줄을 삭제하도록 $EDITOR에서 내용을 편집할 수 있습니다. 전체 대화형 셸을 실행한 뒤 셸이 종료될 때 세션을 스크린샷으로 남기는 기능도 있습니다.
이 프로젝트는 아직 개발 중입니다. 많은 ANSI 시퀀스를 파싱하지만, 일부 출력이나 커서 위치를 초기화하는 명령은 제대로 렌더링되지 않을 수 있습니다.
핵심 기능
- 01구문 강조를 적용하는 대신 실제 ANSI 색상 및 서식 코드를 렌더링합니다.
- 02선택적으로 장식, 그림자, 여백, 패딩을 추가해 터미널 창처럼 표시합니다.
- 03이미지를 생성하기 전에 캡처한 출력을 $EDITOR에서 편집할 수 있습니다.
- 04전체 대화형 셸 세션을 스크린샷으로 남길 수 있습니다.
- 05Homebrew 또는 macOS 및 Linux용 사전 빌드 바이너리로 설치할 수 있습니다.
활용 사례
- 블로그 게시물, 문서 또는 릴리스 노트에 넣을 CLI 출력 스크린샷을 만들 수 있습니다.
- 민감한 줄을 먼저 삭제한 뒤 명령 출력을 소셜 미디어나 채팅에서 공유할 수 있습니다.
- figlet이나 lolcat 같은 색상이 화려한 도구를 원래 스타일 그대로 보여줄 수 있습니다.
빠른 시작
- 1
macOS 또는 Linux에서 Homebrew로 설치
brew install homeport/tap/termshot - 2
명령어 앞에 termshot을 붙이면 out.png가 생성됩니다
termshot ls -a
사용 전 알아둘 점
- README에 따르면 아직 개발 중이며, 일부 ANSI 시퀀스나 커서를 재설정하는 명령어는 올바르게 렌더링되지 않을 수 있습니다.
토픽
자주 묻는 질문
- termshot은(는) 무엇인가요?
- 터미널 명령을 실행하고 ANSI 색상 출력을 창 스타일의 PNG 스크린샷으로 렌더링하는 CLI입니다. termshot은 명령을 pseudo terminal에서 실행하고, ANSI 색상 및 서식 코드를 포함한 출력을 캡처해 터미널 창처럼 보이는 이미지로 렌더링합니다. 붙여 넣은 텍스트에 구문 강조를 적용하는 도구와 달리, 명령 자체가 출력하는 이스케이프 코드를 사용하므로 ls, figlet, lolcat 같은 도구의 출력도 원래 색상을 유지합니다.
- termshot은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
- termshot은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
- termshot은(는) 아직 유지보수되고 있나요?
- 6개월 이내 업데이트. termshot의 마지막 커밋은 2026년 9월 15일입니다.
- termshot은(는) 어디에 사용할 수 있나요?
- 블로그 게시물, 문서 또는 릴리스 노트에 넣을 CLI 출력 스크린샷을 만들 수 있습니다. 민감한 줄을 먼저 삭제한 뒤 명령 출력을 소셜 미디어나 채팅에서 공유할 수 있습니다. figlet이나 lolcat 같은 색상이 화려한 도구를 원래 스타일 그대로 보여줄 수 있습니다.
- termshot는 어떻게 설치하나요?
- macOS 또는 Linux에서 Homebrew로 설치: brew install homeport/tap/termshot 명령어 앞에 termshot을 붙이면 out.png가 생성됩니다: termshot ls -a
- termshot은(는) 어디서 받을 수 있나요?
- 소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/homeport/termshot
요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.
관련 프로젝트
~/.ssh/config에 정의된 SSH 호스트를 탐색하고 연결하며 관리하는 터미널 TUI입니다.
tmux 세션을 저장하고 TUI에서 골라 필요한 항목만 복원하는 Go CLI