AppImage to Desktop - Script d'intégration Linux

Un script Bash simple et efficace pour intégrer automatiquement vos fichiers AppImage dans le menu d'applications de votre environnement de bureau Linux.

🚀 Fonctionnalités

• Intégration automatique : Ajoute vos AppImages au menu d'applications
• Extraction d'icônes : Extrait automatiquement l'icône de l'AppImage ou permet d'utiliser une icône personnalisée
• Gestion des doublons : Vérifie l'existence d'entrées existantes et propose de les remplacer
• Organisation propre : Place les fichiers aux bons endroits selon les standards Linux
• Interface interactive : Interface en ligne de commande simple et claire

📋 Prérequis

• Un système Linux avec Bash
• Permissions d'écriture dans votre répertoire home
• Le fichier AppImage doit être exécutable

🔧 Installation

1. Clonez ce dépôt ou téléchargez le script :

   git clone https://github.com/Amedon-Roland/appimage-to-desktop-linux.git
   cd appimage-to-desktop-linux

2. Rendez le script exécutable :

   chmod +x appimage-to-desktop-linux.sh

📖 Utilisation

1. Exécutez le script :

   ./appimage-to-desktop-linux.sh

2. Suivez les instructions interactives :

   • Entrez le chemin complet vers votre fichier .AppImage
   • (Optionnel) Spécifiez un chemin vers une icône personnalisée
   • Confirmez ou annulez si une entrée existe déjà

3. Votre application sera disponible dans le menu d'applications de votre environnement de bureau !

📁 Structure des fichiers créés

Le script organise vos fichiers selon les standards FreeDesktop :

~/.local/share/applications/    # Fichiers .desktop
~/.local/share/icons/          # Icônes extraites ou personnalisées
~/Applications/                # Liens symboliques vers les AppImages

🖼️ Gestion des icônes

Le script propose deux options pour les icônes :

1. Extraction automatique : Le script tente d'extraire l'icône de l'AppImage (priorité aux résolutions 512x512 et 256x256)
2. Icône personnalisée : Vous pouvez spécifier le chemin vers votre propre icône (PNG ou SVG)

⚙️ Fonctionnement technique

1. Validation : Vérification de l'existence du fichier AppImage
2. Détection des doublons : Contrôle si une entrée existe déjà
3. Extraction d'icône : Utilisation de --appimage-extract pour récupérer l'icône
4. Création du .desktop : Génération du fichier de raccourci selon les standards
5. Lien symbolique : Création d'un lien dans ~/Applications pour un accès facile

🔍 Exemple d'utilisation

$ ./appimage-to-desktop-linux.sh
📦 Entrez le chemin complet vers le fichier .AppImage (copier-coller possible) :
/home/user/Downloads/MonApp-1.2.3-x86_64.AppImage

🖼️ Entrez le chemin complet vers une icône (PNG/SVG), ou appuyez sur Entrée pour essayer d'extraire automatiquement :
[Appuyez sur Entrée]

✅ Application 'MonApp-1.2.3-x86_64' ajoutée au menu avec succès !

🛠️ Dépannage

L'application n'apparaît pas dans le menu

• Déconnectez-vous et reconnectez-vous
• Ou redémarrez votre environnement de bureau
• Vérifiez que le fichier .desktop a été créé dans ~/.local/share/applications/

Erreur de permissions

• Assurez-vous que l'AppImage est exécutable : chmod +x votre-appimage.AppImage
• Vérifiez les permissions d'écriture dans votre répertoire home

L'icône ne s'affiche pas

• Essayez avec une icône personnalisée
• Vérifiez que l'icône est bien copiée dans ~/.local/share/icons/

🤝 Contribution

Les contributions sont les bienvenues ! N'hésitez pas à :

• Signaler des bugs
• Proposer des améliorations
• Soumettre des pull requests

📄 Licence

Ce projet est sous licence MIT. Voir le fichier LICENSE pour plus de détails.

⭐ Remerciements

Merci à la communauté AppImage pour ce format d'application portable et pratique !

---

Développé par RolandTech 🔧

Si ce script vous a été utile, n'hésitez pas à lui donner une étoile ⭐