https://github.com/ayuzur/cpond

procedurally animated fish for your terminal
https://github.com/ayuzur/cpond

Last synced: 3 months ago
JSON representation

procedurally animated fish for your terminal

• Host: GitHub
• URL: https://github.com/ayuzur/cpond
• Owner: ayuzur
• License: mit
• Created: 2025-06-10T04:43:49.000Z (about 1 year ago)
• Default Branch: main
• Last Pushed: 2025-11-23T11:05:45.000Z (7 months ago)
• Last Synced: 2025-11-23T13:05:37.543Z (7 months ago)
• Language: C
• Homepage:
• Size: 44.9 KB
• Stars: 31
• Watchers: 0
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

• awesome-cli-apps-in-a-csv - cpond - The program creates procedurally animated fish to swim around your terminal. (<a name="animation"></a>Animation)
• awesome-cli-apps - cpond - The program creates procedurally animated fish to swim around your terminal. (<a name="animation"></a>Animation)

README

          
# cpond

![image](https://github.com/user-attachments/assets/a8dddebd-af3d-4e20-a346-9742b1322300)

creates procedurally animated fish to swim around your terminal

> [!NOTE]

> Command line options have been added, including the option to use braille character drawing!

> See "usage" below.

## make

_note I used gcc_

1. git clone

2. ensure you have ncurses installed. (ncurses6 was used)

3. move into your local clone of the repo

4. run `make` to get the cpond executable

    - if you are on mac and run into issues try changing `-lncursesw` to `-lncurses` in the Makefile

## usage

- to run `./cpond`

- `-b or --braille` allows you to toggle the use of braille characters

    - This makes it so you don't have to zoom out (as far) to see the fish!

- `-c or --count` allows you to set the number of fish

- `--fps` allows you to change the fps by changing the delay between frames.

    - ex: `--fps 60` will set the delay between frames to 1s / 60.

while runnning

- type q to quit

- type p to toggle pause