📝 Update README.md for Paris OSM Event Watcher 🇫🇷📅

This commit is contained in:
Edward Betts 2024-10-18 09:37:35 +01:00
parent 39b2fa24a6
commit 01409b7246

View file

@ -1,19 +1,21 @@
# OSM Paris Event Watcher
# Paris OSM Event Watcher
This Python script periodically checks the OpenStreetMap Calendar API for upcoming events in Paris, particularly focused on hack weekends. If it finds any events, it sends an email notification with the event details.
This Python script monitors the OpenStreetMap Calendar for upcoming events in Paris and sends email alerts if any are found. It specifically checks the OSM Calendar API for any events that are scheduled to take place in Paris.
## Features
- Fetches event data from the OSM Calendar API for events located in France.
- Filters for events that are specifically in Paris.
- Sends an email notification for each event found in Paris.
- **Event Filtering**: Filters the list of events retrieved from OSMCal to find those located in Paris.
- **Email Notifications**: Sends a detailed email notification listing the upcoming events found in Paris.
## Requirements
## Installation
- Python 3.8 or later.
- `requests` library.
Clone the repository to your local machine:
To install the required Python library, run:
```bash
git clone https://git.4angle.com/edward/check-osmcal-for-paris-events
```
Ensure you have `Python 3` and `requests` library installed:
```bash
pip install requests
@ -21,13 +23,18 @@ pip install requests
## Usage
To run the script, simply execute:
The script can be executed manually by running:
```bash
python3 check.py
python3 /path/to/check.py
```
Make sure to run it in an environment where it has network access to both the OSM Calendar API and your SMTP server.
However, it is intended to be run periodically as a cron job. Here's an example cron job setup that executes the script every 6 hours:
```
# Check the OpenStreetMap Calendar API for upcoming events in Paris and send an alert
0 */6 * * * /usr/bin/python3 /parth/to/check.py
```
## Configuration
@ -37,12 +44,13 @@ You will need to configure the following variables within the script:
- `MAIL_TO`: The recipient email address.
- `SMTP_HOST`: The hostname of the SMTP server you are using to send emails.
These are currently set to default values and will need to be updated to reflect your actual email setup.
## Support
## Contact
For support, contact Edward Betts at [edward@4angle.com](mailto:edward@4angle.com).
For any queries or further customization, please contact:
Edward Betts <edward@4angle.com>
## Contributing
Contributions to this project are welcome. Please fork the repository and submit a pull request.
## License