A simple dollcode encoder, decoder, and generator inside your terminal :3 GPL-3.0-or-later
Find a file
2026-04-13 09:14:01 +01:00
pkg updated PKGBUILD for v1.4.0 2026-04-08 21:50:45 +01:00
src fixed pattern generation to not throw error if zero value is generated 2026-04-13 09:14:01 +01:00
.gitignore updated gitignore and cargo packages 2026-04-03 19:43:58 +01:00
Cargo.lock updated pattern tokens in readme 2026-04-10 20:17:10 +01:00
Cargo.toml incremented minor version counter to v1.4.0 2026-04-08 21:42:49 +01:00
LICENSE added license information (GPL3) :3 2026-02-09 21:59:16 +00:00
README.md updated pattern tokens in readme 2026-04-10 20:17:10 +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: Digit (0-9)
  • l: Letter Lowercase (a-z)
  • L: Letter Uppercase (A-Z)
  • m: Letter Mixed (a-z, A-Z)
  • a: Alphanumeric Lowercase (0-9, a-z)
  • A: Alphanumeric Uppercase (0-9, A-Z)
  • x: Alphanumeric Mixed (0-9, a-z, A-Z)
  • b: Binary Digit (0-1)
  • o: Octal Digit (0-7)
  • h: Hex Lowercase (0-f)
  • H: Hex Uppercase (0-F)
  • X: Hex Mixed (0-9, a-f, A-F)
  • *: any other character is used literally
$ 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