Guide d'utilisation de CineLume

1. Démarrer

Ouvre simplement quasaria.github.io/CineLume. Aucune inscription, aucun email, aucun mot de passe. L'app est immédiatement utilisable.

Au premier lancement tu vois le calendrier des sorties cinéma de la semaine courante pour la France. Tu peux changer le pays via le bouton Filtres en haut.

2. Trouver les sorties

La barre de navigation centrale affiche le mois et l'année courants. Tu peux :

• Taper le mois pour ouvrir un picker (grille de 12 mois + flèches d'année)
• Utiliser les flèches gauche/droite pour avancer mois par mois
• Cliquer sur une semaine (S1, S2, S3...) pour la sélectionner
• Cliquer sur l'icône calendrier pour revenir à aujourd'hui

Le bouton Filtres ouvre un panneau pour affiner par genre, plateforme de streaming (Netflix, Prime Video, Disney+, etc.), type de sortie (cinéma, streaming, festival) et durée maximale.

Tu peux aussi chercher n'importe quel film, acteur ou réalisateur via la loupe en haut à droite. L'historique des 8 dernières recherches reste accessible.

Si tu as déjà marqué des films comme vus (voir section suivante), le mode déjà-vu (activé par défaut, désactivable dans Paramètres) grise légèrement leurs affiches sur la grille avec un petit badge, pour repérer en un coup d'œil ce qu'il te reste à découvrir.

3. Favoris et watchlist

Sur chaque carte de film, deux boutons en haut à droite :

• Cœur (♥) = ajouter aux Favoris. Les favoris déclenchent les notifications de sortie.
• Marque-page = ajouter à la Watchlist (à voir plus tard).

Pour consulter tes listes, clique les icônes correspondantes dans la navbar. Les deux onglets sont dans la même modale "Mes films" — tu switches entre eux sans fermer.

Les films sont automatiquement groupés par section : Cette semaine, À venir, Sortis, Date inconnue.

4. Marquer un film comme vu

Sur la fiche d'un film, tape l'icône œil pour le marquer comme vu. C'est distinct des favoris et de la watchlist :

• Un film marqué vu quitte automatiquement ta liste à voir s'il y était
• Il reste consultable dans Mon Calendrier (voir plus bas), avec la date exacte où tu l'as regardé
• Si un film est à la fois dans tes favoris et marqué vu, un petit badge "Vus" apparaît à côté dans la modale Mes films, pour le distinguer sans le supprimer de ta liste affective

5. Listes personnalisées

Pour des collections thématiques (Date night, Marathon Tarantino, À montrer à mes parents...), utilise les Listes :

6. Notifications de sortie

Pour être prévenu le jour où tes films favoris sortent :

1. Ajoute des films à tes Favoris (♥)
2. Paramètres → section Notifications → Activer
3. Autorise dans la popup navigateur
4. (Optionnel) Configure les heures de calme (par exemple 22h-8h) pour ne pas être dérangé la nuit

Les notifications fonctionnent en navigateur ouvert et en mode PWA installée. Aucun service push tiers : tout est local (API Notification du navigateur).

7. Modes Swipe et Pioche

Quand tu hésites sur quel film regarder, deux modes alternatifs sont accessibles depuis le menu burger :

Pioche un film

Modale qui tire au sort un film dans la source choisie (Watchlist / Favoris / Toutes mes listes). Filtre optionnel par genre. Bouton "Une autre" pour re-piocher, "Voir les détails" pour ouvrir la modale film.

Mode sélecteur (Swipe)

À la Tinder : choisis une source (Cette semaine / Watchlist / Favoris). Une carte par carte :

• Swipe à droite ou bouton cœur = ajouter à la watchlist
• Swipe à gauche ou bouton X = passer
• Bouton Annuler ramène la dernière carte si erreur
• Sur desktop : flèches gauche/droite du clavier marchent aussi
• Scrolle vers le bas dans une carte pour voir synopsis, genres, réalisateur

8. Mon Calendrier, Mon Année et Mon Wrapped

Trois espaces accessibles depuis le menu burger pour suivre ta cinéphilie, en complément (pas en remplacement) d'un journal social type Letterboxd.

Mon Calendrier

Dashboard complet de ton historique de visionnage :

• Statistiques : total de films vus, cette année, ce mois, ta plus longue série de jours consécutifs, ton mois le plus actif
• Genres préférés en répartition visuelle
• Un vrai calendrier mois par mois : navigue librement avec les chevrons (même sur des mois sans film vu), chaque jour où tu as vu un film affiche son affiche directement dans la case. Plusieurs films le même jour ? Un badge "+N" les indique tous.

Mon Année cinéma

Vue calendrier annuelle stylisée qui regroupe automatiquement les films de tes favoris et de ta liste à voir sur leur mois de sortie à venir, avec un dégradé de couleur qui change selon la saison.

Mon Wrapped

Récap mensuel ou annuel de ta cinéphilie, façon "Spotify Wrapped" pour le cinéma :

9. Import depuis Letterboxd

Si tu utilises déjà Letterboxd et veux migrer ta watchlist :

Tu peux aussi exporter ta watchlist CineLume au format Letterboxd CSV via le bouton Exporter de la même section, pour migrer ailleurs si tu veux.

10. Installer CineLume sur ton téléphone

CineLume est une Progressive Web App, installable sur tous les appareils :

Sur iPhone / iPad (Safari)

1. Ouvre CineLume dans Safari
2. Tape l'icône Partager (carré avec flèche)
3. Sélectionne Ajouter à l'écran d'accueil

Sur Android (Chrome)

Chrome propose automatiquement un bouton "Installer l'app" en bas de l'écran après quelques visites, ou via le menu ⋮ → Installer l'app.

Sur desktop (Chrome / Edge)

Une icône Installer apparaît à droite de la barre d'adresse. Sinon, menu ⋮ → Installer CineLume.

Une fois installée, CineLume se lance comme une app native (sans la barre du navigateur). Long-presse l'icône sur l'écran d'accueil pour accéder aux raccourcis : Favoris et Pioche un film.