A simple dollcode encoder, decoder, and generator inside your terminal :3 GPL-3.0-or-later
Find a file
2026-04-08 13:29:43 +01:00
pkg added PKGBUILD file for installation 2026-04-03 19:47:37 +01:00
src added pattern tokens help argument 2026-04-08 13:29:43 +01:00
.gitignore updated gitignore and cargo packages 2026-04-03 19:43:58 +01:00
Cargo.lock fixed args to only execute one set if multiple sets are passed 2026-04-08 12:12:21 +01:00
Cargo.toml 1.3.0 :: implemented the text autodetection for decoding which should have been present in 1.1.0 however wasn't because i forgor, also updated the README to reflect changes in encoding and decoding text 2026-02-11 20:32:14 +00:00
LICENSE added license information (GPL3) :3 2026-02-09 21:59:16 +00:00
README.md added uppercase variations for letter and alphanumeric generation symbols and removed --upper flag 2026-04-08 12:34:32 +01:00

dolltool

A simple dollcode encoder, decoder, and generator inside your terminal :3

About

Being technical, this is a high-performance, arbitrary-precision ternary encoder and decoder formatted into patterns using a set of block symbols (▖, ▘, ▌), also known as a 2-track pharmacode. Additionally, this program can generate codes based on patterns entered by the user.

This project was inspired by noe and its dollcode transcoder.

Installation

Arch Linux

You can install this package from the AUR with the package name dolltool, or alternatively by cloning the repository and using makepkg -si inside the pkg/ directory.

Other

Clone the repository then cd into the directory and run:

cargo install --path .

This will install the dolltool binary to your ~/.cargo/bin directory, so to execute anywhere from inside your terminal you must add ~/.cargo/bin to your path.

Usage

Encoding

If an integer is passed to encode it will by default be encoded as an integer:

$ dolltool -e 123
▖▖▖▖▌

If you would like to encode an integer as text instead you must pass the -t (--text) argument:

$ dolltool -e 123 -t
▖▘▖▖ ▖▘▖▘ ▖▘▖▌

Finally, any non-integer patterns will automatically be encoded as text:

$ dolltool -e "hello world :3"
▌▘▖▘ ▌▖▌▘ ▌▘▘▌ ▌▘▘▌ ▌▘▌▌ ▌▖▘ ▌▌▌▘ ▌▘▌▌ ▌▌▖▌ ▌▘▘▌ ▌▖▌▖ ▌▖▘ ▖▌▖▖ ▖▘▖▌

Decoding

This works the same for both integers and text:

$ dolltool -d ▖▖▖▖▌
123
$ dolltool -d "▌▘▖▘ ▌▖▌▘ ▌▘▘▌ ▌▘▘▌
▌▘▌▌ ▌▖▘ ▌▌▌▘ ▌▘▌▌ ▌▌▖▌ ▌▘▘▌ ▌▖▌▖ ▌▖▘ ▖▌▖▖ ▖▘▖▌"
hello world :3

Generation

Generates random codes based on a user-defined pattern:

  • n: Number (0-9)
  • l: Letter (a-z)
  • L: Uppercase Letter (A-Z)
  • a: Alphanumeric (0-9, a-z)
  • A: Uppercase Alphanumeric (0-9, a-z)
$ dolltool -g "nn-lll" -c 3
74-igm :: ▖▘▌▖ ▖▘▘▖ ▖▖▘▌ ▌▘▖▌ ▌▘▖▖ ▌▘▌▖
01-ldc :: ▖▖▌▌ ▖▘▖▖ ▖▖▘▌ ▌▘▘▌ ▌▖▌▖ ▌▖▘▌
44-mpx :: ▖▘▘▖ ▖▘▘▖ ▖▖▘▌ ▌▘▌▖ ▌▌▖▖ ▌▌▌▌

If the generation pattern contains only numbers it will use the integer encoding method as opposed to the string encoding method:

$ dolltool -g "nnnnnn" -c 3
933737 :: ▖▖▌▖▌▌▘▘▖▖▘▖▘
088231 :: ▌▌▌▌▘▘▌▘▖▖
439614 :: ▖▌▌▌▘▘▘▘▌▘▘▌

How it Works

dolltool uses a bijective base-3 system, this means unlike standard base-3 which uses 0, 1, and 2, it uses 1, 2, and 3. This removes the leading zeros which are often present in standard base-3.

Symbol Value
▖ 1
▘ 2
▌ 3

License

Copyright (c) 2026 ika4422, under GNU GPL-3.0-or-later.

See the LICENSE file or run:

dolltool --license