Skip to content

Commit 30b35d0

Browse files
committed
fix: resolve desktop launcher issue and add comprehensive troubleshooting guide
- Fix missing executable by reinstalling with pip install -e . - Reinstall desktop integration with proper file paths - Update desktop database and icon cache - Add detailed troubleshooting guide for future issues - Document alternative solutions for persistent problems - Provide step-by-step diagnosis commands
1 parent 7f6694d commit 30b35d0

1 file changed

Lines changed: 114 additions & 0 deletions

File tree

‎DESKTOP_LAUNCHER_FIX.md‎

Lines changed: 114 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,114 @@
1+
# 🔧 Desktop Launcher Fix
2+
3+
## Problem
4+
Die Anwendung lässt sich nicht über das Startmenü starten:
5+
```
6+
Fehlermeldung: Programm „/home/marci/.local/bin/bash-script-maker" ist nicht auffindbar
7+
```
8+
9+
## Lösung - Schritt für Schritt
10+
11+
### 1. ✅ App korrekt installieren
12+
```bash
13+
cd /home/marci/Code/Bash-Script-Maker
14+
pip install -e .
15+
```
16+
17+
### 2. ✅ Prüfen ob ausführbare Datei existiert
18+
```bash
19+
ls -la ~/.local/bin/bash-script-maker
20+
# Sollte anzeigen: -rwxr-xr-x. 1 marci marci 219 ... bash-script-maker
21+
```
22+
23+
### 3. ✅ Desktop-Integration installieren
24+
```bash
25+
./install_desktop_integration.sh
26+
```
27+
28+
### 4. ✅ Desktop-Datenbank aktualisieren
29+
```bash
30+
update-desktop-database ~/.local/share/applications
31+
gtk-update-icon-cache ~/.local/share/icons/hicolor/ --ignore-theme-index
32+
```
33+
34+
### 5. 🔄 Desktop-Umgebung neu starten
35+
```bash
36+
# GNOME/KDE/XFCE neu starten oder
37+
# Abmelden und wieder anmelden
38+
```
39+
40+
## Diagnose-Befehle
41+
42+
### Prüfe Installation:
43+
```bash
44+
which bash-script-maker
45+
~/.local/bin/bash-script-maker --version
46+
```
47+
48+
### Prüfe Desktop-Datei:
49+
```bash
50+
cat ~/.local/share/applications/bash-script-maker.desktop
51+
desktop-file-validate ~/.local/share/applications/bash-script-maker.desktop
52+
```
53+
54+
### Prüfe Icons:
55+
```bash
56+
ls ~/.local/share/icons/hicolor/*/apps/bash-script-maker.*
57+
```
58+
59+
### Prüfe PATH:
60+
```bash
61+
echo $PATH | grep -o '/home/marci/.local/bin'
62+
```
63+
64+
## Alternative Lösungen
65+
66+
### Wenn das Problem weiterhin besteht:
67+
68+
#### Option 1: Absolute Pfade in Desktop-Datei
69+
```bash
70+
# Desktop-Datei bearbeiten
71+
sed -i 's|Icon=bash-script-maker|Icon=/home/marci/.local/share/icons/hicolor/scalable/apps/bash-script-maker.svg|' ~/.local/share/applications/bash-script-maker.desktop
72+
```
73+
74+
#### Option 2: System-weite Installation
75+
```bash
76+
sudo pip install -e .
77+
# Dann Desktop-Integration mit sudo ausführen
78+
```
79+
80+
#### Option 3: Desktop-Datei manuell erstellen
81+
```bash
82+
cat > ~/.local/share/applications/bash-script-maker.desktop << 'EOF'
83+
[Desktop Entry]
84+
Name=Bash-Script-Maker
85+
Comment=Ein GUI-Programm zur Erstellung von Bash-Scripts
86+
Exec=/home/marci/.local/bin/bash-script-maker
87+
Icon=/home/marci/.local/share/icons/hicolor/48x48/apps/bash-script-maker.png
88+
Terminal=false
89+
Type=Application
90+
Categories=Development;Utility;TextEditor;
91+
Keywords=bash;script;editor;generator;development;
92+
StartupWMClass=bash-script-maker
93+
MimeType=text/x-shellscript;application/x-shellscript;
94+
EOF
95+
96+
chmod +x ~/.local/share/applications/bash-script-maker.desktop
97+
update-desktop-database ~/.local/share/applications
98+
```
99+
100+
## Status nach Fix
101+
102+
- ✅ App installiert: v1.9.0
103+
- ✅ Ausführbare Datei: `/home/marci/.local/bin/bash-script-maker`
104+
- ✅ Desktop-Datei: `~/.local/share/applications/bash-script-maker.desktop`
105+
- ✅ Icons installiert: Verschiedene Größen
106+
- ✅ Desktop-Datenbank aktualisiert
107+
108+
## Test
109+
```bash
110+
# Terminal-Start (sollte funktionieren):
111+
bash-script-maker
112+
113+
# Desktop-Start: Über Anwendungsmenü testen
114+
```

0 commit comments

Comments
 (0)