Skip to content

owengregson/tranquill

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

22 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

tranquill logo

tranquill

Human-like typing automation for Google Chrome.

Overview

tranquill is a real-time automated typing bot designed to work seamlessly with Google Chrome. This extension allows you to automate typing tasks on websites such as Google Docs, simulating human-like typing while doing so.

Using tranquill, you can create realistic edit history
on your documents, rather than pasting
and having everything appear at once.

⚠️ This code is provided for demonstrational purposes only. I am not liable for any misuse of this script. Use at your own discretion.

Features

  • Completely Undetectable: Simulates keypresses in a way that appears to like native keypresses, undetectable to any website.
  • Human-like Typing Simulation: Simulates realistic typing behavior, including variable typing speed, pauses, and delays based on key distances and human typing habits.
  • Version Control: Automatically checks for updates to ensure you always have the latest features and improvements.
  • User-Friendly Interface: Simple and intuitive UI to control and customize your typing tasks.

Installation

tranquill is currently not available in the Chrome Web Store. To install the extension, you will need to load it locally in Developer Mode. Follow the steps below:

Step 1: Download the Extension Files

  1. Clone or download the tranquill repository from this GitHub by clicking the green Code button, then clicking Download ZIP.
  2. Once downloaded, extract the ZIP file to a folder on your computer.

web page showing green code button



web page showing gray download ZIP button



mac os interface showing hovering open button

Step 2: Enable Developer Mode in Chrome

  1. Open Google Chrome.
  2. Navigate to chrome://extensions/.
  3. In the top right corner, toggle the switch to enable Developer mode.

url bar showing chrome extensions url



toggle slider showing enabling developer mode

Step 3: Load the Extension

  1. Click on the Load unpacked button in the top left corner.
  2. In the file dialog, navigate to the folder where you extracted the tranquill files.
  3. Select the folder and click Open.
  4. The tranquill extension should now appear in your list of extensions.

button labeled load unpacked



file dialog with tranquill folder selected

Step 4: Select and Pin Extension

  1. Click the extension button and select the tranquill extension.
  2. Pin the extension to the taskbar, and click it to open the GUI.

extensions icon



extension in list showing the pin icon



clicking tranquill icon

Usage

tranquill is designed to be intuitive and easy to use, with a focus on automating typing tasks in real-time. Here’s a step-by-step guide on how to use it:

Step 1: Open the Extension Popup

Click on the tranquill icon in the Chrome toolbar to open the extension's popup interface.

tranquill gui

Step 2: Enter Text

In the popup, you will see a text input field labeled "Text Queue". Enter or paste the text that you want tranquill to type. Then, press the blue Save button.

Step 3: Start Typing

Click the green Start button. tranquill will begin typing the text into the active element on the webpage. The typing speed and behavior will mimic human typing, including natural delays between keystrokes.

Step 4: Stop Typing

If you need to stop the typing process, simply click the red Stop button in the popup.

Step 5: Resetting the Input

If you want to clear the text queue, click the gray Reset button. This will clear the input field and stop any ongoing typing tasks.

Update Notifications

tranquill includes a built-in update notification system that checks for new versions each time the service worker is activated. If a new version is detected, the default popup is set to an update notification page, prompting you to update.

How to Update

  1. When an update is available, the extension will automatically show an Update Required page.
  2. Click the Update Now button to visit this repository, and follow the installation instructions found above.

Troubleshooting

  • Extension Not Loading: Make sure Developer Mode is enabled and the folder you selected is correct.
  • Version Check Failing: Ensure you have an active internet connection and that github.com is accessible on your WiFi network.
  • Typing Issues: Verify that the active element on the webpage is an input field or editable area where typing is possible.

For more detailed troubleshooting, please visit the issues section of this repository.

License

tranquill is licensed under the MIT License. See the LICENSE file for more details.

Contributing

We welcome contributions from the community! If you'd like to contribute, please fork the repository, create a new branch, and submit a pull request with your changes.


Happy Typing with tranquill!

tranquill logo