Repolode
SheepChef

SheepChef/Abracadabra

Encrypts text into classical-Chinese-style prose built from Chinese characters, using AES-256 encryption.

Stars
2,527
Forks
231
Open issues
4
Last commit
4 days ago

What is it?

Abracadabra (魔曰) is a text encryption tool that converts plaintext into ciphertext written as classical-style Chinese prose. Instead of random-looking strings, the output reads like a short passage of ancient Chinese text, built from common Chinese characters that stand in for Latin letters, digits and some symbols.

Encryption uses AES-256-CTR as the core cipher, and data is compressed beforehand (Unishox2 for short text, GZIP for larger data). A three-rotor scrambling step, modeled on a rotor cipher machine, shifts the character mapping according to the key. Optional advanced settings add a stronger IV, HMAC-SHA256 signatures, PBKDF2 key derivation and TOTP-based salting.

The project is available as a static web page, Chrome, Edge and Firefox extensions, and an offline Android app built with Cordova. It can also be deployed to Cloudflare Workers, Netlify or Vercel.

Key features

  • 01Encrypts text with AES-256-CTR, with compression applied before encryption.
  • 02Outputs ciphertext disguised as classical-style Chinese prose.
  • 03Offers optional HMAC-SHA256, PBKDF2 and TOTP for stronger encryption.
  • 04Uses a three-rotor mapping that changes with the key.
  • 05Runs as a web page, browser extension or offline Android app.

Use cases

  • Hiding short messages in text that looks like ordinary classical prose.
  • Sharing encrypted notes in a form less conspicuous than random strings.
  • Hosting a private encryption page on a static hosting platform.

Quick start

  1. 1

    Open the online web app at abra.js.org

  2. 2

    Or download the static deploy package from the Release page

  3. 3

    Or install the browser extension from the Chrome, Edge or Firefox store

Things to know

  • The project uses the AIPL-1.2 license, a custom private license rather than a standard open-source license.
  • The README asks that the license be respected and copyright notices kept when deploying.
  • The Edge add-on store updates are slow, so the Edge version may lag behind.

Topics

FAQ

What is Abracadabra?
Encrypts text into classical-Chinese-style prose built from Chinese characters, using AES-256 encryption. Abracadabra (魔曰) is a text encryption tool that converts plaintext into ciphertext written as classical-style Chinese prose. Instead of random-looking strings, the output reads like a short passage of ancient Chinese text, built from common Chinese characters that stand in for Latin letters, digits and some symbols.
Is Abracadabra free to use? What license does it have?
Abracadabra is open source under the Other license. Check the license terms before using it in commercial products.
Is Abracadabra still maintained?
Actively maintained. The last commit to Abracadabra was on Oct 18, 2026.
What can I use Abracadabra for?
Hiding short messages in text that looks like ordinary classical prose. Sharing encrypted notes in a form less conspicuous than random strings. Hosting a private encryption page on a static hosting platform.
How do I install Abracadabra?
Open the online web app at abra.js.org Or download the static deploy package from the Release page Or install the browser extension from the Chrome, Edge or Firefox store
Where can I get Abracadabra?
The source code and installation instructions are on GitHub: https://github.com/SheepChef/Abracadabra

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects