v0.6.0 — Update-Check via GitHub Releases API

Author: Marcuss28

CHANGELOG.md

@@ -1,5 +1,14 @@
 # Changelog
 
+## v0.6.0 (2026-05-09)
+- Feature: **Update-Check** gegen GitHub Releases API. Einmal taeglich (per `chrome.alarms`) prueft der Background-Worker, ob ein neueres Release verfuegbar ist. Bei Update wird die Versionsnummer in Sidebar-Footer und Options-Header fett+gelb dargestellt und ist klickbar (oeffnet Release-Seite).
+- Options: Neuer Abschnitt "Update-Check" mit Toggle (default an) und "Jetzt suchen"-Button fuer manuelle Pruefung.
+- Permissions: Neu `alarms` (fuer den taeglichen Check) und `https://api.github.com/*` (fuer den Releases-Endpoint). Chrome wird beim Update einmalig um Bestaetigung der erweiterten Permissions bitten.
+- Privacy: README praezisiert — der Update-Check ist die einzige externe Anfrage und kann abgeschaltet werden.
+
+## v0.5.3 (2026-05-09)
+- UX: Versionsnummer im Sidebar-Footer (dezent rechts) und im Options-Header (neben "Einstellungen"). Beides liest live aus `manifest.json` ueber `chrome.runtime.getManifest()` — keine doppelte Pflege bei Releases.
+
 ## v0.5.2 (2026-05-09)
 - Bugfix: Community-Namen wurden auf Detail-, Settings- und Leaderboard-Seiten mit dem Seiten-`<h1>` ueberschrieben. Folge: Eintraege wie "Change password", "GPT 5.5" oder Post-Titel landeten als Community-Namen im Round-Robin. Ab jetzt werden Namen nur noch auf der Community-Root-Seite erfasst.
 - Selbstheilung: Nav-Scan ueberschreibt bestehende Namen aktiv aus der zuverlaessigen Skool-Drawer-Komponente. Falsche Namen aus pre-v0.5.2 korrigieren sich beim naechsten Skool-Besuch automatisch — ohne dass der User etwas tun muss.

README.md

@@ -47,7 +47,9 @@ Klick auf das Extension-Icon → **Einstellungen öffnen**, oder aus der Side
 
 ## Privacy
 
-Die Extension macht **keine** externen Netzwerk-Requests. Alle Daten (Keywords, Communities, Bookmarks, History) liegen ausschließlich in `chrome.storage.sync` und `chrome.storage.local` im Browser. Skool bekommt nicht mit, dass die Extension läuft — sie liest nur den DOM-Inhalt, den du sowieso siehst, und fügt eine Sidebar hinzu.
+Alle Daten (Keywords, Communities, Bookmarks, History) liegen ausschließlich in `chrome.storage.sync` und `chrome.storage.local` im Browser. Skool bekommt nicht mit, dass die Extension läuft — sie liest nur den DOM-Inhalt, den du sowieso siehst, und fügt eine Sidebar hinzu.
+
+Eine einzige Ausnahme: einmal täglich fragt der Background-Worker bei der GitHub-Releases-API (`api.github.com`) nach, ob eine neuere Version vorliegt. Es werden keine Nutzerdaten gesendet, nur die Anfrage selbst (mit Standard-User-Agent von Chrome). Diesen Update-Check kannst du in den Optionen abschalten.
 
 ## Entwicklung / Contributing
 

background.js

@@ -16,8 +16,63 @@ chrome.runtime.onInstalled.addListener(async () => {
     if (existing[k] === undefined) patch[k] = v;
   }
   if (Object.keys(patch).length) await chrome.storage.sync.set(patch);
+  checkForUpdates();
 });
 
+chrome.runtime.onStartup.addListener(() => {
+  checkForUpdates();
+});
+
+// Update-Check: einmal taeglich gegen GitHub Releases API. Per Setting
+// `checkForUpdates` deaktivierbar. Ergebnis wandert in storage.local und
+// wird vom Content-Script (Footer) und der Options-Page gerendert.
+const UPDATE_REPO = "Marcuss28/skool-helper";
+const UPDATE_ALARM = "skool-helper-update-check";
+
+chrome.alarms.create(UPDATE_ALARM, { periodInMinutes: 24 * 60 });
+chrome.alarms.onAlarm.addListener((alarm) => {
+  if (alarm.name === UPDATE_ALARM) checkForUpdates();
+});
+
+function semverGt(a, b) {
+  const pa = String(a || "0").split(".").map(n => parseInt(n, 10) || 0);
+  const pb = String(b || "0").split(".").map(n => parseInt(n, 10) || 0);
+  for (let i = 0; i < Math.max(pa.length, pb.length); i++) {
+    const av = pa[i] || 0;
+    const bv = pb[i] || 0;
+    if (av > bv) return true;
+    if (av < bv) return false;
+  }
+  return false;
+}
+
+async function checkForUpdates() {
+  try {
+    const { checkForUpdates: enabled = true } = await chrome.storage.sync.get({ checkForUpdates: true });
+    if (!enabled) return;
+
+    const r = await fetch(`https://api.github.com/repos/${UPDATE_REPO}/releases/latest`, {
+      headers: { Accept: "application/vnd.github+json" }
+    });
+    if (!r.ok) return;
+    const data = await r.json();
+    const latestTag = (data.tag_name || "").replace(/^v/, "");
+    const currentVersion = chrome.runtime.getManifest().version;
+
+    await chrome.storage.local.set({
+      updateInfo: {
+        latestVersion: latestTag,
+        url: data.html_url || `https://github.com/${UPDATE_REPO}/releases/latest`,
+        checkedAt: Date.now(),
+        updateAvailable: semverGt(latestTag, currentVersion)
+      }
+    });
+  } catch (e) {
+    // Netzwerk-Fehler / Rate-Limit: leise ignorieren, beim naechsten Lauf
+    // wird's nochmal probiert.
+  }
+}
+
 // Tastatur-Shortcut: Alt+Shift+S togglet die Sidebar global (sync-Storage,
 // damit der content-Script das Storage-Change-Event mitbekommt).
 if (chrome.commands && chrome.commands.onCommand) {
@@ -53,5 +108,12 @@ chrome.runtime.onMessage.addListener((msg, sender, sendResponse) => {
     chrome.runtime.openOptionsPage();
   }
 
+  if (msg.type === "check-for-updates") {
+    checkForUpdates().then(() => {
+      try { sendResponse({ ok: true }); } catch (e) {}
+    });
+    return true; // async response
+  }
+
   return false;
 });

content.css

@@ -1,4 +1,29 @@
-/* Skool Helper – Styles (v0.5.2) */
+/* Skool Helper – Styles (v0.6.0) */
+
+/* Update-Verfuegbar: fett + gelb, klickbar */
+#skool-helper-sidebar .sh-footer-version-update {
+  color: #fbbf24 !important;
+  font-weight: 700;
+  text-decoration: none;
+  cursor: pointer;
+}
+#skool-helper-sidebar a.sh-footer-version-update:hover {
+  text-decoration: underline;
+}
+
+/* Versions-Anzeige im Footer: dezent, rechts vom Hauptext */
+#skool-helper-sidebar .sh-footer-version {
+  color: #6b7280;
+  font-size: 10px;
+  font-variant-numeric: tabular-nums;
+  margin-left: 6px;
+  flex: 0 0 auto;
+}
+#skool-helper-sidebar .sh-footer-main {
+  flex: 1 1 auto;
+  text-align: center;
+}
+
 
 /* Round-Robin Punkte-Badge: dezent, in der Zeile zwischen Name und Time */
 #skool-helper-sidebar .sh-rr-points {

content.js

@@ -1,6 +1,16 @@
 /**
- * Skool Helper – Content Script (v0.5.2)
+ * Skool Helper – Content Script (v0.6.0)
  *
+ * v0.6.0: Update-Check (opt-in, default an) — Background-Worker prueft 1x
+ *         taeglich gegen die GitHub-Releases-API, ob ein neueres Release
+ *         verfuegbar ist. Bei Update wird die Versionsnummer im Footer
+ *         fett+gelb und klickbar (oeffnet Release-Seite). Per Toggle in
+ *         den Options abschaltbar. Neue Permissions: alarms +
+ *         host_permission api.github.com.
+ * v0.5.3: Versionsnummer sichtbar — im Sidebar-Footer (klein, rechts neben
+ *         dem Standardtext) und im Options-Header (neben "Einstellungen").
+ *         Liest aus chrome.runtime.getManifest().version, damit nur die
+ *         manifest.json bei Releases angefasst werden muss.
  * v0.5.2: Bugfix — Community-Namen wurden auf Detail-/Settings-/Leaderboard-
  *         Seiten mit dem Seitentitel ueberschrieben (Folge: "Change password",
  *         Post-Titel etc. tauchten als Community-Namen im Round-Robin auf).
@@ -123,10 +133,11 @@
       state.showTimer = sync.showTimer === true;
       state.showEngagement = sync.showEngagement === true;
 
-      const local = await chrome.storage.local.get({ communities: {}, bookmarks: {}, postHistory: {} });
+      const local = await chrome.storage.local.get({ communities: {}, bookmarks: {}, postHistory: {}, updateInfo: null });
       state.communities = local.communities || {};
       state.bookmarks = local.bookmarks || {};
       state.postHistory = local.postHistory || {};
+      state.updateInfo = local.updateInfo || null;
       prunePostHistory();
     } catch (err) {
       console.warn("[Skool Helper] Konnte Config nicht laden:", err);
@@ -286,6 +297,10 @@
       state.communities = changes.communities.newValue || {};
       renderRoundRobin();
     }
+    if (area === "local" && changes.updateInfo) {
+      state.updateInfo = changes.updateInfo.newValue || null;
+      renderFooterStats();
+    }
   });
 
   function currentCommunitySlug() {
@@ -1227,6 +1242,14 @@
     });
   }
 
+  // Versions-String wird einmalig aus manifest.json gelesen und gecached.
+  let __versionStr = "";
+  try {
+    if (chrome.runtime && chrome.runtime.getManifest) {
+      __versionStr = "v" + chrome.runtime.getManifest().version;
+    }
+  } catch (e) {}
+
   function renderFooterStats() {
     if (!sidebarEl) return;
     const foot = sidebarEl.querySelector("#sh-footer");
@@ -1246,10 +1269,21 @@
       const totalMatches = Object.values(state.sessionCounts).reduce((a, b) => a + b, 0);
       parts.push(`${todayVisited} Comm · ${totalMatches} Treffer`);
     }
-    if (parts.length > 0) {
-      foot.textContent = parts.join(" · ");
+    const main = parts.length > 0 ? parts.join(" · ") : "Keywords & Communities in den Einstellungen";
+    const update = state.updateInfo;
+    const hasUpdate = update && update.updateAvailable === true && update.latestVersion;
+    if (__versionStr) {
+      const versionClass = hasUpdate ? "sh-footer-version sh-footer-version-update" : "sh-footer-version";
+      const tooltip = hasUpdate
+        ? `Update verfuegbar: v${update.latestVersion} — klicken zum Oeffnen`
+        : "Aktuelle Version";
+      const versionLabel = hasUpdate ? `${__versionStr} →` : __versionStr;
+      const versionMarkup = hasUpdate
+        ? `<a class="${versionClass}" href="${escapeHtml(update.url || "")}" target="_blank" rel="noopener" title="${escapeHtml(tooltip)}">${escapeHtml(versionLabel)}</a>`
+        : `<span class="${versionClass}" title="${escapeHtml(tooltip)}">${escapeHtml(versionLabel)}</span>`;
+      foot.innerHTML = `<span class="sh-footer-main">${escapeHtml(main)}</span> ${versionMarkup}`;
     } else {
-      foot.textContent = "Keywords & Communities in den Einstellungen";
+      foot.textContent = main;
     }
   }
 

defaults.js

@@ -32,5 +32,6 @@ globalThis.SKOOL_HELPER_DEFAULTS = {
   excludedKeywords: [],
   excludedAuthors: [],
   showTimer: false,
-  showEngagement: false
+  showEngagement: false,
+  checkForUpdates: true
 };

manifest.json

@@ -1,16 +1,18 @@
 {
   "manifest_version": 3,
   "name": "Skool Helper – Keyword Feed & Highlights",
-  "version": "0.5.2",
+  "version": "0.6.0",
   "description": "Hebt relevante Skool-Beiträge anhand deiner Keywords hervor, zeigt einen Community Round-Robin (welche Communities heute noch offen sind), bietet Kommentar-Ideen. Jede Interaktion bleibt manuell.",
   "permissions": [
     "storage",
     "notifications",
-    "activeTab"
+    "activeTab",
+    "alarms"
   ],
   "host_permissions": [
     "https://www.skool.com/*",
-    "https://skool.com/*"
+    "https://skool.com/*",
+    "https://api.github.com/*"
   ],
   "content_scripts": [
     {

options.css

@@ -8,6 +8,22 @@ body {
   line-height: 1.5;
 }
 header h1 { margin: 0 0 4px; font-size: 22px; }
+header h1 #version-badge {
+  font-size: 13px;
+  font-weight: 400;
+  color: #9ca3af;
+  margin-left: 8px;
+  vertical-align: middle;
+  font-variant-numeric: tabular-nums;
+}
+header h1 #version-badge .version-update {
+  color: #fbbf24;
+  font-weight: 700;
+  text-decoration: none;
+}
+header h1 #version-badge .version-update:hover {
+  text-decoration: underline;
+}
 header p { margin: 0 0 24px; color: #9ca3af; }
 main { max-width: 760px; }
 section {

options.html

@@ -7,7 +7,7 @@
 </head>
 <body>
   <header>
-    <h1>Skool Helper – Einstellungen</h1>
+    <h1>Skool Helper – Einstellungen <span id="version-badge"></span></h1>
     <p>Keywords, Kommentar-Vorlagen, Communities und Benachrichtigungen konfigurieren. Änderungen am Sprachfilter und an der Sprache einer Community werden automatisch gespeichert.</p>
   </header>
 
@@ -131,6 +131,23 @@ <h2>Tastatur-Shortcut</h2>
       </p>
     </section>
 
+    <section>
+      <h2>Update-Check</h2>
+      <p class="hint">
+        Prüft einmal täglich gegen die GitHub-Releases-API, ob ein neueres Release verfügbar ist.
+        Wenn ja, wird die Versionsnummer im Sidebar-Footer und im Header dieser Seite fett und gelb dargestellt — ein Klick öffnet die Release-Seite.
+        Es werden keine Daten gesendet, nur der Versionsstand abgefragt.
+      </p>
+      <label class="check">
+        <input type="checkbox" id="checkForUpdates" />
+        Täglich nach neuen Versionen suchen
+      </label>
+      <div class="row-actions">
+        <button id="check-now">Jetzt suchen</button>
+        <span id="update-status" class="status"></span>
+      </div>
+    </section>
+
     <div class="actions">
       <button id="save" class="primary">Speichern</button>
       <button id="reset">Zurücksetzen</button>

options.js

@@ -18,6 +18,7 @@ async function load() {
   if ($("excludedAuthors")) $("excludedAuthors").value = (sync.excludedAuthors || []).join("\n");
   if ($("showTimer")) $("showTimer").checked = sync.showTimer === true;
   if ($("showEngagement")) $("showEngagement").checked = sync.showEngagement === true;
+  if ($("checkForUpdates")) $("checkForUpdates").checked = sync.checkForUpdates !== false;
 
   const local = await chrome.storage.local.get({ communities: {} });
   renderCommunities(local.communities || {});
@@ -105,7 +106,8 @@ async function save() {
     excludedKeywords: parseList(($("excludedKeywords") || {value: ""}).value).map(s => s.toLowerCase()),
     excludedAuthors: parseList(($("excludedAuthors") || {value: ""}).value).map(s => s.toLowerCase()),
     showTimer: $("showTimer") ? $("showTimer").checked === true : false,
-    showEngagement: $("showEngagement") ? $("showEngagement").checked === true : false
+    showEngagement: $("showEngagement") ? $("showEngagement").checked === true : false,
+    checkForUpdates: $("checkForUpdates") ? $("checkForUpdates").checked === true : true
   };
   await chrome.storage.sync.set(payload);
 
@@ -259,7 +261,24 @@ async function importBackupFromFile(file) {
   }
 }
 
+async function applyUpdateBadge() {
+  try {
+    const v = chrome.runtime.getManifest().version;
+    const badge = document.getElementById("version-badge");
+    if (!badge) return;
+    const { updateInfo } = await chrome.storage.local.get({ updateInfo: null });
+    const hasUpdate = updateInfo && updateInfo.updateAvailable === true && updateInfo.latestVersion;
+    if (hasUpdate) {
+      badge.innerHTML = `<a href="${updateInfo.url || `https://github.com/Marcuss28/skool-helper/releases/latest`}" target="_blank" rel="noopener" class="version-update" title="Update verfügbar: v${updateInfo.latestVersion}">v${v} → v${updateInfo.latestVersion}</a>`;
+    } else {
+      badge.textContent = "v" + v;
+    }
+  } catch (e) {}
+}
+
 document.addEventListener("DOMContentLoaded", () => {
+  applyUpdateBadge();
+
   load();
   $("save").addEventListener("click", save);
   $("reset").addEventListener("click", reset);
@@ -293,4 +312,39 @@ document.addEventListener("DOMContentLoaded", () => {
       showStatus("Sprachfilter übernommen");
     });
   }
+
+  const checkUpdatesChk = $("checkForUpdates");
+  if (checkUpdatesChk) {
+    checkUpdatesChk.addEventListener("change", async () => {
+      await chrome.storage.sync.set({ checkForUpdates: checkUpdatesChk.checked === true });
+      showStatus("Update-Check " + (checkUpdatesChk.checked ? "aktiviert" : "deaktiviert"));
+    });
+  }
+  const checkNowBtn = $("check-now");
+  if (checkNowBtn) {
+    checkNowBtn.addEventListener("click", () => {
+      const status = $("update-status");
+      if (status) status.textContent = "Suche…";
+      chrome.runtime.sendMessage({ type: "check-for-updates" }, async () => {
+        await applyUpdateBadge();
+        const { updateInfo } = await chrome.storage.local.get({ updateInfo: null });
+        if (status) {
+          if (updateInfo && updateInfo.updateAvailable) {
+            status.textContent = `Update verfügbar: v${updateInfo.latestVersion}`;
+          } else if (updateInfo && updateInfo.latestVersion) {
+            status.textContent = `Aktuelle Version: v${updateInfo.latestVersion}`;
+          } else {
+            status.textContent = "Konnte nicht prüfen (Netzwerk?)";
+          }
+          setTimeout(() => { status.textContent = ""; }, 4000);
+        }
+      });
+    });
+  }
+
+  // Storage-Listener: wenn Background den Update-Check abgeschlossen hat,
+  // Badge live aktualisieren ohne Reload.
+  chrome.storage.onChanged.addListener((changes, area) => {
+    if (area === "local" && changes.updateInfo) applyUpdateBadge();
+  });
 });