FAQ

FAQ et Dépannage

Bienvenue dans la section dédiée aux questions fréquentes et aux problèmes rencontrés avec Mxlw Browser.

---

Questions fréquentes (FAQ)

❓ Pourquoi la fenêtre ne s’ouvre pas ?

Cela peut venir de :

• Un fichier manquant (ex : home.html)
• Un chemin incorrect dans main.js ou settings.json
• Une erreur Electron : vérifiez le terminal avec npm start

---

❓ Mon thème sombre ne fonctionne pas

Vérifie que dans settings.json le thème est bien défini :

"theme": "dark"

Assure-toi que la logique de style est bien liée à la classe ou au data-theme dans le HTML (

).

❓ Le navigateur n’ouvre pas les liens dans un nouvel onglet

Mxlw Browser est conçu pour bloquer les fenêtres pop-up. Les liens avec target="_blank" sont interceptés et redirigés dans l’onglet actuel. Cette sécurité est voulue, mais peut être désactivée manuellement dans le code si besoin.

❓ Où sont stockés les paramètres ?

Dans le fichier local : settings.json Ce fichier est généré automatiquement au premier lancement.

❓ Le navigateur ne se lance pas après un npm start

Voici les vérifications à faire :

1. Avez-vous installé les dépendances ?

   
   
   npm install
   
   

2. Le fichier home.html est-il présent dans renderer/ ?

3. Lancez avec des logs :

   
   
   electron . --trace-warnings
   
   

4. Essayez un clean install :

   
   
   rm -rf node_modules package-lock.json
   npm install
   
   

---

Dépannage rapide

Problème | Solution -- | -- ERR_FILE_NOT_FOUND | Vérifiez que le fichier HTML visé existe et que le chemin est correct Fichier .AppImage ne se lance pas | Lancer avec chmod +x puis ./Mxlw\ Browser.AppImage electron: not found | Refaire npm install dans le dossier du projet Page blanche au lancement | Ouvrir la console devtools avec Ctrl+Shift+I pour inspecter les erreurs Problèmes CSS/JS non appliqués | Vérifiez les chemins relatifs dans home.html

---

Contacter le support ou remonter un bug

Si tu rencontres un problème qui n'est pas listé ici :

1. Crée une issue sur GitHub

2. Donne un maximum d’informations :

   • OS utilisé

   • Version de Node.js / Electron

   • Message d’erreur complet

   • Étapes pour reproduire le bug

---

Besoin d’aide personnalisée ?

Tu peux aussi :

• Contacter Maxlware

• Ouvrir une discussion via GitHub Discussions (à activer dans le repo)

• Ou demander une assistance via un canal Discord ou Matrix (optionnel à créer)

---

Envie de contribuer à corriger ces problèmes ?

Consulte la page Contribuer pour aider à l’amélioration du navigateur.

❓ Le navigateur ne se lance pas après un npm start

Voici les vérifications à faire :

Avez-vous installé les dépendances ?

npm install

Le fichier home.html est-il présent dans renderer/ ?

Lancez avec des logs :

electron . --trace-warnings

Essayez un clean install :

rm -rf node_modules package-lock.json npm install

Dépannage rapide Problème Solution ERR_FILE_NOT_FOUND Vérifiez que le fichier HTML visé existe et que le chemin est correct Fichier .AppImage ne se lance pas Lancer avec chmod +x puis ./Mxlw\ Browser.AppImage electron: not found Refaire npm install dans le dossier du projet Page blanche au lancement Ouvrir la console devtools avec Ctrl+Shift+I pour inspecter les erreurs Problèmes CSS/JS non appliqués Vérifiez les chemins relatifs dans home.html Contacter le support ou remonter un bug

Si tu rencontres un problème qui n'est pas listé ici :

Crée une issue sur GitHub

Donne un maximum d’informations :

OS utilisé

Version de Node.js / Electron

Message d’erreur complet

Étapes pour reproduire le bug

Besoin d’aide personnalisée ?

Tu peux aussi :

Contacter Maxlware

Ouvrir une discussion via GitHub Discussions (à activer dans le repo)

Ou demander une assistance via un canal Discord ou Matrix (optionnel à créer)

Envie de contribuer à corriger ces problèmes ?

Consulte la page Contribuer pour aider à l’amélioration du navigateur.