====== GuideOS GuideOSBookHub ======

===== Übersicht =====
{{ :guideosbookhub-home.png?300|}}
**GuideOSBookHub** ist eine PyQt6-Desktop-Anwendung zum Synchronisieren von Browser-Lesezeichen über Cloud-Speicher oder einen USB-Stick unter Linux.

===== Zweck =====

GuideOSBookHub ist bewusst **kein** Lesezeichen-Editor – Anlegen, Ändern und Löschen einzelner Lesezeichen bleibt dort, wo es hingehört: im Browser selbst. Die App übernimmt nur drei Dinge:

  - **Import** – liest Lesezeichen automatisch direkt aus dem Browser-Profil (kein manueller Export nötig)
  - **Cloud-/Stick-Sync** – hält sie über eine frei wählbare Cloud oder einen USB-Stick zwischen mehreren Geräten synchron
  - **Rück-Export** – schreibt den synchronisierten Bestand bei Bedarf in einen (auch anderen) Browser zurück

===== Unterstützte Browser =====

^ Browser ^ Import-Methode ^
| **Vivaldi, Google Chrome, Chromium, Brave, Microsoft Edge, Opera** | Automatisch (Standard-Profilpfad) |
| **Firefox / sonstige** | Manueller HTML-Export als Fallback |

===== Unterstützte Cloud-Anbieter =====

Cloud-Sync-Assistent direkt in der App, keine Terminal-Kenntnisse nötig:

<WRAP round info 70%>
  * WebDAV / Nextcloud / ownCloud
  * Proton Drive
  * Google Drive
  * Microsoft OneDrive
  * Dropbox
  * pCloud
  * Lokaler Ordner / USB-Stick (kein Cloud-Konto nötig)
</WRAP>

===== Bedienung =====

==== Programm starten ====

''guideosbookhub''

Oder aus dem Anwendungsmenü.

{{:0:home.png?400|}}
==== Erste Schritte ====

  - **Browser wählen** – Lesezeichen werden automatisch gefunden und importiert
  - **Cloud- oder Stick-Sync einrichten** (optional, jederzeit später über die Startseite nachholbar) – Anbieter auswählen, Zugangsdaten eingeben oder im Browser anmelden

{{ :guideosbookhub-cloud-sync.png?300|}}

{{:0:cloud-sync-setup.png?400|}}

==== Sync und Rück-Export ====

  - Automatischer und manueller Sync läuft im Hintergrund-Thread (blockiert die Oberfläche nicht)
  - Zwei-Wege-Sync mit Konfliktlösung (neuere Änderung gewinnt), Löschungen werden über Tombstones nachvollzogen
  - Rück-Export in den Browser mit drei wählbaren Strategien: Zusammenführen, in einen gesonderten Ordner, oder komplettes Ersetzen – mit Sicherheitsabfrage, ob der Ziel-Browser wirklich geschlossen ist
  - Mehrere unabhängige Sync-Profile gleichzeitig möglich (z. B. "Arbeit" → Nextcloud, "Privat" → Proton Drive)

===== Installation =====

^ Format ^ Bringt rclone mit ^ Geeignet für ^
| ''.deb'' | – (Empfehlung) | Native apt-Integration (Debian/Ubuntu/GuideOS) |
| AppImage | ja | Einzelne Datei, kein Root nötig |
| Flatpak | ja (im Sandbox) | Saubere Desktop-Integration |
| pip/pipx | – | Entwicklung, volle Kontrolle |

Fertige Pakete stehen bei jedem Versions-Tag automatisch zum Download bereit:

[[https://github.com/Stephan-Lefty/GuideOSBookHub/releases|github.com/Stephan-Lefty/GuideOSBookHub/releases]]

<code bash>
sudo apt install ./guideosbookhub_0.1.0_all.deb
</code>

===== Wichtige Hinweise =====

<WRAP round important 90%>
  * ''rclone'' ist nur als Empfehlung eingetragen, nicht als harte Abhängigkeit – fehlt es, bietet die App selbst eine Installation per Dialog an
  * Kein Locking auf rclone-Ebene: synchronisieren zwei Geräte im selben Sekundenfenster, gewinnt der zuletzt schreibende Push
  * JottaCloud und iCloud Drive sind im Einrichtungs-Assistenten bewusst nicht abgedeckt, funktionieren aber weiterhin über manuell per ''rclone config'' eingerichtete Remotes
</WRAP>

===== Lizenz =====

| **Autor** | Stephan R. |
| **Quellcode** | [[https://github.com/Stephan-Lefty/GuideOSBookHub|github.com/Stephan-Lefty/GuideOSBookHub]] |
| **Lizenz** | GPL-3.0-or-later |