Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/namzug16/gifterm


https://github.com/namzug16/gifterm

Last synced: 15 days ago
JSON representation

Awesome Lists containing this project

README

        

# GifTerm

GIFs on the terminal

Gifterm demo

*The terminal output is actual text*

## Contents

- [Installation](#installation)
- [Usage](#usage)
- [Video to Gif](#how-to-convert-a-video-into-a-gif)

## Installation

You can simply install it by running

```
$ make
```

Just make sure to have installed and setup the minimum required version of Go. You can find it in the go.mod file

## Usage

### Basic usage

```
$ gifterm
```

### Flags

- **cd**: Character Density. Default ".,:-=i|%O#@$X"
- **far**: Font Aspect Ratio. Default 2.1
- **fps**: FPS. Default 12
- **randomBlank**: Set if a random character from CD should be picked for a blank pixel

> The Font Aspect Ratio changes from terminal to terminal, this value works in mine, so make sure to play a round to find yours

```
$ gifterm -cd ".,:-=i|%O#@$X" -far 2.1 -fps 12 -randomBlank
```
Will produce something like this

Gifterm demo

## How to convert a video into a GIF

Make sure to have installed ffmpeg and imagemagick and then run

```
$ ffmpeg -i -vf "fps=12" -c:v pam -f image2pipe - | convert - input.gif
```