Skip to content

Home

Jump to bottom
Bocaletto Luca edited this page Jul 19, 2025 · 1 revision

Welcome to the CryptoLinkShare wiki!

CryptoLinkShare

Client-side encrypted link generator with AES-256, shareable URLs, QR codes, and JSON mapping export/import.

Try Demo

Table of Contents

Features

  • AES-256 client-side encryption (via CryptoJS)
  • Opaque shareable links (#/e/{token})
  • Live QR code generation (via QRCode.js)
  • Persistent mapping in localStorage
  • Export/import mapping as mapping.json
  • Full static implementation: HTML, CSS, JavaScript, JSON
  • No backend required—works on any static host or local HTTP server

Demo

Open the live demo on GitHub Pages:
https://bocaletto-luca.github.io/CryptoLinkShare/index.html

Getting Started

These instructions will get you a copy of the project up and running on your local machine.

Prerequisites

A modern browser and a simple static HTTP server. For example:

  • Python 3 
    python3 -m http.server 8000
  • Node.js 
    npx http-server . -p 8000

Installation

  1. Clone this repository:

    git clone https://github.com/bocaletto-luca/CryptoLinkShare.git
cd CryptoLinkShare

  2. Start your HTTP server in this directory:

    python3 -m http.server 8000

  3. Open your browser at http://localhost:8000 and enjoy!

Usage

  1. Generate Secure Link

    • Paste any URL into the input field and click Generate Secure Link.
    • The page displays:
      • A shareable encrypted link (#/e/{token})
      • A QR code you can scan
      • A Copy button to copy the link to your clipboard

  2. Share

    • Send the encrypted link or QR code to recipients.
    • When they visit the link on the same page, they will be automatically redirected.

  3. Export Mapping

    • Click Export Mapping to download mapping.json, containing all {token: originalURL} pairs.

  4. Import Mapping

    • Click Import Mapping and select a previously exported mapping.json to restore your mapping.

How It Works

  • Encryption: Uses CryptoJS AES-256 to encrypt URLs into opaque tokens.
  • Decryption & Redirect: When visiting index.html#/e/{token}, the app decrypts the token and performs a client-side redirect.
  • QR Codes: Utilizes QRCode.js to render a scannable QR code for each encrypted link.
  • Persistence: Stores the token-to-URL mapping in localStorage for quick recall; export/import provides backup and portability.
  • Client-Side Only: All logic lives in a single HTML file—no server-side dependencies or databases.

File Structure

CryptoLinkShare/
├── index.html      # Single-page app with embedded HTML, CSS, JS
├── mapping.json    # Optional export/import file for token→URL mapping
└── README.md       # This file

Customization

  • Passphrase: Edit the SECRET constant in the inline <script> of index.html.
  • Styling: Modify the <style> block in index.html or convert it to an external style.css.
  • Routing Prefix: Change the #/e/ prefix in the script if preferred.

Contributing

Contributions are welcome! To propose improvements or report issues:

  1. Fork the repository
  2. Create a new branch (git checkout -b feature/my-feature)
  3. Commit your changes (git commit -m "Add my feature")
  4. Push to your fork (git push origin feature/my-feature)
  5. Open a Pull Request

Please ensure your code adheres to the existing style and is well-tested.

License

This project is licensed under the MIT License.

Author

Bocaletto Luca

Clone this wiki locally