Sakana

A desktop pet for macOS — a little fish (or your own character) that sways and bounces on your screen. Inspired by sakana-widget.

Features

• Physics-based swaying animation with spring dynamics
• Custom character image support
• Always-on-top or normal window level
• Multi-screen placement
• Drag-to-interact — grab and pull the character

Requirements

• macOS 14+
• Swift 5.9

Build & Run

swift build
swift run

Settings

Click the menu bar icon → Settings… (⌘,) to configure:

• Character Image — choose a custom PNG/JPEG, or remove to use the default
• Window — toggle always-on-top
• Position — pick a screen and set the distance from its bottom‑right corner

License

MIT