SPB Git

Repository Public

13 entries at the root
History

Latest commit docs: legendary README — icon, logo, live spbgit badges, author fc86072

NameLast commitUpdated
App v1.0.0: release tooling, author headers, admin and production tests, documentation
Components v1.0.0: release tooling, author headers, admin and production tests, documentation
Core v1.0.0: release tooling, author headers, admin and production tests, documentation
docs docs: legendary README — icon, logo, live spbgit badges, author
Features v1.0.0: release tooling, author headers, admin and production tests, documentation
Resources Engine: reconnect outside the lock, bounded test helpers; app model, settings, icon, project...
Scripts v1.0.0: release tooling, author headers, admin and production tests, documentation
Tests v1.0.0: release tooling, author headers, admin and production tests, documentation
Tools v1.0.0: release tooling, author headers, admin and production tests, documentation
.gitignore Core: local library, sync, resumable downloads, audio engine; integration tests against a real...
Package.swift v1.0.0: release tooling, author headers, admin and production tests, documentation
project.yml Engine: reconnect outside the lock, bounded test helpers; app model, settings, icon, project...
README.md docs: legendary README — icon, logo, live spbgit badges, author
README.md View source
SP Music logo



SP Music icon

# SP Music pour macOS

Lecteur musical natif — Swift 6, SwiftUI, AppKit, AVAudioEngine — de la bibliothèque privée servie par music.spboucher.ai : lecture en continu depuis le cluster, téléchargement vérifié et lecture hors ligne sans aucune requête.

Author: Simon-Pierre Boucher

music.spboucher.ai version plateforme architectures licence author

Swift concurrence SwiftUI AVAudioEngine SQLite SwiftPM XcodeGen AuthenticationServices dépendances WebView

commits last commit activity language languages size branches tags clones

fichiers Swift lignes Swift cœur écrans tests scripts formats

bundle signature notarisation cible bac à sable


# Sommaire


# 🎯 Vue d'ensemble

SP Music pour macOS est le lecteur natif de la bibliothèque privée servie par music.spboucher.ai sur le cluster MacLustr. Deux modes complémentaires :

  • lecture en continu depuis le cluster (fichiers originaux, jamais transcodés pour l'app) ;
  • téléchargement et lecture hors ligne : albums, listes ou bibliothèque entière copiés sur le Mac, lisibles sans aucune connexion.

Aucun WebView, aucun HTML : l'interface, le moteur audio, les téléchargements et la bibliothèque locale sont du code natif. Bundle ai.spboucher.spmusic, macOS 14 ou plus récent, universel (Apple Silicon et Intel), signé Developer ID, runtime durci.

# Famille SP Music

Dépôt Plateforme Rôle
sp-music Web · PWA Serveur : site, API /api/v1, worker d'import, diffusion audio, paroles
sp-music-macos (ce dépôt) macOS Client natif : copie locale du catalogue, lecture en continu et hors ligne
sp-music-ios iOS · iPadOS Client natif : même API, paquet séparé

# ✨ Fonctionnalités

État détaillé, fonction par fonction (Testé / Vu / Écrit / Absent) : docs/FEATURE_MATRIX.md.

Domaine Ce que fait l'app
Bibliothèque accueil (écoutés récemment, ajouts récents, hors ligne, listes), albums en grille avec 4 tris, fiches album et artiste, liste des titres
Recherche locale, FTS5, accents ignorés, préfixes — fonctionne hors ligne
Favoris et listes titres et albums favoris ; listes créées, renommées, complétées, ordonnées, supprimées — modifiables hors ligne, conflits sans écrasement
Lecture en continu par plages d'octets dans un fichier creux, cache vérifié par SHA-256 et réutilisé
FLAC recherche par plage d'octets exacte à l'échantillon (FLACIndex, FLACSliceSource)
Enchaînement deux platines : piste suivante démarrée à l'échantillon exact (sans blanc) ou en fondu à puissance constante
Traitements égaliseur 10 bandes, normalisation BS.1770 à −14 LUFS, « mode direct » qui les désactive d'un bloc, adaptation de la fréquence du périphérique
Téléchargements titre, album, liste, bibliothèque entière ; file persistante, reprise à l'octet, SHA-256, pause / reprise / annulation, limite de téléchargements simultanés
Hors ligne collections « gardées hors ligne », lecture sans aucune requête, détection de la perte et du retour du cluster
Paroles synchronisées ligne à ligne, clic pour se déplacer, cache hors ligne
Intégration macOS touches multimédias, widget « À l'écoute », menu du Dock, mini-lecteur, notifications, ouverture de fichiers audio locaux
Administration import (fichiers, dossiers, ZIP) par morceaux, doublons, remplacement, édition d'album, pochette, suppression, santé du serveur
Stockage dossier de bibliothèque déplaçable (disque externe possible), garde des suppressions

Choix assumés

  • Pas de bac à sable : la bibliothèque vit dans un dossier choisi (~/Music, disque externe) et doit rester lisible par d'autres lecteurs. Runtime durci sans exception.
  • Pas de « bit-perfect » annoncé : le chemin passe par le mélangeur 32 bits flottants de Core Audio ; l'app décrit ce qu'elle fait sans prétendre connaître ce que reçoit le périphérique.
  • Pas de mise à jour automatique.

# 🏗 Architecture

flowchart TB
    UI["SwiftUI · App · Features · Components"] --> AM["AppModel"]
    AM --> PC["PlaybackController"]
    PC --> AE["AudioEngine"]
    AE --> AV["AVAudioEngine"] --> OUT["Sortie Core Audio"]
    PC -->|ResolvedSource| LS["LibrarySession"]
    LS -->|"ByteSource : LocalFileSource · ProgressiveHTTPSource · FLACSliceSource"| AE
    subgraph CORE["SPMusicCore (paquet SwiftPM, aucune interface)"]
        LS --> ST["LibraryStore<br/>SQLite · FTS5"]
        LS --> SM["StorageManager + PathGuard"]
        LS --> DM["DownloadManager<br/>reprise par plage · SHA-256"]
        LS --> SY["SyncEngine"]
        LS --> AR["ArtworkStore"]
        LS --> API["APIClient + Connectivity"]
    end
    API -->|HTTPS| SRV["music.spboucher.ai<br/>/api/v1"]
    DM -->|"Range + If-Range"| SRV

# Règles tenues

  • Le moteur audio ne connaît ni les titres ni le réseau : il reçoit des sources d'octets et des jetons.
  • Le moteur de téléchargement ne connaît pas le moteur audio ; il réutilise seulement un fichier complet du cache de lecture.
  • La bibliothèque locale n'a jamais besoin du serveur : ouvrir une session, lister, chercher et lire un titre téléchargé ne font aucune requête (prouvé par un test qui compte les connexions).
  • Rien n'est supprimé hors d'un dossier marqué par l'app, liens symboliques résolus.

# Lecture

  • Deux platines (lecteur → mélangeur) alimentent un pré-mélangeur, l'égaliseur, puis le mélangeur principal. La piste suivante est préparée sur l'autre platine et démarrée à l'échantillon exact où la courante se termine (pas de blanc), ou plus tôt avec une rampe à puissance constante (fondu).
  • Chaque platine décode sur sa propre file : une source qui attend le réseau ne bloque jamais les commandes.
  • Les rappels du lecteur AVFoundation ne prennent jamais le verrou du moteur sur un fil audio (cause de deux interblocages trouvés par les tests).
  • Lecture en continu : ProgressiveHTTPSource écrit dans un fichier creux par requêtes de plage ; le décodeur lit ce qui est arrivé. Un saut demande les octets de la destination. Fichier complet → vérifié par SHA-256 → marqué, réutilisable.
  • FLAC : Core Audio se déplace dans un FLAC en le relisant depuis le début (mesuré, avec ou sans table de recherche). FLACIndex trouve une frontière de trame juste avant la cible (SEEKTABLE, sinon synchro de trame validée par CRC-8 et par la trame suivante) et FLACSliceSource présente « en-tête + audio à partir de là » au décodeur. Exact à l'échantillon.
  • Fidélité : aucun transcodage ; égaliseur, normalisation et fondu désactivables d'un bloc (« mode direct ») ; option pour régler la fréquence du périphérique sur celle du titre.

# Synchronisation

sequenceDiagram
    autonumber
    participant App as SyncEngine
    participant API as music.spboucher.ai
    App->>API: opérations locales en attente, dans l'ordre
    App->>API: GET library/sync?since=<dernière révision>
    API-->>App: artistes, albums, titres modifiés + pierres tombales
    App->>API: GET library/sync/me
    API-->>App: listes, favoris, état de lecture
    App->>API: historique d'écoute (POST puis GET)
    App->>App: met en file les téléchargements des collections gardées hors ligne

Une passe : (1) envoyer les opérations locales, dans l'ordre ; (2) tirer le catalogue depuis la dernière révision vue (tout, si demandé, si plus de 24 h, ou si les compteurs divergent) ; (3) tirer listes et favoris du compte, sauf si des opérations attendent encore ; (4) historique dans les deux sens ; (5) mettre en file les téléchargements des collections « gardées hors ligne ». Aucun fichier audio n'est transféré par une synchronisation.

Conflit de liste (modifiée ici hors ligne et ailleurs) : aucune version n'est écrasée ; celle du Mac est enregistrée à côté sous « … (copie de ce Mac) » et l'utilisateur est prévenu.

# Téléchargements

Octets dans <bibliothèque>/.spmusic/partial/<titre>.<asset>.part ; reprise par Range + If-Range sur l'identifiant de l'asset ; taille puis SHA-256 vérifiés avant un déplacement atomique vers le nom lisible. L'état est en base : une fermeture ou un plantage ne perd rien. Un fichier remplacé sur le cluster est retéléchargé ; un titre supprimé du cluster mais téléchargé ici est conservé et signalé.

# 🧱 Pile technique

Couche Technologie Version Rôle
Langage Swift (swift-tools-version 6.0, mode de langage 6) 6.0 concurrence stricte complete, isolation par défaut MainActor dans l'app
Interface SwiftUI + AppKit macOS 14+ fenêtres, barre latérale, lecteur, réglages
Audio AVAudioEngine · Core Audio système décodage, deux platines, égaliseur, mélangeur
Persistance SQLite (bibliothèque système sqlite3) + FTS5 système bibliothèque locale, recherche
Réseau URLSession (APIClient, HTTPByteStream) système JSON, plages d'octets
Authentification AuthenticationServices · Trousseau système clé d'accès, session
Système MediaPlayer, notifications système « À l'écoute », touches multimédias
Paquet SwiftPM SPMusicCore (bibliothèque) + spmusic-cli (point d'entrée provisoire) — cœur sans interface, testable seul
Projet XcodeGen (project.yml) — SPMusic.xcodeproj n'est pas versionné
Distribution Developer ID · notarytool · DMG — signature, notarisation, agrafage

Aucune dépendance tierce : Package.swift ne déclare aucun paquet externe.

# 🗂 Organisation du dépôt

text
Package.swift            paquet SwiftPM « SPMusicCore » (aucune interface) + tests
project.yml              définition XcodeGen de l'app (SPMusic.xcodeproj n'est pas versionné)
Core/                    24 fichiers — le cœur
├── Audio/               AudioEngine, AudioDecoder, AudioQueue, AudioOutputManager, ByteSource, FLACSeeker, LoudnessAnalyzer, PlaybackController
├── Networking/          APIClient, AdminAPI, Connectivity, HTTPByteStream
├── Authentication/      AuthService
├── Downloads/           DownloadManager
├── Offline/             LibrarySession, StorageManager
├── Persistence/         LibraryStore, SQLite
├── Synchronization/     SyncEngine, WireModels
├── Metadata/            ArtworkStore, Models
└── Security/            Keychain, PathGuard
App/                     point d'entrée, AppDelegate, AppEnvironment, AppSettings, intégrations macOS (Notifier, NowPlayingBridge, PasskeySignIn)
Features/                Home · Library · Albums · Artists · Playlists · Search · NowPlaying · Downloads · Settings · Administration · Welcome
Components/              AlbumCard · TrackRow · PlayerBar · ArtworkView · SidebarView · Common
Resources/               Info.plist, droits (Release et Debug), catalogue d'assets, icône
Tests/CoreTests/         42 tests + proxy de pannes (FaultProxy), fixtures, support du backend de test
Tools/spmusic-cli/       point d'entrée en ligne de commande (provisoire)
Scripts/                 build, tests, backend de test, release, notarisation, en-têtes d'auteur
docs/                    ARCHITECTURE.md · FEATURE_MATRIX.md · TEST_REPORT.md · brand/
Dossier Fichiers Swift Lignes
Core/ 24 4 638
Features/ 11 1 715
Tests/ 10 1 412
App/ 7 1 131
Components/ 6 686
Tools/ 1 4
Total 61 9 622

# 🚀 Construire et tester

Le projet Xcode est généré par XcodeGen depuis project.yml.

bash
Scripts/build.sh                 # génère le projet et construit l'app Debug
Scripts/backend-dev.sh start     # vrai backend de test local (clone de sp-music.git dans ~/dev/sp-music-testbed, PostgreSQL, ffmpeg)
Scripts/t.sh                     # tous les tests du cœur ; Scripts/t.sh <filtre> [secondes]
Scripts/run-dev.sh --shot /tmp/x.png -- -SPMusicRoute albums     # lance le build Debug sur le backend de test, muet, et capture la fenêtre
Scripts/make-icon.sh             # régénère l'icône depuis le SVG
Scripts/check-headers.sh         # en-têtes d'auteur
Tous les scripts
Script Rôle
Scripts/build.sh génère le projet Xcode et construit l'app Debug (erreurs seulement sur la console)
Scripts/t.sh [filtre] [secondes] [lignes] swift test avec filtre et limite de temps, n'affiche que les verdicts
Scripts/backend-dev.sh start|stop vrai backend SP Music local pour les tests fonctionnels : code du cluster, base PostgreSQL propre, stockage propre, vrai ffmpeg, vrai worker (port 8695 par défaut)
Scripts/dev-session.sh affiche un jeton de session du backend de test, obtenu par les vraies routes d'association d'appareil ; ne touche jamais la production
Scripts/run-dev.sh [--shot out.png] [--wait s] [--keep] [--fresh] [--no-server] [-- args…] lance le build Debug sur le backend de test, avec ses propres dossiers, muet, et capture sa fenêtre
Scripts/window-shot.swift capture de la fenêtre de l'app
Scripts/make-icon.sh rend le SVG de l'icône dans le catalogue d'assets (toutes les tailles macOS)
Scripts/add-headers.py · Scripts/check-headers.sh ajoute / vérifie l'en-tête d'auteur (Author / File / Description)
Scripts/asc.py client minimal de l'API App Store Connect (clé existante)
Scripts/provision.py identifiant d'app, Associated Domains, profil Developer ID — idempotent
Scripts/release.sh archive Release signée → dist/SP Music.app
Scripts/verify-release.sh [app] signature, runtime durci, droits, profil, pas de moteur web, pas de droit de débogage, pas de secret
Scripts/notarize.sh notarisation, agrafage, DMG signé + notarisé

# ⚙️ Configuration

Build (project.yml)

Réglage Valeur
MARKETING_VERSION · CURRENT_PROJECT_VERSION 1.0.0 · 1
SWIFT_VERSION · SWIFT_STRICT_CONCURRENCY 6.0 · complete
Cible de déploiement macOS 14.0
Identifiant Release · Debug ai.spboucher.spmusic · ai.spboucher.spmusic.debug
Signature Release manuelle, Developer ID Application, profil « SP Music Developer ID », --timestamp
Signature Debug locale, sans profil ni droit restreint (pas d'Associated Domains) ; identifiant distinct pour qu'une copie de développement ne masque jamais l'app installée pour les clés d'accès
ENABLE_HARDENED_RUNTIME YES
Langue de développement fr

Variables d'environnement des tests et scripts (noms seulement)

Variable Rôle
SPMUSIC_TEST_URL · SPMUSIC_TEST_PORT · SPMUSIC_TEST_DB backend de test
SPMUSIC_TESTBED · SPMUSIC_TEST_SCRIPT emplacement du clone de test et de son script
SPMUSIC_REAL_FLAC fichier FLAC réel pour le test de recherche par plage (sinon ignoré)
SPMUSIC_PROD_URL · SPMUSIC_PROD_TOKEN test de fumée en lecture seule contre la production (sinon ignoré)
NOTARY_PROFILE profil trousseau de notarytool (défaut : MacLustr-Notarize)

Arguments de lancement (développement et tests fonctionnels, build Debug)

Argument Effet
-SPMusicServer <url> serveur
-SPMusicDataDir <dossier> · -SPMusicLibraryRoot <dossier> dossiers de données et de bibliothèque
-SPMusicDevToken <jeton> session de développement
-SPMusicRoute albums|artists|tracks|downloads|admin|album:<id>|nowplaying écran d'ouverture
-SPMusicPlay <titre> · -SPMusicSeek <secondes> · -SPMusicShowNowPlaying lecture automatique
-SPMusicDownloadAlbum <album> téléchargement automatique

# 🖥 Écrans

Écran Dossier État (v1.0.0)
Bienvenue / connexion Features/Welcome Vu
Accueil Features/Home Vu
Albums et fiche album Features/Albums Vu
Artistes et fiche artiste Features/Artists Écrit (liste testée côté base)
Titres Features/Library Écrit (requêtes testées)
Listes de lecture Features/Playlists données Testées, écran Écrit
Recherche Features/Search recherche Testée, écran Écrit
Lecture en cours Features/NowPlaying Vu
Téléchargements Features/Downloads Vu
Réglages Features/Settings Écrit
Administration Features/Administration API Testée, écran Écrit

Légende (docs/FEATURE_MATRIX.md) — Testé : couvert par un test automatisé réel · Vu : constaté dans l'app lancée · Écrit : implémenté, compilé, jamais exercé.

# 🔌 Backend et API

Les ajouts côté serveur (synchronisation incrémentale, association d'appareil, historique, fichier apple-app-site-association) sont dans le dépôt sp-music (migration 003_native_clients.sql, docs/ARCHITECTURE.md § Clients natifs). Le site web n'est pas modifié dans son comportement.

Route du serveur Usage dans l'app
GET /api/v1/library/sync?since=<rev> catalogue incrémental et pierres tombales
GET /api/v1/library/sync/me listes, favoris, état de lecture
GET · POST /api/v1/library/history historique d'écoute dans les deux sens
PATCH playlists/:id · PUT playlists/:id/order (baseUpdatedAt) détection des conflits de liste (409)
POST /api/v1/auth/device/{start,poll} association avec le navigateur
GET /api/v1/stream/<id> (Range) lecture en continu et téléchargement
GET /api/v1/art/<id> pochettes
/api/v1/admin/* import, édition d'album, santé (AdminAPI.swift)

# 💾 Données locales

  • Musique téléchargée : ~/Music/SP Music/<compte>/<Artiste>/<Album (année)>/01 Titre.flac (dossier modifiable dans Réglages › Stockage, disque externe possible). Ce sont les originaux du cluster, vérifiés par SHA-256, lisibles par n'importe quel lecteur. Un fichier .spmusic/library.json marque le dossier ; l'app ne supprime jamais rien en dehors.
  • Base locale, pochettes, cache de lecture : ~/Library/Application Support/SP Music/Accounts/<serveur>_<compte>/.
  • Session : dans le trousseau. Se déconnecter n'efface pas la musique téléchargée.

# 🔑 Connexion

  1. Clé d'accès (AuthenticationServices) : même vérification serveur que le navigateur. Demande le droit com.apple.developer.associated-domains (profil Developer ID) et l'app installée dans /Applications.
  2. Association avec le navigateur : l'app affiche un code, un navigateur déjà connecté l'approuve sur https://music.spboucher.ai/appareil, l'app reçoit sa propre session (révocable dans « Compte » sur le site).

# 🔐 Sécurité et vie privée

  • Session dans le trousseau (Core/Security/Keychain.swift) ; droit webcredentials:music.spboucher.ai pour les clés d'accès.
  • PathGuard : aucune suppression hors d'un dossier marqué par l'app (.., liens symboliques, marqueur).
  • Chaque fichier téléchargé est vérifié (taille puis SHA-256) avant installation ; un fichier corrompu n'est jamais installé.
  • Runtime durci sans exception ; App Transport Security limité au réseau local (NSAllowsLocalNetworking) pour le backend de test.
  • Une session révoquée laisse la musique locale lisible.
  • Scripts/verify-release.sh vérifie l'absence de moteur web, de droit de débogage et de secret dans le bundle.
  • Aucun certificat n'est créé par les scripts ; aucun identifiant n'est affiché.

# ✅ Tests

Rapport complet : docs/TEST_REPORT.md — v1.0.0 (1), 18 novembre 2026 : 42 tests automatisés, 40 réussis, 2 ignorés (fichier FLAC réel absent ; fumée production sans jeton), en 17 s, 10 exécutions consécutives sans échec.

Fichier Tests Portée
ClusterTests.swift 11 association d'appareil, synchronisation, téléchargements, modifications hors ligne
StreamingAndOfflineTests.swift 8 lecture en continu, hors ligne sans connexion, stockage
UnitTests.swift 8 cœur sans réseau
AudioTests.swift 7 formats, moteur, enchaînement sans blanc, mesure du niveau
FLACSeekTests.swift 4 recherche FLAC par plage
AdminTests.swift 3 import, édition, santé, 403 pour un auditeur
ProductionSmokeTests.swift 1 fumée en lecture seule contre la production
Total 42

Les tests d'intégration parlent à un vrai serveur (le code du cluster, sa base, son worker) à travers un proxy TCP qui produit de vraies pannes (coupure, lenteur, corruption). Ils sont ignorés quand le backend de test ne tourne pas. Le test de fumée contre la production est en lecture seule et ne tourne que si on lui fournit une session (SPMUSIC_PROD_URL, SPMUSIC_PROD_TOKEN).

Ce qui est vérifié, par domaine
Domaine Vérifié
Formats FLAC 16 et 24 bits, ALAC, WAV, AIFF, MP3, AAC : ouverts, décodés (fréquence du signal mesurée), déplacement exact ; faux fichier refusé
Moteur lecture, pause, déplacement, volume, gain de normalisation et mode direct, enchaînement sans blanc (signal continu ± 20 ms sur 4 s), enchaînement 44,1 → 96 kHz
Recherche FLAC par plage exacte à l'échantillon sur 4 positions + fin de fichier, moins du quart du fichier lu, avec et sans SEEKTABLE
Connexion association d'appareil réelle, jeton inconnu refusé, session révoquée détectée
Synchronisation première synchro complète, suivantes vides, renommage, suppressions, historique dans les deux sens
Téléchargements album complet vérifié SHA-256 ; coupure à 3 Mo → reprise à l'octet exact ; fermeture de l'app → reprise au relancement ; octet corrompu → jamais installé
Hors ligne serveur coupé : parcourir, chercher, lire deux titres enchaînés avec 0 connexion
Lecture en continu son avant l'arrivée du fichier, saut loin devant par requête de plage, copie complète vérifiée ; coupure courte surmontée seule
Modifications hors ligne liste créée, complétée, renommée, favoris → envoyés au retour ; conflit → deux versions conservées + avis
Stockage déplacement de la bibliothèque, dossier occupé refusé, disque débranché sans perte ; garde des chemins
Administration import par morceaux d'un vrai fichier, doublon reconnu, édition d'album, pochette, santé, suppression
Mesure du niveau écart ≤ 0,3 LU avec ffmpeg ebur128 sur bruit rose et sinus
Grande bibliothèque 72 000 titres synchronisés en 1,6 s ; 6 000 albums listés en 21 ms ; recherche en 11 ms

Bogues trouvés par les tests et corrigés : en-tête User-Agent non ASCII quand le nom du Mac contient un accent ; deux interblocages du moteur audio ; index de recherche en O(n²) à la première synchronisation ; garde des chemins contournable par un lien symbolique vers un fichier inexistant ; relecture complète d'un FLAC pour s'y déplacer ; plantage au premier « À l'écoute » ; fiches album, artiste et liste restées vides.

# 📦 Publier

bash
python3 Scripts/provision.py     # identifiant d'app + Associated Domains + profil Developer ID (clé App Store Connect existante ; idempotent)
Scripts/release.sh               # archive Release signée → dist/SP Music.app
Scripts/verify-release.sh        # signature, droits, natif seulement, pas de secret
Scripts/notarize.sh              # notarisation Apple (profil trousseau « MacLustr-Notarize »), agrafage, DMG signé + notarisé + SHA-256

Aucun certificat n'est créé par ces scripts ; aucun identifiant n'est affiché.

État de la v1.0.0 (tag v1.0.0, d'après docs/TEST_REPORT.md) : archive Release universelle (arm64 + x86_64), signature Developer ID, runtime durci, profil avec Associated Domains ; notarisation Accepted pour l'app et pour le DMG, tickets agrafés ; spctl : « Notarized Developer ID ».

# 🩺 Pièges connus

Piège Remède dans le code
Core Audio relit tout un FLAC pour s'y déplacer, même avec SEEKTABLE FLACIndex + FLACSliceSource (Core/Audio/FLACSeeker.swift)
Rappel du lecteur AVFoundation attendant le verrou du moteur → interblocage les rappels ne prennent jamais le verrou ; reconnexion d'une platine hors verrou
Rappels MediaPlayer appelés hors du fil principal (plantage au premier « À l'écoute ») corrigé dans App/Integration/NowPlayingBridge.swift
En-tête User-Agent non ASCII (nom du Mac avec accent ou apostrophe typographique) nom ramené en ASCII
Index FTS5 en O(n²) à la première grande synchronisation index par rowid de la piste
Lien symbolique vers un fichier qui n'existe pas encore PathGuard résout l'ancêtre existant
Fiche restée vide (tâche attachée à un conteneur vide) corrigé dans les vues de fiche
Clé d'accès indisponible en Debug normal : le build Debug n'a pas le droit Associated Domains ; utiliser l'association avec le navigateur ou Scripts/dev-session.sh

# ⚠️ Non vérifié et limites

Repris de docs/TEST_REPORT.md et de docs/FEATURE_MATRIX.md :

  • Connexion par clé d'accès dans l'app : le droit, le profil et le fichier d'association sont en place, l'échange n'a jamais eu lieu.
  • Aucune écoute humaine : tout a joué volume à zéro ou en rendu hors ligne.
  • Fondu enchaîné, égaliseur, adaptation de la fréquence du périphérique, changement ou débranchement de sortie, veille : écrits, jamais exercés.
  • Touches multimédias, widget « À l'écoute », menu du Dock, mini-lecteur, raccourcis configurables, ouverture de fichiers, glisser-déposer, notifications : écrits, jamais exercés.
  • Écrans d'administration, de réglages, artistes, titres, favoris, historique, liste de lecture, recherche : compilés ; leurs données et leurs API sont testées, les écrans n'ont pas été parcourus.
  • Téléchargement de toute la bibliothèque réelle ; Ogg, Opus, DSD (aucun titre) ; paroles réelles dans la vue.
  • Autre Mac, tranche Intel, macOS 14 à 26, VoiceOver, profilage Instruments.
  • Absent de cette version : interface en anglais (français seulement), thème d'accent, édition titre par titre et réordonnancement d'un album, gestion des comptes, journal d'audit et correction des paroles (à faire sur le site).

# 📚 Documentation

# 👤 Auteur


Simon-Pierre Boucher — conception, développement, exploitation
www.spboucher.ai · git.spboucher.ai · contact@spboucher.ai

# 📄 Licence

Le dépôt ne contient pas de fichier de licence. Tous droits réservés © 2026 Simon-Pierre Boucher.

Clone sp-music-macos

Anonymous clone and fetch. Pushing requires the owner's personal access token.

Snapshot of main

Files main
Menu

Theme