Vorne dabei

Browser OS Anwenderhandbuch

Start von der Festplatte, Funktionen im Desktop, Cloud-Katalog, Netzwerk & Sync, eigene WordPress-Cloud.

Stand: August 2026 · Projekt-Domains: BrowserOS https://os.vorne.at · Cloud https://www.vorne.at

1. Was ist BrowserOS?

BrowserOS ist ein Desktop im Browser: Fenster, Startmenü, Dateimanager, Apps – speichert lokal im Browser (IndexedDB) und kann optional mit einer WordPress-Cloud synchronisieren.

• Offline nutzbar (nach dem Laden der Seite)

• HTML-Apps installieren und selbst erstellen

• Cloud-Katalog für öffentliche Apps

• Sync von Einstellungen, Dateien und Apps über WordPress

2. Schnellstart – von der Festplatte

2.1 Entpacken und starten

  1. ZIP oder Projektordner browser-os auf den PC entpacken.
  2. Datei index.html mit einem aktuellen Browser öffnen (Chrome, Firefox, Edge, Safari).
  3. Desktop erscheint – Dateimanager, App-Verwaltung und Systemsteuerung über Startmenü oder Desktop-Icons.

Hinweis: Für Cloud, Katalog und manche Editor-Apps (PDF, ZIP) wird eine Internetverbindung benötigt. Rein lokal funktioniert der Desktop auch offline.

2.2 Online starten (Projekt)

Öffentliche Instanz (Beispiel): https://os.vorne.at

Die Cloud-API (Sync, Katalog) liegt typischerweise auf einer WordPress-Site, z. B. https://www.vorne.at – nicht zwingend auf derselben Domain wie der Desktop.

3. Wichtige Funktionen im Desktop

3.1 Dateimanager

• Dateien und Ordner im virtuellen Dateisystem (/home/user, …)

• Upload/Download von der echten Festplatte

• Kopieren, Einfügen, Papierkorb, Drag & Drop

• Rechtsklick auf HTML/Ordner: Im Browser öffnen, als App starten, als App installieren

3.2 App-Verwaltung

• Lokale Apps installieren: HTML oder Ordner vom PC oder aus dem BrowserOS-Dateisystem

• Cloud-Katalog: öffentliche Apps von einer WordPress-Site laden

• Code-Editor für installierte HTML-Apps (Benutzer-Apps)

3.3 Systemsteuerung

• Darstellung, Sprache, Dateitypen

• Netzwerk: Status und Cloud-Katalog-URL

• Verknüpfung zu Netzwerk & Sync

3.4 Weitere System-Apps

• Browser, Text-Editor, Terminal, Bildschirmverwaltung, Menümanager

• Beispiel-Apps: Foto-Studio, GIMP Lite, PDF-Editor, KI-Studio, Forum (optional)

4. Cloud-Katalog

Der Cloud-Katalog listet freigegebene HTML-Apps von einer WordPress-Site mit dem Plugin BrowserOS Sync. Öffentliche Apps brauchen oft kein Login; private Pakete erfordern Benutzer und Application Password.

4.1 Katalog-Domain einstellen

• Systemsteuerung → Netzwerk → Cloud-Katalog, oder

• Netzwerk & Sync → Zeile „Katalog“, oder

• App-Verwaltung → Cloud-Katalog → Katalog-Site

Muster (Projekt): https://www.vorne.at

Gespeichert wird die URL unter /system/catalog.json im BrowserOS-Dateisystem.

4.2 Apps installieren

  1. App-Verwaltung öffnen → Reiter Cloud-Katalog.
  2. Katalog aktualisieren, App wählen → Installieren.
  3. App erscheint lokal und ist über das Startmenü startbar.

Wichtig: Apps aus dem Katalog laufen in einer Sandbox. Installieren Sie nur vertrauenswürdige Quellen.

5. Netzwerk & manuelles JSON

5.1 Netzwerk-App öffnen

Startmenü → Netzwerk & Sync (oder Systemsteuerung → Netzwerk → Netzwerk & Sync öffnen).

5.2 Lokal als JSON speichern / laden

Ohne WordPress können Sie den kompletten Zustand als JSON-Archiv sichern:

• Neue Verbindung vom Typ JSON-Archiv anlegen, oder

• In einer bestehenden Ansicht „lokal speichern“ / Archiv nutzen

Das JSON enthält je nach Optionen Desktop, Menü, Einstellungen, Dateisystem und Apps (schlank ohne großen App-HTML-Inhalt möglich).

5.3 WordPress-Verbindung anlegen

  1. + Verbindung → WordPress wählen.
  2. Name vergeben (z. B. „meine-cloud“).
  3. Site-URL: https://www.vorne.at (oder Ihre eigene WordPress-Adresse) – mit https://.
  4. Benutzername (WordPress-Login) und Application Password eintragen.
  5. „Verbindung testen“ – erwartet OK und Ihren Benutzernamen.

Wichtig: Application Password ohne Leerzeichen eintragen. WordPress zeigt das Passwort oft in Blöcken an – alle Leerzeichen entfernen.

6. Synchronisieren

6.1 Manuell

• In die Cloud speichern: aktueller Stand wird auf dem Server abgelegt

• Aus der Cloud laden: Stand vom Server überschreibt lokale Daten (mit Rückfrage)

6.2 Automatisch (Master / Slave)

• Auto-Sync aktivieren und Rolle wählen: Manuell, Slave (nur laden), Master (nur speichern)

• Intervall in Minuten einstellen

• Ob Auto-Sync erlaubt ist, steuert der Cloud-Admin in WordPress (Sync-Policy)

Hinweis: Master und Slave gleichzeitig auf derselben Verbindung vermeiden Konflikte – klar festlegen, welches Gerät die „Wahrheit“ schreibt.

7. Eigene Cloud mit WordPress einrichten

7.1 Voraussetzungen

• WordPress 6+ mit HTTPS

• Plugin BrowserOS Sync (Ordner browseros-sync)

• Permalink-Struktur „Beitragsname“

7.2 Permalinks – zwingend

  1. WordPress-Admin → Einstellungen → Permalinks.
  2. „Beitragsname“ aktivieren und speichern.

Wichtig: Ohne passende Permalinks liefert die REST-API oft „Es wurde keine Route gefunden…“. Dann sind Sync und Cloud-Katalog unmöglich.

7.3 Plugin installieren

  1. Plugin-ZIP entpacken. Der Ordner muss browseros-sync heißen.
  2. Nach wp-content/plugins/browseros-sync/ hochladen und aktivieren.
  3. Erneut Permalinks speichern.
  4. Test: https://IHRE-DOMAIN/wp-json/browseros/v1/ping – muss JSON mit ok: true liefern.

7.4 Wordfence und Application Passwords

Bei Neuinstallation mit Wordfence (und ähnlichen Security-Plugins) kann Folgendes die Cloud blockieren:

• Wordfence → All Options → Firewall / Brute Force

• Option „Passwörter für WordPress-Anwendungen“ / Application Passwords deaktivieren oder blockieren

Wichtig: Wenn Application Passwords durch Wordfence (oder ein anderes Security-Plugin) deaktiviert oder blockiert sind, ist keine Benutzerverbindung aus BrowserOS möglich. Damit entfallen Sync und authentifizierter Cloud-Katalog.

Lösung: Application Passwords in WordPress und Wordfence erlauben. Anschließend unter Benutzer → Profil ein Anwendungspasswort erzeugen.

7.5 Benutzer und Application Password

• WordPress-Benutzer anlegen oder bestehenden nutzen

• Profil → Anwendungspasswörter → Name vergeben (z. B. „BrowserOS“) → Hinzufügen

• Angezeigtes Passwort kopieren und alle Leerzeichen entfernen

• In BrowserOS unter Netzwerk als „Application Password“ eintragen

7.6 Verwaltung in WordPress

• Menü BrowserOS Sync / zugehörige Inhaltstypen: Speicher-Snapshots, App-Pakete

• Sync-Policy: global und pro Benutzer, ob Auto-Sync, Master/Slave erlaubt sind

• Öffentliche Freigabe von Apps im Katalog nur durch berechtigte Admins

Empfohlene Test-URL nach der Einrichtung:

https://www.vorne.at/wp-json/browseros/v1/ping

8. Typische Fehler und Lösungen

CORS / Netzwerkfehler beim Ping

• Plugin-Version aktuell? CORS ist im Plugin enthalten

• Site-URL mit https:// angeben

• BrowserOS und WordPress auf derselben Domain: Directory-Schutz kann Authorization stören – Plugin ab 0.1.10 nutzt zusätzliche Header

ok: true, aber kein User

• Application Password falsch oder mit Leerzeichen

• HTTPS fehlt

• Wordfence / Security blockiert Application Passwords

Keine Route gefunden

• Permalink „Beitragsname“ speichern

• Plugin aktiv und Ordnername browseros-sync

• REST-API erreichbar? /wp-json/ im Browser öffnen

Katalog leer

• Katalog-URL prüfen (z. B. www.vorne.at)

• Auf der WordPress-Seite öffentliche Pakete freigegeben?

9. Kurz-Checkliste eigene Cloud

• WordPress mit HTTPS

• Permalink Beitragsname

• Plugin BrowserOS Sync aktiv

• /wp-json/browseros/v1/ping liefert JSON

• Wordfence: Application Passwords erlaubt

• Benutzer + Application Password (ohne Leerzeichen)

• In BrowserOS Verbindung testen → User sichtbar

• Katalog-URL gesetzt; bei Bedarf Sync manuell oder Auto-Sync

10. Projekt-Referenz

BrowserOS-Desktop (Beispiel): https://os.vorne.at

WordPress-Cloud / Katalog (Beispiel): https://www.vorne.at

Andere Betreiber können dasselbe Plugin auf der eigenen Domain nutzen und in BrowserOS als Katalog- bzw. Sync-URL eintragen.

Ende des Anwenderhandbuchs. Bei API-Änderungen Plugin-Version und diese Doku gemeinsam aktualisieren.