Copie et conversion

aede copy écrit une destination distincte : baladeur, carte ou disque, sans toucher aux originaux. L’arborescence est conservée relativement aux racines : sous une racine Music, Music/Artist/Album/01.flac devient Artist/Album/01.flac dans la destination. Aucun reclassement automatique depuis les tags.

aede copy /Volumes/Player --dry-run
aede copy /Volumes/Player --query "loved" --verify
aede copy /Volumes/Card --collection Road --verify

Le dossier de base doit déjà exister. --query emploie la grammaire, --collection réévalue une collection. Choisir une seule option ; sans les deux, tout le catalogue. loved hérite des favoris d’album/artiste ; une note d’album demande album.rating:>=4.

Images et fichiers annexes#

La pochette choisie évite d’embarquer automatiquement tous les gros spectrogrammes/livrets.

Noms et systèmes de fichiers#

Aède teste la destination pour ses restrictions et peut adapter caractères, fins de noms et noms de périphériques réservés. --safe-names force l’adaptation ; --raw-names conserve les caractères originaux et peut échouer. Les compteurs de collision restent applicables. Options incompatibles.

L’adaptation portable reconnaît les mots réservés avant le premier point, même avec plusieurs suffixes ou un suffixe long (CON.foo.bar devient CON_.foo.bar). Le raccourcissement à une frontière Unicode revérifie les espaces/points finaux et mots réservés qu’il peut exposer, en conservant la limite prudente de 255 octets par composant et les extensions reconnues.

Les noms adaptés sont listés. Des compteurs déterministes distinguent les collisions de fichiers et de dossiers par une comparaison conservatrice des majuscules, accents composés/décomposés courants et ponctuation. Deux albums distincts ne sont pas fusionnés après adaptation. Une copie réelle teste aussi les chemins prévus dans un dossier isolé sur la destination ; les autres équivalences ou noms refusés entraînent une erreur avant de modifier les résultats réels.

Vérifier l’arrivée#

Un nouveau fichier est écrit sous un nom temporaire avant publication. Les copies simples déjà présentes à la taille attendue non nulle sont ignorées sans comparaison de contenu. Une conversion existante non vide l’est aussi. Taille/existence servent à reprendre, pas à prouver l’identité.

Chaque sortie utilise un dossier temporaire privé créé exclusivement. Les anciens noms temporaires et liens symboliques de destination ne peuvent pas détourner l’écriture. Sans --replace, une copie simple de taille différente ou une conversion vide est conservée et signalée. La publication atomique refuse aussi un fichier créé entre-temps par un autre écrivain ; elle exige les liens physiques du système de fichiers, vérifiés avant les transferts concernés. FAT/exFAT ne les proposent généralement pas : un --replace explicite permet alors la publication, mais autorise aussi le remplacement des fichiers existants. Une reprise qui ignore tous les fichiers déjà présents n’exige pas cette capacité. Ces contrôles ne protègent pas contre un processus qui remplace simultanément les dossiers parents.

--verify relit les copies simples nouvellement écrites et compare leurs octets à ceux de la source avec une mémoire bornée après vidange applicable. Les fichiers ignorés ne sont pas relus. --replace --verify les réécrit et vérifie volontairement.

L’espace estimé compte seulement les écritures restantes et les encodages temporaires nécessaires à --verify-existing. Une erreur de lecture des fichiers annexes demandés bloque le transfert ; un dossier illisible n’est pas considéré comme vide.

Les sources audio et annexes doivent être des fichiers locaux ordinaires ; une entrée périmée pointant vers un FIFO ou périphérique est refusée même en aperçu. L’encodage utilise un chemin local canonique, sans interpréter le nom comme un protocole FFmpeg. Les appels directs de conversion publient aussi depuis un temporaire isolé et ne peuvent pas tronquer une source via une destination liée.

Le système peut répondre depuis son cache : cela ne prouve pas la conservation durable ni remplace une relecture indépendante ultérieure. C’est différent du contrôle de conteneur.

Refus#

• Destination de base absente : un baladeur débranché ne doit pas devenir un dossier interne. Seuls les sous-dossiers d’une destination existante sont créés.
• Chevauchement avec une racine suivie, à l’intérieur, à égalité ou au-dessus, même via lien symbolique.
• Sélection vide, options contradictoires, format/qualité invalide.
• Espace prévu supérieur à celui disponible ; les tailles converties restent estimées et le disque peut encore se remplir ensuite.

Le bilan compte écrit, déjà présent et échoué. Un échec renvoie une erreur mais conserve le travail terminé. Relancer reprend ; --replace recommence volontairement.

Convertir à la copie#

aede copy /Volumes/Phone --compress opus --quality 128k
aede copy /Volumes/Phone --compress mp3 --quality V0 --query "loved"

Cibles : mp3, opus, aac dans M4A, vorbis dans Ogg, flac, wav. Qualités : MP3 V0–V9, Vorbis q0–q10 ou débit 192k, interprété par l’encodeur choisi. flac/wav sans perte refusent la qualité ; qualité sans --compress aussi.

Une conversion vers une cible sans perte exige une précision PCM connue ; sinon elle est refusée avant encodage plutôt que de réduire silencieusement les échantillons. La conversion explicite vers une cible avec perte reste possible.

Les sources WavPack flottantes n’affichent pas de précision PCM entière ; leur conversion en FLAC/WAV est donc refusée. Ce refus s’applique aussi lorsque la représentation du premier bloc audio reste indéterminée après 64 en-têtes de blocs WavPack. La copie à l’identique ou le choix explicite d’une cible avec perte restent possibles.

Seules les sources identifiées sans perte sont encodées. Les sources avec perte sont copiées telles quelles, même dans un autre codec cible. MP3 vers Opus reste donc MP3 ; MP3 vers FLAC n’invente pas une qualité sans perte.

FFmpeg est requis à la conversion réelle. Une reprise qui ignore seulement des sorties converties déjà présentes et non vides n’a pas besoin de l’encodeur ; --replace, --verify-existing ou une sortie convertie absente l’exigent. Conversion parallèle automatiquement ; copie simple : un traitement par défaut. --threads N remplace ce choix. La prévision ne lance pas l’encodage.

Les diagnostics de l’encodeur sont lus entièrement, mais seule une fin de taille bornée est conservée : les erreurs répétées d’une source corrompue ne s’accumulent pas en mémoire. Un encodage en échec préserve tout fichier de destination préexistant.

Les métadonnées traversent selon les limites du conteneur/FFmpeg, depuis le conteneur et la première piste audio (dont les commentaires Ogg-FLAC). Si une clé existe dans les deux, la valeur du conteneur est prioritaire. Images intégrées possibles dans les chemins MP3/AAC/FLAC choisis ; limitations WAV/Vorbis/Opus. WAV ne conserve pas tous les crédits/champs personnalisés. Les images annexes restent indépendamment sélectionnables.

Avec --verify, les lecteurs Aède vérifient la durée lisible non nulle du résultat nouvellement encodé et la comparent à la source si disponible, selon la tolérance du code. Ce n’est pas une comparaison de tous les échantillons ni une preuve de transparence audible.

Originaux et dérivés#

Les dérivés convertis peuvent recevoir les tags de l’encodeur ; jamais les originaux. Sauvegarder l’archive séparément.

Voir copy pour toutes les options, backup pour les données personnelles/catalogue sans audio.

Reprise contrôlée et playlists#

--verify-existing compare les copies déjà présentes avec leur source. Pour une conversion, un nouvel encodage temporaire est comparé au fichier existant : une version d’encodeur ou des métadonnées non déterministes peuvent changer les octets malgré un audio équivalent. Un écart conserve le fichier existant et signale une erreur ; --replace autorise explicitement sa réécriture. FFmpeg et de l’espace temporaire sont nécessaires pour comparer une conversion.

--playlists crée aede-selection.m3u8 dans l’ordre de sélection et adapte les M3U/M3U8 UTF-8 copiés avec --extras all. Les chemins suivent les noms adaptés et les extensions converties ; les entrées hors sélection, y compris les URL, sont omises et comptées. Une playlist existante différente reste intacte sans --replace.

Chaque M3U/M3U8 compagnon doit être un fichier ordinaire UTF-8 de 16 Mio au maximum, comme pour la lecture en ligne de commande. Un fichier trop volumineux ou illisible bloque explicitement la préparation ; il n’est pas ignoré silencieusement.

Un chemin relatif commençant par un espace, # ou file: reçoit le préfixe explicite ./ pour que le lecteur conserve le nom exact au lieu de le tronquer ou de lire un commentaire. Les noms audio, listes sources, ordre et répétitions restent inchangés.

Les écritures utilisent un dossier temporaire privé créé exclusivement. Les liens symboliques dans les fichiers ou sous-dossiers de destination sont refusés. --dry-run ne crée aucune sonde ; sans politique explicite, les noms prévus sont conservateurs. Donner --safe-names ou --raw-names fixe la politique pour la prévision et le transfert. La conversion WAV conserve la précision entière ou flottante connue de la source ; une précision inconnue ou non prise en charge est refusée. La conversion des sources flottantes en FLAC est refusée, même en prévision : ce format entier quantifierait leurs échantillons. Un fichier déjà au format audio cible reste inchangé même si son extension est un alias. MP3 accepte V0–V9, Vorbis q0–q10, AAC/Opus uniquement un débit.

Les sources entières dépassant 24 bits exigent un encodeur FFmpeg prenant en charge le FLAC 32 bits ; un encodeur incapable est refusé. Les nouveaux fichiers sans perte sont contrôlés avant publication : précision, fréquence d’échantillonnage et nombre de canaux conservés, même sans --verify.

Export des originaux vers une application desktop#

Phémios peut récupérer les originaux sélectionnés depuis un Aède local ou distant puis réutiliser le moteur de copie/conversion pour un lecteur connecté à sa machine. La capacité original_exports de /api/v1/status annonce cette API : POST /api/me/v1/exports/plan accepte 1 à 200 références de pistes distinctes dans references et retourne les composants du chemin relatif portable, la taille et un jeton de version du fichier. La capacité supplémentaire export_conversion_plans accepte le champ facultatif format et fournit output_components / output_key, noms et clés des fichiers de destination après conversion selon les règles du moteur. Les originaux déjà compressés gardent leur format ; le client doit refuser les collisions entre sorties, y compris entre plusieurs lots. Les composants et jetons originaux restent ceux des fichiers à récupérer. GET /api/me/v1/exports/original?ref=<référence>&stamp=<jeton> transmet le fichier catalogué exact ; une source modifiée est refusée.

Ces opérations ne modifient ni le catalogue ni l’historique. Elles exigent une session utilisateur ou administrateur : accès anonyme, auditeur et contrôle parental actif sont refusés. Le transport revérifie la session et les règles pendant le transfert, y compris lorsque le destinataire cesse momentanément de lire. Aucune écriture vers un chemin fourni par le client n’est exposée sur le serveur. Il faut mettre à jour et redémarrer un ancien serveur Aède pour bénéficier de cette capacité ; la mise à jour de Phémios seule ne suffit pas.