From 63538efd6aa0c2d02ca387ef12a968a3719e4181 Mon Sep 17 00:00:00 2001
From: mehbark <terezi@pyrope.net>
Date: Wed, 22 Apr 2026 18:14:50 -0400
Subject: [PATCH] add readme

---
 README.md | 115 ++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 115 insertions(+)
 create mode 100644 README.md

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..65e0084
--- /dev/null
+++ b/README.md
@@ -0,0 +1,115 @@
+# Substitution helper
+Helps with cracking (English-only) substitution ciphers.
+
+## Usage example
+```
+substitution-helper < README.md SZ
+┌───┬───────┬────┐
+│ L │  Freq │  N │
+╞═══╪═══════╪════╡
+│ e │ 11.4% │ 12 │
+├───┼───────┼────┤
+│ Z │ 10.5% │ 11 │
+├───┼───────┼────┤
+│ t │  9.5% │ 10 │
+├───┼───────┼────┤
+│ i │  9.5% │ 10 │
+├───┼───────┼────┤
+│ u │  6.7% │  7 │
+├───┼───────┼────┤
+│ n │  5.7% │  6 │
+├───┼───────┼────┤
+│ l │  5.7% │  6 │
+├───┼───────┼────┤
+│ h │  5.7% │  6 │
+├───┼───────┼────┤
+│ r │  4.8% │  5 │
+├───┼───────┼────┤
+│ p │  4.8% │  5 │
+├───┼───────┼────┤
+│ o │  3.8% │  4 │
+├───┼───────┼────┤
+│ a │  3.8% │  4 │
+├───┼───────┼────┤
+│ m │  2.9% │  3 │
+├───┼───────┼────┤
+│ g │  2.9% │  3 │
+├───┼───────┼────┤
+│ c │  2.9% │  3 │
+├───┼───────┼────┤
+│ b │  2.9% │  3 │
+├───┼───────┼────┤
+│ d │  1.9% │  2 │
+└───┴───────┴────┘
+┌────┬──────┬───┐
+│ Di │ Freq │ N │
+╞════╪══════╪═══╡
+│ ti │ 6.7% │ 6 │
+├────┼──────┼───┤
+│ on │ 4.5% │ 4 │
+├────┼──────┼───┤
+│ it │ 4.5% │ 4 │
+├────┼──────┼───┤
+│ ut │ 3.4% │ 3 │
+├────┼──────┼───┤
+│ ub │ 3.4% │ 3 │
+├────┼──────┼───┤
+│ tu │ 3.4% │ 3 │
+├────┼──────┼───┤
+│ st │ 3.4% │ 3 │
+├────┼──────┼───┤
+│ lp │ 3.4% │ 3 │
+├────┼──────┼───┤
+│ io │ 3.4% │ 3 │
+├────┼──────┼───┤
+│ he │ 3.4% │ 3 │
+├────┼──────┼───┤
+│ er │ 3.4% │ 3 │
+├────┼──────┼───┤
+│ el │ 3.4% │ 3 │
+├────┼──────┼───┤
+│ bs │ 3.4% │ 3 │
+├────┼──────┼───┤
+│ su │ 2.2% │ 2 │
+├────┼──────┼───┤
+│ pe │ 2.2% │ 2 │
+├────┼──────┼───┤
+│ ng │ 2.2% │ 2 │
+└────┴──────┴───┘
+┌─────┬──────┬───┐
+│ Tri │ Freq │ N │
+╞═════╪══════╪═══╡
+│ uti │ 4.1% │ 3 │
+├─────┼──────┼───┤
+│ ubs │ 4.1% │ 3 │
+├─────┼──────┼───┤
+│ tut │ 4.1% │ 3 │
+├─────┼──────┼───┤
+│ tit │ 4.1% │ 3 │
+├─────┼──────┼───┤
+│ tio │ 4.1% │ 3 │
+├─────┼──────┼───┤
+│ sti │ 4.1% │ 3 │
+├─────┼──────┼───┤
+│ itu │ 4.1% │ 3 │
+├─────┼──────┼───┤
+│ ion │ 4.1% │ 3 │
+├─────┼──────┼───┤
+│ elp │ 4.1% │ 3 │
+├─────┼──────┼───┤
+│ bst │ 4.1% │ 3 │
+├─────┼──────┼───┤
+│ sub │ 2.7% │ 2 │
+├─────┼──────┼───┤
+│ per │ 2.7% │ 2 │
+├─────┼──────┼───┤
+│ lpe │ 2.7% │ 2 │
+├─────┼──────┼───┤
+│ hel │ 2.7% │ 2 │
+└─────┴──────┴───┘
+# ZubZtitution helper
+helpZ with cracking (engliZh-only) ZubZtitution cipherZ.
+
+## uZage example
+…
+```