mirror of
https://github.com/AngelJumbo/lavat.git
synced 2024-11-16 04:36:40 +00:00
89 lines
3.4 KiB
Markdown
89 lines
3.4 KiB
Markdown
# 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 <COLOR> Set color. Available colours: red, blue, yellow, green, cyan, magenta, white and black.
|
|
-s <SPEED> Set the speed, from 1 to 10. (default 5)
|
|
-r <RADIUS> Set the radius of the metaballs, from 1 to 10. (default: 5)
|
|
-R <RIM> 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 <COLOR> Set the color of the rim if there is one. Available colours: red, blue, yellow, green, cyan, magenta, white and black.
|
|
-b <NBALLS> Set the number of metaballs in the simulation, from 5 to 20. (default: 10)
|
|
-F <CHARS> 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 <MODE> 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)
|