Skip to content

Repository files navigation

vikle-app

A standalone Android meta-search app for second-hand goods. One search box queries vinted.de, ebay.de and kleinanzeigen.de at once, then merges, de-duplicates, filters, sorts and maps the results — with an eBay-style UI.

⚠️ Personal use only — read this first. vikle works by scraping public listing pages. Scraping these marketplaces lives in a legal grey zone and generally runs against their Terms of Service. This app is intended for personal, low-volume experimentation. You are responsible for how you use it. Don't hammer the sites with high request volumes.


Beta

This is a beta. Grab the APK from the Releases page and sideload it (enable "install from unknown sources"), or build it yourself (below).

  • minSdk 26 (Android 8.0+), target/compile SDK 36.
  • No account, no backend — the phone talks to the marketplaces directly.

Features

  • Search tab: one query across all three marketplaces with a rich syntax — -word, "exact phrase", (a | b), title:word, wild*, /regex/, price:10-50. Platform toggles, sort modes, list/grid views, a full filter sheet (price, condition, seller, listing type, shipping, location/ZIP, radius, recency…), cross-platform de-duplication, deal highlighting, saved searches and search history.
  • Map tab: every located result plotted on an interactive map (Leaflet + OpenStreetMap) via a fully offline German postal-code dataset — price-pill markers, per-listing detail card, platform legend.
  • Settings tab: light/dark/system theme, optional AI term expansion via a local Ollama server on your network (fully optional — the app works without it), and data controls.

Build

Requires JDK 17+ and the Android SDK (platform 36, build-tools 36).

git clone https://github.com/codebooo/vikle-app.git
cd vikle-app
# point the build at your SDK (or set ANDROID_HOME):
echo "sdk.dir=/path/to/Android/Sdk" > local.properties

./gradlew test assembleDebug
# APK: app/build/outputs/apk/debug/app-debug.apk

Unit tests cover the query parser, filter/sort/dedupe engine and the German price/condition normalizer (./gradlew test).

Tech

Kotlin · Jetpack Compose (Material 3) · OkHttp + Jsoup (scraping) · Coil (images) · Leaflet in a WebView (map). No analytics, no tracking, no network calls except to the three marketplaces (and, if you enable it, your own Ollama).

Disclaimer

Provided as-is for educational and personal use. Not affiliated with Vinted, eBay or Kleinanzeigen. Respect the marketplaces' terms of service and applicable law in your jurisdiction.

About

Standalone Android meta-search for Vinted, eBay & Kleinanzeigen (personal-use scraper). Beta.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages