Skip to content

README.md

Latest commit

 

History

History
81 lines (56 loc) · 3.5 KB

README.md

File metadata and controls

81 lines (56 loc) · 3.5 KB

ko-fi

🌍 Vinted Geolocator

Version License JavaScript

Reveal hidden seller locations on Vinted and filter items by country with intelligent caching and a beautiful, intuitive UI.

image

✨ Features

  • 🏳️ Country Flags — Instantly see where each item ships from with flag badges
  • 🔍 Smart Filtering — Filter items by country with a single click
  • 💾 Intelligent Caching — Location data is cached forever, no repeated API calls
  • 📊 Live Stats — Track matching items, total scanned, and queue progress
  • 🎨 Sleek UI — Minimalist floating panel that stays out of your way
  • ⚡ Lightweight — Pure JavaScript, no external dependencies

🛒 Supported Vinted Sites

Site URL
🇳🇱 Netherlands vinted.nl
🇧🇪 Belgium vinted.be
🇫🇷 France vinted.fr
🇩🇪 Germany vinted.de
🇪🇸 Spain vinted.es
🇮🇹 Italy vinted.it
🇸🇪 Sweden vinted.se

📦 Installation

  1. Install a userscript manager:

  2. Click here to install the script from Greasy Fork

    Or create a new script and paste the contents of code.js

  3. Visit any supported Vinted site and start browsing!

🎯 How It Works

  1. The script scans visible items on the page
  2. For each item, it first checks cached location data, then fetches from Vinted's API if needed
  3. Location data is cached forever to avoid repeated API calls
  4. Country flags are added to item cards
  5. Use the floating panel to filter by your preferred country
  6. Non-matching items fade out, keeping your focus on relevant listings

⚠️ Important Notes

  • Language: Set Vinted to English for the script to work correctly
  • Rate Limits: The script respects Vinted's API limits.
  • Visual Only: Filtering is purely visual — it doesn't affect Vinted's search results

🔒 Privacy & Security

  • ✅ No data sent to third parties
  • ✅ No tracking or analytics
  • ✅ No ads or miners
  • ✅ Open source — inspect the code yourself!

📄 License

MIT License — feel free to use, modify, and share!

Made with ❤️ by Nigel1992

Support This Project

Support this project! All donations go towards your chosen charity. You can pick any charity you'd like, and I will ensure the funds are sent their way. Please note that standard payment processing fees (Ko-fi & PayPal) will be deducted from the total. As a thank you, your name will be listed as a supporter/donor in this project. Feel free to email me at thedjskywalker@gmail.com for proof of the donation or to let me know which charity you've selected!