Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/AngelJumbo/lavat
Lava lamp simulation using metaballs in the terminal
https://github.com/AngelJumbo/lavat
lavalamp metaballs ncurses simulation
Last synced: 12 days ago
JSON representation
Lava lamp simulation using metaballs in the terminal
- Host: GitHub
- URL: https://github.com/AngelJumbo/lavat
- Owner: AngelJumbo
- License: mit
- Created: 2022-10-17T01:03:39.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2024-01-25T03:53:32.000Z (about 1 year ago)
- Last Synced: 2024-09-26T01:47:04.408Z (4 months ago)
- Topics: lavalamp, metaballs, ncurses, simulation
- Language: C
- Homepage:
- Size: 20.1 MB
- Stars: 342
- Watchers: 1
- Forks: 4
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-terminal-art - lavat
README
# lavat
Little program that simulates a lava lamp in the terminal.
## Installation
Requirements: A Unix-like system, a C compiler and make.
```
git clone https://github.com/AngelJumbo/lavat
cd lavat
make install
```
### Arch Linux
Lavat is also available on the AUR [here](https://aur.archlinux.org/packages/lavat-git). Install it with your favourite AUR-helper or manually.
```
$ paru -S lavat-git
```
## Usage
```
Usage: lavat [OPTIONS]
OPTIONS:
-c Set color. Available colours: red, blue, yellow, green, cyan, magenta, white and black.
-s Set the speed, from 1 to 10. (default 5)
-r Set the radius of the metaballs, from 1 to 10. (default: 5)
-R Set a rim for each metaball, sizes from 1 to 5.(default: none)
This option does not work with the default color
If you use Kitty or Alacritty you must use it with the -k option to see the rim.
-k Set the color of the rim if there is one. Available colours: red, blue, yellow, green, cyan, magenta, white and black.
-b Set the number of metaballs in the simulation, from 5 to 20. (default: 10)
-F Allows for a custom set of chars to be used
Only ascii symbols are supported for now, wide/unicode chars may appear broken.
-C Retain the entire lava inside the terminal.
It may not work well with a lot of balls or with a bigger radius than the default one.
-p PARTY!! THREE MODES AVAILABLE (p1, p2 and p3).
-h Print help.
RUNTIME CONTROLS:
i Increase radius of the metaballs.
d Decrease radius of the metaballs.
shift i Increase rim of the metaballs.
shift d Decrease rim of the metaballs.
m Increase the number of metaballs.
l Decrease the number metaballs.
c Change the color of the metaballs.
k Change the rim color of the metaballs.
+ Increase speed.
- Decrease speed.
p TURN ON THE PARTY AND CYCLE THROUGH THE PARTY MODES (it can also turns off the party).
(Tip: Zoom out in your terminal before running the program to get a better resolution of the lava).
```
## Demo
`lavat -p3`
PARTY MODE!!!
`lavat -c red -R 1`
`lavat -c cyan -R 4 -b 20 -r 2`
If you send more than one character to the -F option you can have 3d-ish effect.
`lavat -c blue -R2 -F @@:::::: -r10`
For the Alacritty and Kitty users I know that the -R option haven't been working for you, but now you can set the color of the rim independently. Try:
`lavat -c yellow -R1 -k red`
(The colors depend on your color scheme.)
## Credits
- This program is made with [Termbox2](https://github.com/termbox/termbox2).
- [Lava lamp in JavaScript](https://codeguppy.com/site/tutorials/lava-lamp.html)