Introducing Parseltongue (αlpha)
Parseltongue is an innovative browser extension designed to make text conversion and real-time tokenization visualization accessible and efficient. This tool supports a variety of formats, including leetspeak, binary, base64, among others, making it a versatile choice for developers, linguists, and casual users alike to enhance text prompts effortlessly.
Compatibility
Parseltongue is fully compatible with both Firefox and Chrome browsers, providing a seamless experience with all its features, as outlined below:
Feature | Firefox | Chrome |
---|---|---|
Text Conversion | ✅ | ✅ |
Tokenization Visualization | ✅ | ✅ |
Popup UI | ✅ | ✅ |
Context Menu Integration | ✅ | ✅ |
Real-time Visualization | ✅ | ✅ |
Features
- Text Conversion: With the ability to convert text to and from various formats such as leetspeak, binary, base64, and ROT13, Parseltongue ensures flexibility in text manipulation.
- Tokenization Visualization: Offers real-time visualization of tokens, providing a colorful and interactive way to view text data.
- User Interface: The extension is equipped with an easy-to-use popup and context menu integration for quick access.
ROADMAP (To-Do)
The development plans for Parseltongue include adding features such as a glitch token library, prompt library with system and 'harmful' prompts for testing, language translation, text reversal, special characters and unicode support, emojispeak, word order scrambling, and more. Image mutator functionalities like adding noise are also on the horizon.
Installation
Clone the Repository
git clone https://github.com/BASI-LABS/parseltongue.git
cd parseltongue
Build the Extension
Parseltongue is built using Webpack. Follow these steps to compile the extension:
-
Install Dependencies:
npm install
-
Compile with Webpack:
npm run build
Load the Extension
Chrome
- Navigate to
chrome://extensions/
. - Enable "Developer mode".
- Click "Load unpacked".
- Select the
manifest.json
file in thedist
directory.
Firefox
- Go to
about:debugging#/runtime/this-firefox
. - Click "Load Temporary Add-on..."
- Select the
manifest.json
file from thedist
directory.
Accessing the Sidebar
For full functionality, access the sidebar after activating the extension:
- Chrome Users: Right-click the Parseltongue icon in the toolbar and select "Open side panel".
- Firefox Users: Use the sidebar icon, keyboard shortcut Ctrl+B (Cmd+B on Mac), or go to View > Sidebar in the menu and select Parseltongue.
Usage
- Text Conversion: Highlight the text, right-click, and select "Convert Text".
- Tokenization Visualization: Open the popup to see tokens in real-time.
- Toggle Real-time Visualization: Click the extension icon to enable or disable real-time token visualization.
Contributing
Open to contributions, Parseltongue encourages developers to join in by:
- Forking the Repository: Use the "Fork" button.
- Cloning Your Fork:
git clone https://github.com/<your-username>/parseltongue.git cd parseltongue
- Creating a Branch:
git checkout -b feature/your-feature-name
- Making Your Changes.
- Committing Your Changes:
git add . git commit -m "Description of your changes"
- Pushing to Your Fork:
git push origin feature/your-feature-name
- Creating a Pull Request: Submit a pull request to the
main
branch.
Temporary Extension Use
To try out the extension without permanent installation, follow the "Load the Extension" instructions for your browser.
License
Parseltongue is licensed under the MIT License. For further details, refer to the LICENSE file.
Parseltongue — convert and visualize text with ease and creativity!