XIOR Delft Room Monitor

Automatically checks XIOR Student Housing for available rooms and sends a Telegram notification the moment one opens up.

---

What it monitors

By default:

• Antonia Veerstraat (Delft)
• Barbarasteeg (Delft)

You can monitor any XIOR property in the Netherlands by editing the PROPERTIES list in monitor.py. Just add the property name and its URL from the XIOR website.

Important: the monitor works by automatically clicking the Check Availability button on the property page. Make sure the URL you add follows this format:

https://www.xiorstudenthousing.eu/netherlands/[city]/[property-name]-student-accommodation/

For example:

https://www.xiorstudenthousing.eu/netherlands/delft/antonia-veerstraat-student-accommodation/

URLs ending in -student-accommodation/ are the individual property pages that have the Check Availability button.

PROPERTIES = [
    {
        "name": "Antonia Veerstraat (Delft)",
        "url":  "https://www.xiorstudenthousing.eu/netherlands/delft/antonia-veerstraat-student-accommodation/",
    },
    {
        "name": "Your Property Name",
        "url":  "https://www.xiorstudenthousing.eu/netherlands/...",
    },
]

---

Requirements

• Windows PC
• Python 3.10+
• Google Chrome installed

Install dependencies:

pip install undetected-chromedriver selenium httpx

---

Setup

Step 1 — Create a Telegram Bot

1. Open Telegram and search for @BotFather
2. Send /newbot and follow the instructions
3. Copy the Bot Token it gives you (looks like 123456789:ABCdef...)

Step 2 — Get your Chat ID

1. Send any message to your new bot
2. Open this URL in your browser (replace YOUR_TOKEN with your token):

   https://api.telegram.org/botYOUR_TOKEN/getUpdates
   

3. Find "id" inside the "chat" section — that is your Chat ID

Step 3 — Fill in config.py

Open config.py and replace the placeholder values:

TG_TOKEN   = "123456789:ABCdef..."   # your Bot Token
TG_CHAT_ID = "987654321"             # your Chat ID

---

How to run

Open a Command Prompt in the folder containing monitor.py and run:

python monitor.py --loop

A Chrome window will open and start checking automatically every 5 minutes. You will receive a Telegram message if a room becomes available.

---

Important: keep the Chrome window visible

The script controls a real Chrome window to bypass the website's bot protection. Some rules:

• Do not close the Chrome window — the script will stop working
• The window needs to remain open for the entire time the monitor is running
• If the window closes or crashes, restart the script

The best setup is a spare laptop or PC that you leave running 24/7. This way you don't have to worry about accidentally closing the window, and your main computer stays free.

---

Stopping the monitor

Press Ctrl + C in the Command Prompt window.