Repolode
Submit
orangecoding

orangecoding/fredy

Self-hosted tool that watches European real estate portals like ImmoScout24 and Kleinanzeigen and pushes new listings to Slack, Telegram, email, Discord or ntfy.

Open-source alternative to:ImmoScout24

View on GitHubWebsite
Stars
1,622
Forks
261
Open issues
6
Last commit
14 hours ago

What is it?

Fredy searches 29 real estate portals across Germany, Austria, Switzerland, Spain, Italy, Portugal and France for apartments, houses and flats. Searches are configured in a web UI, and new listings are sent through notification channels such as Slack, Telegram, email, ntfy, Discord and Gotify. Listings that appear on several portals are deduplicated by living space, rooms and location.

Beyond alerts, Fredy estimates financing costs for renting or buying, computes real travel times from your own addresses by public transit, car, bike or on foot, and flags listings that show signs of rental scams. It also compares each listing's price per square metre with the local median and lets you attach documents to a listing.

Fredy runs with Docker or Node.js 22.22.0 or higher, stores its data in SQLite, and includes an MCP server so tools like Claude or a local LLM can query your listings. It is licensed under Apache-2.0 with a Commons Clause, so self-hosting is allowed but commercial resale is not.

Key features

  • 01Monitors 29 real estate portals across seven European countries.
  • 02Sends new listings to Slack, Telegram, email, ntfy, Discord and other channels.
  • 03Deduplicates the same flat listed on multiple portals.
  • 04Calculates rent and purchase financing costs from your own figures.
  • 05Shows real travel times from your addresses by transit, car, bike or on foot.
  • 06Flags listings that show signs of rental scams.

Use cases

  • Hunting for an apartment in a competitive German or Austrian rental market where listings go fast.
  • Getting alerts on a phone via Telegram or ntfy as soon as a matching flat appears.
  • Comparing listings by real commute time from your workplace.
  • Running a private, self-hosted search instance on a home server or NAS.

Quick start

  1. 1

    Start Fredy with Docker

    docker run -d --name fredy -v fredy_conf:/conf -v fredy_db:/db -p 9998:9998 ghcr.io/orangecoding/fredy:master
  2. 2

    Open the Web UI at localhost:9998 and sign in with admin / admin

Things to know

  • Requires Node.js 22.22.0 or higher if not using Docker.
  • Relies on a reverse engineered ImmoScout Mobile API, which may break when the portal changes.

In collections

Self-hosted apps

Topics

#real-estate#web-scraping#self-hosted#notifications#nodejs#puppeteer#telegram#docker#appartment#appartments

FAQ

What is fredy?
Self-hosted tool that watches European real estate portals like ImmoScout24 and Kleinanzeigen and pushes new listings to Slack, Telegram, email, Discord or ntfy. Fredy searches 29 real estate portals across Germany, Austria, Switzerland, Spain, Italy, Portugal and France for apartments, houses and flats. Searches are configured in a web UI, and new listings are sent through notification channels such as Slack, Telegram, email, ntfy, Discord and Gotify. Listings that appear on several portals are deduplicated by living space, rooms and location.
Is fredy free to use? What license does it have?
fredy is open source under the Apache-2.0 license. Check the license terms before using it in commercial products.
Is fredy still maintained?
Actively maintained. The last commit to fredy was on Nov 6, 2026.
What can I use fredy for?
Hunting for an apartment in a competitive German or Austrian rental market where listings go fast. Getting alerts on a phone via Telegram or ntfy as soon as a matching flat appears. Comparing listings by real commute time from your workplace. Running a private, self-hosted search instance on a home server or NAS.
How do I install fredy?
Start Fredy with Docker: docker run -d --name fredy -v fredy_conf:/conf -v fredy_db:/db -p 9998:9998 ghcr.io/orangecoding/fredy:master Open the Web UI at localhost:9998 and sign in with admin / admin
Where can I get fredy?
The source code and installation instructions are on GitHub: https://github.com/orangecoding/fredy

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects