Selene Plugin API

Übersicht SelenePlugin Storage DOM HTTP Page Logging SeleneBridge Tabs Bookmarks History Settings Theme Notifications Manifest Vollständiges Beispiel

⚠ Wichtiger Hinweis: SeleneBridge wird über QWebChannel geladen und ist nicht sofort verfügbar. Verwende den waitForBridge Pattern:

SelenePlugin.dom.ready(function() {
  function waitForBridge(callback) {
    if (window.SeleneBridge) {
      callback();
    } else {
      setTimeout(function() { waitForBridge(callback); }, 50);
    }
  }
  waitForBridge(function() {
    var info = SeleneBridge.browserInfo();
    console.log(info.name, info.version);
  });
});

1.1 Storage — Persistenter Key-Value Store

Plugin-spezifischer Storage, isoliert von anderen Plugins und der Website.

// Wert speichern
SelenePlugin.storage.set('darkMode', 'true');

// Wert lesen
var value = SelenePlugin.storage.get('darkMode'); // → "true" oder null

// Wert löschen
SelenePlugin.storage.remove('darkMode');

// Alle Keys auflisten
var keys = SelenePlugin.storage.keys(); // → ["darkMode", "fontSize", ...]

Bereich: localStorage mit Prefix selene_plugin_ — isoliert pro Plugin.

1.2 DOM — DOM-Manipulation

// Warten bis DOM bereit ist
SelenePlugin.dom.ready(function() {
  // Code läuft wenn DOM geladen ist
});

// CSS injizieren
SelenePlugin.dom.addStyle('body { background: #0a0a1a !important; }');

// Externes Script laden
SelenePlugin.dom.injectScript('https://cdn.example.com/lib.js');

// Auf Element warten (pollt bis es erscheint)
SelenePlugin.dom.waitFor('.player-container', function(el) {
  console.log('Player gefunden:', el);
}, 15000); // Timeout: 15 Sekunden (default: 10s)

1.3 HTTP — Netzwerk-Anfragen

// Text herunterladen
SelenePlugin.http.get('https://api.example.com/data', function(err, text) {
  if (err) { SelenePlugin.error('HTTP Fehler: ' + err); return; }
  console.log('Antwort:', text);
});

// JSON herunterladen
SelenePlugin.http.getJSON('https://api.example.com/data', function(err, data) {
  if (err) { SelenePlugin.error('JSON Fehler: ' + err); return; }
  console.log('Daten:', data);
});

1.4 Page — Seiten-Informationen

var url    = SelenePlugin.page.url;     // "https://www.youtube.com/watch?v=..."
var domain = SelenePlugin.page.domain;  // "www.youtube.com"
var title  = SelenePlugin.page.title;   // "Video Title - YouTube"

1.5 Logging — Konsolen-Ausgabe

SelenePlugin.log('Normale Nachricht');
SelenePlugin.warn('Warnung!');
SelenePlugin.error('Fehler!');

Erscheint im Browser-Log mit Prefix [Selene Plugin].

2.1 Tabs — Aktuellen Tab steuern

// Aktuelle Tab-Info abrufen
var info = SeleneBridge.currentTabInfo();
// → { url: "https://google.com", title: "Google", iconUrl: "..." }

// Zu einer URL navigieren (lädt im aktuellen Tab)
SeleneBridge.navigate('https://www.youtube.com');

2.2 Bookmarks — Lesezeichen verwalten

// Lesezeichen hinzufügen
var added = SeleneBridge.addBookmark('https://example.com', 'Example Site');
// → true wenn hinzugefügt, false wenn bereits vorhanden

// Lesezeichen entfernen
var removed = SeleneBridge.removeBookmark('https://example.com');
// → true wenn entfernt, false wenn nicht vorhanden

// Prüfen ob URL bereits gebookmarkt ist
var exists = SeleneBridge.isBookmarked('https://example.com');
// → true / false

// Alle Lesezeichen auflisten
var bookmarks = SeleneBridge.listBookmarks();
// → [{ url: "...", title: "...", folder: "..." }, ...]

Bereich: Browser-Lesezeichen (gespeichert in ~/.selene/bookmarks.wlb).

2.3 History — Verlauf durchsuchen

// Verlauf durchsuchen
var results = SeleneBridge.searchHistory('youtube', 20);
// → [{ url: "...", title: "...", timestamp: 1691612345000, visitCount: 5 }, ...]

// Letzte Einträge abrufen
var recent = SeleneBridge.recentHistory(10);
// → [{ url: "...", title: "...", timestamp: ..., visitCount: 1 }, ...]

// Verlauf-Eintrag hinzufügen
SeleneBridge.addHistoryEntry('https://example.com', 'Example');

Bereich: Browser-Verlauf (gespeichert in ~/.selene/browser.wlb).

2.4 Settings — Browser-Einstellungen lesen/schreiben

// String-Einstellung lesen
var homepage = SeleneBridge.getSetting('homepage', 'https://google.com');

// String-Einstellung setzen
SeleneBridge.setSetting('homepage', 'https://youtube.com');

// Boolean-Einstellung lesen
var darkMode = SeleneBridge.getBoolSetting('dark_mode', false);
// → true / false

// Boolean-Einstellung setzen
SeleneBridge.setBoolSetting('dark_mode', true);

Bereich: Browser-Einstellungen (gespeichert in ~/.selene/settings.wlb). Plugins können eigene Settings hier speichern (mit Plugin-Name als Prefix empfohlen).

2.5 Theme — Aktuelles Theme abfragen

var theme = SeleneBridge.currentTheme();
// → "cyberpunk" | "light" | "custom_theme_name"

2.6 Notifications — Benachrichtigungen anzeigen

SeleneBridge.notify('Plugin geladen', 'YouTube Dark Mode ist aktiv!');

Zeigt eine Benachrichtigung im Browser-UI an (Status-Bar / Toast).

2.7 Browser Info — Browser-Metadaten

var info = SeleneBridge.browserInfo();
// → { name: "Selene", version: "1.0.0", displayName: "Selene", organization: "Selene" }

console.log('Browser:', info.name, 'v' + info.version);