Command line ASCII boxes unlimited!
Go to file
Thomas Jensen bae35281d0
v2.3.1
2024-10-03 10:47:35 +02:00
.github Fix MacOS CI build by staying on macos-13 2024-05-05 21:19:25 +02:00
.vscode Migrate preprocessor-based debug statements to our logging module 2024-09-28 15:00:45 +02:00
doc v2.3.1 2024-10-03 10:47:35 +02:00
src Activate ANSI processing on older terminals on Windows 2024-09-28 20:55:55 +02:00
test Add test cases for generating debug log output 2024-09-28 15:00:45 +02:00
tools Add chocolatey package spec 2019-03-28 22:09:10 +01:00
utest Remove remaining EOF comments from source files 2024-09-28 15:00:45 +02:00
.clang-format Update copyright statements for 2024 2024-02-16 22:01:58 +01:00
.gitattributes Update copyright statements for 2024 2024-02-16 22:01:58 +01:00
.gitignore Update copyright statements for 2024 2024-02-16 22:01:58 +01:00
boxes-config Remove remaining EOF comments from source files 2024-09-28 15:00:45 +02:00
boxes-pkg.openwrt v2.3.1 2024-10-03 10:47:35 +02:00
boxes.portable.nuspec v2.3.1 2024-10-03 10:47:35 +02:00
boxes.vim Remove remaining EOF comments from source files 2024-09-28 15:00:45 +02:00
LICENSE Upgrade project license to GPL-3 #101 2022-09-18 15:00:15 +02:00
Makefile v2.3.1 2024-10-03 10:47:35 +02:00
README-0.gif Update sample GIF in README.md 2024-09-30 21:57:17 +02:00
README.md Give SPDX id of our license in README 2024-06-01 16:18:23 +02:00
README.Win32.md Increased version number to 1.3 for release 2019-02-21 18:50:44 +01:00

Build Status Coverage Latest Version

boxes

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.

Download

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.

Status

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.

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!

Custom box designs

In addition to the pre-defined 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.

License

Boxes is free software under the GNU General Public License, version 3 (GPL-3.0-only).

 __________________________________
/\                                 \
\_|    May your days with Boxes    |
  |    be filled with discovery    |
  |    and delight!                |
  |   _____________________________|_
   \_/_______________________________/