# fur

> Quick generator for banner, favicon, etc...

Latest version **7.2.0** (published 2020-06-02) · MIT license · 0 weekly downloads

## Install

```sh
npm install fur
pnpm add fur
yarn add fur
bun add fur
```

Provides the command `fur`.

## Health

**Score 15/100 (F)** — status: abandoned.

Positive: no vulnerabilities.

Warnings: low downloads; no types; no esm support.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 7.2.0 |
| Published | 2020-06-02 |
| First published | 2014-05-03 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | CommonJS |
| Node | >=10 |
| Dependencies | 13 |
| Unpacked size | 335.6 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 26 |
| Author | Taka Okunishi |
| Maintainers | okunishinishi |
| Keywords | logo, banner, favicon, genertor |

## Links

- npm: https://www.npmjs.com/package/fur
- Repository: https://github.com/fur-labo/fur
- Homepage: https://github.com/fur-labo/fur#readme
- Issues: https://github.com/fur-labo/fur/issues
- npm.io page: https://npm.io/package/fur

## Dependencies (13)

- [argx](https://npm.io/package/argx.md) ^4.0.0
- [svgpng](https://npm.io/package/svgpng.md) ^4.0.0
- [filedel](https://npm.io/package/filedel.md) ^4.1.2
- [filecopy](https://npm.io/package/filecopy.md) ^4.1.0
- [writeout](https://npm.io/package/writeout.md) ^2.3.2
- [writexml](https://npm.io/package/writexml.md) ^3.0.0
- [commander](https://npm.io/package/commander.md) ^5.1.0
- [fur-fonts](https://npm.io/package/fur-fonts.md) ^2.1.4
- [randomval](https://npm.io/package/randomval.md) ^2.0.5
- [fur-colors](https://npm.io/package/fur-colors.md) ^2.0.5
- [fur-logger](https://npm.io/package/fur-logger.md) ^2.0.3
- [fur-shapes](https://npm.io/package/fur-shapes.md) ^2.1.2
- [stringcase](https://npm.io/package/stringcase.md) ^4.3.1

## Alternatives

- [@fortawesome/react-fontawesome](https://npm.io/package/@fortawesome/react-fontawesome.md) — 2.2M weekly downloads
- [roboto-fontface](https://npm.io/package/roboto-fontface.md) — 196.0K weekly downloads
- [@react-native-vector-icons/common](https://npm.io/package/@react-native-vector-icons/common.md) — 150.4K weekly downloads
- [@procore/core-icons](https://npm.io/package/@procore/core-icons.md) — 4.6K weekly downloads
- [@react-md/material-icons](https://npm.io/package/@react-md/material-icons.md) — 1.6K weekly downloads

## Recent versions

- 7.2.0 (latest) — 2020-06-02
- 7.0.7 — 2019-10-06
- 7.0.5 — 2019-04-02
- 7.0.4 — 2018-11-08
- 7.0.3 — 2018-11-07
- 7.0.2 — 2018-11-01
- 7.0.0 — 2018-11-01
- 6.1.2 — 2018-03-06
- 6.1.1 — 2017-12-31
- 6.1.0 — 2017-12-31
- 5.1.1 — 2017-06-05
- 5.1.0 — 2017-06-05
- 5.0.2 — 2016-08-13
- 5.0.0 — 2016-07-09
- 4.1.5 — 2016-07-09
- … 41 more at https://npm.io/package/fur/versions

## README

fur
==========

<!---
This file is generated by ape-tmpl. Do not update manually.
--->

<!-- Badge Start -->
<a name="badges"></a>

[![Build Status][bd_travis_shield_url]][bd_travis_url]
[![npm Version][bd_npm_shield_url]][bd_npm_url]
[![JS Standard][bd_standard_shield_url]][bd_standard_url]

[bd_repo_url]: https://github.com/fur-labo/fur
[bd_travis_url]: http://travis-ci.org/fur-labo/fur
[bd_travis_shield_url]: http://img.shields.io/travis/fur-labo/fur.svg?style=flat
[bd_travis_com_url]: http://travis-ci.com/fur-labo/fur
[bd_travis_com_shield_url]: https://api.travis-ci.com/fur-labo/fur.svg?token=
[bd_license_url]: https://github.com/fur-labo/fur/blob/master/LICENSE
[bd_codeclimate_url]: http://codeclimate.com/github/fur-labo/fur
[bd_codeclimate_shield_url]: http://img.shields.io/codeclimate/github/fur-labo/fur.svg?style=flat
[bd_codeclimate_coverage_shield_url]: http://img.shields.io/codeclimate/coverage/github/fur-labo/fur.svg?style=flat
[bd_gemnasium_url]: https://gemnasium.com/fur-labo/fur
[bd_gemnasium_shield_url]: https://gemnasium.com/fur-labo/fur.svg
[bd_npm_url]: http://www.npmjs.org/package/fur
[bd_npm_shield_url]: http://img.shields.io/npm/v/fur.svg?style=flat
[bd_standard_url]: http://standardjs.com/
[bd_standard_shield_url]: https://img.shields.io/badge/code%20style-standard-brightgreen.svg

<!-- Badge End -->


<!-- Description Start -->
<a name="description"></a>

Quick generator for banner, favicon, etc...

<!-- Description End -->


<!-- Overview Start -->
<a name="overview"></a>

<a href="https://github.com/fur-labo/fur#readme"><img style="height:128px;" src="doc/fur-banner.png" height="128"/></a>

```javascript
// Generate favicon with command options.
$ fur favicon "my-favicon.png" --color b --font n --text oh --shape c
```



<!-- Overview End -->


<!-- Sections Start -->
<a name="sections"></a>

<!-- Section from "doc/guides/02-howto.md.hbs" Start -->

<a name="section-doc-guides-02-howto-md"></a>

Getting started
------

### Requirements

+ [node.js&gt;&#x3D;10][nodejs_url]

### Installation

fur is available as an [npm][npm_url] package.

```bash
# Install fur as a global module.
$ npm install fur -g
```

Or you can install it without `-g` option and use [Programmatic API](#programmatic-api).


<a name="available commands"/>

### Available Commands

```bash
$ fur -h
Usage: fur [options] [command]

Options:
  -V, --version                 output the version number
  -h, --help                    display help for command

Commands:
  banner [options] <filename>   Generate a banner.
  favicon [options] <filename>  Generate a favicon.
  help [command]                display help for command

```

<a name="programmatic-api"/>

### Programmatic API

fur provides programmatic API which enables you to execute fur commands from Node.js program.

```javascript
const fur = require('fur')

;(async () => {
  await fur.banner('my-banner.svg', {
    text: 'coz',
    color: 'o',
    font: 'aa',
    style: 'plain',
    shape: 'k'
  })
})()

```


[nodejs_url]: https://nodejs.org/
[npm_url]: https://www.npmjs.com


<!-- Section from "doc/guides/02-howto.md.hbs" End -->

<!-- Section from "doc/guides/03-banners.md.hbs" Start -->

<a name="section-doc-guides-03-banners-md"></a>

Generating Logo Banner
------------------

### Banner Examples

| Image | Command |
| ----- | ------- |
| <img src="https://github.com/fur-labo/fur-examples/raw/master/example/01-fur/banner.png" height="40" style="height:40px;"/> | ` $ fur banner "fur-banner.png" --text="FUR" --color="#ff9100" --font="bt" --shape="a"  ` |
| <img src="https://github.com/fur-labo/fur-examples/raw/master/example/02-coz/banner.png" height="40" style="height:40px;"/> | ` $ fur banner "coz-banner.png" --text="coz" --color="#00b560" --font="aa" --shape="b"  ` |
| <img src="https://github.com/fur-labo/fur-examples/raw/master/example/03-apeman/banner.png" height="40" style="height:40px;"/> | ` $ fur banner "apeman-banner.png" --text="apeman" --color="n" --font="p" --shape="a"  ` |
| <img src="https://github.com/fur-labo/fur-examples/raw/master/example/04-pudding/banner.png" height="40" style="height:40px;"/> | ` $ fur banner "pudding-banner.png" --text="PUDDING" --color="bi" --font="cn" --shape="e"  ` |
| <img src="https://github.com/fur-labo/fur-examples/raw/master/example/05-pon/banner.png" height="40" style="height:40px;"/> | ` $ fur banner "pon-banner.png" --text="pon" --color="ah" --font="ar" --shape="f"  ` |
| <img src="https://github.com/fur-labo/fur-examples/raw/master/example/06-rfunc/banner.png" height="40" style="height:40px;"/> | ` $ fur banner "rfunc-banner.png" --text="rfunc" --color="ac" --font="e" --shape="f"  ` |

These examples are available [here](https://github.com/fur-labo/fur-examples).

### Banner Usage

```bash
$ fur banner -h

Usage: fur banner [options] <filename>

Generate a banner.

Options:
  -c, --color <color>         Color expression string or color theme name.
  -s, --shape <shape>         Banner style.
  -f, --font <font>           Font file name or font theme name.
  -F, --font-size <fontSize>  Size of font.
  -H, --height <height>       Banner height.
  -o, --format <format>       File format. 'svg' or 'png'.
  -t, --text <text>           Banner text.
  -W, --width <width>         Banner width.
  -v, --verbose               Emit verbose log.
  -h, --help                  display help for command

```



<!-- Section from "doc/guides/03-banners.md.hbs" End -->

<!-- Section from "doc/guides/04-favicons.md.hbs" Start -->

<a name="section-doc-guides-04-favicons-md"></a>

Generating Favicon
------------------

### Favicon Examples

| Image | Command |
| ----- | ------- |
| <img src="https://github.com/fur-labo/fur-examples/raw/master/example/01-fur/favicon.png" height="40" style="height:40px;" /> | ` $ fur favicon "f-favicon.png" --text="F" --color="#ff9100" --font="bt" --shape="a"  ` |
| <img src="https://github.com/fur-labo/fur-examples/raw/master/example/02-coz/favicon.png" height="40" style="height:40px;" /> | ` $ fur favicon "c-favicon.png" --text="c" --color="#00b560" --font="aa" --shape="c"  ` |
| <img src="https://github.com/fur-labo/fur-examples/raw/master/example/03-apeman/favicon.png" height="40" style="height:40px;" /> | ` $ fur favicon "ap-favicon.png" --text="ap" --color="n" --font="p" --shape="g"  ` |
| <img src="https://github.com/fur-labo/fur-examples/raw/master/example/04-pudding/favicon.png" height="40" style="height:40px;" /> | ` $ fur favicon "p-favicon.png" --text="P" --color="bi" --font="cn" --shape="a"  ` |
| <img src="https://github.com/fur-labo/fur-examples/raw/master/example/05-pon/favicon.png" height="40" style="height:40px;" /> | ` $ fur favicon "pon-favicon.png" --text="pon" --color="ah" --font="ar" --shape="g"  ` |
| <img src="https://github.com/fur-labo/fur-examples/raw/master/example/06-rfunc/favicon.png" height="40" style="height:40px;" /> | ` $ fur favicon "rf-favicon.png" --text="rf" --color="ac" --font="e" --shape="c" --font-size="148"  ` |
| <img src="https://github.com/fur-labo/fur-examples/raw/master/example/07-apeman-middleware/favicon.png" height="40" style="height:40px;" /> | ` $ fur favicon "mw-favicon.png" --text="mw" --color="n" --font="p" --shape="i" --font-size="92"  ` |
| <img src="https://github.com/fur-labo/fur-examples/raw/master/example/08-apeman-api/favicon.png" height="40" style="height:40px;" /> | ` $ fur favicon "api-favicon.png" --text="api" --color="n" --font="p" --shape="i" --font-size="92"  ` |
| <img src="https://github.com/fur-labo/fur-examples/raw/master/example/09-a/favicon.png" height="40" style="height:40px;" /> | ` $ fur favicon "a-favicon.png" --text="a" --color="n" --font="p" --shape="g" --font-size="92"  ` |

These examples are available [here](https://github.com/fur-labo/fur-examples).


### Favicon Usage

```bash
$ fur favicon -h

Usage: fur favicon [options] <filename>

Generate a favicon.

Options:
  -c, --color <color>         Color expression string or color theme name.
  -f, --font <font>           Font file name or font theme name.
  -F, --font-size <fontSize>  Size of font.
  -S, --size <size>           Favicon size.
  -s, --shape <shape>         Banner style.
  -t, --text <text>           Favicon text.
  -o, --format <format>       File format. 'svg' or 'png'.
  -v, --verbose               Emit verbose log.
  -h, --help                  display help for command

```


<!-- Section from "doc/guides/04-favicons.md.hbs" End -->

<!-- Section from "doc/guides/05-Themes.md.hbs" Start -->

<a name="section-doc-guides-05-themes-md"></a>

Theme Gallery
------------

+ [Color Themes](http://fur-labo.github.io/fur-colors)
+ [Font Themes](http://fur-labo.github.io/fur-fonts)
+ [Shape Themes](http://fur-labo.github.io/fur-shapes)



<!-- Section from "doc/guides/05-Themes.md.hbs" End -->

<!-- Section from "doc/guides/11-project.md.hbs" Start -->

<a name="section-doc-guides-11-project-md"></a>

About this project
--------

<a name="11-project-author"></a>
### Author

+ [Taka Okunishi](http://okunishitaka.com)

<a name="11-project-donation"></a>
### Donation

Support this project and [others by okunishinishi][my_gratipay_url] via [gratipay][my_gratipay_url].

[<img src="https://cdn.rawgit.com/gratipay/gratipay-badge/2.3.0/dist/gratipay.svg" alt="Support via Gratipay"/>][my_gratipay_url]



[my_gratipay_url]: https://gratipay.com/okunishinishi/
[my_gratipay_budge_url]: http://img.shields.io/gratipay/okunishinishi.svg?style=flat


<!-- Section from "doc/guides/11-project.md.hbs" End -->


<!-- Sections Start -->


<!-- LICENSE Start -->
<a name="license"></a>

License
-------
This software is released under the [MIT License](https://github.com/fur-labo/fur/blob/master/LICENSE).

<!-- LICENSE End -->


<!-- Links Start -->
<a name="links"></a>

Links
------

+ [fur-examples][fur_examples_url]
+ [fur-colors][fur_colors_url]
+ [fur-fonts][fur_fonts_url]
+ [fur-shapes][fur_shapes_url]

[fur_examples_url]: https://github.com/fur-labo/fur-examples
[fur_colors_url]: https://github.com/fur-labo/fur-colors
[fur_fonts_url]: https://github.com/fur-labo/fur-fonts
[fur_shapes_url]: https://github.com/fur-labo/fur-shapes

<!-- Links End -->

---
_Source: https://npm.io/package/fur · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._