{"id":15137919,"url":"https://github.com/cxreiff/lifecycler","last_synced_at":"2025-05-16T07:06:56.225Z","repository":{"id":249457169,"uuid":"831512511","full_name":"cxreiff/lifecycler","owner":"cxreiff","description":"Bevy Game Jam #5 submission. Terminal aquarium.","archived":false,"fork":false,"pushed_at":"2024-10-16T01:47:21.000Z","size":1655,"stargazers_count":167,"open_issues_count":1,"forks_count":3,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-05-12T20:17:22.285Z","etag":null,"topics":["aquarium","bevy","game","gamejam","terminal-game"],"latest_commit_sha":null,"homepage":"https://cxreiff.itch.io/lifecycler","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/cxreiff.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE-Apache-2.0.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-07-20T19:18:02.000Z","updated_at":"2025-05-08T06:13:57.000Z","dependencies_parsed_at":"2024-10-18T04:05:16.842Z","dependency_job_id":null,"html_url":"https://github.com/cxreiff/lifecycler","commit_stats":{"total_commits":32,"total_committers":2,"mean_commits":16.0,"dds":0.03125,"last_synced_commit":"29b9e90546998eebea9d87599162979c73aa49bd"},"previous_names":["cxreiff/lifecycler"],"tags_count":20,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cxreiff%2Flifecycler","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cxreiff%2Flifecycler/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cxreiff%2Flifecycler/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cxreiff%2Flifecycler/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/cxreiff","download_url":"https://codeload.github.com/cxreiff/lifecycler/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254485064,"owners_count":22078767,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["aquarium","bevy","game","gamejam","terminal-game"],"created_at":"2024-09-26T07:03:33.580Z","updated_at":"2025-05-16T07:06:51.185Z","avatar_url":"https://github.com/cxreiff.png","language":"Rust","funding_links":[],"categories":["\u003ca name=\"screensaver\"\u003e\u003c/a\u003eScreen savers"],"sub_categories":[],"readme":"# lifecycler\n\n[_bevy game jam #5 submission_](https://itch.io/jam/bevy-jam-5)\n\n![logo](https://assets.cxreiff.com/github/lifecycler.png)\n\nAn aquarium that runs in your terminal!\n\nA decoration/fidget-toy that lets you watch your fishes' lifecycle while you code. Test drive of my plugin [bevy_ratatui_render](https://github.com/cxreiff/bevy_ratatui_render), a plugin that lets you render a bevy application to the terminal using [ratatui](https://github.com/ratatui-org/ratatui)/[ratatui-image](https://github.com/benjajaja/ratatui-image).\n\n## play with cargo\n\nIf you have [cargo](https://github.com/rust-lang/cargo) installed, you can simply run the following:\n\n```sh\ncargo install lifecycler --locked\n```\n\n...and then to launch the game:\n\n```sh\nlifecycler\n```\n\n## controls\n\n|                    |                            |\n|--------------------|----------------------------|\n| Left Click or Drag | Dispense a food pellet.    |\n| Space Bar          | Toggle day/night modes.    |\n| M                  | Mute/unmute sound effects. |\n| Q                  | Quit the game.             |\n\n## resolution\n\nThe 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.\n\n## other install methods\n\n### distro packages\n\n#### AUR\n\nArch Linux users can also install [from the AUR](https://aur.archlinux.org/packages/lifecycler) using an [AUR helper](https://wiki.archlinux.org/title/AUR_helpers):\n\n```sh\nparu -S lifecycler\n```\n\n### manually\n\nAlternatively you can manually download an executable from the [itch.io page](https://cxreiff.itch.io/lifecycler) or [github releases](https://github.com/cxreiff/lifecycler/releases).\n\nIf you manually installed the executable, you will have to include the path to launch it (e.g. `./lifecycler` if in the same directory).\n\nOn macOS you may need to Right-Click \u003e Open With, selecting a supported terminal, and then selecting Open in order to bypass code signing (I haven't figured out code signing yet).\n\n## issues\n\nI am still hunting down platform-specific problems with rendering and input- if you run into one, please open an issue!\n\n## compatibility\n\nThis requires that your terminal:\n\n1. Supports 24bit color.\n2. Has reasonably efficient rendering.\n\nThis includes a decent variety of terminals, but I have personally confirmed good results in the following:\n\n- Alacritty\n- Kitty\n- WezTerm\n- iTerm2\n\n## gifs\n\n![day mode](https://assets.cxreiff.com/github/lifecycler_day.gif)![night mode](https://assets.cxreiff.com/github/lifecycler_night.gif)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcxreiff%2Flifecycler","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcxreiff%2Flifecycler","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcxreiff%2Flifecycler/lists"}