diff --git a/.gitignore b/.gitignore index 64777da..99a3b6d 100644 --- a/.gitignore +++ b/.gitignore @@ -1,2 +1,5 @@ __pycache__/ .DS_Store +*.egg-info/ +rtg-admin.log +rtg-admin.pid diff --git a/Dockerfile b/Dockerfile index 58e2fb2..2794c26 100644 --- a/Dockerfile +++ b/Dockerfile @@ -17,7 +17,7 @@ RUN pip install --no-cache-dir . && rtg verifier # le Mac : les sources notées dans les voyage.toml restent valables. ENV XDG_CONFIG_HOME=/config TZ=Europe/Paris PYTHONUNBUFFERED=1 \ RTG_RACINE=/Volumes/CLEROADTRIPS/Road-Trips RTG_PREFIXE=/admin \ - RTG_ARRET_INACTIF=120 + RTG_ARRET_INACTIF=0 EXPOSE 8765 # Aucun port publié : seul le nginx du site (même réseau Docker) le joint. diff --git a/README.md b/README.md index 810b39a..91d627a 100644 --- a/README.md +++ b/README.md @@ -8,9 +8,9 @@ Je me suis rendu compte que je passais des heures à monter des films de mes roa Pour chaque voyage, je dispose de photos et de vidéos géolocalisées (photos iPhone, films GoPro), des traces GPS de chaque journée et d'un récit écrit en Markdown. -Les scripts lisent les positions GPS des photos et des vidéos, les placent sur une carte avec la trace du parcours découpée par jour, et construisent des pages web où l'on peut, en parallèle, lire le récit du voyage. Voir par exemple mon [road-trip de l'été 2025](https://roadtrip.ouaibe.fr/Ete-2025/). +RTG lit les positions GPS des photos et des vidéos, les placent sur une carte avec la trace du parcours découpée par jour, et construit des pages web où l'on peut, en parallèle, lire le récit du voyage. Voir par exemple mon [road-trip de l'été 2025](https://roadtrips.ouaibe.fr/Ete-2025/). -Ils préparent aussi les médias pour le web : +Il prépare aussi les médias pour le web : * **vidéos** : un 720p H.264 lisible partout, chargé par défaut, et un 1080p HEVC proposé à la demande (environ 40 % plus léger que du H.264 à qualité égale) ; * **photos** : une version allégée (1600 px, quelques centaines de Ko) affichée dans les diaporamas, le clic ouvrant l'original ; @@ -86,212 +86,177 @@ rtg verifier La commande contrôle Python, les modules, exiftool, ffmpeg et ses encodeurs, et donne pour chaque élément manquant la commande à taper sur votre système. -## Organisation des dossiers - -Le dépôt et le site sont deux dossiers voisins. Un voyage est un dossier qui contient au moins un des sous-dossiers `photos`, `rushs` ou `routes`. Les voyages rangés à la racine du site forment la rubrique « Voyages » de la page d'accueil. Ceux rangés un niveau plus bas, dans un dossier de regroupement (ici `Balades`), forment une rubrique du nom de ce dossier. L'accueil montre les 2 plus récents de chaque rubrique (`ACCUEIL_NB=3` pour en montrer plus), avec un lien vers la liste complète. - -``` -CLEROADTRIPS -|-RoadTripsGenerator ce dépôt -| |-Scripts -| |-templates mise en page (HTML, CSS, JavaScript) -|-Road-Trips le site - |-Ete-2025 - | |-photos photos (JPEG) - | |-rushs vidéos d'origine (peut être un lien vers un disque externe) - | |-routes une trace GPX par jour, date dans le nom : 2025-08-02.gpx - | |-voyage.md le récit - |-Balades - |-Aisne-06-2026 - |-... -``` - -Dans le récit `voyage.md`, deux raccourcis évitent les liens écrits en dur (qui ne marcheraient pas à la fois en local et en ligne) : - -``` -[Carte du jour](jour:2025-08-02) -[Le col](media:photos/IMG_4831.jpeg) -[La descente](media:videos/GH011272.mp4) -``` - -## L'interface +## Premiers pas ``` cd /Volumes/CLEROADTRIPS/Road-Trips rtg interface ``` -Le navigateur s'ouvre sur l'interface de RTG (adresse `http://127.0.0.1:8765/…`, visible de cet ordinateur seulement). Laisser la fenêtre de Terminal ouverte pendant l'utilisation ; Ctrl+C l'arrête. +L'interface s'ouvre dans le navigateur. Laisser la fenêtre de Terminal ouverte pendant l'utilisation ; Ctrl+C l'arrête. -- **Mes voyages** : tous les voyages par rubrique, avec leurs dates et l'avancement des vidéos, des photos et des pages. Le bouton « Nouveau voyage » crée le dossier et son `voyage.toml`. -- **Un voyage**, en cinq onglets : - - *Journées* : la carte des traces, jour par jour, et les kilomètres. Une trace sans heures et sans date dans son nom (un itinéraire préparé, par exemple) se rattache ici à un jour. RTG propose le jour où des photos ou des vidéos ont été prises le long de la trace. On peut aussi répartir les traces à la suite, un jour par trace. - - *Carte et corrections* : glisser une photo ou une vidéo mal placée, placer celles qui n'ont pas de position (cliquer son nom puis la carte), et masquer des zones de trace : autour de chez soi, ou sur une erreur du GPS. Une zone peut valoir pour tous les voyages (zone privée). Fond plan ou satellite. Les corrections sont notées dans `voyage.toml` (`[positions]`, `[corrections]`) ou `site.toml` (`[confidentialite]`) et appliquées à la génération suivante ; les fichiers d'origine ne sont pas modifiés. - - *Sources* : où sont les traces, les vidéos et les photos d'origine, choisies dans une fenêtre de dossiers ou collées. Le nombre de fichiers trouvés s'affiche, et un disque débranché est signalé. - - *Infos et récit* : titre, moto et récit (`voyage.md`). - - *Générer* : tailles des rushs et de ce qui reste à encoder, espace libre, puis lancement de la génération ou de l'encodage seul. L'avancement de chaque vidéo s'affiche ; « Arrêter » interrompt proprement, sans perdre les vidéos déjà finies. -- **Réglages** : les réglages de `site.toml` (qualité vidéo, taille des photos, fuseau, cartes My Maps) et la vérification des outils installés. -- **Voir le site** : le site généré, servi tel quel, vidéos comprises. +- **Site existant**, organisé à l'ancienne (avant RTG) : `rtg migrer` écrit une fois `site.toml` et un `voyage.toml` par voyage. +- **Nouveau site** : lancer `rtg interface` dans un dossier vide ; l'interface propose de créer le site. -### Accès à l'interface +**L'aide d'utilisation est dans l'interface** : un bouton « ? » sur chaque écran et chaque onglet, et la page « Aide » du menu. Elle est aussi lisible ici, dans [`rtg/interface/aide/`](rtg/interface/aide/index.md). -L'interface permet de modifier le site et de lire les fichiers de l'ordinateur : elle est protégée. +## Organisation des dossiers -- **Sur l'ordinateur où elle tourne**, l'adresse ouverte au lancement contient une clé d'accès tirée au hasard (`…/?jeton=…`), affichée aussi dans le Terminal. Sans elle, l'interface demande de se connecter. La clé change à chaque lancement ; le navigateur garde ensuite une session de 12 heures, perdue quand l'interface s'arrête. « Se déconnecter » la ferme tout de suite. -- **Mot de passe** : `rtg mot-de-passe` le définit (10 caractères au moins). Seule une empreinte est enregistrée, hors du site : `~/.config/rtg/acces.toml` (`%APPDATA%\rtg\acces.toml` sous Windows). `rtg mot-de-passe --supprimer` l'efface. Après 5 essais faux, l'adresse IP doit attendre une minute, puis deux, quatre… jusqu'à une heure. -- **Depuis une autre machine** (le serveur qui héberge le site, par exemple) : `rtg interface --distant`, qui exige le mot de passe. Sans HTTPS, ce mot de passe circulerait en clair. Trois solutions : - - servir l'interface derrière le serveur web du site, en HTTPS, sur une adresse à part ; - - `--certificat cert.pem --cle cle.pem` ; - - le plus simple : un tunnel SSH. Sur le serveur, lancer `rtg interface --sans-navigateur` (sans `--distant`). Sur le Mac, ouvrir `ssh -L 8765:127.0.0.1:8765 serveur`, puis l'adresse avec la clé affichée sur le serveur. -- **Bouton « Connexion » sur l'accueil du site** : voir ci-dessous. -- Les fichiers de réglages (`site.toml`, `voyage.toml`) sont dans les dossiers du site. Si le serveur web publie ce dossier tel quel, ils sont lisibles par tous, avec les chemins de tes disques. Rien de secret n'y est écrit, mais on peut les refuser au serveur web (par exemple `location ~ \.toml$ { deny all; }` pour nginx, ou ` Require all denied ` pour Apache). - -### Administration depuis le site - -Pour administrer le site depuis son adresse publique (bouton « Connexion » en haut à droite de l'accueil, qui mène à `https://roadtrips.ouaibe.fr/admin/`), l'interface tourne sur la machine qui sert le site, derrière son serveur web en HTTPS. Les sources (rushs, traces, photos) doivent alors être accessibles depuis cette machine pour encoder et générer. - -1. Sur cette machine, une fois : `rtg mot-de-passe`. -2. Lancer l'interface, en permanence de préférence (service, `tmux`…) : - ``` - rtg --racine /chemin/vers/Road-Trips interface --proxy --prefixe /admin --port 8765 - ``` - Elle n'écoute que sur 127.0.0.1 : seul le serveur web peut la joindre. Le mot de passe est obligatoire. -3. Transmettre `/admin/` à l'interface depuis le serveur web. - - Traefik qui envoie le site à un conteneur nginx (docker compose) : rien à changer dans Traefik. Ajouter le bloc de `exemples/nginx-admin.conf` dans le `nginx.conf` du conteneur, et `extra_hosts: ["host.docker.internal:host-gateway"]` au service dans `docker-compose.yml`, puis `docker compose up -d`. - - Traefik seul (fichier de configuration dynamique) : copier `exemples/traefik-rtg-admin.yml` dans le dossier de configuration dynamique de Traefik, en y mettant les mêmes `entryPoints` et `certResolver` que pour le site. Le fichier indique l'adresse à mettre selon que Traefik tourne dans Docker sur le Mac, directement sur le Mac, ou sur une autre machine (dans ce dernier cas, lancer RTG avec `--ecoute 0.0.0.0` en plus). - - nginx, dans le bloc `server` du site en HTTPS : - ```nginx - location ^~ /admin/ { - proxy_pass http://127.0.0.1:8765; - proxy_set_header Host $host; - proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; - proxy_set_header X-Forwarded-Proto $scheme; - proxy_buffering off; - } - location ~ \.toml$ { deny all; } - ``` - - Apache (modules `proxy`, `proxy_http`, `headers`) : - ```apache - ProxyPass /admin/ http://127.0.0.1:8765/admin/ - ProxyPassReverse /admin/ http://127.0.0.1:8765/admin/ - RequestHeader set X-Forwarded-Proto "https" - - Require all denied - - ``` -4. Dans l'interface, Réglages → « Administration depuis le site » : adresse `/admin/`. Après « Refaire l'accueil », le bouton « Connexion » apparaît sur la page d'accueil. - -### L'administration dans Docker - -Plutôt que de laisser `rtg interface` ouvert dans un Terminal, on peut le faire tourner dans un conteneur, à côté du nginx du site. Le `Dockerfile` est à la racine de RoadTripsGenerator (Python, ffmpeg, exiftool). - -1. Définir le mot de passe sur le Mac, une fois : `rtg mot-de-passe`, puis en copier l'empreinte à côté du `docker-compose.yml` : `mkdir -p rtg-acces && cp ~/.config/rtg/acces.toml rtg-acces/`. -2. Ajouter le service `rtg` au `docker-compose.yml` du site (voir `exemples/docker-compose.yml`) et copier `exemples/admin.sh` à côté. Le conteneur voit les disques de `/Volumes` aux mêmes chemins que sur le Mac, ce qui garde valables les sources notées dans les `voyage.toml`. Tous sont en lecture seule, sauf le dossier du site. Le disque interne (ici `MACHD`) est masqué par un dossier vide ; quant au lien `/Volumes/Macintosh HD`, il pointe dans le conteneur vers le système du conteneur, pas vers celui du Mac. Docker Desktop doit partager `/Volumes` (Réglages → Resources → File sharing) ; ce réglage permet seulement aux conteneurs de le demander, et seul `rtg` le fait. -3. Dans `nginx.conf`, faire pointer `/admin/` vers ce conteneur : voir `exemples/nginx-admin.conf`. Le site reste en ligne même si le conteneur RTG est arrêté. -4. `docker compose build rtg`, puis `docker compose up -d` (le site ; l'administration ne démarre pas avec lui). - -L'administration est **à la demande** : `./admin.sh` l'ouvre, `./admin.sh stop` la ferme, et elle se ferme d'elle-même après 2 heures sans activité (variable `RTG_ARRET_INACTIF`, en minutes). Fermée, `/admin/` affiche « Administration fermée » et le site reste en ligne. - -Après une mise à jour de RTG : `docker compose build rtg`. Disque des rushs branché après l'ouverture : relancer `./admin.sh`. L'encodage utilise les processeurs attribués à Docker (réglages de Docker Desktop, « Resources ») ; l'encodeur matériel VideoToolbox du Mac n'est pas disponible dans le conteneur. - -Le bouton n'est qu'un lien : la protection est celle de l'interface (mot de passe, blocage après plusieurs essais faux, cookie de session limité à `/admin/`, envoyé seulement en HTTPS). - -Tout ce que fait l'interface s'écrit dans `site.toml` et les `voyage.toml`. On peut toujours utiliser les commandes ci-dessous ou modifier ces fichiers à la main. Une réécriture par l'interface conserve les valeurs mais pas les commentaires. - -## Utilisation : la commande `rtg` - -Depuis le dossier du site (`Road-Trips`) : +Le dépôt et le site sont deux dossiers voisins. Un voyage est un dossier qui contient un `voyage.toml` (ou, à l'ancienne, un des sous-dossiers `photos`, `rushs` ou `routes`). Les voyages rangés à la racine du site forment la rubrique « Voyages » de la page d'accueil ; ceux rangés un niveau plus bas, dans un dossier de regroupement (ici `Balades`), forment une rubrique du nom de ce dossier. ``` -rtg migrer # une fois : écrit site.toml et un voyage.toml par voyage -rtg etat # avancement de chaque voyage -rtg generer Balades/Vexin-10-2026 # un voyage, puis l'accueil -rtg generer --sans-compression # tous les voyages, sans encoder de vidéo -rtg analyser Balades/Vexin-10-2026 # ce que RTG trouve dans les sources -rtg verifier # tout est-il installé ? -rtg interface # l'interface dans le navigateur -rtg mot-de-passe # mot de passe de l'interface (accès distant) -rtg interface --proxy --prefixe /admin # derrière le serveur web du site (bouton Connexion) +CLEROADTRIPS +|-RoadTripsGenerator ce dépôt +| |-rtg le logiciel (interface, pages, encodage…) +| |-exemples docker-compose, nginx, admin.sh +| |-Scripts anciens scripts +|-Road-Trips le site + |-site.toml réglages du site + |-Ete-2025 + | |-voyage.toml sources, infos et réglages du voyage + | |-voyage.md le récit + | |-routes une trace GPX par jour (écrite par RTG) + | |-photos, photos_web photos et versions allégées + | |-videos, apercus vidéos encodées et images d'aperçu + |-Balades + |-Aisne-06-2026 + |-... ``` -Les sources d'un voyage peuvent rester où elles sont, nommées n'importe comment : on les indique dans son `voyage.toml`. +Les sources (rushs, photos, traces d'origine) peuvent rester sur d'autres disques ; leurs chemins sont notés dans `voyage.toml`. + +## Administration depuis le site : mise en place + +Le bouton « Connexion » de l'accueil mène à l'interface, servie sous `/admin/` par le serveur web du site. Exemple avec le site servi par un conteneur nginx derrière Traefik, et l'interface lancée directement sur le Mac : + +``` +Traefik (HTTPS) → nginx (le site, dans Docker) → /admin/ → RTG sur le Mac (host.docker.internal:8765) +``` + +L'interface ne tourne qu'à la demande (`./admin.sh`, `./admin.sh stop`). Fermée, `/admin/` affiche « Administration fermée » et le site reste en ligne. Sur le Mac, elle voit tous les disques et encode à pleine vitesse. Son utilisation est décrite dans l'aide de l'interface. + +1. **Mot de passe**, une fois : `rtg mot-de-passe` (10 caractères au moins). +2. **`docker-compose.yml`** du site : le service nginx doit pouvoir joindre le Mac, avec `extra_hosts: ["host.docker.internal:host-gateway"]`. Voir [`exemples/docker-compose.yml`](exemples/docker-compose.yml). +3. **`nginx.conf`** : ajouter le bloc `/admin/` et la page « Administration fermée », voir [`exemples/nginx-admin.conf`](exemples/nginx-admin.conf). Le `^~` de `location ^~ /admin/` est nécessaire si `nginx.conf` contient déjà une règle pour les `.js`, `.css` ou images. +4. `docker compose up -d --remove-orphans`. +5. **`admin.sh`** : copier [`exemples/admin.sh`](exemples/admin.sh) à côté du `docker-compose.yml`, puis `chmod +x admin.sh` et `./admin.sh`. L'interface tourne en arrière-plan ; son journal est dans `rtg-admin.log`. +6. Dans l'interface, **Réglages → Administration depuis le site** : `/admin/`, puis « Refaire l'accueil » pour faire apparaître le bouton « Connexion ». + +Après une mise à jour de RTG : `./admin.sh stop`, puis `./admin.sh`. + +**Variantes** + +- **Interface dans un conteneur** : [`exemples/docker-compose-conteneur.yml`](exemples/docker-compose-conteneur.yml) et [`exemples/admin-docker.sh`](exemples/admin-docker.sh), avec le `Dockerfile` à la racine du dépôt. L'encodage y est plus lent : il n'a que les processeurs que Docker Desktop attribue, et pas l'encodeur matériel du Mac. Chaque disque des sources doit aussi être déclaré dans Docker Desktop (Réglages → Resources → File sharing). **Ne jamais déclarer `/Volumes` en entier** : avec le partage de la clé du site, Docker Desktop échoue (« mkdir /host_mnt/Volumes/…: file exists ») et nginx ne démarre plus. Le mot de passe se copie à côté du compose : `mkdir -p rtg-acces && cp ~/.config/rtg/acces.toml rtg-acces/`. +- **Traefik seul**, sans nginx : [`exemples/traefik-rtg-admin.yml`](exemples/traefik-rtg-admin.yml). +- **Autre machine du réseau** : `rtg interface --distant` (mot de passe obligatoire), de préférence en HTTPS (`--certificat`, `--cle`) ou par un tunnel SSH (`ssh -L 8765:127.0.0.1:8765 serveur`, puis l'adresse avec la clé affichée sur le serveur). + +Le dossier du site étant publié tel quel, les `.toml` (chemins de vos disques) sont lisibles en ligne si le serveur web ne les refuse pas : la règle `location ~ \.toml$ { deny all; }` de l'exemple nginx s'en charge (Apache : ` Require all denied `). + +## Commandes + +Tout ce que fait l'interface existe aussi dans le Terminal, depuis le dossier du site (`Road-Trips`) ou avec `--racine CHEMIN`. + +| Commande | Rôle | +| --- | --- | +| `rtg interface` | ouvrir l'interface dans le navigateur | +| `rtg generer [VOYAGE…]` | générer un, plusieurs ou tous les voyages, puis l'accueil | +| `rtg etat` | avancement de chaque voyage | +| `rtg analyser VOYAGE` | ce que RTG trouve dans les sources d'un voyage | +| `rtg compresser VOYAGE` | encoder les vidéos d'un voyage | +| `rtg accueil` | refaire l'accueil et la carte globale | +| `rtg migrer` | une fois : écrire `site.toml` et un `voyage.toml` par voyage d'après l'existant | +| `rtg verifier` | Python, exiftool et ffmpeg sont-ils bien installés ? | +| `rtg mot-de-passe` | définir le mot de passe de l'interface (`--tester`, `--supprimer`) | + +### Options utiles + +- `rtg generer --sans-compression` : sans encoder les vidéos. +- `rtg generer --force` : tout refaire, même ce qui est à jour. +- `rtg generer --mymaps-maj` : récupérer à nouveau les cartes Google My Maps. +- `rtg compresser VOYAGE --reglages-changes` : réencoder aussi les vidéos faites avec d'autres réglages que les actuels. +- `rtg compresser VOYAGE --seulement 1080p` (ou `720p`) : ne traiter qu'une version. +- `rtg compresser VOYAGE --force` : tout réencoder. +- `rtg interface --port 8765 --sans-navigateur` : autre port, sans ouvrir le navigateur. +- `rtg interface --proxy --prefixe /admin` : derrière le serveur web du site (mot de passe obligatoire). +- `rtg interface --arret-inactif 120` : s'arrêter après 120 minutes sans activité. +- `rtg interface --distant [--certificat cert.pem --cle cle.pem]` : accepter les connexions du réseau, mot de passe obligatoire, HTTPS conseillé. + +Exemple : `rtg compresser Balades/Aisne-06-2026 --reglages-changes --seulement 1080p`. + +## Fichiers de réglages + +Tout ce que fait l'interface est noté dans deux fichiers texte au format TOML. On peut aussi les modifier à la main ; une réécriture par l'interface garde les valeurs mais pas les commentaires. + +### site.toml (racine du site) ```toml -titre = "Balade dans le Vexin" +titre = "Nos Road-Trips" +adresse_publique = "https://roadtrips.ouaibe.fr/" +accueil_nb_recents = 2 + +[video] +qualite = "equilibree" # econome | equilibree | haute +encodeur = "processeur" # processeur | materiel +preset = "medium" +jobs = 0 # 0 = automatique + +[photos] +grand_cote = 1600 +qualite = 80 +positions_deduites = true + +[journees] +fuseau = "Europe/Paris" +coupure_heure = 4 + +[carte_globale] +mymaps = ["https://www.google.com/maps/d/…"] + +[administration] +adresse = "/admin/" # bouton Connexion sur l'accueil + +[confidentialite] +zones = [[48.80, 2.10, 500]] # zones privées : latitude, longitude, rayon en m +``` + +### voyage.toml (un par voyage) + +```toml +titre = "Été 2026" moto = "BMW R 1300 GS Adventure" [sources] -traces = ["/Volumes/GPS/2026/vexin.gpx"] -videos = ["/Volumes/LaCie/Perso/Gopro/Gopro-2026/Vexin"] -photos = ["~/Pictures/Export/Vexin"] +traces = ["routes"] +videos = ["/Volumes/LaCie/Perso/Gopro/Gopro-2026/Ete-2026"] +photos = ["photos"] + +[video] # réglages vidéo propres au voyage (facultatif) +qualite = "econome" +preset = "slow" +crf_hevc = 28 +crf_h264 = 27 + +[dates_traces] # jours imposés aux traces +"Etape 3.gpx" = "2026-08-03" + +[positions] # médias placés à la main +"IMG_4831.jpeg" = [48.85, 2.35] + +[corrections] +masques = [[48.85, 2.35, 300]] # zones retirées des traces de ce voyage ``` -RTG range alors lui-même les traces par journée (`routes/AAAA-MM-JJ.gpx`, d'après leurs horodatages, à défaut la date du nom de fichier, ou le jour choisi dans l'interface et noté dans `[dates_traces]`) et copie les photos dans `photos/` (les HEIC de l'iPhone sont converties en JPEG). Une photo sans GPS reçoit la position de la trace à son heure, quand la trace est horodatée. Les réglages communs (qualité vidéo, taille des photos, fuseau horaire, cartes My Maps…) sont dans `site.toml`. - -Les scripts de `Scripts/` restent disponibles pendant la transition ; ils produisent le même site. Ils demandent en plus d'installer à la main les modules Python : `pip3 install pandas folium gpxpy markdown2 numpy pillow`. - -## Mode d'emploi (anciens scripts) - -### Tout le site, ou quelques voyages - -Depuis le dossier du site : - -``` -cd Road-Trips -../RoadTripsGenerator/Scripts/genere_site.sh # tous les voyages -../RoadTripsGenerator/Scripts/genere_site.sh Balades/Vexin-10-2026 # un seul -SKIP_COMPRESS=1 ../RoadTripsGenerator/Scripts/genere_site.sh # sans réencoder les vidéos -``` - -Pour chaque voyage, `genere_site.sh` enchaîne les étapes ci-dessous, puis régénère la page d'accueil et la carte globale. Un voyage d'une seule journée (une balade, souvent) n'a pas de carte générale intermédiaire : sa page est directement la carte du jour, avec photos et vidéos. Chaque étape ne refait que ce qui a changé : relancer le script est rapide, sauf quand de nouveaux rushs sont à encoder. - -### Étape par étape - -Depuis le dossier d'un voyage (ici `Road-Trips/Balades/Vexin-10-2026`, d'où les `../../../`) : - -| Commande | Rôle | Produit | -|---|---|---| -| `../../../RoadTripsGenerator/Scripts/extraction_infos.sh` | positions GPS des photos et vidéos | `export_photos.csv`, `export_videos.csv` | -| `../../../RoadTripsGenerator/Scripts/compress.sh` | vidéos web (long) | `videos/` | -| `../../../RoadTripsGenerator/Scripts/prepare_web.py` | photos allégées, aperçus | `photos_web/`, `apercus/` | -| `../../../RoadTripsGenerator/Scripts/genere_carte.py` | pages du voyage | `index.html`, `mini.html`, `html/`, `assets/`, `.kml` | - -Puis, depuis le dossier du site, la page d'accueil : - -``` -../RoadTripsGenerator/Scripts/genere_index_general.py -``` - -Sans compression, il faut faire de `videos` un lien vers `rushs` : `ln -s rushs videos`. - -### Réglages utiles - -* `compress.sh` : `ENCODER=vt` (encodeur matériel du Mac, bien plus rapide, un peu moins bon à taille égale), `JOBS=N`, `CRF_HEVC`, `CRF_H264`, `FORCE=1` pour tout réencoder. Une vidéo déjà encodée mais illisible (encodage interrompu) est refaite automatiquement. -* `prepare_web.py` : `WEB_PX=1600` (taille des photos), `WEB_QUALITE=80`, `FORCE=1`. -* `bench_crf.sh` : mesure la qualité (VMAF ou SSIM) d'un extrait de rush à plusieurs CRF, pour choisir `CRF_HEVC` / `CRF_H264` sur ses propres images. - -### Carte globale de l'accueil - -Sous les rubriques, l'accueil affiche une grande carte (`carte_globale.html`, fond OpenStreetMap, sans Google) qui réunit le contenu récupéré de nos cartes Google My Maps et les voyages du site (rubrique « Voyages »), un calque et une couleur par voyage ; un clic sur une trace mène au voyage. Un fichier `moto.txt` (une ligne) dans un voyage ajoute la moto à son nom dans la légende, par exemple « Ete 2026 (BMW R 1300 GS Adventure) ». - -On peut y ajouter des cartes Google My Maps : mettre leurs liens, un par ligne, dans `mymaps.txt` à la racine du site (les cartes doivent être partagées en « Tous les utilisateurs disposant du lien »). Le KML de chaque carte est récupéré une seule fois dans `_mymaps/` ; ensuite la carte ne dépend plus de Google (`MYMAPS_MAJ=1` pour le reprendre après avoir modifié la carte Google). On peut aussi déposer à la main des exports `.kml` ou `.kmz` dans `_mymaps/`. Chaque calque My Maps devient un calque de la carte, avec ses couleurs d'origine. - -Chaque voyage produit aussi un `.kml` (tout le voyage en une seule trace, avec sa distance et un lien vers sa page, sous les 5 Mo acceptés par My Maps), pour qui voudrait l'importer dans une carte My Maps. Régler l'adresse publique du site avec `SITE_URL` (par défaut `https://roadtrip.ouaibe.fr/`) pour des liens corrects. - -### Modifier l'apparence - -Toute la mise en page est dans `Scripts/templates/` : - -* `carte.css`, `carte.js` : style et comportement des pages de voyage (copiés dans `assets/` de chaque voyage à la génération) ; -* `fragments.html` : les morceaux de HTML (popups photo et vidéo, journal, boutons, barre des jours) ; -* `fragments_globale.html` : les popups et la légende de la carte globale ; -* `base_accueil.html`, `accueil.html`, `liste.html` : la page d'accueil (rubriques Voyages et Balades, les 2 plus récents de chacune) et les listes complètes `voyages.html`, `balades.html`. - -Après une modification, `SKIP_COMPRESS=1 ../RoadTripsGenerator/Scripts/genere_site.sh` régénère tout en quelques dizaines de secondes. +Un chemin relatif (comme `routes`) part du dossier du voyage. ## Publier -Il suffit de copier le dossier du site. Les sous-dossiers `rushs` (originaux, très lourds) et les fichiers `export_*.csv` sont inutiles en ligne ; `photos` reste nécessaire pour l'ouverture des originaux. +Le site est statique. Servi directement depuis son dossier (comme ici par nginx), il est en ligne dès la génération terminée. Sinon, il suffit de le copier : les sous-dossiers `rushs` (originaux, très lourds) et les fichiers `export_*.csv` sont inutiles en ligne ; `photos` reste nécessaire pour l'ouverture des originaux. + +## Anciens scripts + +Les scripts de `Scripts/` (`genere_site.sh`, `compress.sh`, `prepare_web.py`…) produisent le même site que RTG ; ils restent disponibles pendant la transition. Ils demandent d'installer à la main les modules Python : `pip3 install pandas folium gpxpy markdown2 numpy pillow`. `bench_crf.sh` mesure la qualité (VMAF ou SSIM) d'un extrait de rush à plusieurs CRF, pour choisir les réglages sur ses propres images. + +La mise en page de RTG est dans `rtg/templates/` (pages des voyages, accueil, carte globale) et `rtg/interface/` (interface). ## Contribuer diff --git a/exemples/admin-docker.sh b/exemples/admin-docker.sh new file mode 100644 index 0000000..cc15502 --- /dev/null +++ b/exemples/admin-docker.sh @@ -0,0 +1,41 @@ +#!/bin/sh +# Variante : ouvre ou ferme l'administration RTG dans un conteneur « rtg » +# (docker-compose-conteneur.yml). +# ./admin-docker.sh ouvrir (https://roadtrips.ouaibe.fr/admin/) +# ./admin-docker.sh stop fermer +# RTG_ARRET_INACTIF (minutes, dans le compose) : fermeture automatique sans activité ; 0 = jamais. +# À placer à côté du docker-compose.yml du site. + +# Disques ou dossiers des sources (rushs, photos, traces), vus en lecture seule +# aux mêmes chemins que sur le Mac. Chacun doit être déclaré dans Docker Desktop +# (Réglages → Resources → File sharing). Ceux qui sont débranchés sont ignorés. +# Avant d'éjecter l'un de ces disques : ./admin-docker.sh stop (un disque retiré sous un +# conteneur qui l'utilise peut dérégler Docker Desktop). Rebranché : ./admin-docker.sh. +SOURCES="/Volumes/LaCie /Volumes/EXTFAT" + +cd "$(dirname "$0")" || exit 1 + +if [ "$1" = "stop" ]; then + docker compose stop rtg && echo "Administration fermée." + exit +fi + +# Montages du jour : seulement les sources branchées, sinon Docker refuse de démarrer. +MONTAGES="" +for s in $SOURCES; do + if [ -d "$s" ]; then + MONTAGES="$MONTAGES - $s:$s:ro +" + echo "Source : $s (lecture seule)" + else + echo "Source débranchée, ignorée : $s" + fi +done +FICHIERS="-f docker-compose.yml" +if [ -n "$MONTAGES" ]; then + printf '# Écrit par admin.sh à chaque ouverture.\nservices:\n rtg:\n volumes:\n%s' "$MONTAGES" > rtg-sources.yml + FICHIERS="$FICHIERS -f rtg-sources.yml" +fi + +docker compose $FICHIERS up -d --force-recreate rtg \ + && echo "Administration ouverte : https://roadtrips.ouaibe.fr/admin/ (./admin-docker.sh stop pour la fermer)" diff --git a/exemples/admin.sh b/exemples/admin.sh old mode 100755 new mode 100644 index 48ffa5d..a929b0b --- a/exemples/admin.sh +++ b/exemples/admin.sh @@ -1,16 +1,47 @@ #!/bin/sh -# Ouvre ou ferme l'administration RTG du site. -# ./admin.sh ouvrir +# Ouvre ou ferme l'administration RTG du site, lancée directement sur le Mac. +# ./admin.sh ouvrir (https://roadtrips.ouaibe.fr/admin/) # ./admin.sh stop fermer -# À placer à côté du docker-compose.yml du site. +# Option --arret-inactif MINUTES : fermeture automatique sans activité. +# Le nginx du site la joint par host.docker.internal:8765 (exemples/nginx-admin.conf). +# Journal : rtg-admin.log, à côté de ce script. +RACINE=/Volumes/CLEROADTRIPS/Road-Trips +RTG="" # chemin de la commande rtg si elle n'est pas trouvée toute seule cd "$(dirname "$0")" || exit 1 +PID="$PWD/rtg-admin.pid" +JOURNAL="$PWD/rtg-admin.log" + +ouverte() { [ -f "$PID" ] && kill -0 "$(cat "$PID")" 2>/dev/null; } if [ "$1" = "stop" ]; then - docker compose stop rtg && echo "Administration fermée." + if ouverte; then kill "$(cat "$PID")" && echo "Administration fermée." + else echo "L'administration n'était pas ouverte."; fi + rm -f "$PID" exit fi -[ -d /Volumes/LaCie ] || echo "LaCie débranché : les rushs ne seront pas accessibles (pas d'encodage vidéo)." -# --force-recreate : le conteneur voit les disques branchés au moment de l'ouverture. -docker compose up -d --force-recreate rtg \ - && echo "Administration ouverte : https://roadtrips.ouaibe.fr/admin/ (se ferme seule après 2 h sans activité)" +if ouverte; then + echo "Déjà ouverte : https://roadtrips.ouaibe.fr/admin/" + exit +fi +# rtg : celui du chemin des commandes, sinon l'emplacement habituel de pipx. +[ -n "$RTG" ] || RTG=$(command -v rtg 2>/dev/null) +for c in "$HOME/.local/bin/rtg" /opt/homebrew/bin/rtg /usr/local/bin/rtg; do + [ -n "$RTG" ] && break + [ -x "$c" ] && RTG="$c" +done +[ -n "$RTG" ] || { echo "❌ Commande rtg introuvable : tapez « type rtg » dans le Terminal et mettez son chemin dans RTG= en haut de ce script."; exit 1; } +nohup "$RTG" --racine "$RACINE" interface --proxy --prefixe /admin > "$JOURNAL" 2>&1 & +echo $! > "$PID" +# Attendre qu'elle réponde (quelques secondes au premier lancement). +i=0 +while [ $i -lt 15 ] && ouverte && ! curl -s -o /dev/null http://127.0.0.1:8765/admin/connexion; do + sleep 1; i=$((i + 1)) +done +if ouverte; then + echo "Administration ouverte : https://roadtrips.ouaibe.fr/admin/ (journal : $JOURNAL)" +else + echo "❌ L'administration n'a pas démarré :" + tail -5 "$JOURNAL" + rm -f "$PID" +fi diff --git a/exemples/docker-compose-conteneur.yml b/exemples/docker-compose-conteneur.yml new file mode 100644 index 0000000..b03afb7 --- /dev/null +++ b/exemples/docker-compose-conteneur.yml @@ -0,0 +1,39 @@ +# Variante : l'administration RTG dans son propre conteneur (admin-docker.sh). +# Plus lente pour encoder (processeurs limités par Docker Desktop, pas d'encodeur +# matériel), et chaque disque des sources doit être partagé dans Docker Desktop. +# Ouvrir : ./admin-docker.sh ; fermer : ./admin-docker.sh stop. +# Après une mise à jour de RTG : docker compose build rtg +services: + roadtrip: + image: nginx:alpine + restart: unless-stopped + networks: + - ouaibe_network + volumes: + - /Volumes/CLEROADTRIPS/Road-Trips:/usr/share/nginx/html:ro + - ./nginx.conf:/etc/nginx/nginx.conf:ro + labels: + - traefik.enable=true + - traefik.docker.network=ouaibe_network + - traefik.http.routers.ouaibe_roadtrip.rule=Host(`roadtrip.ouaibe.fr`) || Host(`roadtrips.ouaibe.fr`) + - traefik.http.routers.ouaibe_roadtrip.entrypoints=websecure + + # Ne démarre pas avec le reste (profil « admin »). Fermeture automatique + # possible : environment: [RTG_ARRET_INACTIF=120] (minutes ; 0 = jamais, défaut). + rtg: + build: /Volumes/CLEROADTRIPS/RoadTripsGenerator + profiles: ["admin"] + restart: "no" + networks: + - ouaibe_network + volumes: + # Le site, en lecture et écriture, au même chemin que sur le Mac + # (même partage Docker Desktop que pour nginx). + - /Volumes/CLEROADTRIPS/Road-Trips:/Volumes/CLEROADTRIPS/Road-Trips + # Le mot de passe : mkdir -p rtg-acces && cp ~/.config/rtg/acces.toml rtg-acces/ + - ./rtg-acces:/config/rtg:ro + # Les sources (LaCie…) sont ajoutées par admin.sh, en lecture seule. + +networks: + ouaibe_network: + external: true diff --git a/exemples/docker-compose.yml b/exemples/docker-compose.yml index ece08d1..680454e 100644 --- a/exemples/docker-compose.yml +++ b/exemples/docker-compose.yml @@ -1,9 +1,13 @@ -# docker-compose.yml du site, avec l'administration RTG dans son propre conteneur. -# Après une mise à jour de RTG : docker compose build rtg +# docker-compose.yml du site. L'administration RTG n'y figure pas : admin.sh la +# lance directement sur le Mac, à la demande (vitesse maximale, tous les disques +# visibles sans réglage) ; nginx la joint par host.docker.internal. +# Variante avec l'administration en conteneur : docker-compose-conteneur.yml. services: roadtrip: image: nginx:alpine restart: unless-stopped + extra_hosts: + - "host.docker.internal:host-gateway" networks: - ouaibe_network volumes: @@ -15,26 +19,6 @@ services: - traefik.http.routers.ouaibe_roadtrip.rule=Host(`roadtrip.ouaibe.fr`) || Host(`roadtrips.ouaibe.fr`) - traefik.http.routers.ouaibe_roadtrip.entrypoints=websecure - # Administration à la demande : elle ne démarre pas avec le reste. - # ouvrir : ./admin.sh fermer : ./admin.sh stop - # Mot de passe, une fois : mkdir -p rtg-acces && cp ~/.config/rtg/acces.toml rtg-acces/ - # Elle se ferme d'elle-même après 2 h sans activité (RTG_ARRET_INACTIF, en minutes). - rtg: - build: /Volumes/CLEROADTRIPS/RoadTripsGenerator - profiles: ["admin"] - restart: "no" - networks: - - ouaibe_network - # Disques du Mac aux mêmes chemins que sur le Mac (les sources notées dans - # les voyage.toml restent valables), tous en lecture seule sauf le site. - # Docker Desktop doit partager /Volumes (Réglages → Resources → File sharing). - volumes: - - /Volumes:/Volumes:ro # tous les disques, lecture seule - - /Volumes/CLEROADTRIPS/Road-Trips:/Volumes/CLEROADTRIPS/Road-Trips # le site, lecture et écriture - - type: tmpfs # MACHD masqué : vide dans le conteneur - target: /Volumes/MACHD - - ./rtg-acces:/config/rtg:ro # mot de passe (copie de acces.toml) - networks: ouaibe_network: external: true diff --git a/exemples/nginx-admin.conf b/exemples/nginx-admin.conf index 7e13b4e..da97dfa 100644 --- a/exemples/nginx-admin.conf +++ b/exemples/nginx-admin.conf @@ -1,16 +1,15 @@ # Bloc à ajouter dans nginx.conf, à l'intérieur de « server { … } », quand le # site est servi par un conteneur nginx derrière Traefik (Traefik → nginx → RTG). +# Si RTG ne tourne pas, /admin/ affiche « Administration fermée ». # « ^~ » : sinon une règle du type « location ~* \.(js|css|png)$ » déjà # présente dans nginx.conf prendrait les fichiers de l'interface pour ceux du site. location ^~ /admin/ { - # RTG dans le conteneur « rtg » (exemples/docker-compose.yml). Passer par - # une variable laisse nginx démarrer même si ce conteneur est arrêté. - resolver 127.0.0.11 valid=30s; - set $rtg http://rtg:8765; - proxy_pass $rtg; - # RTG lancé à la main sur le Mac à la place : remplacer les trois lignes - # ci-dessus par « proxy_pass http://host.docker.internal:8765; ». + # RTG lancé sur le Mac par admin.sh (extra_hosts + # « host.docker.internal:host-gateway » dans le compose). + proxy_pass http://host.docker.internal:8765; + # Variante, RTG dans un conteneur « rtg » (docker-compose-conteneur.yml) : + # resolver 127.0.0.11 valid=30s; set $rtg http://rtg:8765; proxy_pass $rtg; proxy_set_header Host $host; # Traefik a déjà noté l'adresse du visiteur et le https : on les transmet tels quels. @@ -18,7 +17,7 @@ proxy_set_header X-Forwarded-Proto $http_x_forwarded_proto; proxy_buffering off; proxy_read_timeout 300s; - # Conteneur RTG arrêté : une page claire plutôt qu'une erreur 502. + # Administration fermée : une page claire plutôt qu'une erreur 502. error_page 502 504 = @admin_fermee; } diff --git a/pyproject.toml b/pyproject.toml index b71849c..a147a9a 100644 --- a/pyproject.toml +++ b/pyproject.toml @@ -34,4 +34,4 @@ packages = ["rtg", "rtg.interface"] [tool.setuptools.package-data] rtg = ["templates/*"] -"rtg.interface" = ["modeles/*", "static/*", "static/images/*"] +"rtg.interface" = ["modeles/*", "static/*", "static/images/*", "aide/*"] diff --git a/rtg/cli.py b/rtg/cli.py index e6ea0cc..cc8f3a7 100644 --- a/rtg/cli.py +++ b/rtg/cli.py @@ -39,7 +39,11 @@ def main(argv=None): c = sp.add_parser("compresser", help="encoder les vidéos d'un voyage") c.add_argument("voyage") - c.add_argument("--force", action="store_true") + c.add_argument("--force", action="store_true", help="refaire même les vidéos déjà encodées") + c.add_argument("--seulement", choices=["1080p", "720p"], + help="ne (re)faire qu'une des deux versions") + c.add_argument("--reglages-changes", action="store_true", + help="réencoder aussi les vidéos faites avec d'autres réglages que les actuels") ac = sp.add_parser("accueil", help="régénérer l'accueil et la carte globale") ac.add_argument("--mymaps-maj", action="store_true") @@ -110,7 +114,10 @@ def main(argv=None): elif args.commande == "compresser": v = os.path.abspath(args.voyage) cfg = reglages_voyage(v, reglages_site(racine)) - sys.exit(0 if video.compresser(v, cfg, sources.analyser(v, cfg), force=args.force) else 1) + paliers = {"1080p": ("hd",), "720p": ("sd",)}.get(args.seulement, ("hd", "sd")) + refaire = "differentes" if args.reglages_changes else "manquantes" + sys.exit(0 if video.compresser(v, cfg, sources.analyser(v, cfg), force=args.force, + paliers=paliers, refaire=refaire) else 1) elif args.commande == "accueil": accueil.generer(racine, reglages_site(racine), args.mymaps_maj) elif args.commande == "migrer": diff --git a/rtg/config.py b/rtg/config.py index a79536f..12b482f 100644 --- a/rtg/config.py +++ b/rtg/config.py @@ -120,6 +120,8 @@ def parametres_video(cfg): """Paramètres d'encodage effectifs (dictionnaire plat).""" v = cfg["video"] q = QUALITES.get(v.get("qualite", "equilibree"), QUALITES["equilibree"]) + # crf_hevc / crf_h264 dans [video] l'emportent sur la qualité choisie (essais). + q = dict(q, **{k: int(v[k]) for k in ("crf_hevc", "crf_h264") if k in v}) return dict(q, encodeur="vt" if v.get("encodeur") == "materiel" else "cpu", preset=v.get("preset", "medium"), fps_max=int(v.get("fps_max", 60)), jobs=int(v.get("jobs", 0)), threads=int(v.get("threads", 0))) diff --git a/rtg/interface/aide/acces.md b/rtg/interface/aide/acces.md new file mode 100644 index 0000000..b30ea89 --- /dev/null +++ b/rtg/interface/aide/acces.md @@ -0,0 +1,22 @@ +# Accès et sécurité + +L'interface permet de modifier le site et de parcourir les disques : elle est protégée. + +## Deux façons d'entrer + +- **La clé d'accès** : à chaque lancement de l'interface, une clé tirée au hasard est ajoutée à l'adresse ouverte dans le navigateur (`…/?jeton=…`) et affichée dans le Terminal ou le journal. Seul celui qui la voit peut entrer. Elle change à chaque lancement. +- **Le mot de passe** : défini dans le Terminal avec `rtg mot-de-passe` (10 caractères au moins). Indispensable depuis une autre machine ou depuis le site. `rtg mot-de-passe --tester` vérifie un mot de passe ; `--supprimer` l'efface. + +Le mot de passe n'est enregistré nulle part en clair : seule une empreinte est gardée, hors du site, dans `~/.config/rtg/acces.toml`. + +## Session + +Une fois entré, le navigateur garde une session de 12 heures après la dernière action. Elle est perdue quand l'interface s'arrête. **Se déconnecter** la ferme tout de suite. + +## Protections + +- Après 5 mots de passe faux, l'adresse IP doit attendre une minute, puis deux, quatre… jusqu'à une heure. +- Le cookie de session n'est lisible que par l'interface, et n'est envoyé qu'en HTTPS quand le site l'est. +- Une autre page ouverte dans le navigateur ne peut rien modifier, et l'interface refuse d'être affichée dans un cadre. + +Pour l'accès depuis le site, voir [Administration depuis le site](administration.md). diff --git a/rtg/interface/aide/administration.md b/rtg/interface/aide/administration.md new file mode 100644 index 0000000..83a253c --- /dev/null +++ b/rtg/interface/aide/administration.md @@ -0,0 +1,41 @@ +# Administration depuis le site + +Le bouton **Connexion** de l'accueil mène à `https://roadtrips.ouaibe.fr/admin/`. Le serveur web y fait suivre les demandes vers l'interface RTG, qui tourne directement sur le Mac : + +``` +Traefik (HTTPS) → nginx (le site, dans Docker) → /admin/ → RTG sur le Mac +``` + +L'interface ne tourne que quand on en a besoin. Fermée, `/admin/` affiche « Administration fermée » et le site reste en ligne. + +## Au quotidien + +Dans le dossier du `docker-compose.yml` du site : + +``` +./admin.sh ouvrir l'administration +./admin.sh stop la fermer +``` + +Elle tourne en arrière-plan : inutile de garder le Terminal ouvert. Son journal est dans `rtg-admin.log`, à côté du script. Fermer pendant un encodage l'arrête proprement ; les vidéos finies sont gardées. + +À la maison, devant le Mac, on peut aussi simplement taper `rtg interface` dans le Terminal : ce sont les mêmes écrans, sans passer par le site. + +## Disques et vitesse + +L'interface tourne sur le Mac : elle voit tous les disques branchés, comme n'importe quelle application, et encode à pleine vitesse (tous les cœurs performance, encodeur matériel possible dans les [Réglages du site](reglages.md)). + +Un disque des sources débranché est signalé dans [Sources](sources.md) ; les vidéos déjà encodées restent en ligne. + +## Avant d'éjecter un disque + +- **Disque de sources** : attendre la fin de l'encodage en cours, ou fermer l'administration. +- **Clé du site** : nginx s'en sert en permanence ; `docker compose stop` d'abord, `docker compose up -d` une fois rebranchée. + +## Après une mise à jour de RTG + +`./admin.sh stop`, puis `./admin.sh`. + +## Mise en place + +L'installation (nginx, mot de passe, `admin.sh`) est décrite dans le README de RoadTripsGenerator, sur git, section « Administration depuis le site : mise en place ». diff --git a/rtg/interface/aide/carte.md b/rtg/interface/aide/carte.md new file mode 100644 index 0000000..fa39428 --- /dev/null +++ b/rtg/interface/aide/carte.md @@ -0,0 +1,22 @@ +# Carte et corrections + +Corriger à la souris ce que les fichiers d'origine ont de faux. Les corrections sont enregistrées aussitôt dans `voyage.toml` (ou `site.toml` pour une zone privée) et appliquées **à la prochaine génération** ; les fichiers d'origine ne changent pas. + +## Photos et vidéos + +- **Déplacer** : glisser le marqueur (rouge pour une photo, bleu pour une vidéo). Un marqueur cerclé d'orange a une position corrigée à la main ; sa bulle propose de revenir à la position d'origine. +- **Placer un média sans position** : cliquer son nom dans « Médias sans position », puis cliquer sur la carte. Échap annule. +- Le sélecteur **Jour** et les cases **Photos** / **Vidéos** filtrent l'affichage. Le fond **Satellite** (bouton des calques) aide à placer précisément. + +## Zones masquées + +Les points de trace situés dans une zone sont retirés des pages : autour de chez soi, ou sur une erreur du GPS. + +1. **+ Masquer une zone**, puis cliquer au centre ; un nouveau clic déplace la zone. +2. Régler le **rayon**. +3. Cocher **Zone privée** pour la retirer de **tous les voyages** (elle est alors notée dans `site.toml`). +4. **Enregistrer la zone**. + +Une zone se supprime depuis la liste, bouton **Supprimer**. + +Après des corrections, régénérer le voyage ([Générer](generer.md)) ; pour une zone privée, régénérer les voyages concernés. diff --git a/rtg/interface/aide/generer.md b/rtg/interface/aide/generer.md new file mode 100644 index 0000000..3187e12 --- /dev/null +++ b/rtg/interface/aide/generer.md @@ -0,0 +1,49 @@ +# Générer + +Fabrique tout ce que le site affiche pour ce voyage, puis refait l'accueil. + +## Les étapes + +1. **Sources** : les traces sont réparties par jour, les photos copiées. +2. **Positions** : dates et positions GPS des photos et des vidéos (exiftool). +3. **Vidéos** : encodage des rushs. +4. **Photos** : versions allégées pour le web, et une image d'aperçu par vidéo. +5. **Pages** : cartes du voyage et de chaque jour. +6. **Accueil** : page d'accueil, rubriques, carte globale. + +Ce qui est déjà à jour n'est pas refait. Le journal s'affiche en dessous. **Arrêter** interrompt proprement : les vidéos finies sont gardées. + +## Compression des vidéos + +Chaque rush donne deux vidéos : + +- **1080p en HEVC (H.265)**, environ 40 % plus léger que du H.264 à qualité égale ; +- **720p en H.264**, chargée par défaut et lisible partout. + +Le tableau **Compression des vidéos** montre, pour chaque version : + +- **Vidéos actuelles** : les réglages relus dans les fichiers eux-mêmes (les encodeurs x265 et x264 y inscrivent leurs réglages, par exemple « HEVC CRF 26 »). **conforme** ou **différent** les compare aux prochains encodages. Pour un voyage de plus de 40 vidéos, un échantillon est lu. +- **Prochains encodages** : ce que donneraient les réglages actuels. + +Le **CRF** règle la qualité : plus il est élevé, plus les fichiers sont légers et moins la qualité est bonne. Les qualités du site correspondent à : Économe 28 / 27, Équilibrée 26 / 25, Haute 23 / 22 (1080p / 720p). + +## Réglages vidéo propres à ce voyage + +Pour tester une compression sur un seul voyage, sans toucher au reste du site : qualité, vitesse de l'encodeur (plus lent = un peu plus léger à qualité égale), ou un **CRF précis** pour le 1080p et le 720p. Laisser vide pour suivre les réglages du site. Ces réglages sont notés dans `voyage.toml`, table `[video]`. + +## Quelles vidéos encoder + +- **Seulement celles qui manquent** (par défaut). +- **Aussi celles faites avec d'autres réglages** : RTG relit les réglages de chaque vidéo et ne refait que celles qui diffèrent. Relancé avec les mêmes réglages, il ne refait rien. +- **Tout réencoder**. + +**Versions concernées** limite le travail au **1080p** ou au **720p** ; l'autre version est gardée telle quelle. Le journal affiche pour chaque vidéo la nouvelle taille et l'ancienne (« avant … »). + +**Ne pas toucher aux vidéos** saute l'encodage (utile quand le disque des rushs n'est pas branché). **Refaire aussi les photos web et les pages** les refait même si elles sont à jour. + +## Boutons + +- **Générer le voyage** : toutes les étapes. +- **Encoder les vidéos seulement** : l'étape Vidéos seule, avec les choix ci-dessus. + +Pour essayer un réglage sur Aisne, par exemple : réglages propres au voyage, puis « aussi celles faites avec d'autres réglages », « 1080p seulement » et « Encoder les vidéos seulement ». diff --git a/rtg/interface/aide/index.md b/rtg/interface/aide/index.md new file mode 100644 index 0000000..27b8093 --- /dev/null +++ b/rtg/interface/aide/index.md @@ -0,0 +1,25 @@ +# Prise en main + +RTG fabrique un site web de road-trips : pour chaque voyage, une carte par jour avec la trace GPS, les photos, les vidéos et le récit. Le site produit est statique : de simples fichiers, servis tels quels par le serveur web. + +## Les étapes, pour un nouveau voyage + +1. **Mes voyages → Nouveau voyage** : un titre, un nom de dossier, une rubrique. Voir [Mes voyages](voyages.md). +2. **Onglet Sources** : indiquer où sont les traces GPS, les vidéos et les photos d'origine. Elles restent où elles sont. Voir [Sources](sources.md). +3. **Onglet Journées** : vérifier les jours et rattacher à un jour les traces qui n'ont pas d'heures. Voir [Journées](journees.md). +4. **Onglet Générer** : lancer la génération, qui encode les vidéos, prépare les photos et fabrique les pages. Voir [Générer](generer.md). +5. **Onglets Infos et récit, Carte et corrections** : écrire le récit, corriger une photo mal placée, masquer une portion de trace, puis régénérer. Voir [Infos et récit](infos.md) et [Carte et corrections](carte.md). + +Les fichiers d'origine ne sont jamais modifiés. Tout ce que fait l'interface est noté dans deux fichiers texte, `site.toml` (réglages du site) et `voyage.toml` (un par voyage). L'installation, les commandes du Terminal et le détail de ces fichiers sont dans le README de RoadTripsGenerator, sur git. + +## Toutes les pages d'aide + +- [Mes voyages](voyages.md) — la liste, les pastilles, créer un voyage +- [Sources](sources.md) — où RTG trouve les fichiers d'origine +- [Journées](journees.md) — les jours du voyage, les traces sans heures +- [Carte et corrections](carte.md) — déplacer une photo, masquer une zone +- [Infos et récit](infos.md) — titre, moto, récit en Markdown +- [Générer](generer.md) — génération, compression des vidéos +- [Réglages du site](reglages.md) +- [Accès et sécurité](acces.md) — clé d'accès, mot de passe +- [Administration depuis le site](administration.md) — ouvrir, fermer, disques des sources diff --git a/rtg/interface/aide/infos.md b/rtg/interface/aide/infos.md new file mode 100644 index 0000000..5685da5 --- /dev/null +++ b/rtg/interface/aide/infos.md @@ -0,0 +1,27 @@ +# Infos et récit + +## Titre et moto + +- **Titre** : le nom du voyage sur l'accueil, dans les listes et dans la légende de la carte globale. +- **Moto** : facultative ; affichée dans la légende de la carte globale, par exemple « Ete 2026 (BMW R 1300 GS Adventure) ». + +La rubrique vient du dossier où le voyage est rangé (voir [Mes voyages](voyages.md)). + +## Récit + +Le récit est le fichier `voyage.md`, en Markdown, affiché dans un panneau à côté des cartes du voyage. + +Deux liens spéciaux, qui marchent aussi bien en local qu'en ligne : + +``` +[Carte du jour](jour:2026-08-01) +[Le col](media:photos/IMG_4831.jpeg) +[La descente](media:videos/GH011272.mp4) +``` + +- `jour:AAAA-MM-JJ` ouvre la carte de ce jour ; +- `media:…` ouvre un média du voyage (chemin depuis le dossier du voyage). + +Un lien vers un jour sans carte ou vers un média introuvable est signalé dans le journal de génération. + +Enregistrer, puis régénérer le voyage pour mettre le site à jour ([Générer](generer.md)). diff --git a/rtg/interface/aide/journees.md b/rtg/interface/aide/journees.md new file mode 100644 index 0000000..cbd15c9 --- /dev/null +++ b/rtg/interface/aide/journees.md @@ -0,0 +1,19 @@ +# Journées + +Les jours du voyage d'après les traces GPS, avec leurs kilomètres, et la carte des traces (une couleur par jour). + +## Traces à rattacher à un jour + +Une trace **sans heures** (un itinéraire préparé, par exemple) et sans date AAAA-MM-JJ dans son nom ne peut pas être placée seule. Elle apparaît en pointillé sur la carte, dans un encadré jaune. Pour chacune : + +- choisir la date puis **OK** ; +- ou accepter la **suggestion** (« Le 11 juin ? »). RTG propose le jour où des photos ou des vidéos ont été prises le long de la trace ; +- ou, pour plusieurs traces d'un coup, **Répartir** : un jour par trace, dans l'ordre des noms, à partir de la date choisie. + +## Imposer un jour + +Le détail « Les N fichiers de traces et leur jour » permet d'imposer un jour à n'importe quelle trace, même datée ; **Annuler** revient au jour déduit. Ce choix est noté dans `voyage.toml`, table `[dates_traces]`. + +Les jours se changent à minuit, sauf avant l'heure réglée dans [Réglages du site](reglages.md) (4 h par défaut) : une étape finie à 1 h du matin reste sur la veille. + +Les modifications sont prises en compte à la prochaine génération ([Générer](generer.md)). diff --git a/rtg/interface/aide/reglages.md b/rtg/interface/aide/reglages.md new file mode 100644 index 0000000..86bf769 --- /dev/null +++ b/rtg/interface/aide/reglages.md @@ -0,0 +1,38 @@ +# Réglages du site + +Ils valent pour tous les voyages et sont enregistrés dans `site.toml`. Un voyage peut avoir ses propres réglages vidéo (onglet [Générer](generer.md)). + +## Site + +- **Titre** : affiché en haut de l'accueil. +- **Adresse publique** : l'adresse du site en ligne (par exemple `https://roadtrips.ouaibe.fr/`), pour les liens des fichiers KML. +- **Voyages récents par rubrique** : combien l'accueil en montre avant le lien « Tout voir ». + +## Vidéos + +- **Qualité** : Économe, Équilibrée (le réglage d'origine) ou Haute. Voir les valeurs de CRF dans [Générer](generer.md). +- **Encodeur** : **processeur** (x265 et x264, meilleure qualité à taille égale) ou **matériel** (VideoToolbox du Mac : bien plus rapide, fichiers plus gros ; indisponible dans le conteneur Docker). +- **Vitesse** : `medium` par défaut ; plus lent = un peu plus léger à qualité égale, mais plus long. +- **Vidéos encodées en parallèle** : 0 = automatique selon le nombre de cœurs. + +## Photos + +- **Plus grand côté** (1600 px par défaut) et **qualité JPEG** (80) des versions web. Le clic sur une photo ouvre l'original. +- **Placer les photos sans GPS d'après l'heure et la trace** : à 5 minutes près, quand la trace a des heures. + +## Journées + +- **Fuseau horaire** du voyage (Europe/Paris par défaut). +- **Heure de changement de jour** (4 h) : une étape finie avant cette heure reste sur la veille. + +## Carte globale + +Liens de cartes Google My Maps à reprendre, un par ligne. Leurs tracés sont récupérés une fois et ajoutés à la carte de l'accueil, sur fond OpenStreetMap. + +## Administration depuis le site + +Adresse de l'interface (par exemple `/admin/`). Si elle est remplie, l'accueil affiche un bouton « Connexion » vers cette adresse, après « Refaire l'accueil ». Voir [Administration depuis le site](administration.md). + +## Système + +Vérifie que Python, exiftool et ffmpeg (avec libx265 et libx264) sont installés, et l'espace libre sur le disque du site. diff --git a/rtg/interface/aide/sources.md b/rtg/interface/aide/sources.md new file mode 100644 index 0000000..e6a8c25 --- /dev/null +++ b/rtg/interface/aide/sources.md @@ -0,0 +1,24 @@ +# Sources + +Où se trouvent les fichiers d'origine du voyage : traces GPS, vidéos (rushs) et photos. Ils peuvent être sur n'importe quel disque, nommés n'importe comment, et ne sont **jamais modifiés**. + +## Ajouter ou retirer une source + +- **Choisir un dossier…** ouvre un explorateur : naviguer, puis **Choisir ce dossier**. Le nombre de fichiers reconnus s'affiche en bas. +- Ou coller un chemin (dossier ou fichier) puis **Ajouter**. +- **Retirer** enlève la source de la liste, sans rien effacer. + +Un type de source peut en avoir plusieurs (par exemple deux dossiers de photos). + +## Ce que RTG en fait + +- **Traces GPS** : réparties par journée et recopiées dans `routes/AAAA-MM-JJ.gpx`. Le jour vient des heures de la trace, à défaut d'une date AAAA-MM-JJ dans le nom du fichier, à défaut du jour choisi dans [Journées](journees.md). +- **Photos** : copiées dans `photos/`. Les HEIC de l'iPhone sont converties en JPEG. +- **Vidéos** : lues directement pour l'encodage, sans copie. + +## Pastilles + +- **N fichiers** : la source est lue. +- **introuvable** ou **disque débranché ?** : le chemin n'existe pas, ou le disque n'est pas branché. Les vidéos déjà encodées restent en ligne ; seules les nouvelles attendent le disque. + +Dans la variante où l'administration tourne dans un conteneur Docker, seuls les disques déclarés dans `admin-docker.sh` sont visibles. diff --git a/rtg/interface/aide/voyages.md b/rtg/interface/aide/voyages.md new file mode 100644 index 0000000..0901a98 --- /dev/null +++ b/rtg/interface/aide/voyages.md @@ -0,0 +1,27 @@ +# Mes voyages + +La liste de tous les voyages du site, par rubrique, du plus récent au plus ancien. + +## Rubriques + +- Un voyage rangé **à la racine du site** fait partie de la rubrique **Voyages**. Ce sont aussi ceux de la carte globale de l'accueil. +- Un voyage rangé **dans un dossier** (par exemple `Balades/Aisne-06-2026`) fait partie d'une rubrique du nom de ce dossier. + +## Les colonnes + +| Colonne | Signification | +| --- | --- | +| Dates, Jours | d'après les traces GPS | +| Vidéos web | vidéos encodées / rushs trouvés. « sources absentes » : le disque des rushs n'est pas branché, les vidéos déjà encodées restent en ligne | +| Photos web | photos allégées pour le web / photos du voyage | +| Pages | **à jour**, **à refaire** (photos, vidéos ou récit plus récents que les pages) ou **jamais générées** | +| ⚠️ | points à vérifier (survoler pour les lire) : source introuvable, trace sans jour… | + +Un clic sur le titre ouvre le voyage ; **Voir ↗** ouvre sa page sur le site. + +## Boutons + +- **Nouveau voyage** : un titre (affiché sur le site), un nom de dossier (dans l'adresse des pages : sans espaces ni accents, par exemple `Ete-2027`), la moto (facultative) et la rubrique. RTG crée le dossier et son `voyage.toml` ; il reste à indiquer les [Sources](sources.md). +- **Refaire l'accueil** : régénère la page d'accueil, les pages des rubriques et la carte globale, sans toucher aux voyages. + +Le bandeau en haut à droite montre le traitement en cours ou le dernier terminé ; un clic ouvre son journal. diff --git a/rtg/interface/modeles/_aide.html b/rtg/interface/modeles/_aide.html new file mode 100644 index 0000000..f487b07 --- /dev/null +++ b/rtg/interface/modeles/_aide.html @@ -0,0 +1,2 @@ +
{{ contenu|safe }}
+

Ouvrir dans une page ↗ · Sommaire

diff --git a/rtg/interface/modeles/_compression.html b/rtg/interface/modeles/_compression.html new file mode 100644 index 0000000..af731f3 --- /dev/null +++ b/rtg/interface/modeles/_compression.html @@ -0,0 +1,55 @@ +
+

Compression des vidéos

+ + + + {% for version in ("1080p", "720p") %} + {% set b = bilan[version] %}{% set c = cibles[version] %} + + + + + + {% endfor %} + +
Vidéos actuellesProchains encodages
{{ version }} + {% if not b.total %}aucune + {% else %} + {% for reg, n in b.reglages.most_common() %} +
{{ reg[0] }}{% if reg[1] is not none %} CRF {{ reg[1]|crf }}{% else %} (réglages non inscrits : encodeur matériel ?){% endif %} + × {{ n }} + {% if reg == c %}conforme{% else %}différent{% endif %} +
+ {% endfor %} +
{{ b.total }} vidéo{{ 's' if b.total > 1 }}{% if b.lues < b.total %} · échantillon de {{ b.lues }}{% endif %}
+ {% endif %} + 		{{ c[0] }}{% if c[1] is not none %} CRF {{ c[1]|crf }}{% else %} (encodeur matériel){% endif %}
+

Qualité {{ noms_qualites.get(cfg.video.qualite, cfg.video.qualite) }}, vitesse {{ cfg.video.preset }}, + encodeur {{ "matériel" if p.encodeur == "vt" else "processeur" }} : + {{ "réglages propres à ce voyage" if propre else "réglages du site" }}. + Plus le CRF est élevé, plus les fichiers sont légers, et moins la qualité est bonne.

+ +
+ Réglages vidéo propres à ce voyage +
+ + + + + +

{{ message }}

+
+
+
diff --git a/rtg/interface/modeles/aide.html b/rtg/interface/modeles/aide.html new file mode 100644 index 0000000..e07fe9d --- /dev/null +++ b/rtg/interface/modeles/aide.html @@ -0,0 +1,15 @@ +{% extends "base.html" %} +{% block titre %}Aide{% endblock %} +{% block contenu %} +
+ +
{{ contenu|safe }}
+
+{% endblock %} diff --git a/rtg/interface/modeles/base.html b/rtg/interface/modeles/base.html index 4b3a3b6..b4387fe 100644 --- a/rtg/interface/modeles/base.html +++ b/rtg/interface/modeles/base.html @@ -15,6 +15,7 @@ Mes voyages Réglages Traitement + Aide Voir le site ↗
@@ -25,6 +26,10 @@
+
RoadTripsGenerator {{ version }} · {{ racine }}
{% block fin %}{% endblock %} diff --git a/rtg/interface/modeles/nouveau.html b/rtg/interface/modeles/nouveau.html index 169543c..ac5750e 100644 --- a/rtg/interface/modeles/nouveau.html +++ b/rtg/interface/modeles/nouveau.html @@ -1,7 +1,7 @@ {% extends "base.html" %} {% block titre %}Nouveau voyage{% endblock %} {% block contenu %} -

Nouveau voyage

+

Nouveau voyage

{% if erreur %}
{{ erreur }}
{% endif %}