#terminal #bevy #ratatui #aquarium #tui

bin+lib lifecycler

Bevy Game Jam #5 submission, terminal aquarium

10 releases

0.2.9 Oct 16, 2024
0.2.8 Sep 20, 2024
0.2.7 Aug 1, 2024
0.2.5 Jul 31, 2024

#143 in Games

Download history 708/week @ 2024-07-29 38/week @ 2024-08-05 18/week @ 2024-08-12 1/week @ 2024-08-19 178/week @ 2024-09-16 87/week @ 2024-09-23 15/week @ 2024-09-30 7/week @ 2024-10-07 164/week @ 2024-10-14 10/week @ 2024-10-21 6/week @ 2024-11-04

181 downloads per month

MIT OR Apache-2.0 OR CC0-1.0

2MB
1.5K SLoC

lifecycler

bevy game jam #5 submission

logo

An aquarium that runs in your terminal!

A decoration/fidget-toy that lets you watch your fishes' lifecycle while you code. Test drive of my plugin bevy_ratatui_render, a plugin that lets you render a bevy application to the terminal using ratatui/ratatui-image.

play with cargo

If you have cargo installed, you can simply run the following:

cargo install lifecycler --locked

...and then to launch the game:

lifecycler

controls

Left Click or Drag Dispense a food pellet.
Space Bar Toggle day/night modes.
M Mute/unmute sound effects.
Q Quit the game.

resolution

The resolution is determined by the character-wise dimensions of your terminal- so zoom out in your terminal for more detail, zoom in for a more pixelated look.

other install methods

distro packages

AUR

Arch Linux users can also install from the AUR using an AUR helper:

paru -S lifecycler

manually

Alternatively you can manually download an executable from the itch.io page or github releases.

If you manually installed the executable, you will have to include the path to launch it (e.g. ./lifecycler if in the same directory).

On macOS you may need to Right-Click > Open With, selecting a supported terminal, and then selecting Open in order to bypass code signing (I haven't figured out code signing yet).

issues

I am still hunting down platform-specific problems with rendering and input- if you run into one, please open an issue!

compatibility

This requires that your terminal:

  1. Supports 24bit color.
  2. Has reasonably efficient rendering.

This includes a decent variety of terminals, but I have personally confirmed good results in the following:

  • Alacritty
  • Kitty
  • WezTerm
  • iTerm2

gifs

day modenight mode

Dependencies

~52–91MB
~1.5M SLoC