Command line ASCII boxes unlimited!
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.
doc Fix spelling error in manpage Mar 11, 2018
src Fix some compiler warnings: Oct 22, 2017
test Adapt 2 test cases for homebrew 64-bit #38 Mar 14, 2017
.gitignore minor update to .gitignore May 7, 2016
.travis.yml Add some files to .gitignore; adjust .travis.yml to build only master Jan 7, 2016
LICENSE Initial commit Aug 27, 2014
Makefile Bumped version number to 1.2.1-SNAPSHOT Mar 17, 2017
README.Win32.txt Increased version number to 1.2 for release Mar 17, 2017 Streamline Mar 15, 2017
boxes-1.2.lsm Increased version number to 1.2 for release Mar 17, 2017
boxes-config Update boxes-config with both f90 comments and box Feb 13, 2018
boxes-pkg.openwrt Increased version number to 1.2 for release Mar 17, 2017
boxes.vim Update URL to source of boxes.vim Jan 11, 2015
versions.txt Moved boxes sources from RCS to git Aug 27, 2014

Build Status


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.


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.


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


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!       |
      |  _____________________|_