🐉 Konqi Pet

A chaotic desktop pet for Linux — starring KDE's own mascot

He walks. He climbs. He judges you. He has opinions about your tab count.

     

Install · What he does · Usage · Config · Custom sprites

---

Konqi is KDE's official mascot. He lives on your desktop now. He was not asked.

He walks around your screen, climbs the edges, falls off things, and falls asleep when you're boring. Every few seconds something random happens — he teleports, trips over nothing, summons a second copy of himself to argue with, or writes a bad poem about whatever you have open. He watches which apps you use and his opinions escalate the longer you stay in them.

---

✨ What he does

🚶 Moves like he means it	Full physics — gravity, wall-climbing, falling, and bouncing
👀 Watches your apps	Reacts to 200+ specific window titles with unique dialogue
📈 Escalates	Two minutes open is a comment. Two hours is a confrontation.
💥 Causes chaos	Teleport, spin, drift, shake, dive, trip, glitch, stare, scribble, summon twin
✍️ Writes bad poems	About whatever you have open. They are not good.
🎮 Plays tic-tac-toe	And gets smug about it (the AI is unbeatable)
🌡️ Reacts to your system	CPU load, notifications, typing speed, even your wallpaper colour
🧠 Remembers you	Comfort level builds across sessions — he greets you differently over time

Tip

To reset his opinion of you, delete ~/.local/share/konqi-pet/gremlin_memory.json. (They will re-form quickly.)

---

📦 Install

One line — clones the repo, sets up a venv, and adds him to your app menu:

curl -fsSL https://raw.githubusercontent.com/rostikcermak-pixel/Konqi-Pet/main/install.sh | bash

Manual install

git clone https://github.com/rostikcermak-pixel/Konqi-Pet
cd Konqi-Pet
pip install PyQt6 Pillow psutil
python3 main.py

Steam Deck / SteamOS

pip install --break-system-packages PyQt6 Pillow psutil
python3 main.py

Flatpak (build it yourself)

See flatpak/README.md for details.

flatpak install -y flathub org.kde.Platform//6.8 org.kde.Sdk//6.8
flatpak-builder --user --install --force-clean build-dir \
    flatpak/io.github.rostikcermak_pixel.KonqiPet.yaml
flatpak run io.github.rostikcermak_pixel.KonqiPet

Note

Dependencies: Python 3.10+, PyQt6 (or PyQt5), Pillow. psutil is optional but recommended (CPU/RAM reactions). xdotool enables app detection.

---

⚡ Usage

python3 main.py                  # normal mode
python3 main.py --hyper          # faster, more chaotic
python3 main.py --count 3        # spawn 3 at once
python3 main.py --quiet          # no speech bubbles
python3 main.py --no-chaos       # just a normal walking dragon

Right-click Konqi for the full menu — speed, mode, chaos triggers, tic-tac-toe, tips, autostart, and updates.

---

🎨 Sprites

Walking	Idle	Sleeping	Climbing

Every animation — walk, idle, sleep, climb, fall, stretch, wave, look-around — is generated automatically from these four source PNGs. No sprite sheets to draw.

---

🖌️ Custom sprites

Drop any PNG into assets/ and run:

python3 import_sprite.py your_sprite.png
python3 main.py

Replace any of the four source sprites and restart — frames regenerate automatically:

File	Used for
assets/konqi_walk.png	Walking
assets/konqi_idle.png	Idle, pointing, waving
assets/konqi_sleep.png	Sleeping
assets/konqi_climb.png	Climbing walls

---

⚙️ Config

User settings live in ~/.config/konqi-pet/config.json (shipped defaults are in config.json):

Key	Default	What it does
behavior_mode	"calm"	"calm" or "hyper"
chaos_mode	true	Enables the whole gremlin brain
quiet_mode	false	Suppresses speech bubbles
sound_effects	false	Footsteps, bounce, pop sounds
spawn_count	1	How many spawn on startup
fps	60	Animation framerate
cpu_reactions	true	Reacts when CPU is high

---

📝 Notes

• Works on X11 and XWayland. On pure Wayland without XWayland, movement works but app detection (xdotool) won't.
• Tested on KDE, GNOME, and SteamOS.
• The "useless PC tips" are fake. Please do not defragment your SSD.

---

📜 License

Code: MIT  ·  Konqi artwork: CC-BY-SA © KDE Contributors

Made for people who think their desktop is too calm.