https://github.com/luminousmen/kgif

:neckbeard: Tool for creating gif file from capturing active window.
https://github.com/luminousmen/kgif

capture-tty gif screenshot shell

Last synced: 10 months ago
JSON representation

:neckbeard: Tool for creating gif file from capturing active window.

• Host: GitHub
• URL: https://github.com/luminousmen/kgif
• Owner: luminousmen
• License: mit
• Created: 2016-05-28T13:43:32.000Z (about 10 years ago)
• Default Branch: master
• Last Pushed: 2023-06-13T01:17:27.000Z (about 3 years ago)
• Last Synced: 2025-07-20T04:55:43.367Z (11 months ago)
• Topics: capture-tty, gif, screenshot, shell
• Language: Shell
• Homepage:
• Size: 287 KB
• Stars: 94
• Watchers: 3
• Forks: 3
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
[![FBI](https://img.shields.io/badge/%F0%9F%95%B5-FBI%20checked-green.svg)](https://www.fbi.gov/)

[![bug free](https://img.shields.io/badge/%F0%9F%90%9B-bug%20free-green.svg)](https://en.wikipedia.org/wiki/Software_bug)

Kgif

======

Tool for creating gif file from capturing active window.

![gif](https://camo.githubusercontent.com/38df9b507042dded48415dbb5a5a3c4966ea324c/687474703a2f2f692e696d6775722e636f6d2f3965743864614e2e6a7067)

Originally it was created for capturing tty output and creating preview for github projects :wink:

I needed to capture tty output on my Ubuntu 15.10. First I came up to using ```ttyrec``` with [ttygif](https://github.com/icholy/ttygif) or [tty2gif](https://bitbucket.org/antocuni/tty2gif) convertor, then find [showterm.io](http://showterm.io/). All this solutions didn't work for me :grimacing: Than I create this simple script that satisfies all my needs.

### Dependencies

* scrot

* imagemagick

### Installation

```bash

$ sudo apt-get install imagemagick scrot

$ git clone https://github.com/luminousmen/Kgif

```

### Usage

```bash

$ ./kgif.sh --help

usage: ./kgif.sh [--delay] [--filename ] [--gifdelay] [--noclean] [--check] [-h]

  -h, --help                   Show this help, exit

      --check                  Check if all dependencies are installed, exit

      --delay=            Set delay in seconds to specify how long script will wait until start capturing.

      --gifdelay=         Set delay in seconds to specify how fast images appears in gif.

      --filename=   Set file name for output gif.

      --noclean                Set if you don't want to delete source *.png screenshots.

```

Check if all dependencies presents in system:

```bash

$ ./kgif.sh --check

```

Set ```delay``` in seconds to specify how long script will wait until start capturing.

```bash

$ ./kgif.sh --delay=5

```

Set ```noclean``` if you don't want to delete source png screenshots (for example if you want to delete some of the screenshots).

```bash

$ ./kgif.sh --delay=5 --noclean

```

### Preview

![preview](terminal.gif)