A simple dollcode encoder, decoder, and generator inside your terminal :3 GPL-3.0-or-later
Find a file
2026-02-18 01:51:53 +00:00
src 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
.gitignore initial commit :3c 2026-02-09 14:24:35 +00:00
Cargo.lock corrected part of the readme which showed a cargo command instead of the actual application command 2026-02-15 13:05:12 +00: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 changed installation section slightly to not specify each individual git instance 2026-02-18 01:51:53 +00: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

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)
  • a: 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