OLX/Otomoto Ban + Viewed + Rating — WebExtension

A cross-browser WebExtension for Chrome, Firefox, Opera, Edge, and other Chromium-based browsers. Ban listings, rate sellers, and sync across devices via GitHub Gist.

Zero dependencies on Google, Apple, or Microsoft ecosystem. Only uses GitHub Gist for cloud sync, localStorage for local persistence, and standard WebExtension APIs.

Installation

Download the extension package (.zip)

Chrome / Brave / Edge

  1. Download and extract the .zip to a folder
  2. Go to chrome://extensions/
  3. Enable Developer mode (top right)
  4. Click Load unpacked → select folder
  5. Done

Firefox

  1. Download and extract the .zip to a folder
  2. Go to about:debugging#/runtime/this-firefox
  3. Click Load Temporary Add-on
  4. Select any file in the folder
  5. Done (temporary; reload on browser restart)

For permanent installation, submit to Firefox Add-ons (AMO).

Opera

  1. Download and extract the .zip to a folder
  2. Go to opera://extensions/
  3. Enable Developer mode
  4. Click Load unpacked extension → select folder
  5. Done

Features

  • Ban/unban listings with dark overlay
  • Rate sellers with star system (3★ red, 2★ yellow, 1★ blue)
  • Comment notes on listings (50 char max)
  • View tracking with eye icon
  • Cross-browser support (Chrome, Firefox, Opera, Edge, Brave)
  • Cross-device sync via GitHub Gist (5-minute automatic sync)
  • Privacy-first — only accesses GitHub Gist

Usage

Listing Cards (Search Results)

Each card shows a dark chip overlay with eye icon (viewed listings), star rating (click to cycle), comment box, and BAN toggle. Banned listings fade to 35% opacity with grayscale filter.

Detail Pages (Single Listing)

Bottom-right corner shows similar controls. Banned items show a red banner with ban date/time, comment, and UNBAN button.

Sync

Everything is stored in browser localStorage. Optional GitHub Gist sync merges data across devices using field-level timestamps (newest wins per field).

Setup

  1. Visit any OLX or Otomoto listing page
  2. Open DevTools (F12) → Console — you should see [BG] Service worker initialized
  3. Look for control chips on listing cards

Enable Gist Sync

  1. Create a GitHub token at https://github.com/settings/tokens with gist scope only
  2. Set it in the extension options page or via console:
    chrome.runtime.sendMessage({ action: 'setToken', payload: { token: 'ghp_your_token_here' } }, r => console.log(r))

Troubleshooting

  • Chips not showing? Check you’re on olx.pl or otomoto.pl, refresh the page, check console for [Content] Initialized
  • Sync not working? Verify token is set and valid (classic tokens expire after 1 year)
  • Data loss? Your Gist is preserved on GitHub; reinstall and re-set token

Development

extension/
├── manifest.json
├── background.js
├── content.js
├── options.html
├── options.js
├── README.md
└── images/
    ├── icon-16.png
    ├── icon-48.png
    └── icon-128.png

Source files: ../../development/olx-oto-ban-addon/

License

Same as original userscript (modify as needed for personal use).

Credits

  • Original userscript: piotereks (Tampermonkey)
  • WebExtension port: Zero-Google build for Firefox/cross-browser compatibility