Ratty

GPU 기반 텍스트 렌더링

Ratty는 Bevy 엔진을 통해 텍스트를 GPU에서 렌더링하여 높은 성능과 부드러운 애니메이션을 달성합니다. 터미널 셀 하나하나가 텍스처로 처리되어 복잡한 시각 효과도 실시간으로 처리됩니다.

인라인 3D 객체 지원

사용자는 .obj, .glb, .stl 형식의 3D 모델을 터미널 내에 삽입할 수 있습니다. 이 객체들은 터미널 셀에 고정되어 이동, 회전, 스케일링 등이 가능하며, Ratty Graphics Protocol(RGP)을 통해 제어됩니다.

3D 모드 및 카메라 컨트롤

Ctrl + Alt + Enter를 눌러 2D와 3D 모드를 전환할 수 있으며, 다양한 카메라 시점(평면, 정사투영, 원근, 뫼비우스)을 지원합니다. 마우스 드래그나 키보드 단축키로 카메라 조작이 가능하며, 터치스크린에서는 손가락 제스처로 회전, 확대/축소, 팬 동작을 지원합니다.

커스텀 커서

터미널 커서를 3D 모델로 대체할 수 있으며, 설정 파일을 통해 모델 경로, 크기, 밝기, 오프셋 등을 세부 조정할 수 있습니다. 기본 제공되는 스피닝 랫 커서 외에도 사용자 정의 객체를 사용할 수 있습니다.

다운로드·설치 방법

Windows 사용자는 GitHub releases 페이지에서 사전 빌드된 바이너리를 ZIP 형식으로 다운로드할 수 있습니다. 압축을 해제한 후 실행 파일을 더블클릭하면 바로 사용을 시작할 수 있습니다. 별도의 설치 과정 없이 포터블하게 실행됩니다.

기본 사용법/명령어

Ratty를 실행하면 일반적인 터미널과 같이 명령을 입력할 수 있습니다. 주요 단축키는 다음과 같습니다:

• Ctrl + Alt + C: 선택 영역 복사
• Ctrl + Alt + V: 클립보드 붙여넣기
• Ctrl + Alt + Enter: 2D ↔ 정사투영 3D 모드 전환
• Ctrl + Alt + P: 원근 모드 전환
• Ctrl + Alt + M: 뫼비우스 모드 전환
• Ctrl + Alt + 위/아래: 워프 강도 증가/감소
• Alt + PageUp/PageDown: 한 페이지 스크롤
• Alt + 위/아래: 한 줄 스크롤
• Ctrl + Alt + 0-9 (Shift 포함): 카메라 슬롯 0-9 활성화
• Ctrl + Alt + = / -: 폰트 크기 증가/감소
• Ctrl + Alt + 0: 폰트 크기 초기화

이 외에도 환경 설정 파일(ratty.toml)을 수정하여 커서 모델, 애니메이션 속도, 색상 등을 세부 조정할 수 있습니다.

이런 경우에 유용합니다

개발자나 시스템 관리자가 터미널 작업을 하면서 시각적 피드백이나 3D 모델링 결과를 실시간으로 확인하고 싶을 때 유용합니다. 예를 들어, 로봇 시뮬레이션이나 3D 모델의 회전 상태를 터미널 내에서 직접 시각화해야 하는 경우, 별도의 창을 켜지 않고도 작업 흐름을 유지하면서 확인이 가능합니다. 또한, 교육 목적에서 3D 그래픽이나 렌더링 파이프라인을 시연하는 데 활용할 수 있습니다.

지원 환경·시스템 요구사항

Ratty는 GPU와 호환되는 그래픽 스택이 필요하며, Bevy와 wgpu를 통해 동작합니다. 따라서 최신 그래픽 드라이버가 설치된 Windows 10 이상 시스템에서 정상적으로 작동합니다. 터미널 기능 자체는 PTY를 통해 구현되므로, Windows에서는 WSL이나 ConPTY 기반 환경이 권장됩니다.

최신 버전·업데이트

현재 최신 버전은 0.5.0이며, GitHub 저장소의 releases 페이지에서 확인할 수 있습니다. 업데이트는 새로운 바이너리를 다운로드하여 교체하는 방식으로 이루어집니다.

제한 사항·확인 사항

Ratty는 GPU 가속을 필수로 요구하므로, 그래픽 하드웨어가 오래되었거나 드라이버 지원이 부족한 환경에서는 정상적으로 실행되지 않을 수 있습니다. 또한, 인라인 3D 객체를 사용하려면 해당 모델 파일을 별도로 준비해야 하며, 기본 제공되는 객체는 스피닝 랫 커서뿐입니다.