Bonar.Gibberish 1.0.2

Gibberish

A .NET library tool that turns readable Latin text into unreadable gibberish. It applies a sequence of substitution ciphers: shuffle letters, shuffle punctuation, then optionally map the Latin alphabet onto another script (Georgian or Thai).

This is a fun obfuscation tool, not encryption. Do not use it to protect secrets.

What it does

Given a string, Gibberish can:

1. Change capitalization — leave as-is, force uppercase, or force lowercase.
2. Shuffle letters — remap Latin letters using a random permutation.
3. Shuffle punctuation — remap a standard set of punctuation characters.
4. Replace the character set — map A–Z / a–z onto Georgian or Thai glyphs so the result looks like another script.

Transforms run in that order. Each step is independently configurable, so you can shuffle letters without touching punctuation, replace the script without shuffling, and so on.

Whitespace, digits, and characters outside the Latin alphabet / configured punctuation set are left unchanged.

Random vs Shuffle

Letter and punctuation transforms each have two permutation modes:

Requirements

• .NET 10 SDK

Library usage

Add a project reference to Gibberish, then call the ToGibberish() extension method:

using Gibberish;
using Gibberish.Enums;

// Defaults: random letter shuffle, random punctuation shuffle, Georgian replacement
var output = "Hello, World!".ToGibberish();

// Customize each transform
var formatter = new GibberishFormatter
{
    CapitalizationBehavior = CapitalizationBehavior.Lower,
    LetterOrderBehavior = LetterOrderBehavior.Shuffle,
    PunctuationOrderBehavior = PunctuationOrderBehavior.None,
    CharacterSetReplacementBehavior = CharacterSetReplacementBehavior.Thai
};

var thaiGibberish = "Hello, World!".ToGibberish(formatter);

ToGibberish throws ArgumentNullException if the input string is null. An empty string is valid and returns empty.

Default formatter

When you call ToGibberish() with no arguments, the library uses:

Formatter options

CapitalizationBehavior

Applied before letter shuffling, so a later cipher still sees the cased text.

LetterOrderBehavior

Uppercase and lowercase are treated as separate alphabets in Random mode.

PunctuationOrderBehavior

The standard punctuation set is:

; : , " . ? ' % $ \ / < > * & ^ # @ ! = - _ +

CharacterSetReplacementBehavior

This runs last, so shuffled Latin letters are what get mapped onto the target script.

Custom character data

The cipher tables come from ICharacterData. Pass your own implementation to control alphabets, punctuation, or replacement scripts (useful in tests):

var output = input.ToGibberish(formatter, myCharacterData);

The built-in CharacterData class supplies Latin A–Z / a–z, the punctuation list above, and the Thai / Georgian replacement sets.

Command-line tool

GibberishConsole reads a text file, transforms it, and writes a sibling file named <original> - gibberish<ext>. If that path already exists, it appends a number ( - gibberish 1, - gibberish 2, …).

# From the repo root
dotnet run --project GibberishConsole -- input.txt

# Also print the result to stdout
dotnet run --project GibberishConsole -- input.txt --render

# Control each transform
dotnet run --project GibberishConsole -- input.txt \
  --capitalization lower \
  --letter shuffle \
  --punctuation none \
  --characterSet thai

Options

Show the same help locally:

dotnet run --project GibberishConsole -- --help

Omitted options use the library defaults listed above.