Skip to main content
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

Interaction

InputAction
Left clickPet Jade
Right clickMenu: 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 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/)

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