Tutoriel
Forge Audio
Version 0.12.2 · Mis à jour le 1 octobre 2026
Forge Audio est un lecteur musical libre qui agrège les contenus de YouTube, SoundCloud, Dailymotion et plus de 1 000 sites. Il propose des playlists synchronisées, des paroles, un égaliseur et la lecture vidéo. Ce tutoriel décrit l'installation sur chaque plateforme et les premières utilisations.
Ce qu'il faut
- Connexion Internet
- Pour Linux : accès à un terminal avec droits sudo (pour .deb ou .rpm)
- Pour Windows : aucun prérequis supplémentaire
- Pour macOS : autorisations d’exécution de fichiers non signés
Installation
Web (auto‑hébergé)
- 1Ouvrir le navigateur et se rendre sur https://forgeaudio.heiphaistos.org
- 2Créer un compte ou se connecter avec les identifiants fournis
- 3L’interface est prête à l’emploi, aucune installation n’est nécessaire
Windows – version installable
- 1Télécharger ForgeAudio-0.12.2-win-x64-nsis.exe depuis la page des releases
- 2Double‑cliquer sur le fichier et suivre l’assistant d’installation
- 3Lancer Forge Audio depuis le menu Démarrer ou le raccourci créé
Windows – version portable
- 1Télécharger ForgeAudio-0.12.2-win-portable.exe
- 2Placer le fichier où vous le souhaitez et double‑cliquer pour le lancer
- 3Les données seront stockées dans le dossier ForgeAudio-data à côté de l’exécutable
macOS – Intel ou Apple Silicon
- 1Télécharger le .dmg correspondant (mac‑arm64 ou mac‑x64)
- 2Faire glisser l’icône Forge Audio dans le dossier Applications
- 3Si le système bloque le lancement, faire un clic droit → Ouvrir → Ouvrir
Linux – Debian/Ubuntu
- 1Télécharger ForgeAudio-0.12.2-linux-amd64.deb
- 2Ouvrir un terminal et exécuter : sudo dpkg -i ForgeAudio-0.12.2-linux-amd64.deb
- 3Lancer Forge Audio depuis le menu des applications
Premier lancement
- 1Au premier lancement, Forge Audio télécharge automatiquement yt‑dlp et le met à jour tous les 3 jours
- 2Accepter les permissions système si une boîte de dialogue apparaît (ex. accès au réseau)
- 3L’icône apparaît dans la zone de notification ; cliquer dessus pour afficher le lecteur

rechercher et lire un titre
Utilisez la barre de recherche pour trouver des morceaux sur plusieurs sources.
- 1Cliquer dans le champ de recherche en haut de l’interface
- 2Saisir le nom de l’artiste ou du titre, les suggestions s’affichent en temps réel
- 3Sélectionner le résultat souhaité et appuyer sur Entrée ou cliquer sur le bouton Lecture
créer et gérer une playlist
Les playlists sont sauvegardées automatiquement sur le serveur ou localement.
- 1Dans le panneau Bibliothèque, cliquer sur « Nouvelle playlist »
- 2Donner un nom à la playlist puis valider
- 3Faire glisser des titres depuis la file d’attente ou la recherche vers la playlist
- 4Utiliser le menu contextuel (clic droit) pour renommer, dupliquer ou supprimer
activer les paroles synchronisées
Les paroles sont récupérées depuis LRCLIB et affichées en temps réel.
- 1Lancer la lecture d’un titre disposant de paroles (indiqué par l’icône « L »)
- 2Cliquer sur l’icône « Paroles » dans le lecteur
- 3Faire défiler ou cliquer sur une ligne pour se positionner à ce moment précis
utiliser l’égaliseur
L’égaliseur 10 bandes s’applique uniquement si vous l’activez.
- 1Ouvrir le menu Paramètres → Audio
- 2Cocher « Activer l’égaliseur »
- 3Choisir un des 10 préréglages ou ajuster manuellement chaque bande
- 4Fermer le menu pour appliquer les changements
lire la vidéo du morceau
Le clip vidéo peut être affiché de plusieurs façons.
- 1Pendant la lecture, cliquer sur l’icône vidéo dans le lecteur
- 2Choisir entre plein écran, lecteur réduit (touche I) ou image‑dans‑image
- 3Utiliser la touche Échap pour quitter le plein écran
télécharger un titre
Forge Audio permet d’enregistrer le flux audio ou vidéo.
- 1Dans le menu du titre (trois points), sélectionner « Télécharger »
- 2Choisir le format souhaité : MP3 320 kbit/s, audio original ou MP4 vidéo
- 3Le fichier est enregistré dans le répertoire de téléchargement par défaut
connecter l’application de bureau à un serveur web
Synchronisez votre bibliothèque entre le client de bureau et le serveur auto‑hébergé.
- 1Ouvrir Paramètres → Application de bureau
- 2Saisir l’adresse du serveur, par ex. https://musique.mon-vps.fr
- 3Valider et se connecter avec les mêmes identifiants qu’en ligne
- 4Vérifier que les playlists, l’historique et les réglages sont synchronisés
En images
Astuces
- Utilisez les raccourcis clavier (Espace = Lecture/Pause, N = Suivant, B = Précédent) pour contrôler la musique sans souris.
- Le mode « Lecture réduite » (touche I) reste visible pendant la navigation dans l’application.
- En version portable Windows, supprimez le dossier ForgeAudio-data pour réinitialiser toutes les données locales.
Questions fréquentes
Pourquoi la musique s’arrête‑t‑elle quand je ferme l’onglet du navigateur ?
Le lecteur web dépend de la page active ; fermer l’onglet interrompt le flux. Utilisez l’application de bureau ou mobile pour une lecture en arrière‑plan.
Comment mettre à jour Forge Audio sur Linux ?
Téléchargez la nouvelle version du fichier .deb, .rpm ou .AppImage et réinstallez‑la de la même façon que l’installation initiale.
L’application ne trouve‑t‑elle pas certaines vidéos ?
Forge Audio utilise yt‑dlp qui supporte plus de 1 000 sites. Si un titre ne fonctionne pas, vérifiez que le lien est valide ou essayez une autre source.
Puis‑je désactiver le téléchargement automatique de yt‑dlp ?
Oui, dans Paramètres → Avancé, décochez « Mettre à jour yt‑dlp automatiquement ». Vous devrez alors mettre à jour manuellement le binaire.
Tutoriel rédigé automatiquement à partir de la documentation du projet, mis à jour à chaque évolution.
