CappyHappy Details

Info-dump of everything you need to know about CappyHappy, and more.

This is, like, our sacred text, except it's written by one of us who yaps too much.

Buy now! Back home

Table of Contents

What is CappyHappy?

CappyHappy is a capybara desktop pet that likes to mess about. Cappy will walk around, sit and lie down, and sometimes steal your mouse. He needs special care to keep his stats up, and if they go too low, Cappy may die - so keep him alive as long as possible.

Who is CappyHappy?

Cappy is the capybara (with two 'p's) that causes mischief on your screen.

But who makes Cappy?

Well, we are Pineapple Works, a group based in Sydney, Australia, and we make fun tech stuff for the world in our free time. Join the Pineapple Works community and make our projects better! We have a Discord, and the CappyHappy-Hub GitHub Repo is for suggesting features and reporting bugs. If you have any issues, we will be more than happy to help - shoot us an email.

Why is CappyHappy?

We created CappyHappy as our first project to give us something fun to work on and progress our coding skills. We chose it because desktop pets were popular but not distracting and interactive enough. That might be a good thing, but many people like being distracted!

We were inspired by, of course, Samperson's Desktop Goose, and the Tamagotchi devices, and tried to recreate the interactivity of a Tamagotchi in a Desktop-Goose-style pet. We had been obsessed with capybaras, and the online community seemed to share our sentiment. So we brought these together and after a lot of coding, designing, racking our brains, and frankly some ChatGPT assistance, we ended up with CappyHappy.

We had to give up on our plans to make CappyHappy 'free and open source' due to financial priorities. However, f the project ever dies, we'll be sure to release it under GPL or MIT. For now, make sure you abide to our strict proprietary license.

The Interface

Launch the app and you'll see Cappy immediately spawn in and wander around your screen.

Click the hut icon in the menu bar (the hut where Cappy lives!) and you'll see the hut window. This is the main control centre of CappyHappy. At the top, you'll see 4 tabs:

Statistics

The stats tab shows Cappy's health. As of now, there are 4 measurements.

  • Hunger drops over time - you'll need to feed Cappy carrots to keep the hunger bar up. Yes, more hunger is good. Don't ask.
  • Hygiene corresponds to the amount of sh*ts on screen. Cappy takes a sh*t every now and then. Each sh*t minuses 10 hygiene points, so clean them up quickly with the broom! 10 sh*ts and Cappy dies from poor cleanliness.
  • Energy drops over time - you'll need to put Cappy to sleep to replenish it. The longer Cappy sleeps, the more energy is replenished... but there's a maximum amount you can get per sleep, so don't think that you can get away from Cappy's antics!
  • Finally, disease starts from 0 and is bumped up occasionally but greatly with every virus. More disease is bad, so vaccinating Cappy decreases his disease level, by strengthening his immune system and preventing future infection.
  • Of course, the age statistic shows how long Cappy has been alive in your current run. Quitting the app will pause this, so you can't cheat. Keep Cappy alive for as long as possible!

Health is an average of all these scores. Keep this high.

Cappy will die if its health drops below 25, or if any of these drop to 0! (except for disease - it's 100 instead.)

The Statistics window, with 5 meter bars (health, hunger, hydiene, energy and disease) displaying Cappy's health stats, as well as Cappy's age.

Interactions

The interactions tab allows you to interact with Cappy to keep health stats up!

Clicking on an interaction will spawn an item at your cursor. Long-hold it on top of Cappy to use it, and right-click it to cancel.

  • You can feed Cappy a carrot to replenish 10 hunger.
  • Vaccinating Cappy resets the disease level... for some reason. Uhhhhm - it means immunity, okay?
  • You can also put the capybara to sleep with a pillow. This is good to take a little break from Cappy's antics, and the more time spent sleeping, the more energy recovered... with a cap, of course. You also can't to do anything else while Cappy's asleep. Every other interaction will disappear, and you have to awaken the capybara to resume the normal events.
  • Finally, you can clean up Cappy's sh*t with the broom. This corresponds to the hygiene level - 10 sh*ts on screen equals death, so don't let them pile up!

Remember, once you're holding the item, long-click the capybara (or the poop) with it until it disappears. To cancel, right-click.

The Interactions window, with 4 interaction buttons (Feed, Vaccinate, Put to Sleep and Sweep Droppings) and a close button.

Credits

  • Libraries used:
    • PyQtDarkTheme (MIT, Copyright © 2021 Yunosuke Ohsugi)
    • Pillow (MIT-CMU, Copyright © 2010 by Jeffrey A. Clark and contributors. Friendly fork of PIL: Copyright © 1997-2011 by Secret Labs AB and 1995-2011 by Fredrik Lundh and contributors)
    • PySide6 (LGPL v3, Copyright © 2018 The Qt Company Ltd.)
    • PyAutoGUI (BSD-3-Clause, Copyright © 2014, Al Sweigart)
    • PyGame (LGPL v2, Copyright © 2000 Pete Shinners)
    • screeninfo (MIT, Copyright © 2015 Marcin Kurczewski)
    • PyGetWindow (BSD, Copyright © 2015, Al Sweigart)
  • Assets used:
    • Broom graphic: SVG Repo (CC0)
    • Pillow graphic: IonutNeagu on SVG Repo (Public Domain)
    • Excretion sound: RichardDooDee23 on Pixabay (Pixabay Content License)
    • Vaccination sound: FreeSoundsxx on Pixabay (Pixabay Content License)
  • License

    SOFTWARE LICENSE AGREEMENT

    Copyright (c) 2025 capta1nt0ad, mrpiggy105, and pineappl-e. All rights reserved.

    This software and its accompanying materials (collectively, the "Software") are the proprietary property of capta1nt0ad, mrpiggy105, and pineappl-e, and are protected by applicable copyright laws and international treaties.

    By installing, copying, or otherwise using the Software, you agree to be bound by the terms of this License Agreement:

    1. GRANT
    You are granted a non-exclusive, non-transferable, revocable license to install and use the Software solely for your personal or internal business purposes.

    2. RESTRICTIONS
    You may NOT:
        (a) Copy, distribute, publish, or share the Software with any third party.
        (b) Modify, reverse engineer, decompile, or disassemble any part of the Software.
        (c) Sell, sublicense, rent, lease, or otherwise exploit the Software for commercial purposes.

    3. OWNERSHIP
    The Software is licensed, not sold. All rights, title, and interest in and to the Software, including all intellectual property rights, remain with capta1nt0ad, mrpiggy105, and pineappl-e.

    4. TERMINATION
    This license is effective until terminated. It will terminate automatically and without notice if you fail to comply with any term of this Agreement. Upon termination, you must permanently delete or destroy all copies of the Software in your possession.

    5. DISCLAIMER OF WARRANTY
    The Software is provided "AS IS" without warranty of any kind, express or implied, including but not limited to the implied warranties of merchantability, fitness for a particular purpose, and non-infringement.

    6. LIMITATION OF LIABILITY
    In no event shall capta1nt0ad, mrpiggy105, or pineappl-e be liable for any direct, indirect, incidental, special, or consequential damages arising out of or in connection with the use or inability to use the Software.

    For licensing or legal inquiries, contact: pineappleproductions.enquiries@gmail.com.

    Prices in your local currency, with Exchange Rate API