XIOR-Monitor

KO | EN

gitlite — search

#javascript #python #hacktoberfest #rust #docker #macos #windows #awesome #cli #vue #pytorch #ios #mcp #open-source

(★ 23)

XIOR Student Housing Monitor 房源自动监控器 | Room Hunting Tool 抢房工具 | Automated room availability monitor for XIOR Delft (Antonia Veerstraat & Barbarasteeg)

XIOR-Monitor Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# 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](https://www.xiorstudenthousing.eu/netherlands/).

**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.

```python
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:

```python
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.

XIOR-Monitor

XIOR-Monitor Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

XIOR-Monitor

XIOR-Monitor Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README