# Install boxes with Homebrew, apk, apt, dnf, MacPorts, Nix, scoop

Draw boxes around text. Version 2.3.1 via Homebrew; verified 2026-06-22.

## Install

```sh
sudo av install brew:boxes
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install boxes
```

  Evidence: local Homebrew formula metadata

- MacPorts (94%):

```sh
sudo port install boxes
```

  Evidence: MacPorts ports tree: textproc/boxes/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1

### Linux

- apk (92%):

```sh
sudo apk add boxes
```

  Evidence: Alpine Linux edge package indexes: boxes from https://dl-cdn.alpinelinux.org/alpine/edge/testing/x86_64/APKINDEX.tar.gz

- Debian apt (92%):

```sh
sudo apt install boxes
```

  Evidence: Debian stable package indexes: boxes from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz

- dnf (92%):

```sh
sudo dnf install boxes
```

  Evidence: Fedora Rawhide package metadata: boxes from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/e5ca8ce900cd68f5419e1c39ae517343100b306336cbaeb70a3c153121d95094-primary.xml.zst

- Nix (92%):

```sh
nix profile install nixpkgs#boxes
```

  Evidence: nixpkgs package indexes: pkgs/by-name/bo/boxes/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1

### Windows

- Scoop (92%):

```sh
scoop install main/boxes
```

  Evidence: Scoop official bucket manifest trees: bucket/boxes.json from https://api.github.com/repos/ScoopInstaller/Main/git/trees/master?recursive=1

## Package facts

- **Package key:** brew:boxes
- **Package manager:** Homebrew
- **Package manager page:** <https://formulae.brew.sh/formula/boxes>
- **Version:** 2.3.1
- **Source summary:** Draw boxes around text
- **Homepage:** <https://boxes.thomasjensen.com/>
- **Repository:** <https://github.com/ascii-boxes/boxes>
- **Upstream docs:** <https://boxes.thomasjensen.com/>
- **License:** GPL-3.0-only
- **Source archive:** <https://github.com/ascii-boxes/boxes/archive/refs/tags/v2.3.1.tar.gz>
- **Last updated:** 2026-06-22T14:02:55-07:00
- **Generated:** 2026-07-08T18:08:21+00:00

## Executables

- boxes (cli)
- boxes (alias)

## Dependencies

- libunistring
- pcre2

## Build dependencies

- bison

## Uses from macOS

- ncurses

## Install behavior

- Post-install hook: not defined
- Bottle: available on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, arm64_ventura, sonoma, ventura, x86_64_linux

## Freshness

- Page generated: 2026-07-08
- Package-manager version: 2.3.1
- Package-manager updated: 2026-06-22
- Local data: ok
- Upstream repository: https://github.com/ascii-boxes/boxes
- Upstream latest detected: v2.3.1 (current)
## Project history and usage

boxes is a long-lived Unix-style text filter for drawing, removing, and repairing ASCII art boxes around text. Its own README describes it as stable software that has existed since 1999 and remains available through many package managers.

### Project history

The project is maintained under the ascii-boxes organization and documents Thomas Jensen's official website, manual page, and configuration syntax as its primary user-facing surfaces. The modern GitHub history includes a v1.0 tag in 2014 and ongoing maintenance releases into the 2020s, while the README says the program itself dates back to 1999.

The program's historical shape is classic filter culture: it reads text, applies a named box design, and writes transformed text. Later documentation emphasizes user-defined box designs, shared configuration files, editor integration, and portability across Unix-like systems and Windows.

### Adoption history

The official README notes package-manager availability across apt, rpm, choco, brew, and other ecosystems. The Homebrew input also lists boxes in apk, brew, Debian, Fedora, MacPorts, Nix, Scoop, and Ubuntu, which matches its role as a small portable utility rather than a single-platform application.

Adoption is helped by its editor-filter workflow: the manual and website describe using boxes from editors that can pipe text through external filters, making it useful for source comments, email, plain-text notes, and README ornamentation.

### How it is used

Typical usage pipes text into the command, for example the official README's `echo foo | boxes`, then chooses designs with options such as listing available boxes. The configuration documentation explains that custom designs live in boxes config files and can be shared back through the repository.

Because it is a pure command-line filter, boxes composes naturally with shells, editors, and scripts. Its value is not heavy document rendering; it is quick decoration and comment-block formatting in plain text.

### Why package nerds care

boxes is package-nerd catnip because it is tiny, old, portable, and visually obvious: a package manager installs one command and the user immediately sees a text transformation. It represents the ornamental side of Unix filters, where package collections preserve small tools whose usefulness is partly practical and partly cultural.

The project also has an unusually packageable asset: the box-design database. That makes it more than a binary wrapper; distributions are shipping a small command plus a community-curated catalog of ASCII layouts.

### Timeline

- 1999: Project origin date stated in the official README.
- 2014: v1.0 tag appears in the official GitHub repository.
- 2021: v2.1.1 tag appears in the official GitHub repository.
- 2024: Official website documents v2.3.1 as a maintenance release.

### Related projects

- boxes relates to classic Unix text filters, editor filter commands, figlet-style terminal ornamentation, and other ASCII-art utilities.
- Its closest project-specific related artifact is the official boxes-config file, where the bundled and contributed box designs are maintained.

### Sources

- <https://boxes.thomasjensen.com/>
- <https://boxes.thomasjensen.com/boxes-man-1.html>
- <https://boxes.thomasjensen.com/config-syntax.html>
- <https://github.com/ascii-boxes/boxes#readme>
- source_facts.package-manager


## Security Notes

narrow executable package without higher-risk signals.

- **Geiger risk:** green / low
- narrow executable package without higher-risk signals


## Configuration and credential file locations

These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval.


## Configuration files

- Unix: ~/.boxes, ~/.config/boxes/.boxes, /usr/share/boxes
## Source Database Details

- **Source Database:** Homebrew formula API
- **Tap:** homebrew/core
- **Full Name:** boxes
- **Version Scheme:** 0
- **Revision:** 0
- **Head Version:** HEAD
- **Bottle Stable Root URL:** <https://ghcr.io/v2/homebrew/core>
- **Deprecated:** no
- **Disabled:** no
- **Keg Only:** no
- **URL Keys:** head, stable

## Other Package-Manager Records

- Debian apt - boxes - 2.3.1-1: normalized package name match | Debian stable package indexes: boxes from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | textmode box- and comment drawing filter | https://boxes.thomasjensen.com/
- Nix - boxes: normalized package name match | nixpkgs package indexes: pkgs/by-name/bo/boxes/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1
- Ubuntu apt - boxes - 2.2.1-1: normalized package name match | Ubuntu 24.04 LTS package indexes: boxes from https://archive.ubuntu.com/ubuntu/dists/noble/universe/binary-amd64/Packages.gz | textmode box- and comment drawing filter | https://boxes.thomasjensen.com/
- apk - boxes - 2.3.1-r0: normalized package name match | Alpine Linux edge package indexes: boxes from https://dl-cdn.alpinelinux.org/alpine/edge/testing/x86_64/APKINDEX.tar.gz | Text mode box and comment drawing filter | https://boxes.thomasjensen.com
- apk - boxes-doc - 2.3.1-r0: normalized package name match | Alpine Linux edge package indexes: boxes-doc from https://dl-cdn.alpinelinux.org/alpine/edge/testing/x86_64/APKINDEX.tar.gz | Text mode box and comment drawing filter (documentation) | https://boxes.thomasjensen.com
- dnf - boxes - 2.3.1-5.fc44: normalized package name match | Fedora Rawhide package metadata: boxes from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/e5ca8ce900cd68f5419e1c39ae517343100b306336cbaeb70a3c153121d95094-primary.xml.zst | Command line ASCII boxes unlimited! | http://boxes.thomasjensen.com
- dnf - boxes-vim - 2.3.1-5.fc44: normalized package name match | Fedora Rawhide package metadata: boxes-vim from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/e5ca8ce900cd68f5419e1c39ae517343100b306336cbaeb70a3c153121d95094-primary.xml.zst | Vim plugin for boxes | http://boxes.thomasjensen.com
- MacPorts - boxes: normalized package name match | MacPorts ports tree: textproc/boxes/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1
- Scoop - main/boxes: normalized package name match | Scoop official bucket manifest trees: bucket/boxes.json from https://api.github.com/repos/ScoopInstaller/Main/git/trees/master?recursive=1


## Related links

- [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata.
- [Text processing packages](https://www.automicvault.com/pkg/text-processing-tools/) - Matched text, document, or structured-data processing metadata.
- [Networking and protocol packages](https://www.automicvault.com/pkg/networking-protocol-tools/) - Matched network, protocol, or remote-service metadata.
- [Productivity CLI packages](https://www.automicvault.com/pkg/productivity-cli-packages/) - Matched curated productivity category metadata from av.db.
- [pcre2](https://www.automicvault.com/pkg/brew/pcre2/) - Runtime dependency declared by Homebrew.
- [bison](https://www.automicvault.com/pkg/brew/bison/) - Build dependency declared by Homebrew.
- [arttime](https://www.automicvault.com/pkg/brew/arttime/) - Shares av.db curated category or tags: ascii-art, cli, productivity.
- [a2ps](https://www.automicvault.com/pkg/brew/a2ps/) - Shares av.db curated category or tags: cli, productivity.
- [abook](https://www.automicvault.com/pkg/brew/abook/) - Shares av.db curated category or tags: cli, productivity.
- [acronym](https://www.automicvault.com/pkg/brew/acronym/) - Shares av.db curated category or tags: cli, productivity.
- [ad](https://www.automicvault.com/pkg/brew/ad/) - Shares av.db curated category or tags: cli, productivity.
- [aerc](https://www.automicvault.com/pkg/brew/aerc/) - Shares av.db curated category or tags: cli, productivity.
- [aldo](https://www.automicvault.com/pkg/brew/aldo/) - Shares av.db curated category or tags: cli, productivity.
- [alexjs](https://www.automicvault.com/pkg/brew/alexjs/) - Shares av.db curated category or tags: cli, productivity.
- [edbrowse](https://www.automicvault.com/pkg/brew/edbrowse/) - Local package facts share a topical domain. Shared terms: cli, pcre2, productivity, text.
- [imapfilter](https://www.automicvault.com/pkg/brew/imapfilter/) - Local package facts share a topical domain. Shared terms: cli, pcre2, productivity.

## Combined YAML source

View the package source record on GitHub. [combined/boxes.yml](https://github.com/automic-vault/db/blob/main/combined/boxes.yml)


## Sources

- Nucleus package database
- Geiger risk classifier
- package-page enrichment
- curated configuration and credential file locations
- curated package history
- package version freshness
- av.db category and tag curation
- package relationship graph
- external package-manager database matches
- cross-ecosystem install command graph
