TerminalTools

Version 3.0.0

Tools for your terminal

---

TerminalTools provides little bits of fun for your average terminal

Installation

TerminalTools is a Node.js module available through the npm registry. Installation is done using the npm install command:

$ npm install terminaltools

You can also just add it to your package.json file, and it will be installed the next time you run npm install:

{
  "dependencies": {
    "terminaltools": "^3.0.0"
  }
}

Basic Usage

const TerminalTools = require('terminaltools');
// renderVideo
let frames = TerminalTools.renderVideo('path/to/video.mp4');
let i = frames.length;
let interval = setInterval(() => {
  console.log(frames[i]);
  i--;
  if (i < 0) {
    clearInterval(interval);
  }
}, 1000 / 30);

// renderImage
TerminalTools.renderImage('path/to/image.png').then(console.log);

// Banner
let banner = new TerminalTools.Banner();
banner.load();
banner.write('Hello, World!');

// Mute
let mute = new TerminalTools.Mute();
mute.mute();
console.log("You won't see this");
mute.unmute();
console.log("You will see this");
mute.getOutput(); // You won't see this
mute.clearOutput();

// fun.Matrix
TerminalTools.fun.Matrix.start();
setTimeout(() => {
  TerminalTools.fun.Matrix.stop();
}, 5000);

// fun.Snowfall
TerminalTools.fun.Snowfall.start();
setTimeout(() => {
  TerminalTools.fun.Snowfall.stop();
}, 5000);

// fun.Rainbow
TerminalTools.fun.Rainbow("Hello, World!");

For API usage, and more specific examples, refer to the API.

Contributing

To help with the development of TerminalTools, you can contribute to the project by submitting issues, pull requests, or shooting me an email at me@aviv.sh.