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

https://github.com/gableroux/ansi-colors-chrome-extension

:earth_africa: ANSI colors in your browser!
https://github.com/gableroux/ansi-colors-chrome-extension

ansi-colors ansi-html-stream browserify chrome-extension hacktoberfest strip-ansi

Last synced: about 1 month ago
JSON representation

:earth_africa: ANSI colors in your browser!

Awesome Lists containing this project

README

        

# [ANSI Colors chrome extension](https://chrome.google.com/webstore/detail/hpkomngllcnigoocaolicfknnhibnmfi/)

Chrome extension that converts ANSI characters to colors on the fly / on button click for the lazy ones. Does what [ansi-html-stream][ansi-html-stream] does but within browser.

*Work in progress* (pressing on button currently strip ansi characters for now) :P

## Motivation

I once used to run [salt](https://saltstack.com/) commands with [jenkins](https://jenkins.io/), which outputs colored data by default, but it gets unreadable in a webpage! There's a [jenkins plugin for this](https://wiki.jenkins-ci.org/display/JENKINS/AnsiColor+Plugin), but I tought **why not a plugin for chrome itself?** Here it is :)

Here's a related blog post I wrote about ansi characters and colors:
[Keep saltstack colored output](https://gableroux.com/tips/2016/02/18/keep-saltstack-colored-output/)

## Todo

- [ ] Add support for colors instead of stripping colors
- [ ] Create an icon
- [ ] Upgrade all packages
- [ ] Upgrade node base version (you need node 8 to build this project)
- [x] Provide ansi stripping capability [strip-ansi][strip-ansi] :tada:
- [x] Publish

## Usage

Right now, hitting extension button can convert from this:
```
Summary
-------------[0m
[0;32mSucceeded: 24[0m ([0;32mchanged=3[0m)
[0;36mFailed: 0[0m
[0;36m-------------
Total states run: 24[0m
```
to this
```
Summary
-------------
Succeeded: 24 (changed=3)
Failed: 0
-------------
Total states run: 24
```

## Installation

### From the chrome webstore

[ANSI Colors chrome extension](https://chrome.google.com/webstore/detail/hpkomngllcnigoocaolicfknnhibnmfi/)

### Manually from releases page

1. Download latest zip file in [the releases tab](https://github.com/GabLeRoux/ansi-colors-chrome-extension/releases).
2. Unzip the file somewhere on your computer
3. Open [chrome://extensions](chrome://extensions)
4. Drag n drop the folder of the plugin

Have fun! :v:

## Contributing

* Pull requests are welcome! Please contribute :rocket:
* This plugin uses [browserify][browserify] in a chrome extension and it works!
* The plugin was created using [generator-chrome-extension](https://github.com/yeoman/generator-chrome-extension)

## Development and requirements

1. Clone the repository
2. Build or watch (see commands section)
3. Open [chrome://extensions](chrome://extensions)
4. Check the Developer mode checkbox
![chrome-extensions](https://cloud.githubusercontent.com/assets/1264761/23734467/40ac4e3a-044d-11e7-8ef6-d5f3a043767a.png)
5. Hit `Load unpacked extension...` button
6. Select the `dist` folder (which contains the `manifest.json` file)

### Commands

Install dependencies

```bash
npm i
```

Transform updated source written by ES2015 (default option)

```bash
npm run gulp-babel
```

or Using watch to update source continuously

```bash
npm run watch
```

Make a production version extension

```bash
npm run build
```

Compress and prepare for the chrome web store package (after `npm run build`)

```bash
npm run package
```

More details at [generator-chrome-extension](https://github.com/yeoman/generator-chrome-extension)

## Problems? Questions?
See [issues](https://github.com/GabLeRoux/ansi-colors-chrome-extension/issues/)

## License

MIT © [Gabriel Le Breton](https://gableroux.com/)

[strip-ansi]: https://github.com/chalk/strip-ansi
[ansi-html-stream]: https://github.com/hughsk/ansi-html-stream
[browserify]: http://browserify.org/