<p align="center">
<img src="https://raw.githubusercontent.com/unhappychoice/gitlogue/HEAD/docs/assets/demo.gif" alt="gitlogue" width="820">
</p>
<p align="center">
<a href="https://crates.io/crates/gitlogue"><img src="https://img.shields.io/crates/v/gitlogue.svg?style=flat-square&color=E06B4B" alt="crates.io"></a>
<a href="https://github.com/unhappychoice/gitlogue/releases"><img src="https://img.shields.io/github/v/release/unhappychoice/gitlogue?style=flat-square&color=E0C14B&label=release" alt="release"></a>
<a href="https://github.com/unhappychoice/gitlogue/actions/workflows/ci.yml"><img src="https://img.shields.io/github/actions/workflow/status/unhappychoice/gitlogue/ci.yml?branch=main&style=flat-square&label=CI" alt="CI"></a>
<a href="https://codecov.io/gh/unhappychoice/gitlogue"><img src="https://img.shields.io/codecov/c/github/unhappychoice/gitlogue?style=flat-square" alt="codecov"></a>
<a href="https://github.com/unhappychoice/gitlogue/blob/main/LICENSE"><img src="https://img.shields.io/crates/l/gitlogue.svg?style=flat-square" alt="license"></a>
<a href="https://terminaltrove.com/gitlogue/"><img src="https://img.shields.io/badge/Terminal_Trove-Tool_of_The_Week-2ea043?style=flat-square" alt="Terminal Trove Tool of The Week"></a>
<a href="https://hellogithub.com/repository/unhappychoice/gitlogue" target="_blank"><img src="https://abroad.hellogithub.com/v1/widgets/recommend.svg?rid=611a8aecd29d4ac295c64899448f395c&claim_uid=cSxaw6P2C5pfIlE&theme=small" alt="Featured|HelloGitHub"></a>
</p>
<p align="center">
<strong>터미널을 위한 시네마틱 Git 커밋 리플레이 도구.</strong><br>
<sub>Git 히스토리를 살아있는 애니메이션 스토리로 변환합니다 — 타이핑, 구문 강조(syntax highlighting), 파일 트리 전환.</sub>
</p>
실제 타이핑 애니메이션, 구문 강조 및 파일 트리 전환을 통해 커밋이 펼쳐지는 것을 관찰하며 코드 변경 사항을 시각적인 경험으로 바꿀 수 있습니다.
설치
설치 스크립트 사용 (권장)
⚠️ [IMG:N] 형식 토큰은 이미지 placeholder 입니다. 번역하지 말고 원래 위치에 그대로 유지하세요.
curl -fsSL https://raw.githubusercontent.com/unhappychoice/gitlogue/main/install.sh | bash
Homebrew 사용하기
Cargo 사용하기
Arch Linux에서 사용하기
Nix 사용하기
nix run github:unhappychoice/gitlogue
...
소스에서 빌드하기
git clone https://github.com/unhappychoice/gitlogue.git
cd gitlogue
cargo install --path .
더 많은 옵션과 문제 해결 방법은 Installation Guide를 참조하세요.
기능 (Features)
🎬 애니메이션 커밋 리플레이 — 사실적인 타이핑, 커서 이동, 삭제 및 파일 작업
🔍 작업 트리 Diff 보기 — 커밋 전 스테이징되거나 언스테이징된 변경 사항 시각화
🎨 Tree-sitter 구문 강조 — 32개 언어 지원
🌳 프로젝트 파일 트리 — 변경 통계가 포함된 디렉토리 구조
🖥️ 스크린세이버 모드 — 끝없는 무작위 커밋 재생
🎭 테마 — 내장 테마 9가지 + 완전한 사용자 정의 지원
⚡ 빠르고 가벼움 — 성능을 위해 Rust로 제작
사용법 (Usage)
인기 사용 사례 (Popular Use Cases)
🖥️ 스크린세이버 — 작업 공간을 위한 주변 코딩 디스플레이
🎓 교육 — 시간이 지남에 따라 코드가 어떻게 진화했는지 시각화
📺 프레젠테이션 — 실제 커밋 기록 실시간 재생
🎬 콘텐츠 제작 — VHS 또는 asciinema로 데모 녹화
🎨 데스크톱 라이싱 (Desktop Ricing) — 터미널을 위한 살아있는 장식품
💼 바쁜 척 모드 (Look Busy Mode) — 회의 중 생산적인 것처럼 보이게 함
[!WARNING]
진정한 스크린세이버가 아님 — gitlogue는 전력 관리나 화면 빈화와 같은 전통적인 스크린세이버 기능을 포함하지 않습니다. 순전히 시각적 디스플레이 도구입니다.
OLED 번인 위험 — 정적인 요소(에디터 배경 및 테두리 선 등)는 장시간 사용 시 OLED 디스플레이에서 번인을 유발할 수 있습니다. LCD 디스플레이는 일반적으로 이 문제로부터 안전합니다.
빠른 시작 (Quick Start)
주요 키 바인딩 (Key Bindings)
재생 (Playback)
| Key | Action |
|---|
Space | 재생/일시정지 토글 |
| ... | |
| Key | Action |
|---|
j / ↓ | 선택 항목 아래로 이동 |
| ... | |
설정 (Configuration)
gitlogue는 ~/.config/gitlogue/config.toml을 통해 설정할 수 있습니다. 기본 테마, 타이핑 속도 및 배경 환경 설정을 지정할 수 있습니다.
전체 옵션과 예시는 설정 가이드를 참조하십시오.
지원되는 언어 (Supported Languages)
Astro, Bash, C, C#, C++, Clojure, CSS, Dart, Elixir, Erlang, Go, Godot (GDScript / Shader / Resource), Haskell, HTML, Java, JavaScript, JSON, Kotlin, Lua, Markdown, Nix, PHP, Python, Ruby, Rust, Scala, Svelte, Swift, TypeScript, XML, YAML, Zig
문서화 (Documentation)
설치 가이드
사용 가이드
설정 가이드
테마 사용자 정의
기여 지침
아키텍처 개요
Git 시각화 및 코딩 (Git Visualization & Coding)
- GitType - 소스 코드를 타이핑 챌린지로 변환하는 CLI 코드 타이핑 게임
터미널 스크린세이버 (Terminal Screensavers)
- tarts - Rust로 작성된 터미널 스크린세이버 모음 (Matrix, Game of Life, Boids, 3D 효과 등)
- cbonsai - 터미널에서 아름다운 분재를 키우기
- asciiquarium - 터미널에서 바다의 신비를 즐겨보세요
- cmatrix - 터미널용 Matrix 스크린세이버 효과
- pipes.sh - 터미널을 통해 흐르는 애니메이션 파이프
기여 (Contributing)
기여를 환영합니다. 자세한 내용은 기여 지침을 참조하십시오.
라이선스 (License)
ISC License. 자세한 내용은 LICENSE를 참조하십시오.
작성자 (Author)
@unhappychoice
지원 (Support)
이 프로젝트가 유용하다고 생각되시면, 다음을 고려해 주세요:
어떤 형태의 지원이라도 큰 도움이 됩니다. 감사합니다!