Skip to main content

Classic Unix banner command on steroids with TTF support and more.

Project description

▙▄▄                ▗▟█▙  ▟█▙    ▐▄▄              ▄▄▄▄▄▄▄▄▄█             ▗█    ▙▄▖
▜██████████▄▖        ▀    ▀ ▗█  ▝█████████▙▄ ▗▟██████████▀▚▖   ▗▄█████████▛   ▜█████████▙▄
█▙▄▀▀▀▀▀▀█████▖  ▗▄███████████  █▄▄▀▀▀▀▜█████ ████▀     ▗███▌ ▟██████▀▀▀▀▄▄█▌ █▙▄▛▀▀▀▀▜████▌
████      ▟███▌ ▟████▀   ▀▀▀▀▄▌ ████     ████ ████▖     ▐███▌ ████▀    ▄████▌ ████     ▐███▌
██████████████  ████      ▐███▌ ████     ████ ▝█████████████▌ ██████████████▌ ████▄▄▄▄▄▟███▌
████     ▝▜███▌ ████      ▐███▌ ████     ████    ▀▀▘    ▀███▌ ████▙▖     ▄▄▄  ████████████▀
████      ▟███▌ ████▖     ▟███▌ ████     ████  ▄▄        ███▘ ▝▜████████████  ████  ▝███▙
██████████████  ▝█████████████▌ ▄▄▄▄     ▄▄▄▄   ▜▄▄▄▟███████    ▝▀▀▀▀▀▀▀▀▀▀▘  ████    ▜███▖
▀▀▀▀▀▀▀▀▀▀▀▀▀     ▀▀▀▀▀▀▀▀▝▀▀▀▘ ▝▘▝▘     ▝▘▝▘  ▐█▀▀▀▀▀▀▀▀▀▀                   ▀▀▀▀     ▝▀▀▀▘
                                               ▝
┅┅┅ Your banner deserves to be a bänger ┅┅┅┅┅┅ https://github.com/MarcinOrlowski/banger ┅┅┅

PyPI - Version GitHub License PyPI Downloads


What it is?

Bänger (pronounced just banger) is a modern tribute to the classic Unix banner command line utility that produces text banners, with additional features added a top: multiple built-in ASCII character set and support for rendering any TTF/OTF font with Unicode!

Key Features

  • Built-in fonts: use built-in fonts to bang!
  • Endless font options: use any TTF/OTF font installed on your system,
  • Better typography with proportional spacing that saves significant screen space,
  • Compatible with original Unix banner tool,
  • and moar!

Quick start

Create a banner with the default font:

$ banger "Hello World"

█  █      ▀█  ▀█           █   █          ▀█     █
█▀▀█ ▄▀▀▄  █   █  ▄▀▀▄     █   █ ▄▀▀▄ █▄▀  █  ▄▀▀█
█  █ █▀▀   █   █  █  █     █ █ █ █  █ █    █  █  █
█  █ ▀▄▄▀ ▄█▄ ▄█▄ ▀▄▄▀     █▀ ▀█ ▀▄▄▀ █   ▄█▄ ▀▄▄▀

NOTE: to maintain behavior of the original banner command, you need to quote the text to keep it as a single argument. Otherwise, the command will split the text into one word per line.

Using TTF/OTF fonts

Bänger can also use any TTF/OTF font installed on your system and convert it to beautiful ASCII art using Unicode quadrant blocks. Let's use TTF font of size 70pt and squeeze final banner into 10 terminal lines:

$ banger --ttf-font ~/.fonts/j/JetBrainsMonoNL_Regular.ttf --ttf-size 70 --ttf-lines 10 DäNgęR

█████████▙▄▄     ▐███   ▐██▌   ████▙       ███  ▗▄██████▄▐██▌  ▗▄▟██████▙▄▖  ██████████▙▄▄
██▌      ▀▜██▖                 ███▜█▙      ███ ▟██▛▘    ▝▜██▌ ▟██▛      ▜██▙ ███▌      ▀███▖
██▌       ▝███    ▄▄▄▄▄▄▄▄▄    ███ ▜██▖    ███ ███       ▐██▌ ███▄▄▄▄▄▄▄▄███ ███▌       ▐██▌
██▌        ███  ▟██▀▀▘ ▝▀▀██▙  ███  ▜██▖   ███ ███▖      ▐██▌ ███▀▀▀▀▀▀▀▀▀▀▀ ███▌     ▗▄██▛▘
██▌        ███     ▄▄▄▄▄▄▄███▌ ███   ▜██▖  ███ ▐██▙▖    ▄▟██▌ ▜██▖      ▗▄▄▄ ██████████▀▀▘
██▌        ███ ▗▟██▀▀▀▀▀▀▀███▌ ███    ▜██▖ ███  ▝▀▜████▛▀▐██▌  ▀███▄▄▄▄▟██▀▘ ███▌   ▜██▙
██▌       ▐██▛ ███        ███▌ ███     ▀██▖███           ▐██▌     ▝▀▜█▛▀     ███▌    ▝███▖
██▙▄▄▄▄▄▄███▀  ▜██▙▄▄▄▄▄▄█▜██▌ ███      ▝█████   ▗▄▄▄▄▄▄▄███▘      ▐█▙       ███▌     ▝▜██▙
▀▀▀▀▀▀▀▀▀▘       ▝▀▀▀▀▀▀  ▝▀▀▘ ▀▀▀       ▝▀▀▀▀   ▝▀▀▀▀▀▀▀▀          ▝▀▀▀▀▘   ▀▀▀▘       ▀▀▀▘

Further reading


License

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

banger-1.1.0.tar.gz (49.4 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

banger-1.1.0-py3-none-any.whl (45.9 kB view details)

Uploaded Python 3

File details

Details for the file banger-1.1.0.tar.gz.

File metadata

  • Download URL: banger-1.1.0.tar.gz
  • Upload date:
  • Size: 49.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.12.3

File hashes

Hashes for banger-1.1.0.tar.gz
Algorithm Hash digest
SHA256 715f357b35babbf72b623116b5d528802bf1e1e2ae5a3f927c330468a31b4150
MD5 f191d2ca81dbdd022bbad1f0bac65990
BLAKE2b-256 59c576929973385188776165a20c14006fa12428f35b9f33a357a98f7a94654f

See more details on using hashes here.

File details

Details for the file banger-1.1.0-py3-none-any.whl.

File metadata

  • Download URL: banger-1.1.0-py3-none-any.whl
  • Upload date:
  • Size: 45.9 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.12.3

File hashes

Hashes for banger-1.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 d1bd16a6dab6c756c703e28c7ded74dd8b40362d2612c1d30c7609ab41fa7fbd
MD5 e61fc1eef29e80709e29eef3d68cabd7
BLAKE2b-256 8266002976f6e7ecb9731e61d350f553713c4c762acac5b1bd888754f9d2f9fb

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page