Command line ASCII boxes unlimited!
Go to file
2021-02-15 20:35:29 +01:00
.github Add issue template for bug reports 2019-02-26 09:55:24 +01:00
doc Add examples and references to other ascii art tools to man page 2021-02-15 20:35:29 +01:00
src Add command line option -n to set character encoding of input text #1 2021-02-15 20:35:20 +01:00
test Switch test runner output filter sed to extended regex (-E) 2021-02-15 20:35:29 +01:00
tools Add chocolatey package spec 2019-03-28 22:09:10 +01:00
.gitattributes Add command line option -n to set character encoding of input text #1 2021-02-15 20:35:20 +01:00
.gitignore Clean up .gitignore 2019-03-28 22:09:17 +01:00
.travis.yml Add libunistring and libpcre2 to Travis CI config #1 2021-02-13 10:54:09 +01:00
boxes-config Add test cases for colored unicode 'headline' design #1 2021-02-15 20:35:28 +01:00
boxes-pkg.openwrt Increased version number to 1.3 for release 2019-02-21 18:50:44 +01:00
boxes.portable.nuspec Fix path references in description text of choco package 2019-04-05 15:46:48 +02:00
boxes.spec Increased version number to 1.3 for release 2019-02-21 18:50:44 +01:00
boxes.vim Use 'setlocal' instead of 'set' in Vim syntax file #66 2020-02-01 14:06:32 +01:00
LICENSE Initial commit 2014-08-27 22:49:22 +02:00
Makefile Unicode-enable regex processing by introducing PCRE2 #1 #67 2021-02-13 11:01:54 +01:00
README.md Change website references to https 2019-02-14 21:41:11 +01:00
README.Win32.md Increased version number to 1.3 for release 2019-02-21 18:50:44 +01:00

Build Status

boxes

Command line ASCII boxes unlimited!

Boxes is a command line filter program that draws ASCII art boxes around your input text (examples).

For more information, please visit the website.

Status

Boxes is stable.

It has been around since 1999, and has since been included in several Linux distributions and, lately, even Windows 10, via its Ubuntu subsystem. Its source code is quite portable, and so, boxes has been made to run on a wide range of platforms, from Windows PCs to Netgear routers.

Boxes has matured, and is thusly no longer being actively developed. But contributors can be sure that their pull requests are promptly reviewed and merged into the main code base.

License

Boxes is free software under the GNU General Public License, version 2 (GPLv2).

Development

The website has information on building from source, testing, and contributing to the source code.
Boxes has received support from many contributors over the years, and continues to benefit greatly from contributions. Many thanks for that!

Running it

Try if boxes works by typing echo foo | boxes on the command line. It should give you something like that:

/*******/
/* foo */
/*******/

Type boxes -l to get a long list of box designs to use. Detailed usage information is in the manual page and on the website. Consider tying boxes to your editor, so that it can be invoked by a simple keypress.

Custom box designs

You can define your own box designs!

We appreciate the creative new box designs that you craft for boxes. Please feel free to submit them in the form of pull requests on boxes-config, and they may make it into the next release!

     _________________________
    /\                        \
    \_|    Thank you for      |
      |    using Boxes!       |
      |  _____________________|_
      \_/______________________/