A peaceful ASCII fishbowl screensaver for your terminal.
Watch fish swim, bubbles rise, and seaweed sway — right in your terminal.
~.~'~.~'~.~'~.~'~.~'~.~'~.~'~.~'
° o °
><> ~(°o°)~ °
><))°> ><> ><> <°((<>
° ><> }°{
<>< ><))°> <°((<>
° o V('.')V
)| {| ~/~ ()() ~/~ | ~/~
─═──·─|_________|──♦──═──☆──═─
gh extension install maxbeizer/gh-fishbowlgh fishbowl # just vibes
gh fishbowl --theme halloween # spooky season 🎃
gh fishbowl --repo owner/name # repo stats as decorations
gh fishbowl -R auto # stats from current repoPress any key or Ctrl+C to exit. Press i to swim! 🏊
| Flag | Default | Description |
|---|---|---|
--fps |
10 |
Animation frames per second |
--fish |
auto | Number of fish (auto-scales to terminal size) |
--no-bubbles |
false |
Disable rising bubbles |
--no-seaweed |
false |
Disable seaweed and bottom decorations |
--theme |
auto |
Seasonal theme: auto|halloween|winter|spring|summer |
--repo, -R |
GitHub repo (owner/name or auto) to show stats as decorations |
Minnows, angelfish, pufferfish, whales, jellyfish, crabs, turtles, octopi, seahorses, swordfish, starfish — all with animated sprites and left/right variants. ~15% spawn with ANSI color (gold, cyan, magenta...).
Rising from the floor and puffed from fish mouths, with gentle lateral drift.
Swaying seaweed (3 styles), treasure chest, castle, coral reefs, anchor, starfish and shell decorations on a sandy floor.
Minnows swim in V-formation, turning together with a slight delay.
Press i to take control of a bright yellow player fish. Swim with arrow keys!
Background fish are dim and slow. Foreground fish are bold and fast. Creates a 3D layered feel.
The water surface changes based on your local time — bright ripples by day, soft dots at night.
- Halloween (Oct): ghost fish, bats, skull-fish, spooky decorations
- Winter (Dec–Feb): penguins, narwhals, snowflake bubbles ❄
- Spring (Mar–May): butterflies, frogs, tadpoles, flower decorations ❀
- Summer (Jun–Aug): sunfish, clownfish, tropical vibes
Pass --repo owner/name to scatter starfish (☆) for stars and tridents (Ψ) for forks. Use --repo auto (or -R auto) to detect the repo from your current git checkout.
make help # see all targets
make build # build binary
make ci # build + vet + test-race
make install-local # install from checkout
make relink-local # reinstall after changesgit tag v0.1.0
git push origin v0.1.0MIT