=====================================================================
  ASYLUM COMPANION — CUSTOM SOUNDS  (AsylumCompanion_Sounds)
  Français ci-dessous / English first
=====================================================================

WHAT IS THIS?
  A tiny media-only addon: a folder where you drop your own sounds so
  Asylum Companion can play them (Sound menu: spell links, Bloodlust,
  packs, system events). It contains NO code and needs NO setup.
  Asylum Companion updates NEVER touch this folder, so your files are safe.
  Removing this folder never breaks Asylum Companion.

QUICK START (3 steps)
  1. Install this folder in:
        World of Warcraft/_retail_/Interface/AddOns/AsylumCompanion_Sounds
     (next to the AsylumCompanion folder). It ships with one example
     sound (custom_sound_01.ogg) so you can check that everything works.
  2. Fully close World of Warcraft, launch it again, log in.
     ( /reload is NOT enough: the game only indexes new files at launch. )
  3. Open Asylum Companion > Sound. "Custom sound 01" appears in the lists.
     Replace it, or add your own files, using these EXACT names:
        custom_sound_01.ogg   ...   custom_sound_50.ogg      (spell / event sounds)
        ambiance_sound_01.ogg ...   ambiance_sound_50.ogg    (long music tracks)
     Then restart the game again.

FORMAT — OGG ONLY
  World of Warcraft can only play .ogg (Ogg Vorbis). MP3 and other formats
  are silently ignored. Convert your files with the included helper:
    Windows : drag & drop your .mp3/.wav files onto  convert.bat
    macOS   : run  ./convert.sh mysong.mp3
  Both need ffmpeg installed ( https://ffmpeg.org/download.html ).
  Manual command:  ffmpeg -i input.mp3 -c:a libvorbis -q:a 5 custom_sound_02.ogg
  Tips: keep spell sounds short (< 3 s); music tracks are cut by Asylum
  Companion after the max duration set in the Sound menu.

TROUBLESHOOTING
  - Not detected? Check: exact file name (custom_sound_07.ogg, two digits),
    .ogg format, folder name AsylumCompanion_Sounds, addon enabled in the
    character's addon list, and a FULL game restart.
  - Asylum Companion > Sound > "Diagnose" lists every slot with the path
    it probed and whether the file was found.
  - Names in the game are "Custom sound NN" — the number is the file number.

LICENSE
  Your files stay yours. The bundled example custom_sound_01.ogg is a Kenney
  interface sound (CC0 1.0 — public domain), see LICENSE.txt. Please only
  share packs containing sounds you have the right to redistribute.

---------------------------------------------------------------------
  VERSION FRANÇAISE
---------------------------------------------------------------------

C'EST QUOI ?
  Un mini-addon purement multimédia : un dossier où déposer vos propres sons
  pour qu'Asylum Companion les joue (menu Sound : sons de sorts, Bloodlust,
  packs, événements système). Aucun code, aucune configuration.
  Les mises à jour d'Asylum Companion ne touchent JAMAIS ce dossier : vos
  fichiers sont en sécurité. Le supprimer ne casse jamais Asylum Companion.

DÉMARRAGE RAPIDE (3 étapes)
  1. Installez ce dossier dans :
        World of Warcraft/_retail_/Interface/AddOns/AsylumCompanion_Sounds
     (à côté du dossier AsylumCompanion). Il contient un son d'exemple
     (custom_sound_01.ogg) pour vérifier que tout fonctionne.
  2. Fermez complètement World of Warcraft, relancez-le, connectez-vous.
     ( /reload ne suffit PAS : le jeu n'indexe les nouveaux fichiers qu'au
     lancement. )
  3. Ouvrez Asylum Companion > Sound. « Son personnalisé 01 » apparaît.
     Remplacez-le ou ajoutez vos fichiers avec ces noms EXACTS :
        custom_sound_01.ogg   ...   custom_sound_50.ogg      (sons de sorts / événements)
        ambiance_sound_01.ogg ...   ambiance_sound_50.ogg    (musiques longues)
     Puis redémarrez de nouveau le jeu.

FORMAT — OGG UNIQUEMENT
  World of Warcraft ne lit que le .ogg (Ogg Vorbis). Les MP3 et autres
  formats sont ignorés silencieusement. Convertissez avec l'outil fourni :
    Windows : glissez-déposez vos .mp3/.wav sur  convert.bat
    macOS   : lancez  ./convert.sh machanson.mp3
  Les deux nécessitent ffmpeg ( https://ffmpeg.org/download.html ).
  Commande manuelle : ffmpeg -i entree.mp3 -c:a libvorbis -q:a 5 custom_sound_02.ogg
  Conseils : sons de sorts courts (< 3 s) ; les musiques sont coupées par
  Asylum Companion après la durée maximale réglée dans le menu Sound.

DÉPANNAGE
  - Non détecté ? Vérifiez : nom exact (custom_sound_07.ogg, deux chiffres),
    format .ogg, dossier nommé AsylumCompanion_Sounds, addon activé dans la
    liste des addons du personnage, et un redémarrage COMPLET du jeu.
  - Asylum Companion > Sound > « Diagnostiquer » liste chaque emplacement
    avec le chemin sondé et si le fichier a été trouvé.
  - En jeu, les sons s'appellent « Son personnalisé NN » — NN = le numéro du fichier.

LICENCE
  Vos fichiers restent les vôtres. L'exemple fourni custom_sound_01.ogg est
  un son d'interface Kenney (CC0 1.0 — domaine public), voir LICENSE.txt.
  Ne partagez que des packs dont vous avez le droit de redistribuer les sons.
