codomo-alerts 0.2.2__tar.gz
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- codomo_alerts-0.2.2/.gitignore +18 -0
- codomo_alerts-0.2.2/LICENSE +21 -0
- codomo_alerts-0.2.2/PKG-INFO +372 -0
- codomo_alerts-0.2.2/README.md +334 -0
- codomo_alerts-0.2.2/config.example.toml +48 -0
- codomo_alerts-0.2.2/pyproject.toml +95 -0
- codomo_alerts-0.2.2/src/codomo_alerts/__init__.py +5 -0
- codomo_alerts-0.2.2/src/codomo_alerts/__main__.py +5 -0
- codomo_alerts-0.2.2/src/codomo_alerts/catalog.py +219 -0
- codomo_alerts-0.2.2/src/codomo_alerts/cli.py +401 -0
- codomo_alerts-0.2.2/src/codomo_alerts/client.py +152 -0
- codomo_alerts-0.2.2/src/codomo_alerts/codomo.py +477 -0
- codomo_alerts-0.2.2/src/codomo_alerts/config.py +370 -0
- codomo_alerts-0.2.2/src/codomo_alerts/dashboard.py +204 -0
- codomo_alerts-0.2.2/src/codomo_alerts/demo.py +128 -0
- codomo_alerts-0.2.2/src/codomo_alerts/mcp_server.py +86 -0
- codomo_alerts-0.2.2/src/codomo_alerts/messages.py +109 -0
- codomo_alerts-0.2.2/src/codomo_alerts/notify.py +60 -0
- codomo_alerts-0.2.2/src/codomo_alerts/runtime.py +62 -0
- codomo_alerts-0.2.2/src/codomo_alerts/schedule.py +56 -0
- codomo_alerts-0.2.2/src/codomo_alerts/search.py +219 -0
- codomo_alerts-0.2.2/src/codomo_alerts/store.py +256 -0
- codomo_alerts-0.2.2/src/codomo_alerts/term.py +62 -0
- codomo_alerts-0.2.2/src/codomo_alerts/tracker.py +98 -0
- codomo_alerts-0.2.2/src/codomo_alerts/upstream.py +93 -0
- codomo_alerts-0.2.2/src/codomo_alerts/watcher.py +334 -0
- codomo_alerts-0.2.2/src/codomo_alerts/web/app.css +219 -0
- codomo_alerts-0.2.2/src/codomo_alerts/web/app.js +211 -0
- codomo_alerts-0.2.2/src/codomo_alerts/web/favicon.svg +1 -0
- codomo_alerts-0.2.2/src/codomo_alerts/web/index.html +75 -0
- codomo_alerts-0.2.2/src/codomo_alerts/wizard.py +161 -0
- codomo_alerts-0.2.2/tests/conftest.py +163 -0
- codomo_alerts-0.2.2/tests/data/list_2_bedrooms.html.gz +0 -0
- codomo_alerts-0.2.2/tests/data/unit_interest.html.gz +0 -0
- codomo_alerts-0.2.2/tests/data/unit_short_stay.html.gz +0 -0
- codomo_alerts-0.2.2/tests/test_client.py +83 -0
- codomo_alerts-0.2.2/tests/test_codomo.py +223 -0
- codomo_alerts-0.2.2/tests/test_config.py +158 -0
- codomo_alerts-0.2.2/tests/test_dashboard.py +82 -0
- codomo_alerts-0.2.2/tests/test_messages.py +80 -0
- codomo_alerts-0.2.2/tests/test_resilience.py +152 -0
- codomo_alerts-0.2.2/tests/test_schedule.py +42 -0
- codomo_alerts-0.2.2/tests/test_tracker.py +124 -0
- codomo_alerts-0.2.2/tests/test_upstream.py +84 -0
- codomo_alerts-0.2.2/tests/test_watcher.py +307 -0
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2026 Koorosh Komeilizadeh
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
+
SOFTWARE.
|
|
@@ -0,0 +1,372 @@
|
|
|
1
|
+
Metadata-Version: 2.5
|
|
2
|
+
Name: codomo-alerts
|
|
3
|
+
Version: 0.2.2
|
|
4
|
+
Summary: Self-hosted alerts for new Codomo homes (formerly Holland2Stay) in the Netherlands, Spain, Portugal and Austria.
|
|
5
|
+
Project-URL: Homepage, https://kooroshkz.github.io/codomo-alerts
|
|
6
|
+
Project-URL: Source, https://github.com/kooroshkz/codomo-alerts
|
|
7
|
+
Project-URL: Issues, https://github.com/kooroshkz/codomo-alerts/issues
|
|
8
|
+
Project-URL: Changelog, https://github.com/kooroshkz/codomo-alerts/blob/main/CHANGELOG.md
|
|
9
|
+
Project-URL: Documentation, https://github.com/kooroshkz/codomo-alerts#readme
|
|
10
|
+
Author: Koorosh Komeilizadeh
|
|
11
|
+
License-Expression: MIT
|
|
12
|
+
License-File: LICENSE
|
|
13
|
+
Keywords: alerts,amsterdam,apartment,austria,carcavelos,codomo,codomo-alerts,eindhoven,granada,holland2stay,holland2stay-alerts,housing,linz,lisbon,netherlands,notifications,portugal,rental,rotterdam,self-hosted,spain,student-housing,telegram,the-hague,utrecht
|
|
14
|
+
Classifier: Development Status :: 4 - Beta
|
|
15
|
+
Classifier: Environment :: Console
|
|
16
|
+
Classifier: Environment :: Web Environment
|
|
17
|
+
Classifier: Intended Audience :: End Users/Desktop
|
|
18
|
+
Classifier: Natural Language :: English
|
|
19
|
+
Classifier: Operating System :: OS Independent
|
|
20
|
+
Classifier: Programming Language :: Python :: 3
|
|
21
|
+
Classifier: Programming Language :: Python :: 3 :: Only
|
|
22
|
+
Classifier: Programming Language :: Python :: 3.11
|
|
23
|
+
Classifier: Programming Language :: Python :: 3.12
|
|
24
|
+
Classifier: Programming Language :: Python :: 3.13
|
|
25
|
+
Classifier: Topic :: Communications
|
|
26
|
+
Classifier: Topic :: Internet :: WWW/HTTP
|
|
27
|
+
Classifier: Topic :: Utilities
|
|
28
|
+
Requires-Python: >=3.11
|
|
29
|
+
Requires-Dist: apprise>=1.7
|
|
30
|
+
Requires-Dist: requests>=2.31
|
|
31
|
+
Requires-Dist: tzdata>=2024.1
|
|
32
|
+
Provides-Extra: dev
|
|
33
|
+
Requires-Dist: pytest>=8; extra == 'dev'
|
|
34
|
+
Requires-Dist: ruff>=0.6; extra == 'dev'
|
|
35
|
+
Provides-Extra: mcp
|
|
36
|
+
Requires-Dist: mcp>=1.2; extra == 'mcp'
|
|
37
|
+
Description-Content-Type: text/markdown
|
|
38
|
+
|
|
39
|
+
<div align="center">
|
|
40
|
+
|
|
41
|
+
# Codomo alerts (formerly Holland2Stay alerts)
|
|
42
|
+
|
|
43
|
+
**Get a message the moment a new Codomo home that fits your search is listed.**
|
|
44
|
+
|
|
45
|
+
Codomo alerts is a free, open source notifier for new listings on [codomo.eu](https://codomo.eu),
|
|
46
|
+
the student and expat housing site that was called Holland2Stay. It works in every country
|
|
47
|
+
Codomo rents in: the Netherlands (Eindhoven, Rotterdam, Amsterdam, The Hague, Utrecht and
|
|
48
|
+
more), Spain (Granada), Portugal (Carcavelos, near Lisbon) and Austria (Linz).
|
|
49
|
+
Alerts arrive on Telegram, Discord, ntfy, Slack, email and 100+ other apps.
|
|
50
|
+
|
|
51
|
+
[](https://github.com/kooroshkz/codomo-alerts/actions/workflows/ci.yml)
|
|
52
|
+
[](https://github.com/kooroshkz/codomo-alerts/stargazers)
|
|
53
|
+
[](https://github.com/kooroshkz/codomo-alerts/blob/main/LICENSE)
|
|
54
|
+

|
|
55
|
+

|
|
56
|
+
|
|
57
|
+
[Website](https://kooroshkz.github.io/codomo-alerts/) · [Live demo](https://kooroshkz.github.io/codomo-alerts/demo/) · [Quick start](#quick-start) · [Where it works](#where-it-works) · [FAQ](#faq)
|
|
58
|
+
|
|
59
|
+
Nederlands: [Codomo meldingen](https://kooroshkz.github.io/codomo-alerts/nl/) · Español: [alertas Codomo Granada](https://kooroshkz.github.io/codomo-alerts/es/) · Português: [alertas Codomo Lisboa](https://kooroshkz.github.io/codomo-alerts/pt/) · Deutsch: [Codomo Benachrichtigung Linz](https://kooroshkz.github.io/codomo-alerts/de/)
|
|
60
|
+
|
|
61
|
+
<img src="https://raw.githubusercontent.com/kooroshkz/codomo-alerts/main/docs/assets/dashboard.png" alt="Codomo alerts dashboard with matching homes, activity and release hours" width="820">
|
|
62
|
+
|
|
63
|
+
</div>
|
|
64
|
+
|
|
65
|
+
## Why
|
|
66
|
+
|
|
67
|
+
Good homes on Codomo are gone within minutes, and refreshing the site all day is no way to
|
|
68
|
+
live. This checks the listings for you and messages you when something matches your cities,
|
|
69
|
+
size and budget, so you can book it before everyone else.
|
|
70
|
+
|
|
71
|
+
Holland2Stay became Codomo on 16 November 2026 and holland2stay.com now redirects to
|
|
72
|
+
[codomo.eu](https://codomo.eu). This project was called holland2stay-alerts until then and
|
|
73
|
+
moved with it; see [Moving from holland2stay-alerts](#moving-from-holland2stay-alerts).
|
|
74
|
+
|
|
75
|
+
If it helps you find a home, a ⭐ on GitHub helps the next person find this tool.
|
|
76
|
+
|
|
77
|
+
## Where it works
|
|
78
|
+
|
|
79
|
+
Every country and city Codomo lists. When Codomo opens a new country, it is picked up without
|
|
80
|
+
an update. On 17 November 2026:
|
|
81
|
+
|
|
82
|
+
| Country | Cities | What you find there |
|
|
83
|
+
|---|---|---|
|
|
84
|
+
| Netherlands | Amersfoort, Amsterdam, Arnhem, Capelle aan den IJssel, Delft, Den Bosch, Diemen, Dordrecht, Eindhoven, Groningen, Haarlem, Helmond, Leiden, Maarssen, Maastricht, Nieuwegein, Nijmegen, Rijswijk, Rotterdam, Sittard, The Hague, Tilburg, Utrecht, Velp, Zeist, Zoetermeer | Studios and apartments to book directly, plus register-interest homes |
|
|
85
|
+
| Spain | Granada (Codomo Granada) | Rooms from about €395 a month. Some rooms are shared with another tenant, some are female only or male only |
|
|
86
|
+
| Portugal | Carcavelos, near Lisbon (Codomo Lombos) | Student rooms from about €869 a month |
|
|
87
|
+
| Austria | Linz (Codomo Linz) | Student rooms from about €709 a month. Some rooms are shared, some are female only or male only |
|
|
88
|
+
|
|
89
|
+
Prices include service costs. `codomo-alerts cities` shows the cities listed right now, with
|
|
90
|
+
their country.
|
|
91
|
+
|
|
92
|
+
## Quick start
|
|
93
|
+
|
|
94
|
+
### Docker
|
|
95
|
+
|
|
96
|
+
```bash
|
|
97
|
+
docker run -d --name codomo-alerts --restart unless-stopped \
|
|
98
|
+
-e CODOMO_CITIES="Eindhoven, Rotterdam" \
|
|
99
|
+
-e CODOMO_BEDROOMS="studio, 1" \
|
|
100
|
+
-e CODOMO_PRICE_MAX=1600 \
|
|
101
|
+
-e CODOMO_NOTIFY="tgram://BOT_TOKEN/CHAT_ID" \
|
|
102
|
+
-v codomo-data:/data -p 127.0.0.1:8080:8080 \
|
|
103
|
+
ghcr.io/kooroshkz/codomo-alerts
|
|
104
|
+
```
|
|
105
|
+
|
|
106
|
+
The dashboard is on [localhost:8080](http://localhost:8080). To open it to other devices, publish
|
|
107
|
+
the port without `127.0.0.1:` and set `CODOMO_DASHBOARD_PASSWORD`. Works on a Raspberry Pi or a NAS too.
|
|
108
|
+
Prefer Compose? See [docker-compose.yml](https://github.com/kooroshkz/codomo-alerts/blob/main/docker-compose.yml).
|
|
109
|
+
|
|
110
|
+
### Looking in Granada, Lisbon or Linz?
|
|
111
|
+
|
|
112
|
+
Same command, other city. `Lisbon` and `Lisboa` work as names for Carcavelos.
|
|
113
|
+
|
|
114
|
+
```bash
|
|
115
|
+
docker run -d --name codomo-alerts --restart unless-stopped \
|
|
116
|
+
-e CODOMO_CITIES="Granada" \
|
|
117
|
+
-e CODOMO_GENDER=female \
|
|
118
|
+
-e CODOMO_NOTIFY="tgram://BOT_TOKEN/CHAT_ID" \
|
|
119
|
+
-v codomo-data:/data -p 127.0.0.1:8080:8080 \
|
|
120
|
+
ghcr.io/kooroshkz/codomo-alerts
|
|
121
|
+
```
|
|
122
|
+
|
|
123
|
+
| You want | Set |
|
|
124
|
+
|---|---|
|
|
125
|
+
| Granada | `CODOMO_CITIES=Granada` |
|
|
126
|
+
| Lisbon (Carcavelos) | `CODOMO_CITIES=Lisbon` |
|
|
127
|
+
| Linz | `CODOMO_CITIES=Linz` |
|
|
128
|
+
| Every home in Spain and Portugal | `CODOMO_COUNTRIES="es, pt"` |
|
|
129
|
+
| Only the Netherlands | `CODOMO_COUNTRIES=nl` |
|
|
130
|
+
| Everything Codomo lists | leave `CODOMO_CITIES` and `CODOMO_COUNTRIES` empty |
|
|
131
|
+
|
|
132
|
+
`CODOMO_GENDER` is optional: it skips rooms Codomo marks for the other gender only.
|
|
133
|
+
|
|
134
|
+
### Python
|
|
135
|
+
|
|
136
|
+
```bash
|
|
137
|
+
pipx install codomo-alerts
|
|
138
|
+
codomo-alerts init # a few questions, then a test message
|
|
139
|
+
codomo-alerts watch
|
|
140
|
+
```
|
|
141
|
+
|
|
142
|
+
Needs Python 3.11 or newer. Keep it running on any computer that stays on.
|
|
143
|
+
|
|
144
|
+
## What you get
|
|
145
|
+
|
|
146
|
+
- **New homes** matching your search, once each, with city, size, price and contract
|
|
147
|
+
- **Back on the market**: homes that come back after someone didn't pay
|
|
148
|
+
- **Register interest**: homes where Codomo picks someone from a shortlist (it replaced the
|
|
149
|
+
Holland2Stay lottery), with how many people already signed up, and a message when such a
|
|
150
|
+
home becomes directly bookable
|
|
151
|
+
- **Price drops** on homes you're already watching
|
|
152
|
+
- **New buildings** when a new building page shows up on codomo.eu
|
|
153
|
+
- **Female only and male only rooms** are marked in the alert, or skipped with `gender`
|
|
154
|
+
- **A dashboard** with what's available, what got taken and how fast, and the hours new homes
|
|
155
|
+
usually show up
|
|
156
|
+
- **Many at once** come as one message, not twenty
|
|
157
|
+
- **Quiet hours**: alerts wait, and you only get the ones that are still available
|
|
158
|
+
- **Health notices** if Codomo blocks requests or changes something
|
|
159
|
+
|
|
160
|
+
## Notifications
|
|
161
|
+
|
|
162
|
+
Alerts go through [Apprise](https://github.com/caronc/apprise/wiki), so almost any app works.
|
|
163
|
+
Add one link per app:
|
|
164
|
+
|
|
165
|
+
| App | Link |
|
|
166
|
+
|---|---|
|
|
167
|
+
| Telegram | `tgram://BOT_TOKEN/CHAT_ID` ([make a bot](https://core.telegram.org/bots#how-do-i-create-a-bot)) |
|
|
168
|
+
| Discord | `discord://WEBHOOK_ID/WEBHOOK_TOKEN` |
|
|
169
|
+
| ntfy | `ntfy://a-long-secret-topic` (free push to your phone, no account) |
|
|
170
|
+
| Slack | `slack://TOKEN_A/TOKEN_B/TOKEN_C/#channel` |
|
|
171
|
+
| Email | `mailtos://you:app-password@gmail.com` |
|
|
172
|
+
| Signal, Matrix, Pushover, Gotify, Home Assistant, webhooks… | [all options](https://github.com/caronc/apprise/wiki) |
|
|
173
|
+
|
|
174
|
+
Check them with `codomo-alerts test`. Alerts are in English. A new home looks like this:
|
|
175
|
+
|
|
176
|
+
```
|
|
177
|
+
Engelandlaan 300-C
|
|
178
|
+
Zoetermeer · 2 bedrooms · €1,688
|
|
179
|
+
Indefinite · Semi-furnished
|
|
180
|
+
https://codomo.eu/homes/nl/en/zoetermeer/sea-tower/engelandlaan-300-c
|
|
181
|
+
```
|
|
182
|
+
|
|
183
|
+
## Configuration
|
|
184
|
+
|
|
185
|
+
Run `codomo-alerts init`, or copy [config.example.toml](https://github.com/kooroshkz/codomo-alerts/blob/main/config.example.toml) to `config.toml`:
|
|
186
|
+
|
|
187
|
+
```toml
|
|
188
|
+
[search]
|
|
189
|
+
cities = ["Eindhoven", "Rotterdam"] # empty = every city
|
|
190
|
+
countries = [] # empty = every country; or ["nl"], ["es", "pt"]
|
|
191
|
+
bedrooms = ["studio", "1"] # or "2+", "1-3"
|
|
192
|
+
price_max = 1600 # per month, service costs included
|
|
193
|
+
contract = ["long"] # long or short stay
|
|
194
|
+
gender = "" # "female" or "male" skips rooms for the other gender only
|
|
195
|
+
|
|
196
|
+
[notify]
|
|
197
|
+
urls = ["tgram://BOT_TOKEN/CHAT_ID"]
|
|
198
|
+
```
|
|
199
|
+
|
|
200
|
+
`init` asks for countries when you don't name cities, and for gender when your search
|
|
201
|
+
reaches Spain, Portugal or Austria.
|
|
202
|
+
|
|
203
|
+
Every setting also works as an environment variable, which is handy for Docker:
|
|
204
|
+
|
|
205
|
+
| Variable | Example | |
|
|
206
|
+
|---|---|---|
|
|
207
|
+
| `CODOMO_CITIES` | `Eindhoven, The Hague` | only these cities. `codomo-alerts cities` lists names with their country. `Lisbon` works for Carcavelos |
|
|
208
|
+
| `CODOMO_COUNTRIES` | `nl, es` | `nl`, `es`, `pt`, `at`, names like `Spain` or `Österreich`, or `all`. Empty means every country Codomo lists, new ones included. A city outside these countries is a config error |
|
|
209
|
+
| `CODOMO_EXCLUDE_CITIES` | `Maastricht` | everywhere except these |
|
|
210
|
+
| `CODOMO_BEDROOMS` | `studio, 2+` | studio, 1, 2, 3, 4. Homes without a bedroom count (Portugal, Austria) count as studios |
|
|
211
|
+
| `CODOMO_PRICE_MIN` / `CODOMO_PRICE_MAX` | `1600` | euro per month, service costs included |
|
|
212
|
+
| `CODOMO_CONTRACT` | `long` | long, short, or a maximum: indefinite, 2y, 1y, 6m, 4m |
|
|
213
|
+
| `CODOMO_FURNISHING` | `furnished` | fully-furnished, furnished, semi-furnished, unfurnished |
|
|
214
|
+
| `CODOMO_PERSONS` | `2` | the home must fit this many people |
|
|
215
|
+
| `CODOMO_GENDER` | `female` | `female` or `male`: skips rooms Codomo marks for the other gender only. Empty shows all |
|
|
216
|
+
| `CODOMO_MOVE_IN_BEFORE` | `2027-02-01` | |
|
|
217
|
+
| `CODOMO_INTEREST` | `true` | register-interest homes too |
|
|
218
|
+
| `CODOMO_NOTIFY` | `tgram://… ntfy://…` | separate links with a space |
|
|
219
|
+
| `CODOMO_NOTIFY_FILE` | `/run/secrets/codomo` | read the links from a file |
|
|
220
|
+
| `CODOMO_QUIET_HOURS` | `23:00-07:00` | |
|
|
221
|
+
| `CODOMO_SCHEDULE` | `normal` | relaxed, normal or eager |
|
|
222
|
+
| `CODOMO_DASHBOARD` / `CODOMO_PORT` / `CODOMO_HOST` | `on` / `8080` / `0.0.0.0` | |
|
|
223
|
+
| `CODOMO_DASHBOARD_PASSWORD` | | when it's reachable from other devices |
|
|
224
|
+
| `CODOMO_DATA_DIR` | `/data` | |
|
|
225
|
+
| `CODOMO_CONFIG` | `/config/config.toml` | |
|
|
226
|
+
|
|
227
|
+
Country names that work: Netherlands, Holland, Nederland; Spain, España, Spanje; Portugal;
|
|
228
|
+
Austria, Österreich, Oostenrijk.
|
|
229
|
+
|
|
230
|
+
## Commands
|
|
231
|
+
|
|
232
|
+
| | |
|
|
233
|
+
|---|---|
|
|
234
|
+
| `codomo-alerts init` | set up your search and notifications |
|
|
235
|
+
| `codomo-alerts watch` | keep checking and send alerts (the default) |
|
|
236
|
+
| `codomo-alerts list` | what matches right now (`--interest`, `--city`, `--json`) |
|
|
237
|
+
| `codomo-alerts test` | send a test message to every app |
|
|
238
|
+
| `codomo-alerts doctor` | check your setup |
|
|
239
|
+
| `codomo-alerts stats` | what the watcher has seen so far |
|
|
240
|
+
| `codomo-alerts cities` | every city Codomo lists, with its country |
|
|
241
|
+
| `codomo-alerts demo` | try the dashboard with sample data |
|
|
242
|
+
| `codomo-alerts mcp` | MCP server for AI assistants |
|
|
243
|
+
| `codomo-alerts upstream` | check that codomo.eu still works the way this tool expects |
|
|
244
|
+
|
|
245
|
+
## How often it checks
|
|
246
|
+
|
|
247
|
+
Most homes are released on weekdays during office hours, plus a small batch just after
|
|
248
|
+
midnight when unpaid reservations go back on sale. So it checks more often then and less
|
|
249
|
+
at night:
|
|
250
|
+
|
|
251
|
+
| | relaxed | normal | eager |
|
|
252
|
+
|---|---|---|---|
|
|
253
|
+
| Weekdays 08:30 to 18:00, and 00:05 to 00:45 | 5 min | 2 min | 1 min |
|
|
254
|
+
| Rest of the day | 10 min | 5 min | 3 min |
|
|
255
|
+
| Night | 30 min | 15 min | 10 min |
|
|
256
|
+
|
|
257
|
+
Register-interest homes have no deadline to race, so they are checked every 10 minutes.
|
|
258
|
+
It never goes below one minute, adds a bit of randomness, says who it is in the user agent,
|
|
259
|
+
and backs off when Codomo asks it to.
|
|
260
|
+
|
|
261
|
+
## How it reads Codomo
|
|
262
|
+
|
|
263
|
+
codomo.eu has no public API. The list of homes for each country, like `codomo.eu/homes/nl/en`
|
|
264
|
+
or `codomo.eu/homes/es/en`, is rendered on Codomo's server with your filters in the address,
|
|
265
|
+
and the data of each home card is inside the page. A check reads one list page per country
|
|
266
|
+
and bedroom count you want (one more page for every 25 homes), decodes the cards, and checks
|
|
267
|
+
that what it read adds up to the page's own counts. When it doesn't, the check fails instead
|
|
268
|
+
of reporting homes as taken.
|
|
269
|
+
|
|
270
|
+
The maximum stay (long or short stay) is only on each home's own page, so with a contract
|
|
271
|
+
filter it reads that page once for every new home and remembers the answer. A home whose page
|
|
272
|
+
can't be read waits for the next check, so a short stay is never announced to someone who
|
|
273
|
+
wants a long one. Photos come from Codomo's image server.
|
|
274
|
+
|
|
275
|
+
## Ask an AI assistant
|
|
276
|
+
|
|
277
|
+
`codomo-alerts mcp` runs an [MCP](https://modelcontextprotocol.io) server, so Claude, Cursor and
|
|
278
|
+
others can answer "any studios in Eindhoven under €1,300?" or "which rooms in Granada are free
|
|
279
|
+
in February?". The search tool takes a city or a country. Install the extra first:
|
|
280
|
+
|
|
281
|
+
```bash
|
|
282
|
+
pipx install "codomo-alerts[mcp]"
|
|
283
|
+
```
|
|
284
|
+
|
|
285
|
+
```json
|
|
286
|
+
{ "mcpServers": { "codomo": { "command": "codomo-alerts", "args": ["mcp"] } } }
|
|
287
|
+
```
|
|
288
|
+
|
|
289
|
+
## Home Assistant
|
|
290
|
+
|
|
291
|
+
Send alerts to Home Assistant with an Apprise link (`hassio://…`), or read the dashboard's
|
|
292
|
+
JSON from `http://HOST:8080/api/overview` with a REST sensor.
|
|
293
|
+
|
|
294
|
+
## Tips for actually getting a home
|
|
295
|
+
|
|
296
|
+
- Create your Codomo account before you start looking.
|
|
297
|
+
- Fill in your home search in the Codomo tenant portal: Codomo uses it when it picks someone
|
|
298
|
+
for a register-interest home, and it tells you itself when a home fits.
|
|
299
|
+
- Have your documents ready. After booking you have about a day to pay.
|
|
300
|
+
- Keep a browser tab open and stay logged in, so an alert is one tap away from booking.
|
|
301
|
+
- In Granada and Linz, check whether a room is shared and whether it is female only or male
|
|
302
|
+
only before you book. The alert says so when Codomo marks it.
|
|
303
|
+
|
|
304
|
+
## Moving from holland2stay-alerts
|
|
305
|
+
|
|
306
|
+
- Install the new package: `pipx uninstall holland2stay-alerts && pipx install codomo-alerts`,
|
|
307
|
+
or use the image `ghcr.io/kooroshkz/codomo-alerts`.
|
|
308
|
+
- Rename `H2S_` variables to `CODOMO_`. In the config, `lottery` is now `interest` (the old
|
|
309
|
+
key still works) and `occupants` is now `persons`, a number of people.
|
|
310
|
+
- City names, bedrooms like `2+`, `contract = ["long"]` and furnishing names keep working.
|
|
311
|
+
- With no cities and no countries set, it now reads every country Codomo lists. To keep only
|
|
312
|
+
the Netherlands, set `countries = ["nl"]` (or `CODOMO_COUNTRIES=nl`).
|
|
313
|
+
- The data folder is now `codomo-alerts`, so the first run starts fresh, quietly.
|
|
314
|
+
|
|
315
|
+
## FAQ
|
|
316
|
+
|
|
317
|
+
**Is there a Codomo app that notifies me about new homes?** Codomo uses the home search in
|
|
318
|
+
your tenant portal for register-interest homes. For a message about every new listing,
|
|
319
|
+
filtered your way and sent to the app you already use, run this tool. It is free and
|
|
320
|
+
unofficial.
|
|
321
|
+
|
|
322
|
+
**How do I get Holland2Stay notifications now?** Holland2Stay is now Codomo, and tools that
|
|
323
|
+
used the old Holland2Stay API stopped working when it closed. This project was
|
|
324
|
+
holland2stay-alerts and reads codomo.eu since version 0.2.0. Install `codomo-alerts` and your
|
|
325
|
+
city names still work.
|
|
326
|
+
|
|
327
|
+
**Does it work for Codomo Granada, Lisbon or Linz?** Yes. Set `CODOMO_CITIES` to `Granada`,
|
|
328
|
+
`Lisbon` (Carcavelos) or `Linz`, or set `CODOMO_COUNTRIES` to `es`, `pt` or `at`. Rooms there
|
|
329
|
+
have their own rules: some are shared and some are female only or male only. Set
|
|
330
|
+
`CODOMO_GENDER` to skip the rooms that aren't open to you.
|
|
331
|
+
|
|
332
|
+
**Why don't homes in Portugal and Austria show a bedroom count?** Codomo doesn't give one.
|
|
333
|
+
They are rooms in student residences, so the `bedrooms` filter counts them as studios: `studio` includes
|
|
334
|
+
them, `2+` skips them.
|
|
335
|
+
|
|
336
|
+
**Which countries does it cover?** Every country Codomo lists: today the Netherlands, Spain,
|
|
337
|
+
Portugal and Austria. When Codomo opens a new country, it is included without an update,
|
|
338
|
+
unless you limit `countries`.
|
|
339
|
+
|
|
340
|
+
**Does it book for me?** No, and it never will. Booking with automated tools is against
|
|
341
|
+
Codomo's terms. It tells you, you book.
|
|
342
|
+
|
|
343
|
+
**Is this allowed?** It reads public listing pages at a slow pace and identifies itself in the
|
|
344
|
+
user agent. Codomo's robots.txt asks bots to stay away from `/api/` and from addresses with a
|
|
345
|
+
`?`, which includes the filtered list this tool reads; the sitemap and the home pages are
|
|
346
|
+
allowed. Read [Codomo's terms](https://codomo.eu/en/terms-and-conditions) and decide for
|
|
347
|
+
yourself. You're responsible for how you use it.
|
|
348
|
+
|
|
349
|
+
**Do I need a server?** No. Any computer that stays on works: a laptop on power, a Raspberry
|
|
350
|
+
Pi, a NAS or a small VPS.
|
|
351
|
+
|
|
352
|
+
**What happened to Holland2Stay?** It became Codomo on 16 November 2026. Every
|
|
353
|
+
holland2stay.com address redirects to codomo.eu, and version 0.2.0 reads codomo.eu.
|
|
354
|
+
|
|
355
|
+
**Alerts stopped.** Run `codomo-alerts doctor`, and `codomo-alerts upstream` to see whether
|
|
356
|
+
Codomo changed something. Codomo sometimes shows a maintenance page for half an hour; the tool
|
|
357
|
+
recognises it and keeps trying. A daily check runs the same test here and opens an
|
|
358
|
+
[issue](https://github.com/kooroshkz/codomo-alerts/issues?q=label%3Aupstream) when it fails,
|
|
359
|
+
so look there first.
|
|
360
|
+
|
|
361
|
+
## Contributing
|
|
362
|
+
|
|
363
|
+
Ideas, fixes and other landlords are welcome. If it helped you find a home, a ⭐ helps
|
|
364
|
+
other people find it too. See [CONTRIBUTING.md](https://github.com/kooroshkz/codomo-alerts/blob/main/CONTRIBUTING.md).
|
|
365
|
+
|
|
366
|
+
## Disclaimer
|
|
367
|
+
|
|
368
|
+
This is an unofficial, independent project. It is not affiliated with, endorsed by or
|
|
369
|
+
connected to Codomo or Holland2Stay B.V. Their names are only used to describe what this
|
|
370
|
+
works with. It never books, pays, fills in forms or logs in. There's no guarantee you'll get
|
|
371
|
+
a home, and it can stop working whenever the site changes. Provided as is, under the
|
|
372
|
+
[MIT license](https://github.com/kooroshkz/codomo-alerts/blob/main/LICENSE).
|