Ecosyste.ms: Awesome

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

https://github.com/base16-builder/base16-builder

:hammer: Base16 Builder is a nimble command-line tool that generates themes for your favourite programs.
https://github.com/base16-builder/base16-builder

Last synced: about 1 month ago
JSON representation

:hammer: Base16 Builder is a nimble command-line tool that generates themes for your favourite programs.

Lists

README

        


Base16 Builder

[![Gitter](https://img.shields.io/badge/Gitter-Join%20chat%20%E2%86%92-brightgreen.svg?style=flat-square)](https://gitter.im/base16-builder/base16-builder)
[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=flat-square)](http://makeapullrequest.com)
[![MIT License](https://img.shields.io/badge/Licence-MIT-blue.svg?style=flat-square)](https://github.com/base16-builder/base16-builder/blob/master/licence.md)

_**Base16 Builder** is a nimble command-line tool that generates themes for your favourite programs. See it in action below:_

![](https://camo.githubusercontent.com/ddfcd564006e0f6f6f24abeb1b9424cb71c97ddd/68747470733a2f2f692e696d6775722e636f6d2f6c416e7670526a2e676966)

Base16 Builder is easy to use. All you have to do is supply a [**color `s`cheme**](https://github.com/alexbooker/base16-builder/tree/master/db/schemes), [**`t`emplate**](https://github.com/alexbooker/base16-builder/tree/master/db/templates), and **`b`rightness** (`light` or `dark`). Base16 Builder will use the information you provide to generate a theme and write it to [*stdout*](https://www.digitalocean.com/community/tutorials/an-introduction-to-linux-i-o-redirection).

Because Base16 Builder writes to stdout, it's possible to pipe the theme anywhere you like. In the above screencast, the theme is piped to a new file called "theme", but this could just as well have been a configuration file like ".Xresources".

You don't have to be savvy with [Unix pipelines](https://en.wikipedia.org/wiki/Pipeline_(Unix)) to enjoy Base16 Builder. If you'd prefer, you can just copy the output with your mouse :relaxed:.

## Features

This project aims to rejuvenate [Chris Kempson's original tool](https://github.com/chriskempson/base16-builder) by incorporating some fresh features:

- [Under active development](https://github.com/alexbooker/base16-builder/pulse/monthly)
- [Well-tested](https://github.com/alexbooker/base16-builder/tree/master/tests)
- Simple to use
- Simpler to [install](https://github.com/alexbooker/base16-builder#installation)
- Writes themes to [`stdout`](https://www.digitalocean.com/community/tutorials/an-introduction-to-linux-i-o-redirection)
- Written in uncomplicated JavaScript
- Works on Mac, Linux, and Windows

## Installation

```
$ npm install --global base16-builder
```

Make sure to install Node.js **before** running the above command. We recommended that you install Node.js using [nvm](https://github.com/creationix/nvm) (the **n**ode **v**ersion **m**anager) or the [pre-built installer for your platform](https://nodejs.org/en/download/). `npm` (the **n**ode **p**ackage **m**anager) is bundled and installed automatically with Node.js.

## Usage

```bash
$ base16-builder --help

Usage:
$ base16-builder <-s scheme> <-t template> <-b light|dark>
$ base16-builder <-s scheme path> <-t template path>

Options:
-s, --scheme Build theme using this color scheme
-t, --template Build theme using this template
-b, --brightness Build theme using this brightness
-h, --help Show this menu

Commands:
ls schemes Opens an offline web page with a list of scheme names and their colors
ls templates Writes a list of available templates to the terminal

Examples:
$ base16-builder -s oceanicnext -t rxvt-unicode -b dark
$ base16-builder --scheme oceanicnext --template rxvt-unicode --brightness dark
$ base16-builder --scheme schemes/customScheme.yml --template templs/customTempl.ejs
$ base16-builder ls schemes
$ base16-builder ls templates
```

## Build Status

| Windows | Linux |
|:------:|:------:|
|[![Build status](https://ci.appveyor.com/api/projects/status/6xckfbsriju345cd?svg=true)](https://ci.appveyor.com/project/alexbooker/base16-builder) | [![Build Status](https://travis-ci.org/alexbooker/base16-builder.svg?branch=master)](https://travis-ci.org/alexbooker/base16-builder) |

## Attribution

- The [original base16-builder](https://github.com/chriskempson/base16-builder).
- Scheme and template [contributors](https://github.com/chriskempson/base16-builder/graphs/contributors) to the original base16-builder.
- [Phis](https://github.com/Phisherman) for the charming logo.