Skip to content

michaelsboost/MatrixCipher

Repository files navigation

MatrixCipher

MatrixCipher lets you turn messages into encrypted, shareable URLs instantly.

MatrixCipher

MIT License GitHub Stars GitHub Issues


🚀 About MatrixCipher

MatrixCipher is a client-side encrypted messaging tool that transforms plain text into shareable URLs. It runs entirely in the browser, requiring no server-side message storage, no accounts, and no database setup. Just type your message, generate the encrypted link, and share it.

Built with a sleek retro terminal-inspired interface, MatrixCipher keeps everything lightweight and fast while giving users a simple way to create encrypted message links on demand.


🌟 Features

Client-Side Encryption – Encrypt messages directly in the browser.
URL-Based Sharing – Messages are stored in the URL fragment for instant sharing.
No Backend Required – No database, no user accounts, no server-side message handling.
Optional URL Compression – Uses compression to create shorter, more shareable links.
Instant Decryption – Open a valid MatrixCipher link and decrypt the message instantly.
Clipboard Integration – Quickly copy generated links or the current URL.
Minimal Terminal UI – Clean cyberpunk-inspired interface with a simple workflow.
Rich Text Input Handling – Message input is converted into plain text before processing.
Single-File Deployment – Easy to host and run from a single HTML file.
Mobile Friendly – Responsive layout for desktop and mobile browsers.


🛠️ Tech Stack

MatrixCipher uses a number of open-source tools to work properly:

  • CryptoJS – Handles AES-based encryption and decryption in the browser.
  • LZString – Compresses encrypted data for shorter URLs.
  • Alpine.js – Powers the app’s lightweight reactive behavior.
  • Tailwind CSS – Used for styling and layout.
  • TailwindCSSMod – Custom styling utility used in the interface.

📥 Installation & Setup

MatrixCipher is fully web-based – no installation needed.

To run locally:

Clone the Repository

git clone https://github.com/michaelsboost/MatrixCipher.git
cd MatrixCipher

Start a Local Server

To preview MatrixCipher locally, use a simple Python server:

python3 -m http.server 8000

Then open http://localhost:8000 in your browser.

You can also deploy the HTML file directly to any static host.


🔐 How It Works

MatrixCipher follows a simple workflow:

  1. Type your message into the editor.
  2. Click to generate an encrypted URL.
  3. The message is encrypted in the browser.
  4. The encrypted output is optionally compressed.
  5. The result is stored inside the URL fragment (#).
  6. Share the full URL with the recipient.
  7. Opening the link allows the app to read and decrypt the message locally.

Because everything happens in the browser, there is no message persistence on a server. The encrypted payload lives entirely in the URL.


⚡ Why MatrixCipher

MatrixCipher was built for people who want a fast, simple way to share encrypted messages without relying on a backend or complicated setup.

It is ideal for:

  • Sending quick private notes
  • Sharing encoded messages through a link
  • Lightweight browser-based encryption workflows
  • Static hosting with zero server logic
  • Experimental or educational crypto-inspired projects

🖥️ Interface Highlights

MatrixCipher includes:

  • A terminal-inspired encrypted message editor
  • One-click URL generation
  • Instant decryption from URL hash
  • Compression toggling for shorter links
  • Status feedback for encryption, decryption, and clipboard actions
  • Quick clear/reset functionality

The UI is designed to feel minimal, fast, and focused.


📜 License

MatrixCipher is open-source under the MIT License.
See the full license: LICENSE.


💡 Want to Contribute?

Awesome! MatrixCipher is free and open-source, and contributions are welcome.

How You Can Help:

🔹 Submit a Pull Request – Found a bug or want to improve the app?
🔹 Open an Issue – Share bugs, ideas, or feature requests.
🔹 Fork & Experiment – Build on it, customize it, and have fun with it.
🔹 Spread the Word – Share MatrixCipher with developers, privacy enthusiasts, and creators.

If MatrixCipher has been helpful to you, here are some ways you can show support:

ko-fi

Buy me a coffee: ko-fi.com/michaelsboost
🎨 Grab some of my art prints: DeviantArt Store
👕 Check out my gear: Merch Store
📚 See my other work: michaelsboost.com
💙 Donate via PayPal: Support via PayPal
💸 Donate via Cash App: Support via SquareCash

Your support helps keep open-source projects like MatrixCipher alive and growing.


📧 Contact

For questions, feature requests, or collaborations, reach out to:
Michael Schwartzmichaelsboost.com