Commit df9e9822 authored by Kourser's avatar Kourser
Browse files

docs: update wiki/Pages with all current features



Rewrite the user guide (inbox, search, tags/sort, sleep timer, chapters, notes &
share, OPML import/export, settings) and refresh the README/index feature lists,
ROADMAP (post-MVP done + next), CHANGELOG (chapters). Sync now documented under
Réglages. MkDocs site builds clean.

Co-Authored-By: default avatarClaude <claude@anthropic.com>
parent 0d3a0419
Loading
Loading
Loading
Loading
Loading
+1 −0
Original line number Diff line number Diff line
@@ -29,6 +29,7 @@ adopte le [versionnage sémantique](https://semver.org/lang/fr/).
- Tri et filtre par tag des abonnements ; tri des épisodes (récents/anciens).
- Notes d'épisode (liens cliquables) et partage d'un épisode.
- Réglages « À propos » : version et commit de l'application.
- Chapitres (Podcasting 2.0) : affichage du chapitre courant et navigation.

### À venir
- Validation sur appareil réel et contre un vrai serveur de synchronisation.
+7 −2
Original line number Diff line number Diff line
@@ -30,14 +30,19 @@ qui n'existe pas sur iOS.

- 📥 **Abonnement** à n'importe quel flux RSS par URL
- 🔎 **Découverte** via la recherche Apple Podcasts (iTunes Search)
- 📂 **Import OPML** (migration depuis une autre app)
- 📂 **Import et export OPML** (migration depuis/vers une autre app)
- 🆕 Écran **Nouveautés** (épisodes récents de tous les abonnements)
- 🔍 **Recherche** dans la bibliothèque et les épisodes
- 🗂️ **Tri/filtre & tags** des abonnements ; **favoris**, filtres et tri des épisodes
- ▶️ **Lecture en arrière-plan** + contrôles écran verrouillé (Now Playing, AirPods…)
-**Vitesse de lecture** réglable (0,8× à 2×)
-**Vitesse** réglable (0,8× à 2×), **minuteur de sommeil**, **chapitres** (navigation)
- 📝 **Notes d'épisode** avec liens cliquables, **partage** d'un épisode
- 📃 **File d'attente** réordonnable avec enchaînement automatique
- ⬇️ **Téléchargement hors-ligne** des épisodes
- ⏱️ **Reprise de lecture** (position mémorisée) + suivi lu / non lu
- 🔄 **Synchronisation** des abonnements et de la progression avec **Nextcloud**
  (app *GPodder Sync*) et **gpodder.net** — identifiants stockés dans le **Trousseau**
- 🧹 **Réinitialisation** de l'app ; version & commit dans les réglages

## Plateformes & prérequis

+16 −6
Original line number Diff line number Diff line
@@ -14,13 +14,23 @@ persistance GRDB/SQLite · iOS 18+.
| 7 | Sync | `SyncKit` : sync **abonnements** + **états de lecture** (position/lu) Nextcloud (GPodder Sync) + gpodder.net, identifiants Keychain | ✅ Fait |
| 8 | États de lecture | Persistance locale (position + lu/non-lu), reprise, marquage manuel, indicateurs UI | ✅ Fait |

## Suite (post-MVP)
## Réalisé (post-MVP)

- Validation sur **appareil réel** : audio/écran verrouillé, flux UI ; sync à
  valider contre un vrai serveur Nextcloud/gpodder.net (identifiants requis).
- Affiner la reprise/persistance (sauvegarde à la mise en arrière-plan,
  résolution de conflits de position plus fine).
- Nom & icône définitifs ; signature/compte développeur pour distribution.
- Minuteur de sommeil ; **chapitres** (Podcasting 2.0 : affichage + navigation).
- Favoris d'épisodes ; filtres (non lus / favoris / téléchargés) + tri des épisodes.
- Écran **Nouveautés** ; **recherche** bibliothèque + épisodes.
- Tri/filtre & **tags** des abonnements ; **export OPML**.
- Notes d'épisode (liens cliquables) ; **partage** d'un épisode.
- Réglages : réinitialisation de l'app ; **version & commit**.
- Multiplateforme natif iOS/iPadOS/macOS ; iconset complet.

## Suite envisagée

- **Téléchargement automatique** (règles wifi/charge, par podcast) + nettoyage du cache.
- **Transcriptions** (affichage / suivi) ; chapitres **embarqués** (ID3/MP4).
- **Widget**, **CarPlay**, statistiques d'écoute.
- Validation sur **appareil réel** ; sync contre un vrai serveur ; localisation multi-langue.
- Signature / compte développeur pour distribution App Store.

## Notes

+62 −28
Original line number Diff line number Diff line
# Guide utilisateur

## Ajouter un podcast
## Ajouter des podcasts

Touchez le bouton **+** (en haut), puis choisissez :
Touchez **+** (en haut), puis :

- **Rechercher un podcast** — tapez un nom, parcourez les résultats (annuaire
  Apple Podcasts), touchez **Ajouter**.
- **Ajouter par URL** — collez l'URL d'un flux RSS (p. ex.
  `https://exemple.com/feed.xml`).
- **Rechercher un podcast** — recherche dans l'annuaire Apple Podcasts ; touchez **Ajouter**.
- **Ajouter par URL** — collez l'URL d'un flux RSS (`https://exemple.com/feed.xml`).
- **Importer un fichier OPML** — pour migrer vos abonnements depuis une autre app.

Vos abonnements apparaissent dans la **Bibliothèque** (barre latérale sur iPad/Mac).

## Nouveautés

L'entrée **Nouveautés** liste les **épisodes récents de tous vos abonnements**, du plus
récent au plus ancien. Tirez vers le bas pour actualiser les flux.

## Bibliothèque (abonnements)

- **Tri** : bouton de tri (en haut) → *Récents* ou *Titre*.
- **Tags / dossiers** : ouvrez un podcast → bouton **Tags** pour lui attribuer des
  étiquettes (séparées par des virgules). Filtrez ensuite la bibliothèque par tag depuis
  le bouton de tri/filtre.
- **Recherche** : la barre de recherche filtre vos abonnements **et** cherche dans les
  épisodes (résultats affichés par sections).
- **Tirer pour actualiser** : récupère les nouveaux épisodes de tous les flux.

## Écouter un épisode

Ouvrez un podcast, puis touchez un épisode pour lancer la lecture. Un **mini-lecteur**
apparaît en bas :
Touchez un épisode pour lancer la lecture. Un **mini-lecteur** apparaît en bas ;
touchez-le pour ouvrir le **lecteur plein écran** :

- ⏯️ lecture / pause, ⏪ −15 s, ⏩ +30 s
- barre de progression
- menu **vitesse** (0,8× à 2×)
- ⏯️ lecture/pause, ⏪ −15 s, ⏩ +30 s ;
- **barre de position glissable** (sur le grand lecteur **et** le mini-lecteur) ;
- **vitesse** (0,8× à 2×) ;
- **minuteur de sommeil** (🌙) : 5 à 60 min, pause automatique à la fin ;
- **chapitres** : si l'épisode en fournit, le chapitre courant s'affiche ; touchez-le
  pour voir la liste et **sauter à un chapitre**.

La lecture continue **en arrière-plan** et s'affiche sur l'**écran verrouillé** /
le Centre de contrôle (titre, pochette, commandes). La **position est mémorisée** :
relancer un épisode reprend là où vous vous étiez arrêté.
La lecture continue **en arrière-plan** et sur l'**écran verrouillé** (titre, pochette,
commandes). La **position est mémorisée** : reprendre un épisode redémarre où vous
vous étiez arrêté.

## File d'attente

- **Ajouter à la file** : appui long (menu contextuel) sur un épisode → *Ajouter à la file*.
- Ouvrez **File d'attente** (barre latérale / haut de l'écran) pour **réordonner**
  (glisser) ou retirer des épisodes.
- À la fin d'un épisode, le suivant dans la file s'enchaîne automatiquement.
- **Ajouter à la file** : appui long sur un épisode → *Ajouter à la file*.
- **File d'attente** (barre latérale) : réordonner (glisser), retirer, vider.
- L'épisode suivant s'enchaîne automatiquement à la fin du précédent.

## Téléchargements (hors-ligne)

Touchez ⬇️ sur un épisode pour le télécharger ; une fois téléchargé (✓ vert), la lecture
se fait depuis le fichier local. Pour libérer de l'espace : appui long → *Supprimer le
téléchargement*.

## Notes & partage d'un épisode

Appui long sur un épisode → **Détails / Notes** : affiche la description complète avec
**liens cliquables**, un bouton **Lire**, et le **partage**. *Partager* est aussi
accessible directement depuis le menu contextuel.

## Favoris, lu/non lu, filtres

## Télécharger pour l'hors-ligne
- **Favori** (★) : appui long → *Ajouter aux favoris*.
- **Lu / non lu** : un épisode terminé est marqué *Lu* ; forcez l'état via le menu.
- **Filtrer les épisodes** d'un podcast : *Tous / Non lus / Favoris / Téléchargés* ;
  **tri** *Plus récents / Plus anciens*.

Touchez l'icône ⬇️ sur un épisode pour le télécharger. Une fois téléchargé (✓ vert),
la lecture se fait depuis le fichier local. Pour libérer de l'espace : menu contextuel
*Supprimer le téléchargement*.
## Synchronisation entre appareils

## Lu / non lu
Voir [Configurer la synchronisation](Synchronisation.md) : abonnements **et** progression
de lecture, via Nextcloud (app GPodder Sync) ou gpodder.net. Configuration dans
**Réglages**.

- Un épisode terminé est marqué **Lu** (titre grisé, ✓).
- Forcer l'état : menu contextuel → *Marquer comme lu / non lu*.
## Réglages

## Synchroniser entre appareils
L'écran **Réglages** (barre latérale) regroupe :

Voir [Configurer la synchronisation](Synchronisation.md) pour partager abonnements
et progression via Nextcloud ou gpodder.net.
- la **synchronisation** (fournisseur, serveur, identifiants — mot de passe dans le
  Trousseau) ;
- l'**export OPML** de vos abonnements ;
- la **réinitialisation de l'application** (efface toutes les données — irréversible) ;
- la rubrique **À propos** (version et commit).
+2 −2
Original line number Diff line number Diff line
@@ -4,8 +4,8 @@ Skingomz synchronise vos **abonnements** et votre **progression de lecture**
(position, lu/non lu) avec un serveur compatible *gpodder*. Deux fournisseurs sont
pris en charge.

Ouvrez **Synchronisation** (barre latérale), renseignez le service et vos identifiants,
puis touchez **Synchroniser maintenant**.
Ouvrez **Réglages** (barre latérale) → section **Synchronisation**, renseignez le service
et vos identifiants, puis touchez **Synchroniser maintenant**.

> 🔒 Le mot de passe est stocké dans le **Trousseau** (Keychain), jamais en clair.

Loading