pdf_to_ics/INSTALL.md

📦 Installation - PDF zu ICS Konverter

Eine einfache Installation für Linux-Systeme, die die Anwendung in Ihr Anwendungsmenü integriert.

🚀 Schnell-Installation

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

pdf-to-ics

3. Über den vollständigen Pfad

~/.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

~/.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:

sudo apt-get install python3-tk

Fedora:

sudo dnf install python3-tkinter

Arch Linux:

sudo pacman -S tk

"pdf-to-ics: Befehl nicht gefunden"

Ihr ~/.local/bin ist nicht im PATH. Fügen Sie zu ~/.bashrc hinzu:

export PATH="$HOME/.local/bin:$PATH"

Dann Terminal neu laden:

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:

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:

update-desktop-database ~/.local/share/applications

Oder melden Sie sich ab und wieder an.

🔄 Update

Um auf eine neue Version zu aktualisieren:

# 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:

./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! 📅✨