otter-jade - Otter Shell

otter-jade is a desktop pet otter. Jade hatches from an egg, then grows through pup and teen to adult. Jade walks the screen edges and reacts to pointer input.

Usage

otter-jade

Optional autostart. Add it to compositor autostart if you want Jade at login.

# Reset persisted state on launch
otter-jade --reset

# Non-persistent demo mode
otter-jade --demo

Interaction

Input	Action
Left click	Pet Jade
Right click	Menu: feed, clean, nap, quit

Growth and care

Four stages: egg, pup, teen, adult
Sprite animations for idle, walk, sleep, happy, hungry, dirty, eating, cleaning, petting, and more
Hunger, cleanliness, and mood change how Jade behaves. They are not shown as meters.
Random color and rare shiny rolls when the egg hatches
State stored at $XDG_STATE_HOME/otter-shell/otter-jade.state (fallback: $HOME/.local/state/otter-shell/)

Configuration

Config file: ~/.config/otter-shell/otter-jade.conf

size = 96
fps = 60
movement_speed = 90
idle_pose_interval_ms = 2700
edge_bias_percent = 55
margin = 24
shiny_odds = 4096

Edit this in otter-settings or in the config file.