Homelander

Desktop app that automates apartment applications on ImmobilienScout24
Paste a search URL — it polls for new listings and auto-applies for you.

▶ Watch the demo (1:41)  ·  macOS install guide

_{Search tab — manage searches, view live feed}

_{History tab — browse sent applications, export CSV}

_{Settings tab — persona, message template, captcha config}

ImmobilienScout24 is Germany's largest real estate platform. Apartments in competitive markets (Berlin, Munich, Hamburg) get 100+ applications within hours. If you're not among the first to apply, you never hear back.

Free. No terminal. No cloud. No manual refreshing. Set it and forget it.

• 🪄 One-click setup — guided 6-step wizard, no terminal needed
• 🤖 Auto-apply — fills IS24 contact forms via a bundled Chromium browser
• 🔐 Captcha solving — optional, but automatic using 2captcha (~$0.001 per solve)
• 🧠 Smart pausing — detects session expiry and AWS perimeter challenges, auto-pauses
• ⏱️ Three speed modes — fast, balanced, slow (45-90s delays between applications)
• 💻 Cross-platform — macOS, Windows, Linux
• 🌍 Multilanguage — full German and English UI
• 📦 Local-first — all data in SQLite, nothing sent to us

Download the latest version from the Releases page.

📺 Prefer video? Watch the macOS install walkthrough — download, Gatekeeper, and first launch.

Not sure which Mac you have? Apple menu → About This Mac: "Apple M…" means Apple Silicon, "Intel" means Intel.

macOS may block the app because it's not notarized. After moving to Applications, unblock it:

xattr -cr /Applications/Homelander.app

Then launch from Applications or Spotlight. (See this step in the video)

Download the .exe and run it. Windows SmartScreen may show a warning — click More info → Run anyway.

x64 only (there is no arm64 build of the bundled browser). Install the .deb:

sudo apt install ./homelander_<version>_amd64.deb

An .AppImage is also published, but the .deb is the recommended install. Known limitation: on Ubuntu 23.10+ the bundled browser may fail to launch due to the AppArmor user-namespace restriction — a fix is planned.

Homelander is a fun portfolio / hobby project created for educational purposes. It is not intended to be used on ImmobilienScout24 and is in no way a tool for submitting actual applications or interacting with the IS24 platform.

This project is not affiliated with, endorsed by, or connected to ImmobilienScout24 GmbH in any way. Any use of this software to interact with IS24 is strictly prohibited and may violate IS24's terms of service. The authors assume no liability for any consequences, including but not limited to account restrictions, blocked access, legal claims, or any other actions taken by ImmobilienScout24 or any other party. This software is provided "as is" without warranty of any kind.

The setup wizard guides you through 6 steps:

1. Language - select german or english.
2. Your details — name, email, phone, address
3. Message template — the message sent with each application (use {{title}}, {{address}}, {{name}})
4. IS24 account — log in manually (IS24 blocks automated login)
5. 2captcha API key — for automatic captcha solving
6. First search — paste an IS24 search URL

After setup, the app opens to the Searches tab. Add more searches anytime.

All settings editable from the Settings tab:

Config lives at ~/.homelander/config.json. Database at ~/.homelander/homelander.db (SQLite, WAL mode).

All data is local — nothing is sent anywhere except:

• IS24's API — to discover new listings
• IS24's website via Chromium — to submit contact forms
• 2captcha API — to solve captchas

No telemetry. No analytics. No cloud. Your config.json, homelander.db, and Chrome profile stay on your machine.

• Node.js 20+ (nodejs.org)
• Chrome — bundled automatically via Puppeteer (no separate install)

git clone https://github.com/B1Z0N/homelander.git
cd homelander
npm install
npm run dev

npm run dist:mac     # macOS .dmg + .zip
npm run dist:win     # Windows .exe (NSIS)
npm run dist:linux   # Linux .deb + .AppImage

IS24 Mobile API ←─ HTTP ──→ [Poller → SQLite → Apply Engine → Chrome CDP] → IS24 Forms
                                   │                    │
                              Electron App            Headed
                              (React UI)    

1. You paste an IS24 search URL — any valid search, including Tauschwohnung
2. Poller hits IS24's mobile API every 10 minutes for new listings
3. New listings land in SQLite — deduplicated, timestamped
4. Apply engine opens each listing in a background Chromium window, fills the contact form with your details, and submits
5. Captchas are solved via 2captcha automatically
6. Results appear in the live feed and history — SENT, FAIL, etc.

Everything runs on your computer. Your data stays local.

Is this safe? Yes. Everything runs locally. Your IS24 credentials and personal data never leave your computer except when submitting to IS24 (via the same browser IS24 expects).

Can IS24 detect me? Homelander uses a real Chromium browser, natural typing delays, and behaves like a human. The bundled Chromium profile matches what IS24 sees from regular users.

What does it cost? The app is free and open-source. You only pay 2captcha for solving captchas, and that is optional (~$0.001/solve, about $3 for hundreds of applications).

Does it work outside Germany? The app works anywhere, but it's designed for the German ImmobilienScout24 platform.

Can I search multiple areas? Yes. Add multiple search URLs — each polls independently.

Contributions are welcome! See CONTRIBUTING.md for setup and guidelines.

• Bug reports → Issue template
• Feature ideas → Feature request
• Questions → Discussions

Thanks to everyone who helped outside of the core development:

• Thorsten Buck — testing the app on Ubuntu

If Homelander saves you time and stress, consider supporting development:

MIT © Mykola Fedurko

Built on an auto-apply engine developed and battle-tested across thousands of IS24 listings. Key icon brand by the author.