Skip to content

I-bangash/x-reply-tracker

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

3 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

X Reply Target Tracker

A privacy-focused Chrome extension that helps you track and achieve your daily reply targets on X.com (formerly Twitter). Set goals, monitor progress, and stay motivated - all while keeping your data completely private.

๐ŸŽฏ Features

  • Daily Target Setting: Set your desired number of replies per day
  • Real-time Progress Tracking: Automatically detects when you post replies
  • Visual Progress Bar: Clean, minimal interface showing your progress
  • Persistent Overlay: Optional always-visible tracker on X.com
  • Privacy First: No data collected or sent to any 3rd party. Nothing leaves your device
  • Clean UI: Dark theme matching X's design aesthetic

๐Ÿ”’ Privacy Guarantee

This extension is built with privacy as the top priority:

  • โœ… 100% Local: All data stored locally on your device
  • โœ… No External Servers: Never communicates with outside services
  • โœ… No Data Collection: Doesn't read tweet content or personal info
  • โœ… Open Source: Full transparency - inspect the code yourself
  • โœ… No Analytics: No tracking, no metrics, no data harvesting
  • โœ… Chrome Sync Only: Uses Chrome's built-in sync (like bookmarks)

๐Ÿš€ Installation

Option 1: Manual Installation (Recommended)

  1. Download or clone this repository
  2. Open Chrome and navigate to chrome://extensions/
  3. Enable "Developer mode" (toggle in top right)
  4. Click "Load unpacked" and select the extension folder => "X-reply-tracker"
  5. The extension will appear in your Chrome toolbar

Option 2: Chrome Web Store

Coming soon - pending review

๐Ÿ“ File Structure

x-reply-tracker/
โ”œโ”€โ”€ manifest.json          # Extension configuration
โ”œโ”€โ”€ popup.html            # Extension popup interface
โ”œโ”€โ”€ popup.js              # Popup functionality
โ”œโ”€โ”€ content.js            # X.com page interaction
โ”œโ”€โ”€ background.js         # Background service worker
โ”œโ”€โ”€ icon16.png            # 16x16 icon
โ”œโ”€โ”€ icon48.png            # 48x48 icon
โ”œโ”€โ”€ icon128.png           # 128x128 icon
โ”œโ”€โ”€ README.md             # This file
โ”œโ”€โ”€ LICENSE               # MIT License
โ””โ”€โ”€ CONTRIBUTING.md       # Contribution guidelines

๐ŸŽฎ Usage

  1. Set a Target: Click the extension icon and enter your daily reply goal
  2. Browse X.com: Use X.com normally - the extension automatically tracks replies
  3. Monitor Progress: Check your progress anytime via the extension popup
  4. Stay Motivated: Optional overlay keeps your progress visible while browsing
  5. Toggle Overlay: Use the "Keep popup active" toggle for persistent tracking

๐Ÿ› ๏ธ Technical Details

Technologies Used

  • Manifest V3: Latest Chrome extension standard
  • Vanilla JavaScript: No external dependencies
  • Chrome Storage API: Local data storage
  • Content Script: Page interaction ui

Browser Compatibility

  • Chrome 88+
  • Chromium-based browsers (Edge, Brave, etc.)

Permissions Required

  • activeTab: To interact with X.com pages
  • storage: To save your targets and progress locally
  • scripting: To show the overlay interface

๐Ÿค Contributing

We welcome contributions! Please see CONTRIBUTING.md for guidelines.

Quick Start for Contributors

  1. Fork the repository
  2. Create a feature branch (git checkout -b feature/amazing-feature)
  3. Make your changes
  4. Test thoroughly
  5. Commit your changes (git commit -m 'Add amazing feature')
  6. Push to the branch (git push origin feature/amazing-feature)
  7. Open a Pull Request

Development Setup

# Clone the repo
git clone https://github.com/i-bangash/x-reply-tracker.git

# No build process needed - it's vanilla JavaScript!
# Just load the extension in Chrome developer mode

๐Ÿ“‹ Roadmap

Based on feedback we can add :

  • Weekly/Monthly target options
  • Export progress data
  • Customizable themes
  • Reply streak tracking
  • Goal achievement notifications
  • Firefox support

๐Ÿ› Bug Reports

Found a bug? Please open an issue with:

  • Chrome version
  • Extension version
  • Steps to reproduce
  • Expected vs actual behavior

๐Ÿ“œ License

This project is licensed under the MIT License - see the LICENSE file for details.

๐Ÿ™ Acknowledgments

  • Built for the X.com community
  • Inspired by productivity and goal-tracking tools

๐Ÿ“ž Support

  • GitHub Issues: For bug reports and feature requests
  • Discussions: For questions and community support
  • Privacy Questions: All answered in this README

๐Ÿ‘จโ€๐Ÿ’ป Author

i-bangash - GitHub


Made with โค๏ธ for the X.com community

This extension is not affiliated with X Corp or Twitter, Inc.

About

No description, website, or topics provided.

Resources

License

Contributing

Security policy

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors