terminaltools
v3.0.1-beta
Published
terminaltools allows you to do tricks in the terminal like play videos, show images and more.
Downloads
1,734
Maintainers
Readme
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 [email protected].
License
TerminalTools is licensed under the MIT license. This means that you can use TerminalTools in any way you want, as long as you give credit to me, the original author (RedYetiDev).
What is "as long as you give credit to me"?
Giving credit is showing that you used TerminalTools in your project. This can be done by linking to the GitHub repository, or by linking to the npm package.