Skip to content

Synchroniser votre emploi du temps Pronote avec votre agenda Google !

License

Notifications You must be signed in to change notification settings

johan-perso/syncpronote

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

9 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

SyncPronote

Un service en arrière-plan qui synchronise votre emploi du temps Pronote sur Google Agenda. Celui-ci vous alerte aussi lorsqu'un cours est modifié ou annulé via ntfy (optionnel).

Installation

Vous aurez besoin d'une version récente de Node.js
Vous pouvez installer pm2 pour démarrer le service en arrière-plan
Vous pouvez installer ntfy pour recevoir des notifications lors de certaines actions apportées à l'EDT

  1. Cloner le dépôt
git clone https://github.com/johan-perso/syncpronote.git
  1. Installer les dépendances
cd syncpronote
npm install
# ou "pnpm install" si vous utilisez pnpm
  1. Configurer le service
cd cli

node auth-pronote.js
# Suivez les instructions pour configurer l'accès à Pronote

node auth-google.js
# Suivez les instructions pour configurer l'accès à Google Calendar
# Important : un fichier `google-credentials.json` doit exister à la racine du projet, il doit correspondre au fichier JSON téléchargé sur le dashboard Google (détails d'authentification du client, choissisez "application de bureau")

nano .env
# Ajouter une ligne `GOOGLE_CALENDAR_ID=` avec l'identifiant de l'agenda Google qui contiendra les nouveaux événements (format similaire à celui d'une adresse mail)
# Vous pouvez ajouter `NTFY_URL` et `NTFY_USERNAME` + `NTFY_PASSWORD` pour recevoir des notifications lors de la modification ou suppression d'un cours. Le topic utilisé sera `pronote`.
  1. Lancer le service
npm start
# ou vous pouvez utiliser pm2 pour le lancer en arrière plan
pm2 start index.js --name "SyncPronote"

Fonctionnement

Toutes les demies-heures (x:00 et x:30) entre 6h et 21h, les cours sur la semaine actuelle ainsi que les trois semaines à venir seront récupérés depuis Pronote et comparés aux entrées de l'agenda Google. Les événements manquants seront ajoutés, les cours modifiés seront mis à jour et les cours annulés seront supprimés.

Seules les entrées considérées comme des cours peuvent être mises à jour ou supprimées. Les autres événements du calendrier ne seront pas touchés.

Personnalisation (avancé)

Personnaliser les heures des cours :

Le fichier utils/custom-hours permet de changer les heures de début et de fin des cours annoncées par Pronote. Vous devrez modifier les valeurs pour les faire correspondre à votre emploi du temps.

Personnaliser le nom des matières :

Vous pouvez modifier le fichier utils/classnames.js pour personnaliser le nom affiché dans votre agenda pour chacune de vos matières. Certaines matières sont déjà préconfigurées et seront affichées dans votre agenda sans modification à effectuer.

Licence

MIT © Johan. Soutenez moi via Ko-Fi ou PayPal si vous souhaitez m'aider 💙