BongoCat — Cross-Platform Interactive Desktop Pet

Introduction

BongoCat is a playful desktop pet application that places an animated cat on your screen. The cat reacts to your keyboard presses and mouse movements in real time. It is built with Vue for the frontend and Rust/Tauri for the native desktop shell, running on Windows, macOS, and Linux.

What BongoCat Does

• Displays an animated cat overlay on your desktop that follows keyboard and mouse input
• Reacts to key presses with paw-tapping animations in real time
• Tracks mouse movement so the cat follows your cursor position
• Runs as a lightweight always-on-top window with transparency support
• Provides customizable skins and appearance settings

Architecture Overview

BongoCat uses Tauri as its application framework, combining a Rust backend for system-level input listening with a Vue-based frontend for rendering the cat animations. The Rust layer captures global keyboard and mouse events without requiring accessibility permissions on most platforms, then passes them to the Vue UI via Tauri IPC. The frontend renders sprite-based animations tied to the detected input state.

Self-Hosting & Configuration

• Download prebuilt binaries from the GitHub releases page for Windows, macOS, or Linux
• Build from source by cloning the repo and running pnpm install then pnpm tauri build
• Configure the cat position, size, and opacity through the in-app settings menu
• Swap cat skins by placing custom sprite sheets in the designated assets folder
• Set the app to launch on system startup via your OS settings or the built-in option

Key Features

• Real-time input tracking: the cat responds to every keypress and mouse movement instantly
• Cross-platform: native builds for Windows, macOS, and Linux via Tauri
• Lightweight: small binary size and low resource usage compared to Electron-based pets
• Customizable skins: switch between different cat appearances and animation sets
• Always-on-top overlay: transparent window that stays visible over your workspace

Comparison with Similar Tools

• Shimeji: classic Java-based desktop pet; BongoCat is lighter and input-reactive
• Desktop Goose: a goose that disrupts your screen; BongoCat is non-intrusive and decorative
• RunCat: macOS menu bar cat that shows CPU usage; BongoCat reacts to input instead
• Bongo Cat (web): the original browser meme animation; this app brings it to the desktop natively

FAQ

Q: Does BongoCat use a lot of CPU or memory? A: No. Tauri apps are significantly lighter than Electron-based alternatives, and BongoCat idles at minimal resource usage.

Q: Can I create my own custom cat skin? A: Yes. You can replace the default sprite sheets with custom artwork following the template format provided in the repo.

Q: Does it work with Wayland on Linux? A: Wayland support depends on Tauri's windowing backend. X11 is fully supported; Wayland compatibility may vary by distribution.

Q: Is BongoCat open source? A: Yes, BongoCat is open source and available on GitHub under an MIT-style license.

Sources

• Repository: https://github.com/ayangweb/BongoCat
• Releases: https://github.com/ayangweb/BongoCat/releases