From 15bb4ad79aca9ec7758a11b91b3605cdf6e6d097 Mon Sep 17 00:00:00 2001 From: M_Viper Date: Fri, 7 Aug 2026 06:57:34 +0000 Subject: [PATCH] README.md aktualisiert --- README.md | 173 +++++++++++++++++++++++++++++++++++------------------- 1 file changed, 113 insertions(+), 60 deletions(-) diff --git a/README.md b/README.md index c39659f..9efec2a 100644 --- a/README.md +++ b/README.md @@ -1,87 +1,140 @@ # MyStart -Persönliche Startseite / neue-Tab-Seite als eigenständige Windows-App – -angepasst aus dem quelloffenen Projekt **nightTab**, komplett auf Deutsch. - -Dieses Repo enthält die **Quellen zum Bauen** der App. Die fertige `MyStart.exe` -selbst ist ein Build-Artefakt und liegt nicht im Repo. +**MyStart** ist deine persönliche Startseite als eigenständige Windows-App – +das, was sonst eine "neue Tab"-Seite im Browser wäre, aber als schnelles, +eigenes Programm: mit Lesezeichen, Gruppen, Design-Optionen, Uhr/Datum und +allem, was eine gute Startseite braucht. Sie basiert auf dem quelloffenen +Projekt **nightTab**, komplett ins Deutsche übersetzt und um einige eigene +Funktionen erweitert (Fenster-Bedienung, mehrere Reiter, Cloud-Abgleich). --- -## Was die App kann +## Installation & erster Start -- Angepasste, **komplett deutsche** nightTab-Oberfläche -- Eigenständige, schnelle **WebView2/.NET-Einzeldatei** (~48 MB, Start ~2 s, - danach praktisch sofort) -- **Randloses Fenster** mit eigenen Knöpfen oben rechts (Verschieben ⠿, - Minimieren –, Max./Wiederherstellen □, Schließen ✕); Verschieben auch per - `Alt` + Ziehen -- **Autostart-Schalter** direkt in den Einstellungen (Einstellungen → MyStart) -- Dunkler, schlanker Scrollbalken -- Import nimmt **MyStart-** und alte **nightTab**-Sicherungen an -- Externe Links öffnen im Standard-Browser +MyStart ist eine **portable Einzeldatei** (`MyStart.exe`, ca. 48 MB) – kein +Installer, keine Admin-Rechte nötig. Einfach an einen beliebigen Ort legen +und starten. -Daten der App liegen zur Laufzeit unter `%LOCALAPPDATA%\MyStart`. +- **Erster Start:** ca. 2 Sekunden, danach öffnet sich MyStart praktisch + sofort. +- Die App startet als **normales Fenster** (nicht im Vollbild), zentriert + auf dem Bildschirm. +- Alle deine Daten (Lesezeichen, Design, Reiter …) werden lokal unter + `%LOCALAPPDATA%\MyStart` gespeichert – unabhängig davon, wo die `.exe` + liegt oder ob du sie verschiebst. --- -## Aufbau des Repos +## Das Fenster -``` -bundle.js Baut aus der Quelle die angepasste, deutsche App-HTML -lang/ Deutsche Übersetzungen - de.json Steuerelemente / Labels - de2.json Hilfe- / Meldungstexte -quelle-nightTab/ Unveränderte Original-Quelle (nightTab 7.3.0, GPL v3) -webview2/ Die Windows-App (.NET + WebView2) - Program.cs Fenster, Knöpfe, Verschieben, Autostart, externe Links - MyStart.csproj Bau-Einstellungen (.NET) - app.ico App-Icon (auch build/icon.ico) - app-index.html Von bundle.js erzeugt (die fertige App) * -README.md -.gitignore -``` -\* `webview2/app-index.html` wird von `bundle.js` erzeugt. Sie ist mit -eingecheckt, damit `dotnet publish` sofort funktioniert – nach Änderungen an -`bundle.js`, `lang/` oder der Quelle einfach neu erzeugen (siehe unten). +MyStart hat bewusst **keine klassische Titelleiste** – stattdessen eigene, +schlichte Knöpfe oben rechts: + +| Symbol | Funktion | +|---|---| +| ⠿ | Fenster verschieben (halten & ziehen) | +| – | Minimieren | +| □ | Maximieren / Wiederherstellen (Vollbild an/aus) | +| ✕ | Schließen | + +Zusätzlich: +- **Verschieben** geht auch, indem du `Alt` gedrückt hältst und irgendwo im + Fenster ziehst – nicht nur über den ⠿-Griff. +- **Größe ändern:** einfach an einer beliebigen Fensterkante oder -ecke + ziehen, genau wie bei einem normalen Windows-Fenster. +- Ein maximiertes Fenster deckt nie die Taskleiste ab. --- -## Bauen +## Mehrere Reiter (getrennte Lesezeichen-Sätze) -**Voraussetzungen:** [Node.js](https://nodejs.org) und das -[.NET SDK](https://dotnet.microsoft.com/download) (Windows, x64). +Falls du MyStart für unterschiedliche Zusammenhänge nutzen willst – z. B. +**Büro** und **privater/zweiter Arbeitsplatz** – kannst du oben links +beliebig viele eigene Reiter anlegen. Jeder Reiter hat seine **komplett +eigenen** Lesezeichen, Gruppen und sein eigenes Design. -```bash -# 1) Angepasste, deutsche App-HTML erzeugen -# (schreibt standardmäßig nach webview2/app-index.html) -node bundle.js - -# 2) Die Windows-.exe bauen -cd webview2 -dotnet publish -c Release -r win-x64 -o ./out -# Ergebnis: webview2/out/MyStart.exe -``` - -`bundle.js` liest die Quelle relativ aus `quelle-nightTab/` – das Repo baut -also auf jedem Rechner ohne Pfadanpassung. +- **Standardmäßig unsichtbar:** Solange du keinen Reiter anlegst, siehst du + nur ein kleines, dezentes **„+“** oben links – nichts an der gewohnten + Ansicht ändert sich. +- **„+“ anklicken** fragt nach einem Namen und legt einen neuen Reiter an. + Der allererste übernimmt automatisch deine bisherigen Daten (nichts geht + verloren), jeder weitere startet leer. +- **Klick** auf einen Reiter wechselt zu ihm. +- **Doppelklick** auf einen Reiter benennt ihn um. +- Beim **Überfahren mit der Maus** erscheint ein kleines „ד zum Entfernen + (mit Sicherheitsabfrage, da die darin gespeicherten Daten dabei verloren + gehen). +- Entfernst du alle Reiter wieder, bist du einfach zurück im normalen + Ein-Datensatz-Modus – nichts wird dabei gelöscht. --- -## Anpassen +## Automatischer Abgleich über OneDrive -- **Übersetzungen:** `lang/de.json` (Labels) und `lang/de2.json` (Sätze) ändern, - dann Schritt 1+2 erneut. -- **Info-Seite, Umbenennung, Autostart-Schalter, Fenster-Knöpfe, Scrollbalken - usw.:** stecken als Transformationen in `bundle.js`. -- **Fensterlogik / Autostart / externe Links:** `webview2/Program.cs`. +Arbeitest du an **mehreren PCs**, kann MyStart seinen kompletten Datenstand +(alle Reiter, Lesezeichen, Design) automatisch zwischen den Rechnern +abgleichen – sofern auf beiden PCs **OneDrive** eingerichtet und angemeldet +ist. + +- MyStart legt dazu automatisch `OneDrive\MyStart\sync.json` an. Die + eigentliche Übertragung zwischen den PCs übernimmt OneDrive selbst – + MyStart schreibt/liest dort nur die Datei. +- Abgeglichen wird **alle 30 Sekunden**, außerdem beim Start und beim + Schließen der App. +- Regel bei Änderungen: **die neueste Version gewinnt.** Ändern beide PCs + gleichzeitig etwas, ohne dass zwischendurch synchronisiert wurde, setzt + sich schlicht die zuletzt gespeicherte Version durch (kein Zusammenführen + einzelner Änderungen). +- Ein kleiner **Punkt** in der Reiter-Leiste zeigt den Status (Maus + drüberhalten für Details): + - 🟢 **grün** – zuletzt erfolgreich abgeglichen + - 🟡 **gelb/orange** – aktuell ein Problem (z. B. Datei kurz durch OneDrive + gesperrt; behebt sich meist von selbst beim nächsten Abgleich) +- Ist auf einem PC kein OneDrive eingerichtet, bleibt der Abgleich dort + einfach ohne Fehlermeldung aus – die App funktioniert ganz normal weiter, + nur eben ohne Sync. +- **Wichtig:** Damit der Abgleich funktioniert, muss MyStart auf **jedem** + beteiligten PC vorhanden sein und einmal gestartet werden. + +--- + +## Autostart + +Unter **Einstellungen → MyStart** gibt es einen Schalter, um MyStart +automatisch mit Windows starten zu lassen. Beim Autostart öffnet sich die +App zunächst minimiert in der Taskleiste, statt sofort im Vordergrund zu +erscheinen. + +--- + +## Lesezeichen, Gruppen & Design + +Die eigentliche Startseiten-Funktionalität (Lesezeichen und Gruppen +anlegen/sortieren, Design/Farben/Schrift/Layout anpassen, Uhr, Datum, +Begrüßungstext, Suchfeld mit wählbarer Suchmaschine usw.) läuft komplett +über die Einstellungen innerhalb der App selbst – einfach oben rechts das +Zahnrad-/Einstellungsmenü öffnen und ausprobieren. + +Klickst du ein Lesezeichen zu einer externen Seite an, öffnet sich diese in +deinem **Standardbrowser** – MyStart bleibt dabei im Hintergrund geöffnet. + +--- + +## Daten sichern & wiederherstellen + +Unter **Einstellungen → Daten** kannst du jederzeit: +- eine **Sicherung** deines kompletten Standes exportieren, +- eine zuvor exportierte **MyStart-Sicherung** wiederherstellen, +- auch **alte nightTab-Sicherungen** importieren (falls du vorher das + Original-Projekt genutzt hast), +- oder gezielt einzelne Bereiche/alle Daten zurücksetzen. --- ## Herkunft & Lizenz -Basiert auf **nightTab** von zombieFox +MyStart basiert auf **nightTab** von zombieFox (https://github.com/zombieFox/nightTab), veröffentlicht unter der -**GNU General Public License v3.0**. Der Ordner `quelle-nightTab/` enthält den -unveränderten nightTab-Build; die Anpassungen in diesem Repo unterliegen +**GNU General Public License v3.0**. Die Anpassungen in MyStart (deutsche +Übersetzung, Fenster-Bedienung, Reiter, OneDrive-Sync u. a.) unterliegen ebenfalls der GPL v3.