https://github.com/tomscheers/nface
An ASCII based camera program
https://github.com/tomscheers/nface
Last synced: 19 days ago
JSON representation
An ASCII based camera program
- Host: GitHub
- URL: https://github.com/tomscheers/nface
- Owner: tomScheers
- Created: 2025-02-25T14:44:39.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2025-03-09T21:08:29.000Z (2 months ago)
- Last Synced: 2025-03-30T19:02:57.557Z (about 2 months ago)
- Language: C
- Size: 4.7 MB
- Stars: 10
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# nFace
nFace is a terminal-based camera application that converts your live camera feed into ASCII art in real-time using ncurses.
## Requirements
- Linux (for v4l2)
- A camera (obviously)
- gcc
- ncurses library
- tmux (optional but recommended)
## Installation Process
First you'll have to clone the repo from Github
```bash
git clone https://github.com/tomScheers/nFace.git
cd nFace
```
Secondly, you'll have to run make
```bash
make
```
To run the program, you'll need to run
(optional) install it to your system
```bash
sudo make install
```
## Usage
You can run the project by executing the binary
```bash
bin/nface
```
Or, if you have installed it to your system, just run
```bash
nface
```
### N.B.
- If your terminal is either too small or to large, you won't see anything, so make sure it's the right size (only important for extremes).
- You can change the resolution of the camera by increasing/decreasing your terminal size using tmux, because this program is responsive