설치하기

설치 파일은 GitHub 릴리스에서 받아요. 파일 이름은 PlayPets_버전_운영체제.확장자 꼴이에요.

macOS와 Windows에서 실행 경고가 뜰 수 있어요

지금 배포 파일에는 코드 서명이 없고, macOS 앱에는 공증도 없어요. Gatekeeper나 SmartScreen이 경고하거나 실행을 막을 수 있어요. 이 검사만으로 파일이 안전하다고 확인되는 것은 아니에요. 공식 릴리스 페이지에서 받은 파일을 신뢰할 때만 계속해 주세요. 쓸 수 있는 버튼은 운영체제와 기기 정책에 따라 달라요. 서명은 계획에 있어요.

macOS 0.1.0부터

파일	대상
PlayPets_버전_macos-universal.dmg	Apple Silicon과 Intel 모두

1. dmg를 열고 PlayPets를 응용 프로그램 폴더로 끌어 놓아요.
2. PlayPets를 열어 봐요. 개발자를 확인할 수 없거나 앱을 검증할 수 없다는 안내가 뜨면 닫아요.
3. 시스템 설정 > 개인정보 보호 및 보안으로 가서 PlayPets에 대한 안내와 그래도 열기를 찾아요.
4. 그 버튼이 있고 받은 파일을 신뢰한다면 그래도 열기를 눌러요. 인증을 요청하면 확인하고, 다음 안내에서 열기를 눌러요. macOS가 이 앱을 예외로 저장해요.

이 순서는 Apple의 안전하게 앱 열기 안내를 따라요. 컴퓨터를 손상시킨다는 경고가 뜨면 개발자를 확인할 수 없다는 경고와 같은 경우로 다루지 마세요. 관리되는 기기에서는 앱 실행이 제한될 수 있어요.

Windows 0.1.0부터

파일	대상
PlayPets_버전_windows-x64-setup.exe	일반 PC(x64) 설치 파일
PlayPets_버전_windows-arm64-setup.exe	ARM PC 설치 파일
PlayPets_버전_windows-x64-portable.zip, …_windows-arm64-portable.zip	설치 없이 풀어서 실행

1. 설치 파일을 실행해요. 알 수 없는 앱에 대해 SmartScreen이 "Windows의 PC 보호" 창을 띄우면 공식 릴리스 페이지에서 받은 파일인지 확인해요.
2. 받은 파일을 신뢰한다면 추가 정보를 눌러 쓸 수 있는 선택지를 봐요.
3. 실행 버튼이 있다면 눌러 설치를 이어 가요. 버튼이 없으면 기기의 보안 설정이나 조직 정책으로 실행이 제한된 것일 수 있어요.
4. 언어 선택 창에서 한국어·영어·일본어·중국어 간체 중 하나를 고르고 설치를 진행해요.

포터블 zip은 원하는 폴더에 풀고 playpets.exe를 실행하면 돼요. 같은 알 수 없는 앱 경고가 뜰 수 있어요. SmartScreen은 파일과 게시자의 평판을 확인하므로 새 버전에서 다시 경고할 수 있어요. 자세한 내용은 Microsoft의 SmartScreen 평판 안내에 있어요. 보안 기능은 켜 두세요. 악성 프로그램 경고는 알 수 없는 앱 경고와 다른 경우예요.

ARM PC(스냅드래곤 등)에서는 arm64 파일을 쓰세요. x64 파일도 에뮬레이션으로 돌아가지만, 그 설치·제거 프로그램은 실행 중인 PlayPets를 대신 닫지 못해요. 먼저 트레이에서 종료해 주세요.

TIP

Windows 빌드는 가상 머신에서 확인했지만, 실제 기기에서는 아직 충분히 확인하지 않았어요. 이상한 점이 보이면 GitHub 이슈로 알려 주세요.

Linux 0.1.0부터

파일	대상
PlayPets_버전_linux-x64.deb, …_linux-arm64.deb	Debian, Ubuntu 계열
PlayPets_버전_linux-x64.AppImage, …_linux-arm64.AppImage	호환되는 Linux 배포판

deb는 패키지 관리자로 설치해요. AppImage는 실행 권한을 주고 바로 실행해요.

chmod +x PlayPets_*.AppImage
./PlayPets_*.AppImage

Linux에서 알아 둘 것

• AppImage는 FUSE 2가 필요해요. Ubuntu 22.04에서는 sudo apt install libfuse2로 설치하고, Ubuntu 24.04에서는 이름이 바뀐 패키지인 sudo apt install libfuse2t64를 사용해요. 다른 배포판은 AppImage의 FUSE 안내를 확인해 주세요. FUSE 없이 실행하려면 ./PlayPets_*.AppImage --appimage-extract-and-run을 사용해요.
• 창을 닫으면 앱은 트레이에 남아요. GNOME은 트레이 아이콘을 기본으로 보여 주지 않으니 "AppIndicator and KStatusNotifierItem Support" 확장을 켜 주세요. 아이콘이 안 보여도 앱을 다시 실행하면 놀이터 창이 돌아와요.
• API 키는 Secret Service(GNOME Keyring, KWallet)에 저장해요. 없는 환경에서는 키가 필요한 연결을 저장할 때 보안 저장소에 접근할 수 없다는 안내가 떠요. Ollama와 구독 CLI는 키가 없어서 상관없어요.

업데이트 0.1.0부터

• 설정 탭 PlayPets 정보의 업데이트 확인, 트레이 메뉴의 업데이트 확인…, macOS 메뉴 막대의 **PlayPets → 업데이트 확인…**으로 지금 확인할 수 있어요.
• 놀이터 하단 바의 맨 왼쪽, 장소 선택 앞에 새 버전 버튼이 나타나요. 메뉴 안의 설정에도 점이 보여요. 버튼을 누르면 업데이트 창에서 새로운 점 보기, 나중에, 설치하고 다시 시작 중에 골라요. 같은 창에서 다운로드 진행률, 서명 확인, 설치 단계를 볼 수 있고 실패하면 다시 시도할 수 있어요. 업데이트 후 다시 시작하면 설치된 버전을 알림으로 잠깐 보여 줘요.
• 앱이 시작한 뒤 20초가 지나면 한 번 조용히 확인해요. 새 버전이 있으면 알림이 뜨고, 설정 탭에서 설치할 수 있어요.
• 새 버전은 GitHub 릴리스의 latest.json에서 찾아요. 받은 파일은 업데이트 서명 키로 검증한 뒤에만 설치해요. 검증에 실패한 파일은 설치하지 않아요.
• Windows 포터블 zip은 자동 업데이트 대상이 아니에요. 새 zip을 받아 바꿔 주세요.

제거

운영체제	방법
macOS	응용 프로그램 폴더의 PlayPets를 휴지통으로 옮겨요
Windows 설치 파일	설정 > 앱에서 PlayPets를 제거해요
Windows 포터블	풀어 둔 폴더를 지워요
Linux deb	설치할 때 쓴 패키지 관리자로 제거해요
Linux AppImage	파일을 지워요

앱을 지워도 아래 데이터 폴더는 남아요. 설정과 가져온 펫까지 모두 지우려면 데이터 폴더도 함께 지워 주세요.

데이터 폴더 0.1.0부터

운영체제	위치
macOS	~/Library/Application Support/app.playpets/
Windows	%APPDATA%\app.playpets\
Linux	~/.local/share/app.playpets/

안에는 state.json(친구와 설정), bridge.json(에이전트 연동용 포트와 토큰), pets/(가져온 펫), builtin/(기본 펫 세 개)가 있어요. 다른 곳에 두고 싶으면 환경 변수 PLAYPETS_DATA에 폴더 경로를 넣고 앱을 실행하면 돼요. 자세한 내용은 설정에 있어요.