38 lines
2.2 KiB
Markdown
38 lines
2.2 KiB
Markdown
# event-creator
|
|
|
|
A Violentmonkey userscript: select any text on any webpage, and turn it into a downloadable `.ics` calendar event.
|
|
|
|
Built for event listing sites (concert venues, theaters, local agendas) where the date, time, and location are just scattered in the page text — no need to type anything by hand.
|
|
|
|
## Install
|
|
|
|
1. Install [Violentmonkey](https://violentmonkey.github.io/) (Chrome, Firefox, Edge).
|
|
2. Install the script from the raw file: [event-creator.user.js](https://raw.githubusercontent.com/alexture/event-creator/main/event-creator.user.js) — Violentmonkey will prompt to install it.
|
|
|
|
The script auto-updates itself from this repo (via `@updateURL`), so you don't need to reinstall it when it changes.
|
|
|
|
## Usage
|
|
|
|
1. Select text containing the event info (title, date, time, location…) anywhere on any page.
|
|
2. Click the "Créer événement" bubble that appears above your selection.
|
|
3. Check/fix the fields in the popup — title, date, time(s), recurrence, location, description.
|
|
4. Click "Télécharger .ics" to download the file, then open it to add it to your calendar app.
|
|
|
|
## What it parses
|
|
|
|
- **Title**: first line of the selection that isn't a date/UI text ("Détails", "Réserver"…)
|
|
- **Date & time(s)**: French natural language ("15 mars 2026", "samedi 20 juin", "20h30", "20h30 - 22h30"), via [chrono-node](https://github.com/wanasit/chrono)
|
|
- **Multiple time ranges**: e.g. a listing with several showtimes — each becomes its own event in the `.ics` file
|
|
- **Recurrence**: "tous les mardis", "chaque semaine", "jusqu'au 20 juin" → weekly/daily/monthly/yearly `RRULE`, with an end date
|
|
- **Location**: a line with a venue keyword (salle, théâtre, cinéma, café…), a line starting with "à/au/chez", or a `Localisation` label followed by venue + address
|
|
- **All-day events**: when no time is found
|
|
- Everything is editable before download — the parsing is a best-effort starting point, not gospel
|
|
|
|
## Notes
|
|
|
|
- Single self-contained file — chrono-node is bundled in directly (built with esbuild from the npm package), so there's no runtime dependency on an external CDN.
|
|
- `@match *://*/*` — works on any site.
|
|
|
|
## License
|
|
|
|
MIT — see [LICENSE](LICENSE).
|