boxes  2.2.0
About: boxes draws all kinds of boxes around your text (in ASCII art).
  Fossies Dox: boxes-2.2.0.tar.gz  ("unofficial" and yet experimental doxygen-generated source code documentation)  

No Matches
boxes Documentation

Some Fossies usage hints in advance:

  1. To see the Doxygen generated documentation please click on one of the items in the steelblue colored "quick index" bar above or use the side panel at the left which displays a hierarchical tree-like index structure and is adjustable in width.
  2. If you want to search for something by keyword rather than browse for it you can use the client side search facility (using Javascript and DHTML) that provides live searching, i.e. the search results are presented and adapted as you type in the Search input field at the top right.
  3. Doxygen doesn't incorporate all member files but just a definable subset (basically the main project source code files that are written in a supported language). So to search and browse all member files you may visit the Fossies boxes-2.2.0.tar.gz contents page and use the Fossies standard member browsing features (also with source code highlighting and additionally with optional code folding).

Build Status Coverage Latest Version


Command line ASCII boxes unlimited!

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

example boxes

For more information, please visit the website.


The recommended way is to install boxes via your package manager. But many ways exist to get boxes onto your machine, details here.

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.


Boxes is stable.

It has been around since 1999, and is still available and kept current in many package managers (apt, rpm, choco, brew, just to name a few). 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.

Update 2021: In 2021, the original author has turned to boxes again in order to implement all open issues, including full multi-byte character set support. This is still ongoing, but there have already been two new releases with significant new functionality.


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!

Custom box designs

You can define your own box designs!

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


Boxes is free software under the GNU General Public License, version 3 (GPLv3).

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