Browser extension for X (Twitter): auto-like timeline posts with a delay queue, optional auto-scroll and auto-refresh on the home feed. Settings are stored in chrome.storage.local and synced to the content script.

Load the extension as an unpacked (developer) add-on.

1. Open Firefox (profile where you’re logged into X).
2. In the address bar go to about:debugging → Enter.
3. Click “This Firefox” in the left sidebar.
4. Click “Load Temporary Add-on…”.
5. Open the X-Boost folder and select manifest.json → Open.

The X-Boost icon appears in the toolbar; click it to open the popup.

Note: The add-on is temporary — it is removed after restarting Firefox. Reload from step 1 after a restart. After code changes, open about:debugging again and click Reload on the X-Boost card.

1. Open Chrome and go to chrome://extensions.
2. Enable “Developer mode” (top right).
3. Click “Load unpacked”.
4. Select the X-Boost folder (the one containing manifest.json).

The extension loads; use the toolbar icon to open the popup.

Note: After code changes, click the reload icon on the extension card.

• Single source of truth: chrome.storage.local. Popup reads/writes storage; the content script (injected into X/Twitter tabs) reads storage on load and on storage.onChanged and drives all behaviour.
• Features: Auto-like (queue + MutationObserver), auto-scroll (smooth, configurable interval), auto-refresh (home only, configurable interval). When refresh is on, the extension icon shows a countdown (seconds until next reload). All can be toggled and tuned from the popup.
• Queue: Like buttons are queued and clicked one-by-one with a delay (1–10 s) to reduce rate-limit risk. The popup shows the current queue length.

flowchart LR
  subgraph UI
    Popup[Popup UI]
  end
  subgraph Storage
    Local[(chrome.storage.local)]
  end
  subgraph Page
    Content[Content script\nX/Twitter tab]
  end
  Popup <-->|get / set| Local
  Local -->|onChanged| Content
  Local -->|get on init| Content

Popup reads/writes settings; the content script subscribes to storage.onChanged and loads settings once on init.

flowchart TD
  A[Document ready?] -->|loading| B[Wait DOMContentLoaded]
  A -->|interactive/complete| C[init]
  B --> C
  C --> D[local.get defaultSettings]
  D --> E[applySettings]
  E --> F{enabled?}
  F -->|yes| G[startObserving]
  F -->|no| H[skip]
  E --> I{scrollEnabled?}
  I -->|yes| J[startScroll]
  I -->|no| K[skip]

On load, the content script fetches settings and starts only the features that are enabled.

flowchart TD
  subgraph Observer
    O[MutationObserver on body]
    O --> P[addedNodes]
    P --> Q[scanLikeButtons for each node]
  end
  Q --> R[querySelectorAll like buttons]
  R --> S[scheduleLike for each]
  S --> T{valid & not queued?}
  T -->|yes| U[queue.push\nsyncQueueLength]
  T -->|no| V[skip]
  U --> W{queueTimer running?}
  W -->|no| X[setTimeout processQueue, delayMs]
  W -->|yes| Y[wait]
  X --> Z[processQueue]
  Z --> AA[queue.shift]
  AA --> AB[click if still in DOM]
  AB --> AC[setTimeout processQueue, delayMs]
  AC --> Z

New DOM nodes (e.g. from infinite scroll) are scanned for like buttons; valid, non-queued buttons are pushed to a queue. A single timer runs processQueue every delayMs: it shifts one button, clicks it if still valid, then reschedules itself.

sequenceDiagram
  participant User
  participant Popup
  participant Storage
  participant Content
  User->>Popup: change toggle / stepper
  Popup->>Storage: local.set({ key, value })
  Storage->>Content: onChanged (area: local)
  Content->>Content: local.get then applySettings
  Content->>Content: start/stop observer, scroll

When the user changes a setting in the popup, the content script receives storage.onChanged, fetches full storage and reapplies settings, then starts or stops the corresponding timers/observer. Refresh is driven by the background script (countdown + tab reload).

Defaults: delay 10 s, refresh 60 s, scroll 5 s. The popup configures all of the above. Queue length is shown in the popup.

• Firefox: 109+ (Gecko).
• Chrome: Standard Manifest V2 support.
• Sites: Runs only on *://*.x.com/* and *://*.twitter.com/* (home and timeline).

This project is licensed under the MIT license. See the LICENSE file for more info.