feat: v1.1.0 — full metadata sync, MetadataMode, RemoteSyncFull, progress UI

- GetMetadataAsync uses Users/{userId}/Items/{itemId} for compatibility
- MetadataMode per connector: RemoteSync / RemoteSyncFull / LocalScraping
- RemoteSyncFull: bypasses NFO skip, rewrites all metadata on every sync
- NFO fallback removed: failed metadata fetches are retried on next sync
- LibraryOptions applied per mode (fetchers, savers, cache, chapters)
- SyncAll progress per library via client-side iteration
- syncSingleConnector animated progress bar with connector name
- CONFIGURATION.md updated: auth modes, metadata modes, troubleshooting
- ROADMAP.md: Phase 2a marked complete

Closes #11, #13

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

Author: CCoupel

docs/CONFIGURATION.md

@@ -48,23 +48,39 @@ Ce répertoire sera créé automatiquement par le plugin. Il doit être accessib
 
 ### Étape 3 : Ajouter un serveur source
 
-Cliquer **"Ajouter un serveur"** et remplir :
+Cliquer **"+ Add Connector"** et remplir :
 
 | Champ | Exemple | Description |
 |---|---|---|
 | Nom d'affichage | `Serveur B - Bureau` | Nom libre pour identifier la source |
 | Type de serveur | `Emby` | Emby / Jellyfin / Plex |
 | URL du serveur | `http://192.168.1.200:8096` ou `https://media.example.com/emby` | URL complète avec port **et chemin de base** Emby |
-| Clé API | `abc123def456...` | Clé API du serveur source |
+| Mode d'authentification | `User Credentials` | Voir section Authentication ci-dessous |
+| Mode de métadonnées | `Remote Sync` | Voir section Metadata Source ci-dessous |
 
 **Important — URL du serveur** : inclure le chemin de base si Emby est derrière un reverse proxy.
 Exemple : si Emby répond sur `https://media.example.com/emby/Items/...`, l'URL à configurer est `https://media.example.com/emby`.
 
-Cliquer **"Tester la connexion"** pour valider avant de sauvegarder.
+Cliquer **"Test Connection"** pour valider avant de sauvegarder.
+
+#### Authentification
+
+| Mode | Description |
+|---|---|
+| **API Key** | Accès admin complet, aucun suivi d'usage sur le serveur distant |
+| **User Credentials** | Le serveur distant voit les sessions de cet utilisateur, applique ses restrictions et enregistre l'historique de lecture |
+
+#### Metadata Source
+
+| Mode | Description |
+|---|---|
+| **Remote Sync** | Le plugin télécharge métadonnées et images depuis le serveur distant. Items avec `.nfo` existant ignorés (incrémental). |
+| **Remote Sync Full** | Identique à Remote Sync mais réécrit tous les `.nfo` et re-télécharge les images à chaque sync. |
+| **Local Scraping** | Seuls les `.strm` sont créés. Emby utilise ses propres scrapers (TMDB, TVDB, FanArt) pour enrichir la bibliothèque. Nécessite un accès internet. |
 
 ### Étape 4 : Sélectionner les bibliothèques à synchroniser
 
-Après un test de connexion réussi, la liste des bibliothèques disponibles sur le serveur source s'affiche. Cocher celles à inclure.
+Après un test de connexion réussi, la liste des bibliothèques disponibles s'affiche. Cocher celles à inclure — les dossiers virtuels Emby sont créés automatiquement.
 
 ### Étape 5 : Configurer la synchronisation automatique
 
@@ -75,17 +91,11 @@ Timeout proxy stream :          30 secondes
 
 ### Étape 6 : Lancer la première synchronisation
 
-Cliquer **"Synchroniser maintenant"** pour déclencher la première sync manuellement.
+Cliquer **"Synchronise Now"** pour déclencher la première sync manuellement. La barre de progression avance bibliothèque par bibliothèque.
 
-### Étape 7 : Ajouter la bibliothèque virtuelle dans Emby
+Les dossiers virtuels Emby sont créés automatiquement par le plugin — aucune configuration manuelle dans le Dashboard Emby n'est nécessaire.
 
-Après la sync :
-1. Dashboard → Bibliothèques → Ajouter une bibliothèque
-2. Type : Films (ou Séries selon le contenu)
-3. Dossier : `/media/virtual-libraries/Films_ServeurB`
-4. Valider
-
-Les médias du serveur B apparaissent maintenant dans l'interface d'Emby A.
+Les médias du serveur distant apparaissent dans l'interface d'Emby après le scan de bibliothèque déclenché automatiquement en fin de sync.
 
 ---
 
@@ -235,9 +245,15 @@ Normal : la terminaison TLS est faite par le reverse proxy (traefik). Le serveur
 
 ### La sync ne détecte pas les nouveaux ajouts
 
-- La sync delta compare les IDs distants avec l'index local (`.index/{connectorId}.json`)
-- Si l'index est corrompu, le supprimer pour forcer une re-sync complète
-- Vérifier l'intervalle de sync configuré
+- Les items ajoutés sur le serveur distant sont détectés automatiquement à la prochaine sync (aucun `.nfo` local → créé)
+- Vérifier l'intervalle de sync configuré (défaut : 6h)
+- Déclencher une sync manuelle depuis le dashboard plugin
+
+### Les métadonnées sont incomplètes ou manquantes
+
+- Vérifier que le mode **Remote Sync** ou **Remote Sync Full** est sélectionné (pas Local Scraping)
+- Si les métadonnées ne se mettent pas à jour malgré une sync : passer en mode **Remote Sync Full** pour forcer la réécriture des `.nfo`
+- Les items dont la récupération de métadonnées a échoué sont comptés "failed" et retentés à la prochaine sync
 
 ---
 

docs/ROADMAP.md

@@ -25,16 +25,26 @@
 
 ---
 
-## Phase 2a — Synchronisation des métadonnées *(en cours)*
+## Phase 2a — Synchronisation des métadonnées ✅ Terminé (v1.1.0)
 
 - [x] `SyncService` : orchestration sync par connector + bibliothèque
-- [x] Génération `.strm` + `.nfo` + téléchargement artwork
-- [x] Skip intelligent : toujours régénérer le `.strm` (cheap), ne sauter que si `.nfo` déjà présent
-- [ ] `LibrarySyncJob` : tâche planifiée (`IScheduledTask`) configurable
-- [ ] Détection delta : index JSON local `{connectorId}.json`
+- [x] Génération `.strm` + `.nfo` + téléchargement artwork (poster, fanart, landscape, logo)
+- [x] Métadonnées complètes : cast, directors, writers, tagline, trailer URL
+- [x] Skip intelligent : toujours régénérer le `.strm`, ne sauter le `.nfo` qu'en mode `RemoteSync`
+- [x] `MetadataMode` par connecteur : `RemoteSync` (incrémental) / `RemoteSyncFull` (force) / `LocalScraping`
+- [x] `LibraryOptions` Emby appliquées selon le mode (fetchers TMDB/TVDB/FanArt, cache, chapitres)
+- [x] `LibrarySyncJob` : tâche planifiée (`IScheduledTask`) avec intervalle configurable
+- [x] Mise à jour dynamique du trigger sans redémarrage
+- [x] `QueueLibraryScan()` déclenché si des items ont été créés
+- [x] Compteurs d'items distants par bibliothèque (endpoint `/item-counts`)
+- [x] Fix `Users/Me` 500 : `GetUserIdAsync` sans appel à `/Users/Me`
+- [x] Progression sync par librairie dans l'UI (itération client-side)
+
+**Reste en backlog :**
+- [ ] Détection delta : index JSON local `{connectorId}.json` (issue #12)
 - [ ] Gestion des suppressions (items supprimés sur la source)
-- [ ] Logs de sync dans le dashboard
-- [ ] Tests intégration sync job
+- [ ] Tests intégration sync job (issue #14)
+- [ ] Progression sync par item en temps réel (issue #20)
 
 ---
 

src/VirtualLib/Connectors/EmbyConnector.cs

@@ -287,7 +287,10 @@ public async Task<MediaMetadata> GetMetadataAsync(
         string itemId,
         CancellationToken cancellationToken = default)
     {
-        var url = $"Items/{itemId}?Fields=Overview,Genres,Studios,ProviderIds,People,Tags,RemoteTrailers,Taglines";
+        var userId = await GetUserIdAsync(cancellationToken);
+        var url = userId is not null
+            ? $"Users/{userId}/Items/{itemId}?Fields=Overview,Genres,Studios,ProviderIds,People,Tags,RemoteTrailers,Taglines"
+            : $"Items/{itemId}?Fields=Overview,Genres,Studios,ProviderIds,People,Tags,RemoteTrailers,Taglines";
         using var response = await GetWithRetryAsync(url, cancellationToken);
         response.EnsureSuccessStatusCode();
 

src/VirtualLib/Core/SyncService.cs

@@ -252,17 +252,18 @@ private async Task<LibrarySyncResult> SyncLibraryItemsAsync(
                     continue;
                 }
 
-                // RemoteSync: fetch metadata + write NFO + download artwork
+                // RemoteSync / RemoteSyncFull: fetch metadata + write NFO + download artwork
                 var nfoPath = Path.Combine(nfoDir, _strmGenerator.GetFileName(item) + ".nfo");
-                if (File.Exists(nfoPath)) { libSkipped++; continue; }
+                if (config.MetadataMode == MetadataMode.RemoteSync && File.Exists(nfoPath)) { libSkipped++; continue; }
 
                 MediaMetadata metadata;
                 try { metadata = await connector.GetMetadataAsync(item.RemoteId, ct); }
                 catch (OperationCanceledException) { throw; }
                 catch (Exception ex)
                 {
-                    _logger.LogWarning(ex, "Failed to get metadata for item {RemoteId}", item.RemoteId);
-                    metadata = BuildFallbackMetadata(item);
+                    _logger.LogWarning(ex, "Failed to get metadata for item {RemoteId} '{Title}' — will retry on next sync", item.RemoteId, item.Title);
+                    libFailed++;
+                    continue; // Don't write fallback NFO — let next sync retry
                 }
 
                 _nfoGenerator.Generate(metadata, nfoDir);
@@ -324,24 +325,4 @@ private async Task DownloadArtworkAsync(
         }
     }
 
-    private static MediaMetadata BuildFallbackMetadata(MediaItem item) =>
-        new()
-        {
-            RemoteId = item.RemoteId,
-            Title = item.Title,
-            Type = item.Type,
-            Year = item.Year,
-            SeriesId = item.SeriesId,
-            SeriesName = item.SeriesName,
-            SeasonNumber = item.SeasonNumber,
-            EpisodeNumber = item.EpisodeNumber,
-            ImdbId = item.ImdbId,
-            TmdbId = item.TmdbId,
-            TvdbId = item.TvdbId,
-            DateAdded = item.DateAdded,
-            AvailableArtwork = item.AvailableArtwork,
-            Genres = Array.Empty<string>(),
-            Studios = Array.Empty<string>(),
-            Tags = Array.Empty<string>()
-        };
 }

src/VirtualLib/PluginConfiguration.cs

@@ -6,10 +6,12 @@ public enum AuthMode { ApiKey, UserCredentials }
 
 public enum MetadataMode
 {
-    /// <summary>Plugin fetches metadata/images from the remote server and writes .nfo files.</summary>
+    /// <summary>Plugin fetches metadata/images from the remote server, skips items that already have a .nfo file.</summary>
     RemoteSync,
     /// <summary>Emby's own fetchers handle metadata/images from online databases (TMDB, TVDB…).</summary>
-    LocalScraping
+    LocalScraping,
+    /// <summary>Plugin fetches metadata/images from the remote server for all items, overwriting existing .nfo files.</summary>
+    RemoteSyncFull
 }
 
 public sealed class PluginConfiguration : BasePluginConfiguration

src/VirtualLib/Web_Pages/config.html

@@ -147,14 +147,16 @@ <h2 class="sectionTitle">VirtualLib</h2>
                 <div class="inputContainer" style="margin-top:1em">
                     <label class="inputLabel inputLabelUnfocused" for="connectorMetadataMode">Metadata Source</label>
                     <select id="connectorMetadataMode" is="emby-select" class="emby-select-withcolor emby-input">
-                        <option value="RemoteSync">Remote Sync — plugin fetches metadata &amp; images from the source server</option>
+                        <option value="RemoteSync">Remote Sync — plugin fetches metadata &amp; images (incremental)</option>
+                        <option value="RemoteSyncFull">Remote Sync Full — re-fetches all metadata &amp; images on every sync</option>
                         <option value="LocalScraping">Local Scraping — Emby fetches from TMDB/TVDB, writes NFO files locally</option>
                     </select>
                     <div class="fieldDescription">
-                        <strong>Remote Sync</strong>: actors, directors, posters and backdrops are downloaded from the remote server during sync.
-                        No internet access required from this server.<br/>
+                        <strong>Remote Sync</strong>: actors, directors, posters and backdrops are downloaded from the remote server.
+                        Items already having a .nfo are skipped (incremental).<br/>
+                        <strong>Remote Sync Full</strong>: same as Remote Sync but overwrites existing .nfo and re-downloads artwork on every sync.<br/>
                         <strong>Local Scraping</strong>: only .strm files are created; Emby uses its own scrapers (TMDB, TVDB, FanArt) to enrich
-                        the library. Requires internet access. Chapter images, video thumbnails and image pre-caching are enabled in both modes.
+                        the library. Requires internet access. Chapter images, video thumbnails and image pre-caching are enabled in all modes.
                     </div>
                 </div>
 

src/VirtualLib/Web_Pages/configjs.js

@@ -117,7 +117,7 @@ define([], function () {
                 btnSync.setAttribute('is', 'emby-button');
                 btnSync.className = 'emby-button';
                 btnSync.textContent = 'Sync All';
-                btnSync.addEventListener('click', (function (id) { return function () { syncSingleConnector(id); }; }(c.Id)));
+                btnSync.addEventListener('click', (function (id, name) { return function () { syncSingleConnector(id, name); }; }(c.Id, c.DisplayName)));
 
                 actionCell.appendChild(btnEdit);
                 actionCell.appendChild(btnDelete);
@@ -307,15 +307,28 @@ define([], function () {
             q('syncProgressBar').style.background = 'var(--theme-error-color, #e53935)';
         }
 
-        function syncSingleConnector(id) {
+        function syncSingleConnector(id, displayName) {
             startSyncUI();
-            q('syncProgressBar').style.width = '30%';
+            var bar = q('syncProgressBar');
+            var label = q('syncProgressLabel');
+            bar.style.width = '10%';
+            label.textContent = (displayName ? displayName + ' \u2014 ' : '') + 'Connecting\u2026';
+            // Animate bar while waiting (10% → 80% over ~2s)
+            var pct = 10;
+            var timer = setInterval(function () {
+                pct = Math.min(pct + 5, 80);
+                bar.style.width = pct + '%';
+            }, 400);
             apiPost('/virtuallib/connectors/' + encodeURIComponent(id) + '/sync')
                 .then(function (result) {
+                    clearInterval(timer);
                     finishSyncUI([result], 'Done.');
                     loadLibraryStats(id);
                 })
-                .catch(function (e) { errorSyncUI(e.message); });
+                .catch(function (e) {
+                    clearInterval(timer);
+                    errorSyncUI(e.message);
+                });
         }
 
         function refreshRemoteCounts(connectorId) {
@@ -578,14 +591,39 @@ define([], function () {
 
             q('btnSyncAll').addEventListener('click', function () {
                 startSyncUI();
-                apiPost('/virtuallib/sync')
-                    .then(function (results) {
-                        finishSyncUI(results || [], 'Synchronisation complete.');
-                        apiGet('/virtuallib/connectors').then(function (connectors) {
-                            connectors.forEach(function (c) { loadLibraryStats(c.Id); });
-                        }).catch(function () {});
-                    })
-                    .catch(function (e) { errorSyncUI(e.message); });
+                apiGet('/virtuallib/connectors').then(function (connectors) {
+                    var enabled = (connectors || []).filter(function (c) { return c.Enabled; });
+                    if (!enabled.length) {
+                        finishSyncUI([], 'No enabled connectors.');
+                        return;
+                    }
+                    var results = [];
+                    var bar = q('syncProgressBar');
+                    var label = q('syncProgressLabel');
+
+                    function syncNext(i) {
+                        if (i >= enabled.length) {
+                            bar.style.width = '100%';
+                            finishSyncUI(results, 'Synchronisation complete.');
+                            enabled.forEach(function (c) { loadLibraryStats(c.Id); });
+                            return;
+                        }
+                        var c = enabled[i];
+                        var pct = Math.round((i / enabled.length) * 100);
+                        bar.style.width = pct + '%';
+                        label.textContent = '(' + (i + 1) + '/' + enabled.length + ') ' + c.DisplayName + '\u2026';
+                        apiPost('/virtuallib/connectors/' + encodeURIComponent(c.Id) + '/sync')
+                            .then(function (result) {
+                                results.push(result);
+                                syncNext(i + 1);
+                            })
+                            .catch(function (e) {
+                                results.push({ ConnectorName: c.DisplayName, Success: false, ErrorMessage: e.message });
+                                syncNext(i + 1);
+                            });
+                    }
+                    syncNext(0);
+                }).catch(function (e) { errorSyncUI(e.message); });
             });
         });
     };