GuideME — Ramadan Edition

App desktop d'horaires de priere, suivi du jeune et notifications adhan.

Legere, privee, 100% locale. Construite avec Tauri et Rust.

---

GuideME.-.Ramadan.Edition.2026-02-23.13-22-44.mp4

Fonctionnalites

Horaires de priere

• Double source API — Mawaqit (horaires mosquee) avec Aladhan en fallback (calcul astronomique)
• Navigation par date — Parcourir les horaires sur ±30 jours
• Calendrier mensuel — Vue complete des horaires du mois
• Date Hijri — Affichage de la date du calendrier islamique

Suivi du jeune

• Progression en direct — Barre Suhoor → Iftar mise a jour chaque minute
• Compte a rebours — Timer vers la prochaine priere (tick par seconde)
• Mode reference — Consulter les horaires de jeune des jours passes/futurs

Notifications

• Adhan personnalise — Notification OS a l'heure de chaque priere
• Controle par priere — Activer/desactiver les rappels individuellement
• Rappels silencieux — Notifications sans son disponibles

Interface

• Themes Dark / Light — Bleu nuit + glassmorphism ou vert + or + sable
• System tray — Fermer = minimiser, l'app reste accessible
• Lancement au demarrage — Option autostart
• Titlebar custom — Barre de titre personnalisee avec animations sakura
• Carte interactive — Localiser sa mosquee sur OpenStreetMap
• Onboarding — Tutoriel guide au premier lancement

Communaute

• Signaler un bug — Formulaire integre creant une issue GitHub
• Quoi de neuf — Modale changelog avec badge NEW a chaque mise a jour

---

Telecharger

Plateforme	Formats	Notes
Windows 10/11	.exe (NSIS), .msi	Installation classique
macOS	.dmg	Universal (Intel + Apple Silicon)
Linux	.deb, .AppImage	Debian/Ubuntu ou portable

macOS — Premier lancement

L'app n'est pas signee avec un certificat Apple. macOS affichera un avertissement.

Methode 1 — Terminal (recommande) :

xattr -cr /Applications/GuideME\ -\ Ramadan.app

Puis ouvrir l'app normalement.

Methode 2 — Reglages Systeme :

1. Ouvrir Reglages Systeme → Confidentialite et securite
2. Descendre jusqu'au message "GuideME - Ramadan a ete bloque"
3. Cliquer Ouvrir quand meme → entrer le mot de passe

Linux — Installation

AppImage :

chmod +x GuideME-Ramadan_*.AppImage
./GuideME-Ramadan_*.AppImage

Debian/Ubuntu (.deb) :

sudo dpkg -i guideme-ramadan_*.deb

---

Vie privee

Vos donnees ne quittent jamais votre appareil.

GuideME est concue dans le respect total de votre vie privee :

• Aucun compte requis — Pas d'inscription, pas de login
• Aucune telemetrie — Zero tracking, zero analytics, zero cookie
• Stockage 100% local — Tous vos parametres sont dans un fichier local (guideme-settings.json)
• Geolocalisation locale — Vos coordonnees servent uniquement a calculer les horaires et ne sont jamais transmises
• Bug reports volontaires — Envoyes a GitHub Issues uniquement quand vous cliquez "Envoyer"

APIs externes appelees

API	Usage	Donnees envoyees
Mawaqit	Horaires de la mosquee selectionnee	Slug de la mosquee uniquement
Aladhan	Horaires calcules + date Hijri	Ville ou coordonnees GPS
OpenStreetMap	Tuiles de la carte (settings)	Requetes de tuiles standard

Aucune de ces APIs ne recoit de donnees personnelles identifiantes.

Pour plus de details, consultez notre Politique de confidentialite. Pour les mentions légales, référez-vous aux Conditions Générales d'Utilisation.

---

Stack technique

Composant	Technologie	Role
Desktop	Tauri v2	Framework desktop leger (~8 MB)
Backend	Rust	Logique native, system tray, HTTP securise
Frontend	Vanilla JavaScript (ES modules)	Interface sans framework
Build	Vite 7	Bundler ultra-rapide
Cartes	Leaflet.js + OpenStreetMap	Carte interactive
Icones	Font Awesome 6	Icones UI
Police	Outfit (Google Fonts)	Typographie principale

---

Developpement

Prerequis

• Node.js 18+
• Rust toolchain stable
• Prerequis Tauri selon l'OS :
  • Windows — WebView2 (inclus dans Windows 11)
  • macOS — Xcode Command Line Tools (xcode-select --install)
  • Linux — libwebkit2gtk-4.1-dev libappindicator3-dev librsvg2-dev patchelf (Debian/Ubuntu)

Installation

git clone https://github.com/SofianeBel/myramadan.git
cd myramadan
npm install

Commandes

npm run tauri:dev     # App desktop avec hot reload
npm run tauri:build   # Build installer pour l'OS courant
npm run dev           # Vite dev server seul (port 1420)
npm run build         # Build frontend seul

Structure du projet

src/                  # Frontend (JS, HTML, CSS)
  modules/            # Modules ES : prayer-times, notifications, settings...
  style.css           # Styles + theming (CSS custom properties)
src-tauri/            # Backend Rust
  src/lib.rs          # System tray, bug report, autostart
public/               # Assets statiques (logo, audio)

---

Contribuer

Les contributions sont les bienvenues ! Consultez le guide de contribution pour demarrer.

---

Credits & Attributions

Ce projet existe grace a ces services et librairies :

• Mawaqit — Horaires de priere des mosquees (waqf)
• Aladhan — API de calcul des horaires de priere et calendrier Hijri
• OpenStreetMap contributors — Donnees cartographiques (ODbL)
• Leaflet — Bibliotheque de cartes interactives (BSD-2)
• Tauri — Framework desktop (MIT + Apache 2.0)
• Font Awesome — Icones (CC BY 4.0 / OFL / MIT)
• Google Fonts — Police Outfit (OFL 1.1)

---

Soutenir le projet

GuideME est gratuit et open source. Si l'app vous est utile, un petit soutien aide a la maintenir :

---

Licence

Ce projet est sous licence MIT.

Distribue librement — voir le fichier LICENSE pour les details.

---

_{Fait avec soin pour le Ramadan. Qu'Allah accepte nos efforts.}