Desktop Pets
This is the source code of my macOS app Desktop Pets!.
As you can guess, it brings Desktop Pets to macOS ๐
Like the app? Join our Discord!
๐ฎ Supported Systems
The app is currently available for macOS and iOS (with slightly different features).
I'm working on a Python port using Qt, which will be targeting Windows and Linux systems.
๐ค What's a Desktop Pet?
It's just a cute little pet or animal that lives in your computer.
The most popular one was probably the eSheep for Windows 95.
Hope you like them too!
๐ฒ Get the app
For daily use I recommend getting the App from the App Store.
Alternatively, you can download the latest release from GitHub or build from source (see below).
๐ฅ Screenshots
๐จ Create custom pets
Starting from version 2.20 you can now create custom pets, please check the documentation.
You do not need any programming knowledge or Xcode to create your own pets, just design your characters and follow the instructions, good luck!
๐ Contribute
Contributors get a shout out in the app, just saying... ๐
If you wish to improve support for your language, join our Discord and let us know!
๐ Interoperability
Since version 2.48 you can use DistributedNotificationCenter to send basic commands to your pets.
Here's the payload:
{
# Species id
"subject": "sloth",
# Animation id
"action": "eat",
# Optional, both x and y required
"x": 100,
"y": 100
}Sample Python script to send out notifications:
from Foundation import NSDistributedNotificationCenter, NSDictionary
def send_notification():
notification_name = "it.curzel.pets.Api"
message = {...}
user_info = NSDictionary.dictionaryWithDictionary_(message)
center = NSDistributedNotificationCenter.defaultCenter()
center.postNotificationName_object_userInfo_deliverImmediately_(
notification_name, None, user_info, True
)
if __name__ == "__main__":
send_notification()๐ ๏ธ Build from Source
- Download and setup Xcode
- Open the
Sources/macOS/DesktopPets.xcworkspace - Give Xcode some time to figure out dependencies...
- Run