172 lines
4.1 KiB
Markdown
172 lines
4.1 KiB
Markdown
# 📦 Installation - PDF zu ICS Konverter
|
|
|
|
Eine einfache Installation für Linux-Systeme, die die Anwendung in Ihr Anwendungsmenü integriert.
|
|
|
|
## 🚀 Schnell-Installation
|
|
|
|
```bash
|
|
chmod +x install.sh
|
|
./install.sh
|
|
```
|
|
|
|
Das war's! Die Anwendung erscheint nun in Ihrem Anwendungsmenü unter "PDF zu ICS Konverter".
|
|
|
|
## 📋 Was macht das Installations-Script?
|
|
|
|
1. ✅ **Prüft Python-Installation** (Python 3.6+)
|
|
2. ✅ **Installiert Tkinter** falls nötig (mit sudo-Berechtigung)
|
|
3. ✅ **Erstellt Installationsverzeichnis** in `~/.local/share/pdf-to-ics`
|
|
4. ✅ **Kopiert alle Dateien** ins Installationsverzeichnis
|
|
5. ✅ **Erstellt Python Virtual Environment** mit allen Abhängigkeiten
|
|
6. ✅ **Erstellt Desktop-Verknüpfung** für das Anwendungsmenü
|
|
7. ✅ **Erstellt Launcher-Script** in `~/.local/bin/pdf-to-ics`
|
|
|
|
## 🎯 Nach der Installation
|
|
|
|
Die Anwendung starten Sie auf drei Arten:
|
|
|
|
### 1. Über das Anwendungsmenü (Empfohlen)
|
|
- Öffnen Sie Ihr Anwendungsmenü (z.B. GNOME Activities, KDE Application Launcher)
|
|
- Suchen Sie nach "PDF zu ICS"
|
|
- Klicken Sie auf das Icon
|
|
|
|
### 2. Über die Kommandozeile
|
|
```bash
|
|
pdf-to-ics
|
|
```
|
|
|
|
### 3. Über den vollständigen Pfad
|
|
```bash
|
|
~/.local/bin/pdf-to-ics
|
|
```
|
|
|
|
## 🔧 Systemanforderungen
|
|
|
|
### Unterstützte Distributionen:
|
|
- ✅ Ubuntu / Debian (automatische Tkinter-Installation)
|
|
- ✅ Fedora / RHEL (automatische Tkinter-Installation)
|
|
- ✅ Arch Linux (automatische Tkinter-Installation)
|
|
- ✅ Andere Distributionen (manuelle Tkinter-Installation erforderlich)
|
|
|
|
### Voraussetzungen:
|
|
- Python 3.6 oder höher
|
|
- `sudo`-Berechtigung (für Tkinter-Installation)
|
|
- Etwa 50 MB Festplattenspeicher
|
|
|
|
## 📁 Installations-Pfade
|
|
|
|
```
|
|
~/.local/share/pdf-to-ics/ # Hauptinstallation
|
|
~/.local/bin/pdf-to-ics # Launcher-Script
|
|
~/.local/share/applications/ # Desktop-Verknüpfung
|
|
~/.pdf_to_ics_config.json # Benutzer-Einstellungen
|
|
```
|
|
|
|
## 🗑️ Deinstallation
|
|
|
|
```bash
|
|
~/.local/share/pdf-to-ics/uninstall.sh
|
|
```
|
|
|
|
Das Deinstallations-Script entfernt:
|
|
- ✅ Installationsverzeichnis
|
|
- ✅ Desktop-Verknüpfung
|
|
- ✅ Launcher-Script
|
|
- ⚠️ Konfigurationsdatei (optional)
|
|
|
|
## ⚠️ Fehlerbehebung
|
|
|
|
### "Tkinter ist nicht installiert"
|
|
|
|
**Ubuntu/Debian:**
|
|
```bash
|
|
sudo apt-get install python3-tk
|
|
```
|
|
|
|
**Fedora:**
|
|
```bash
|
|
sudo dnf install python3-tkinter
|
|
```
|
|
|
|
**Arch Linux:**
|
|
```bash
|
|
sudo pacman -S tk
|
|
```
|
|
|
|
### "pdf-to-ics: Befehl nicht gefunden"
|
|
|
|
Ihr `~/.local/bin` ist nicht im PATH. Fügen Sie zu `~/.bashrc` hinzu:
|
|
|
|
```bash
|
|
export PATH="$HOME/.local/bin:$PATH"
|
|
```
|
|
|
|
Dann Terminal neu laden:
|
|
```bash
|
|
source ~/.bashrc
|
|
```
|
|
|
|
### Windows: "python" oder "python3" wurde nicht gefunden
|
|
|
|
1. Installieren Sie Python 3.10+ von python.org und aktivieren Sie beim Setup **"Add Python to PATH"**.
|
|
2. Öffnen Sie danach eine neue Eingabeaufforderung im Projektordner.
|
|
3. Führen Sie aus:
|
|
|
|
```bat
|
|
py -3 -m venv .venv --upgrade-deps
|
|
.\.venv\Scripts\python.exe -m pip install -q pdfplumber icalendar pypdf2 pytz packaging
|
|
.\.venv\Scripts\pythonw.exe gui.py
|
|
```
|
|
|
|
### Anwendung erscheint nicht im Menü
|
|
|
|
Aktualisieren Sie die Desktop-Datenbank:
|
|
```bash
|
|
update-desktop-database ~/.local/share/applications
|
|
```
|
|
|
|
Oder melden Sie sich ab und wieder an.
|
|
|
|
## 🔄 Update
|
|
|
|
Um auf eine neue Version zu aktualisieren:
|
|
|
|
```bash
|
|
# 1. Deinstallieren
|
|
~/.local/share/pdf-to-ics/uninstall.sh
|
|
|
|
# 2. Neue Version herunterladen
|
|
cd /pfad/zur/neuen/version
|
|
|
|
# 3. Neu installieren
|
|
./install.sh
|
|
```
|
|
|
|
## 💡 Entwickler-Modus
|
|
|
|
Wenn Sie an der Anwendung entwickeln möchten, nutzen Sie stattdessen:
|
|
|
|
```bash
|
|
./start_gui.sh # Startet aus dem aktuellen Verzeichnis
|
|
```
|
|
|
|
Die Installation ist nur für End-Benutzer gedacht.
|
|
|
|
## 🐧 Andere Betriebssysteme
|
|
|
|
- **Windows:** Nutzen Sie `start_gui.cmd` (Python 3.10+ erforderlich, Einrichtung beim ersten Start erfolgt automatisch)
|
|
- **macOS:** Nutzen Sie `start_gui.sh` (keine Installation nötig)
|
|
|
|
## 📞 Support
|
|
|
|
Bei Problemen während der Installation:
|
|
|
|
1. Prüfen Sie die Systemanforderungen
|
|
2. Lesen Sie die Fehlermeldungen sorgfältig
|
|
3. Konsultieren Sie die README.md
|
|
4. Öffnen Sie ein Issue im Repository
|
|
|
|
---
|
|
|
|
**Installation erfolgreich?** Viel Spaß beim Konvertieren Ihrer Dienstpläne! 📅✨
|