explaingit

fwilldev/portasplit-tracker

Analysis updated 2026-05-18

16JavaAudience · developerComplexity · 2/5Setup · moderate

TLDR

A Java Spring Boot app that monitors availability of the Midea PortaSplit AC across German retail stores and Amazon, sending a Telegram alert when it comes back in stock.

Mindmap

mindmap
  root((PortaSplit Tracker))
    What it does
      Stock monitoring
      Telegram alerts
      Dashboard
    Sources
      German hardware stores
      Amazon
      Kleinanzeigen
    Setup
      Docker
      Maven
      Telegram bot
    Audience
      Hobbyists
      German market
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Get a Telegram alert the moment the Midea PortaSplit goes back in stock at OBI, Bauhaus, Amazon, or Lidl

USE CASE 2

Monitor multiple German hardware store websites for a specific product without checking manually

USE CASE 3

Track product availability history over time using the built-in dashboard

What is it built with?

JavaSpring BootDockerMavenSQLite

How does it compare?

fwilldev/portasplit-trackerandrea-lyz/melodycodectweakerstpavel/tspu-probe
Stars161616
LanguageJavaJavaJava
Setup difficultymoderatemoderateeasy
Complexity2/53/52/5
Audiencedevelopergeneralops devops

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires Docker and a Telegram bot token to receive availability alerts.

In plain English

PortaSplit Tracker is a Java application that monitors the stock availability of the Midea PortaSplit air conditioner across several German hardware and retail stores, including OBI, toom, Bauhaus, Hornbach, and Globus, as well as Amazon, Lidl, and the classifieds site kleinanzeigen.de. When the product goes from out of stock to available at any of these sources, the app sends a notification through Telegram. The app runs as a Spring Boot web application with a built-in dashboard. The dashboard shows live availability status from each store, a history chart, a change log, and a technical log. A location filter lets you narrow results by postal code and radius, so stores outside your area can be excluded while online shops always count. Each store is handled by a separate worker running independently. The app also integrates with CloakBrowser, a tool that helps avoid bot-detection measures on the retailer websites. The Telegram notification setup requires creating a bot through Telegram's BotFather service and entering the bot token and chat ID into the configuration file. There is an optional alpha feature that can attempt to automatically add the product to a cart and begin the checkout process when stock appears at a supported retailer, with the user confirming the purchase via Telegram. This feature requires encrypted credential storage using an AES key. Installation is done with Docker (the recommended method, which bundles CloakBrowser) or locally using Maven and JDK 21. The README is written in German. This is a hobby project built for personal use. The author states it should not be used to scalp or hoard items, and users are responsible for checking each website's terms of service.

Copy-paste prompts

Prompt 1
How do I set up PortaSplit Tracker with Docker and configure my Telegram bot token and chat ID?
Prompt 2
How does the kleinanzeigen search work in portasplit-tracker, and what URL format should I provide?
Prompt 3
What does the auto-reserve alpha feature do, and how do I enable it with an AES key?
Prompt 4
How do I configure portasplit-tracker to filter results to stores within 30km of my postal code?

Frequently asked questions

What is portasplit-tracker?

A Java Spring Boot app that monitors availability of the Midea PortaSplit AC across German retail stores and Amazon, sending a Telegram alert when it comes back in stock.

What language is portasplit-tracker written in?

Mainly Java. The stack also includes Java, Spring Boot, Docker.

How hard is portasplit-tracker to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is portasplit-tracker for?

Mainly developer.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Scan in gitsafehub Deploy in gitdeployhub fwilldev on gitmyhub

Verify against the repo before relying on details.