DrivenTundra16

🐦 WhyTwitter - Take Control of Your Twitter Time

A Chrome extension that adds psychological friction to Twitter/X by requiring you to state your intention before accessing it.

🚀 Getting Started

Follow these simple steps to download and run the WhyTwitter extension.

Step 1: Download the Extension

To get the extension, you have two options:

1. Using Git: If you have Git installed, open your terminal and type:

   git clone https://github.com/randomness11/whytwitter.git
   

2. Downloading ZIP: If you prefer a direct download, click Code → Download ZIP on the GitHub Releases Page and extract the contents to your computer.

Step 2: Open Chrome Extensions Page

• Open Chrome.
• Go to the Extensions page by typing this in the address bar:

  chrome://extensions/
  

Step 3: Enable Developer Mode

• In the top right corner of the Extensions page, toggle on Developer mode.

Step 4: Load the Extension

Now you’ll load the extension you just downloaded:

1. Click the Load unpacked button.
2. Navigate to the folder where you extracted the ZIP file or cloned the repository.
3. Select the folder and click Open.

Step 5: Confirm Installation

Once you load the extension, you should see it listed on the Extensions page. Click on the puzzle piece icon in the top right of Chrome to pin the extension for easy access.

🔥 How It Works

Using WhyTwitter is straightforward:

1. Navigate to twitter.com or x.com, and you will see the extension’s popup.
2. Type your reason for visiting Twitter (must be 5 or more characters).
3. Once you type your intention, you gain access for 5 minutes in that tab only.
4. After 5 minutes, the extension will block access again.
5. If you open a new tab, you will need to state a new reason.

🌟 Features

• 🚫 Blocks Twitter/X until you state your reason.
• ⏱️ Enforces a 5-minute access limit per tab.
• 📝 Logs all your reasons locally for your review.
• 🔒 Does not collect data; operates entirely offline.
• 🎨 Matches X’s official design for a seamless user experience.

📥 Download & Install

To download the latest version of WhyTwitter, visit the GitHub Releases Page. You will find all the files you need to get started.

🛠️ System Requirements

To use WhyTwitter, you will need:

• A computer running Windows, macOS, or Linux.
• Google Chrome installed on your device (latest version recommended).

⚙️ Troubleshooting

If you experience issues, consider the following steps:

1. Reload Chrome: Close and reopen Chrome to refresh the extension.
2. Check Permissions: Make sure that the extension has the required permissions to run.
3. Update Chrome: Ensure that you have the latest version of Chrome.

🗨️ Feedback

We value your input. If you have any suggestions or feedback, please feel free to open an issue on the GitHub Repository. Your contributions can help us improve this tool for everyone.

Enjoy using WhyTwitter to take control of your time on Twitter!