Skip to content

README.md

Latest commit

 

History

History
106 lines (74 loc) · 3.41 KB

README.md

File metadata and controls

106 lines (74 loc) · 3.41 KB
Raw

Parseltongue (αlpha)

parseltongue

Parseltongue is a powerful browser extension for text conversion and real-time tokenization visualization, supporting formats like leetspeak, binary, base64, and more to come. Perfect for developers, linguists, and casual users to enhance text prompts on the fly.

Compatibility

Feature Firefox Chrome
Text Conversion Fully compatible Some bugs
Tokenization Visualization Fully compatible Some bugs
Popup UI Fully compatible Some bugs
Context Menu Integration Fully compatible Some bugs
Real-time Visualization Fully compatible Some bugs

Features

  • Text Conversion: Convert text to/from leetspeak, binary, base64, ROT13, and more.
  • Tokenization Visualization: Real-time token visualization with colored tokens.
  • User Interface: Easy access via popup and context menu integration.

To Add: glitch token library, prompt library (system prompts + 'harmful' prompts for testing), language translation, text reversal, special characters + unicode, emojispeak, word order scrambling, prompt enhancer/mutator, image mutator (adds noise)

Installation

Clone the Repository

git clone https://github.com/BASI-LABS/parseltongue.git
cd parseltongue

Build the Extension

Parseltongue uses Webpack to bundle the extension. Follow these steps to compile the extension:

  1. Install Dependencies:

    npm install

  2. Compile with Webpack:

    npm run build

Load the Extension

Chrome

  1. Go to chrome://extensions/
  2. Enable "Developer mode"
  3. Click "Load unpacked"
  4. Select the dist directory

Firefox

  1. Go to about:debugging#/runtime/this-firefox
  2. Click "Load Temporary Add-on..."
  3. Select any file in the dist directory

Usage

  • Text Conversion: Highlight text, right-click, and select "Convert Text".
  • Tokenization Visualization: Use the popup to visualize tokens in real-time.
  • Toggle Real-time Visualization: Click the extension icon to enable/disable real-time token visualization.

Contributing

We welcome contributions! Follow these steps to set up your development environment:

  1. Fork the Repository: Click the "Fork" button at the top right of the repository page.
  2. Clone Your Fork: 
    git clone https://github.com/<your-username>/parseltongue.git
cd parseltongue
  3. Create a Branch: 
    git checkout -b feature/your-feature-name
  4. Make Your Changes: Implement your feature or fix.
  5. Commit Your Changes: 
    git add .
git commit -m "Description of your changes"
  6. Push to Your Fork: 
    git push origin feature/your-feature-name
  7. Create a Pull Request: Open a pull request from your branch to the main branch of the original repository.

Running a Temporary Extension

To test the extension without permanently installing it, follow the loading instructions under "Load the Extension" for Chrome or Firefox.

License

Licensed under the MIT License. See the LICENSE file for details.

Parseltongue - Convert and visualize text like magic!