Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/esimov/ascii-fluid
Terminal based ASCII fluid simulation controlled by your webcam. 🌊
https://github.com/esimov/ascii-fluid
face-detection fluid-simulation fluid-solver golang navier-stokes tcell terminal wasm webassembly webcam
Last synced: 23 days ago
JSON representation
Terminal based ASCII fluid simulation controlled by your webcam. 🌊
- Host: GitHub
- URL: https://github.com/esimov/ascii-fluid
- Owner: esimov
- License: mit
- Created: 2019-11-20T13:33:11.000Z (about 5 years ago)
- Default Branch: master
- Last Pushed: 2022-07-13T03:31:10.000Z (over 2 years ago)
- Last Synced: 2024-10-16T01:10:48.083Z (about 1 month ago)
- Topics: face-detection, fluid-simulation, fluid-solver, golang, navier-stokes, tcell, terminal, wasm, webassembly, webcam
- Language: Go
- Homepage:
- Size: 4.17 MB
- Stars: 66
- Watchers: 3
- Forks: 6
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 🌊 ascii-fluid
**ascii-fluid** is a face controlled ASCII fluid simulation running real time in your terminal. You can control the fluid dynamics with your face by using a webcam, but also with your mouse or touchpad.
## Usage
```bash
$ go get -u -v github.com/esimov/ascii-fluid
$ cd wasm && make
```
## How does it works?
The fluid solver is mainly based on Jos Stam's paper [Real-Time Fluid Dynamics for Games](https://pdfs.semanticscholar.org/847f/819a4ea14bd789aca8bc88e85e906cfc657c.pdf). [tcell](https://github.com/gdamore/tcell) library is used for rendering the fluid simulation in terminal and [gorrilla/websocket](https://github.com/gorilla/websocket) package for communicating through a websocket connection with the Webassembly version of the [Pigo](https://github.com/esimov/pigo) face detection library.
This will start three new operation simultaneously:
- open a new terminal window
- start a new web server which is listening on the incoming websocket connection
- build the webassembly interface for accessing the webcam.
The coordinates of the first detected face will be transferred over the websocket connection to the terminal application. On each refresh rate (defined as a parameter) the terminal will update the fluid simulation.
## OS Support
**This program has been tested on Linux and MacOS, but normally it should also run on Windows.**
Because of the OS imposed security constrains there are some important steps you need to take:
#### MacOS:
In MacOS you must set the accessibility authorization for the terminal you are running from.
## Controls
- **CTRL-D** show/hide the grid system
- **TAB + mouse down** activate/deactivate agents (agents generates repulsions).
## Dependencies
- https://github.com/gdamore/tcell
- https://github.com/esimov/pigo
- https://github.com/gorilla/websocket
## Author
* Endre Simo ([@simo_endre](https://twitter.com/simo_endre))
## License
Copyright © 2020 Endre Simo
This software is distributed under the MIT license. See the LICENSE file for the full license text.