otter-jade

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

Usage

otter-jade

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

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

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

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

Four stages: egg, pup, teen, adult
Sprite animations for idle, walk, sleep, happy, hungry, dirty, eating, cleaning, petting, and more
Hunger, cleanliness, and mood affect behavior, not 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/)

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 via otter-settings or directly in the config file.

⌘I