You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Mohammad Fares 42d950a2b6 Check for the os when hiding the Dock 5 years ago
bin first commit 5 years ago
commands Change the default command for non-windows os to be bash -l 5 years ago
img first commit 5 years ago
lib first commit 5 years ago
render Check for the os when hiding the Dock 5 years ago
.gitignore first commit 5 years ago
.jscsrc first commit 5 years ago Add node-gyp note 5 years ago
app.js first commit 5 years ago
config.yml first commit 5 years ago
di.js first commit 5 years ago
package.json 0.1.5 5 years ago
utility.js first commit 5 years ago


npm npm Gitter Unicorn

Record your terminal and generate animated gif images

Built to be jusT cOol 👌🦄 !

If you think so, support me by a star and a follow 😘

Built while listening to Ever Felt Pt.1 - Otis McDonald 🎵 And Nyan Cat 😛

Table of Contents


  • Highly customizable.
  • Corss platform (Linux, Windows, MacOS).
  • Custom window frames.
  • Custom font.
  • Custom colors.
  • Custom styles with CSS.
  • Watermark.
  • Edit frames and adjust delays before rendering.
  • Skipping frames by a step value to reduce the number of rendered frames.
  • Render images with texts on them instead of capturing your screen for better quality.
  • The ability to configure:
    • The command to capture (bash, powershell.exe, yourOwnCommand, etc)
    • The current working directory.
    • Explicit values for the number of cols and rows.
    • GIF quality and repeating.
    • Frames delays.
    • The max idle time between frames.
    • cursor style.
    • font.
    • font size.
    • line height.
    • letter spacing.
    • theme.


You need first to install Node.js, then install the tool globally using this command:

npm install -g terminalizer

If the installation failed, you may need to install the developement tools to build the C++ addons.

⚠️ Terminalizer uses some C++ addons that require building. Until we release the first stable version that will include prebuilt binaries for different OSs you may need to install some tools to build for now. Try the following, if they don't solve your installation issue, check

For MacOS

xcode-select --install

For RHEL, CentOS, Scientific Linux, Fedora

yum update
yum groupinstall "Development Tools"

For Debian, Ubuntu and derivatives

sudo apt-get update
sudo apt-get install build-essential


zypper refresh
zypper update
zypper install -t pattern devel_C_C++

For Arch Linux and derivatives

sudo pacman -Syyu
sudo pacman -S base-devel

Verifying Installation

gcc -v
make -v

Getting Started

Start recording your terminal using the command record.

terminalizer record demo

A file called demo.yml will be created in the current directory. You can open it using any editor to edit the configurations and the recoreded frames. You can replay your recording using the command play.

terminalizer play demo

Now let's render our recording as an animated gif.

terminalizer render demo


GIF compression is not implementated yet. For now we recommend


You can use the option --help to get more details about the commands and their options.

terminalizer <command> [options]


Generate a config file in the current directory

terminalizer config


Record your terminal and create a recording file

terminalizer record <recordingFile>


-c, --config   Overwrite the default configurations [string]
-d, --command  The command to be executed           [string] [default: null]


terminalizer record foo                      Start recording and create a recording file called foo.yml
terminalizer record foo --config config.yml  Start recording with with your own configurations


Play a recording file on your terminal

terminalizer play <recordingFile>


-r, --real-timing   Use the actual delays between frames as recorded        [boolean] [default: false]
-s, --speed-factor  Speed factor, multiply the frames delays by this factor [number] [default: 1]


Render a recording file as an animated gif image

terminalizer render <recordingFile>


-o, --output   A name for the output file                                      [string]
-q, --quality  The quality of the rendered image (1 - 100)                     [number]
-s, --step     To reduce the number of rendered frames (step > 1) [number] [default: 1]


Upload a recording file and get a link for an online player

terminalizer share <recordingFile>


Generate a web player for a recording file

terminalizer generate <recordingFile>


The default config.yml file is stored at root directory of the project. Execute the bellow command to copy it to your current directory.

Use any editor to edit the copied config.yml, then use the option -c to overwrite the default one.

terminalizer config


  • command: Specify a command to be executed like /bin/bash -l, ls, or any other commands. The default is bash for Linux or powershell.exe for Windows.
  • cwd: Specify the current working directory path. The default is the current working directory path.
  • env: Export additional ENV variables, to be read by your scripts when start recording.
  • cols: Explicitly set the number of columns or use auto to take the current number of columns of your shell.
  • rows: Explicitly set the number of rows or use auto to take the current number of columns of your shell.


  • frameDelay: The delay between frames in ms. If the value is auto use the actual recording delays.
  • maxIdleTime: Maximum delay between frames in ms. Ignored if the frameDelay isn't set to auto. Set to auto to prevnt limiting the max idle time.


  • quality: The quality of the generated GIF image (1 - 100).
  • repeat: Amount of times to repeat GIF:
    • If value is -1, play once.
    • If value is 0, loop indefinitely.
    • If value is a positive number, loop n times.


  • cursorStyle: Cursor style can be one of block, underline, or bar.
  • fontFamily: You can use any font that is installed on your machine like Monaco or Lucida Console.
  • fontSize: The size of the font in pixels.
  • lineHeight: The height of lines in pixels.
  • letterSpacing: The spacing between letters in pixels.


You can set the colors of your terminal using one of the CSS formats:

  • Hex: #FFFFFF.
  • RGB: rgb(255, 255, 255).
  • HSL: hsl(0, 0%, 100%).
  • Name: 'white', 'red', 'blue',

You can use the the value transparent too.

The default colors that are assigned to the termianl colors are:

  • background: #ffffff transparent
  • foreground: #afafaf #afafaf
  • cursor: #c7c7c7 #c7c7c7
  • black: #232628 #232628
  • red: #fc4384 #fc4384
  • green: #b3e33b #b3e33b
  • yellow: #ffa727 #ffa727
  • blue: #75dff2 #75dff2
  • magenta: #ae89fe #ae89fe
  • cyan: #708387 #708387
  • white: #d5d5d0 #d5d5d0
  • brightBlack: #626566 #626566
  • brightRed: #ff7fac #ff7fac
  • brightGreen: #c8ed71 #c8ed71
  • brightYellow: #ebdf86 #ebdf86
  • brightBlue: #75dff2 #75dff2
  • brightMagenta: #ae89fe #ae89fe
  • brightCyan: #b1c6ca #b1c6ca
  • brightWhite: #f9f9f4 #f9f9f4


You can add a watermark logo to your generated GIF images.

  imagePath: AbsolutePathOrURL
    position: absolute
    right: 15px
    bottom: 15px
    width: 100px
    opacity: 0.9
  • watermark.imagePath: An absolute path for the image on your machine or a url.
  • Apply CSS styles (camelCase) to the watermark image, like resizing it.

Frame Box

Terminalizer comes with predefined frames that you can use to make your GIF images look cool.

  • frameBox.type: Can be null, window, floating, or solid.
  • frameBox.title: To display a title for the frame or null.
  • To apply custom CSS styles or to overwrite the current onces.

Null Frame

No frame, just your recording.

Don't forget to add a backgroundColor under style.

  type: null
  title: null
    backgroundColor: black

Window Frame

  type: window
  title: Terminalizer
  style: []

Floating Frame

  type: floating
  title: Terminalizer
  style: []

Solid Frame

  type: solid
  title: Terminalizer
  style: []

Solid Frame Without Title

  type: solid
  title: null
  style: []

Styling Hint

You can disable the default shadows and margins by:

  type: solid
  title: null
    boxShadow: none
    margin: 0px


This project is under the MIT license.