Skip to content

Latest commit

Β 

History

3 Commits

Folders and files

NameName
Last commit message
Last commit date
Β 
Β 
Β 
Β 

Repository files navigation

πŸ” Message Convertor

HTML5 CSS3 JavaScript Web App Status

Message Convertor is a browser-based secret message transformation tool that converts ordinary messages into context-specific disguised messages using predefined word mappings.

The application provides separate sender and receiver interfaces, allowing users to select a communication context, transform selected words into alternative phrases, copy the disguised message, and decode it back using the corresponding mapping system.

Built entirely with HTML, CSS, and vanilla JavaScript, the project requires no backend, database, framework, or build system.


πŸ“‘ Table of Contents

  • Features
  • How It Works
  • Conversion Modes
  • Screenshots
  • Live Demo
  • Technologies
  • Project Structure
  • Message Mapping System
  • Encryption & Decryption Logic
  • Clipboard Support
  • Installation
  • Important Note
  • Future Improvements
  • Contributing
  • License
  • Author
  • Support

✨ Features

  • πŸ” Rule-based secret message conversion
  • πŸ”„ Reversible message transformation
  • 🎭 Context-specific disguise systems
  • 🎲 Random replacement selection
  • πŸ‘€ Separate Sender and Receiver interfaces
  • πŸ’‘ GF/BF school-themed conversion mode
  • ⚽ Friend sports-themed conversion mode
  • 🏠 Family chores-themed conversion mode
  • πŸ’Ό Higher-Ups work-themed conversion mode
  • πŸ“‹ One-click copy-to-clipboard
  • βœ… Copy confirmation feedback
  • πŸ“± Mobile-focused responsive interface
  • 🌌 Futuristic CyberGlass interface
  • ✨ Animated gradient background
  • πŸ’Ž Glassmorphism cards
  • πŸ’‘ Neon glow effects
  • 🎨 Orbitron + Poppins typography
  • ⚑ Fully client-side processing
  • 🚫 No backend required
  • 🚫 No database required
  • 🚫 No account required
  • 🌐 Works directly in a modern browser

🎭 Conversion Modes

The application contains four different context-based conversion systems.

πŸ’‘ GF/BF β€” School Theme

Designed around school and study-related disguises.

Example mappings include concepts such as:

meet β†’ study / review / discuss
date β†’ study session / group study / tutorial
kiss β†’ solve problem / take notes / do homework
love β†’ enjoy class / like subject / appreciate lesson
secret β†’ homework / assignment / project
party β†’ library visit / study group / exam prep

⚽ Friend β€” Sports Theme

Messages are transformed using sports-related terminology.

Example mappings include:

secret β†’ game strategy / team play / match plan party β†’ soccer game / basketball match / tennis session drink β†’ hydrate / refuel / take a break smoke β†’ warm up / stretch / practice hang out β†’ train / compete / play gossip β†’ discuss tactics / review plays / analyze game trouble β†’ foul / penalty / red card fun β†’ victory / goal / score


🏠 Family β€” Chores Theme

Messages are converted into everyday household or chore-related phrases.

Example mappings include:

secret β†’ grocery list / cleaning task / house chore party β†’ family dinner / house cleaning / grocery shopping drink β†’ make tea / prepare meal / wash dishes date β†’ run errand / fix something / organize room trouble β†’ forgot chore / missed task / delayed errand fun β†’ help at home / do laundry / cook dinner meet β†’ visit relative / help neighbor / attend meeting love β†’ appreciate family / enjoy home / like routine


πŸ’Ό Higher-Ups β€” Work Theme

Messages are disguised using professional workplace terminology.

Example mappings include:

bribe β†’ submit report / send update / provide feedback cheat β†’ optimize process / streamline task / improve efficiency skip β†’ postpone meeting / reschedule task / defer assignment lie β†’ adjust statement / refine details / clarify points secret β†’ confidential info / internal memo / project detail trouble β†’ issue report / problem log / error notice meet β†’ schedule call / arrange discussion / set up review favor β†’ request assistance / seek approval / ask for input


⚑ How It Works

The application uses a predefined mapping database containing original words and their possible disguised replacements.

Sender Flow Select a recipient/context type. Enter the original message. Click Encrypt Message. The application searches for supported words. Matching words are replaced with context-specific alternatives. When multiple alternatives exist, one is selected randomly. The transformed message appears in the disguised message field. Click Copy Disguised Text to copy the result.


Receiver Flow

Select the corresponding sender/context type. Paste the disguised message. Click Decrypt Message. The application searches the reverse mapping table. Recognized disguised phrases are converted back to their original terms. The decoded message appears in the output field.


🧠 Message Mapping System

The conversion engine is based on a JavaScript mapping object.

Each context contains:

forward reverse

The forward mapping defines how original words are transformed into disguised alternatives.

The reverse mapping is generated automatically from the forward mappings when the application starts.

Conceptually:

Original Message β”‚ β–Ό Context Selection β”‚ β–Ό Forward Mapping β”‚ β–Ό Random Disguise β”‚ β–Ό Disguised Message

For decoding:

Disguised Message β”‚ β–Ό Context Selection β”‚ β–Ό Reverse Mapping β”‚ β–Ό Decoded Message


🎲 Randomized Disguise Selection

Some original words have multiple possible replacement phrases.

For example:

meet β”œβ”€β”€ study β”œβ”€β”€ review └── discuss

When the conversion is performed, JavaScript randomly selects one of the available alternatives.

This means the same original word can produce different disguised messages across multiple conversions.


πŸ”„ Text Transformation Logic

The conversion engine:

Converts the message to lowercase. Sorts mapping keys by length. Creates word-boundary regular expressions. Searches for matching terms. Replaces matching terms with mapped alternatives. Returns the transformed message.

Longer phrases are processed before shorter ones to reduce conflicts between overlapping mappings.


πŸ“‹ Clipboard Support

The application includes browser clipboard functionality.

After generating a disguised message, users can click:

Copy Disguised Text

The application uses the browser's Clipboard API to copy the generated message and displays a temporary confirmation:

βœ… Copied!


🎨 User Interface

The application uses a futuristic CyberGlass Holo UI design.

UI Highlights

🌌 Animated dark gradient background πŸ’Ž Glassmorphism panels πŸ”΅ Neon cyan accents 🟣 Gradient action buttons ✨ Glow effects 🧊 Backdrop blur πŸ“± Mobile-first layout πŸ“Œ Sticky header πŸ“Œ Fixed footer 🎞️ Smooth transitions 🎯 Responsive controls

The interface is specifically optimized for smaller screens while remaining usable on larger displays.


πŸš€ Live Demo

πŸ”— Open Message Convertor


βš™οΈ Technologies Used

HTML5 β€” Application structure CSS3 β€” CyberGlass UI, responsive design, animations and effects JavaScript ES6 β€” Message conversion and application logic Regular Expressions β€” Word-boundary matching and replacement Clipboard API β€” Copying generated messages Google Fonts β€” Poppins and Orbitron


πŸ“‚ Project Structure

Message-Convertor/ β”‚ β”œβ”€β”€ index.html β”œβ”€β”€ images/ β”‚ β”œβ”€β”€ home.png β”‚ β”œβ”€β”€ converter.png β”‚ β”œβ”€β”€ gf-bf-mode.png β”‚ β”œβ”€β”€ friend-mode.png β”‚ β”œβ”€β”€ family-mode.png β”‚ β”œβ”€β”€ higher-ups-mode.png β”‚ └── mobile.png β”‚ └── README.md

The main application is implemented in a single HTML file containing the page structure, styling, mapping system, and JavaScript logic.


πŸ’» Installation

Clone the repository:

git clone https://github.com/dhruvpandit46/Message-Convertor.git

Navigate into the project:

cd Message-Convertor

Open:

index.html

in any modern web browser.

No package installation is required.

No build process is required.

No backend server is required.


🌐 Browser Compatibility

The project uses standard browser APIs and modern JavaScript features.

For the best experience, use a modern browser such as:

Google Chrome Microsoft Edge Mozilla Firefox Safari

Clipboard functionality may require a secure context such as HTTPS when deployed online.


πŸ”’ Privacy

Message processing happens directly inside the browser.

The project does not require:

User accounts A backend server A database Cloud storage External AI services

Messages entered into the application are processed locally by the JavaScript conversion logic.


⚠️ Important Note

Message Convertor is a rule-based text disguise tool, not a cryptographic encryption system.

The application does not provide cryptographic security, secure key exchange, or protection against cryptanalysis.

Its purpose is to transform messages into context-specific disguised text using predefined substitution rules.

It should therefore not be used for protecting sensitive, confidential, financial, authentication, or security-critical information.


πŸ§ͺ Example

Original Let's meet tomorrow. GF/BF School Theme

Possible result:

Let's study tomorrow.

Because the application can randomly choose from multiple replacements, another conversion could produce:

Let's review tomorrow.

The receiver can then use the same context to decode the disguised terminology.


πŸš€ Future Improvements

Possible future improvements include:

πŸ” Real cryptographic encryption options πŸ”‘ User-defined encryption keys 🧠 Custom mapping creation πŸ“š Larger conversion dictionaries 🌍 Multi-language support πŸ’Ύ Save and manage custom mappings πŸ“€ Export converted messages πŸ“₯ Import mapping files πŸŒ“ Theme customization πŸ“± Progressive Web App support πŸ”— Shareable encoded messages πŸ›‘οΈ Secure encryption mode using modern cryptographic algorithms 🎨 Additional disguise themes πŸ“Š Conversion history


🀝 Contributing

Contributions are welcome.

To contribute:

Fork the repository. Create a feature branch. git checkout -b feature/your-feature Make your changes. Commit your changes. git commit -m "Add your feature" Push the branch. git push origin feature/your-feature Open a Pull Request.


πŸ“œ License

Licensed under the MIT License.

MIT Β© 2026 Dhruv Pandit.

See the LICENSE file for full license details.


πŸ‘¨β€πŸ’» Author

Dhruv Pandit

GitHub: @dhruvpandit46


⭐ Support

If you found this project interesting or useful, consider giving the repository a ⭐ on GitHub.

It helps support future development and encourages more experimental web projects.

About

A browser-based secret message converter that disguises messages using context-aware word mappings, reversible decoding, random substitutions, and a futuristic CyberGlass UI.

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages