swoonqx / TypingPet

# 🐾 Typing Pet
**키보드를 칠 때마다 캐릭터가 손을 번갈아 들며 통통 튀는 Windows용 데스크톱 펫입니다.**
원하는 이미지를 사용해 나만의 캐릭터를 만들 수 있으며, 
GIF / APNG 애니메이션, 키·마우스 패턴, 프리셋, 멀티 펫 기능을 지원합니다.
> **Latest Version: v4.3.1**
❔FAQ/CONTACT 
📥 최신 버전 다운로드 · 📝 업데이트 내역
---
## ✨ 주요 기능
- ⌨️ 키보드 입력에 맞춰 캐릭터가 움직입니다.
- 🖼️ 원하는 이미지로 캐릭터를 변경할 수 있습니다.
- 🎞️ **PNG / JPG / GIF / APNG**를 지원합니다.
- 🎯 특정 키, 키 조합, 기능키 또는 마우스 클릭에 반응하는 **패턴을 최대 20개**까지 등록할 수 있습니다.
- ✍️ 스타일러스 펜 및 터치 입력을 클릭 패턴으로 사용할 수 있습니다.
- 💾 최대 10개의 **프리셋**을 저장하고, zip 파일로 내보내고 불러올 수 있습니다.
- 🐾 기본 펫 포함 **최대 4마리의 멀티 펫**을 동시에 띄울 수 있습니다.
- 🪟 여러 펫이 겹쳤을 때 표시 순서를 조절할 수 있습니다.
- 🎚️ 펫 전체의 **불투명도**를 조절할 수 있습니다.
- 👻 마우스를 올리면 펫이 잠시 **반투명**해집니다.
- 🌐 **한국어 / English / 日本語 / 简体中文**을 지원합니다.
- 🛠️ 오류 발생 시 `%AppData%\TypingPet\error.log`에 원인이 기록됩니다.
- 🔒 입력한 키의 내용은 저장하거나 전송하지 않습니다.
- 🌐 프로그램 자체는 인터넷에 접속하지 않습니다.
---
# 🆕 v4.3.1 업데이트
## 수정
- APNG / GIF 애니메이션이 파일에 적힌 속도보다 훨씬 느리게 재생되던 문제를 수정했습니다.
- 프리셋 `적용` 등에서 "기본 이미지를 찾을 수 없음" 오류가 나던 문제를 수정했습니다. 이제 `images` 폴더가 없어도 기본 이미지가 정상 동작합니다.
## 개선
- 이미지 변경이 실패하면 원인을 안내하고, 저장이 일시적으로 막힌 경우 자동으로 다시 시도합니다.
- 일부 이상한 APNG 파일도 첫 장면으로 적용할 수 있습니다.
- 펫을 최대 개수까지 띄운 경우, 다른 펫을 먼저 숨기라는 안내를 추가했습니다.
---
# 🆕 v4.3 업데이트
## 개선 / 추가
- **멀티 펫 최대 4마리**
 - 기본 펫을 포함해 최대 4마리까지 동시에 띄울 수 있습니다. (기존 최대 3마리)
- **패턴 최대 20개**
 - 패턴을 최대 20개까지 등록할 수 있습니다. (기존 최대 10개)
 - 새로 추가하는 패턴에는 다른 패턴과 겹치지 않는 기본 트리거가 자동으로 배정됩니다.
- **프리셋 내보내기 / 가져오기**
 - 프리셋을 zip 파일 하나로 내보내 보관하거나 다른 사람과 나눌 수 있습니다.
 - 프리셋 목록의 각 줄에 버튼이 추가되었습니다. 저장된 슬롯에는 `내보내기`, 빈 슬롯에는 `가져오기`가 표시됩니다.
자세한 버전별 변경사항은 `CHANGELOG.md`에서 확인할 수 있습니다.
---
# 📥 다운로드
Typing Pet은 **GitHub Releases**를 통해 배포합니다.
### 최신 버전
➡️ **GitHub Releases에서 다운로드**
Release 페이지의 Assets에서 `TypingPet.exe`를 다운로드한 뒤 실행하면 됩니다.
> 다른 사이트나 제3자가 배포한 파일보다는 **이 GitHub 저장소의 Releases에 등록된 파일**을 사용하는 것을 권장합니다.
---
# 🚀 실행
`TypingPet.exe`를 실행하면 화면 오른쪽 아래에 캐릭터가 나타나고 Windows 시스템 트레이에 Typing Pet 아이콘이 생성됩니다.
처음 직접 실행한 경우 설정 창이 한 번 자동으로 열립니다.
> Windows 시작 프로그램을 통해 자동 실행된 경우에는 설정 창이 자동으로 열리지 않습니다.
---
# 🖱️ 기본 사용법
캐릭터를 마우스로 드래그하면 원하는 위치로 이동할 수 있습니다.
**트레이 아이콘 또는 데스크톱 펫을 우클릭**하면 다음 메뉴를 사용할 수 있습니다.
| 메뉴 | 기능 |
|---|---|
| **설정...** | 설정 창을 엽니다. |
| **크기** | 작게 / 보통 / 크게 / 아주 크게 |
| **항상 위에 고정** | 다른 창보다 항상 위에 표시합니다. |
| **위치 잠금** | 마우스 입력이 캐릭터를 통과하며 드래그 이동을 막습니다. |
| **위치 초기화** | 캐릭터를 화면 오른쪽 아래로 되돌립니다. |
| **멀티 펫 겹침 순서** | 여러 펫이 겹쳐 있을 때 표시 순서를 변경합니다. |
| **종료** | Typing Pet을 종료합니다. |
추가로 띄운 펫을 우클릭하면 **맨 앞으로 가져오기** 및 **이 펫 숨기기** 등의 기능을 사용할 수 있습니다.
---
# ⚙️ 설정
설정 창은 다음 네 개의 탭으로 구성되어 있습니다.
- **기본 설정**
- **이미지 설정**
- **프리셋 설정**
- **레이어 설정**
설정 창 오른쪽 아래의 **설명서** 버튼을 누르면 프로그램 안에서도 주요 사용법을 확인할 수 있습니다.
설명서는 한국어 / English / 日本語 / 简体中文을 지원합니다.
---
## ⚙️ 기본 설정
### 크기
캐릭터의 표시 크기를 설정합니다.
- 작게
- 보통
- 크게
- 아주 크게
### 항상 위에 고정
켜면 캐릭터가 다른 창보다 항상 위에 표시됩니다.
끄면 일반적인 창처럼 다른 프로그램 뒤로 이동할 수 있습니다.
### 위치 잠금
켜면 마우스 클릭이 캐릭터를 통과하며 캐릭터를 드래그해서 이동할 수 없게 됩니다.
### 위치 초기화
캐릭터를 화면 오른쪽 아래의 기본 위치로 되돌립니다.
---
## 💫 흔들림
타이핑할 때 캐릭터가 움직이는 정도를 설정합니다.
| 설정 | 동작 |
|---|---|
| **없음** | 위치는 움직이지 않고 이미지만 바뀝니다. |
| **1단계** | 약하게 움직입니다. |
| **2단계** | 중간 정도로 움직입니다. |
| **3단계** | 가장 크게 움직입니다. 기존 방식과 같은 움직임입니다. |
v4.1에서는