README.md aktualisiert

This commit is contained in:
2026-08-07 06:57:34 +00:00
parent 1958a47b3a
commit 15bb4ad79a

173
README.md
View File

@@ -1,87 +1,140 @@
# MyStart # MyStart
Persönliche Startseite / neue-Tab-Seite als eigenständige Windows-App **MyStart** ist deine persönliche Startseite als eigenständige Windows-App
angepasst aus dem quelloffenen Projekt **nightTab**, komplett auf Deutsch. das, was sonst eine "neue Tab"-Seite im Browser wäre, aber als schnelles,
eigenes Programm: mit Lesezeichen, Gruppen, Design-Optionen, Uhr/Datum und
Dieses Repo enthält die **Quellen zum Bauen** der App. Die fertige `MyStart.exe` allem, was eine gute Startseite braucht. Sie basiert auf dem quelloffenen
selbst ist ein Build-Artefakt und liegt nicht im Repo. 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 MyStart ist eine **portable Einzeldatei** (`MyStart.exe`, ca. 48 MB) kein
- Eigenständige, schnelle **WebView2/.NET-Einzeldatei** (~48 MB, Start ~2 s, Installer, keine Admin-Rechte nötig. Einfach an einen beliebigen Ort legen
danach praktisch sofort) und starten.
- **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
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
``` MyStart hat bewusst **keine klassische Titelleiste** stattdessen eigene,
bundle.js Baut aus der Quelle die angepasste, deutsche App-HTML schlichte Knöpfe oben rechts:
lang/ Deutsche Übersetzungen
de.json Steuerelemente / Labels | Symbol | Funktion |
de2.json Hilfe- / Meldungstexte |---|---|
quelle-nightTab/ Unveränderte Original-Quelle (nightTab 7.3.0, GPL v3) | ⠿ | Fenster verschieben (halten & ziehen) |
webview2/ Die Windows-App (.NET + WebView2) | | Minimieren |
Program.cs Fenster, Knöpfe, Verschieben, Autostart, externe Links | □ | Maximieren / Wiederherstellen (Vollbild an/aus) |
MyStart.csproj Bau-Einstellungen (.NET) | ✕ | Schließen |
app.ico App-Icon (auch build/icon.ico)
app-index.html Von bundle.js erzeugt (die fertige App) * Zusätzlich:
README.md - **Verschieben** geht auch, indem du `Alt` gedrückt hältst und irgendwo im
.gitignore Fenster ziehst nicht nur über den ⠿-Griff.
``` - **Größe ändern:** einfach an einer beliebigen Fensterkante oder -ecke
\* `webview2/app-index.html` wird von `bundle.js` erzeugt. Sie ist mit ziehen, genau wie bei einem normalen Windows-Fenster.
eingecheckt, damit `dotnet publish` sofort funktioniert nach Änderungen an - Ein maximiertes Fenster deckt nie die Taskleiste ab.
`bundle.js`, `lang/` oder der Quelle einfach neu erzeugen (siehe unten).
--- ---
## Bauen ## Mehrere Reiter (getrennte Lesezeichen-Sätze)
**Voraussetzungen:** [Node.js](https://nodejs.org) und das Falls du MyStart für unterschiedliche Zusammenhänge nutzen willst z. B.
[.NET SDK](https://dotnet.microsoft.com/download) (Windows, x64). **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 - **Standardmäßig unsichtbar:** Solange du keinen Reiter anlegst, siehst du
# 1) Angepasste, deutsche App-HTML erzeugen nur ein kleines, dezentes **„+“** oben links nichts an der gewohnten
# (schreibt standardmäßig nach webview2/app-index.html) Ansicht ändert sich.
node bundle.js - **„+“ anklicken** fragt nach einem Namen und legt einen neuen Reiter an.
Der allererste übernimmt automatisch deine bisherigen Daten (nichts geht
# 2) Die Windows-.exe bauen verloren), jeder weitere startet leer.
cd webview2 - **Klick** auf einen Reiter wechselt zu ihm.
dotnet publish -c Release -r win-x64 -o ./out - **Doppelklick** auf einen Reiter benennt ihn um.
# Ergebnis: webview2/out/MyStart.exe - Beim **Überfahren mit der Maus** erscheint ein kleines „ד zum Entfernen
``` (mit Sicherheitsabfrage, da die darin gespeicherten Daten dabei verloren
gehen).
`bundle.js` liest die Quelle relativ aus `quelle-nightTab/` das Repo baut - Entfernst du alle Reiter wieder, bist du einfach zurück im normalen
also auf jedem Rechner ohne Pfadanpassung. 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, Arbeitest du an **mehreren PCs**, kann MyStart seinen kompletten Datenstand
dann Schritt 1+2 erneut. (alle Reiter, Lesezeichen, Design) automatisch zwischen den Rechnern
- **Info-Seite, Umbenennung, Autostart-Schalter, Fenster-Knöpfe, Scrollbalken abgleichen sofern auf beiden PCs **OneDrive** eingerichtet und angemeldet
usw.:** stecken als Transformationen in `bundle.js`. ist.
- **Fensterlogik / Autostart / externe Links:** `webview2/Program.cs`.
- 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 ## Herkunft & Lizenz
Basiert auf **nightTab** von zombieFox MyStart basiert auf **nightTab** von zombieFox
(https://github.com/zombieFox/nightTab), veröffentlicht unter der (https://github.com/zombieFox/nightTab), veröffentlicht unter der
**GNU General Public License v3.0**. Der Ordner `quelle-nightTab/` enthält den **GNU General Public License v3.0**. Die Anpassungen in MyStart (deutsche
unveränderten nightTab-Build; die Anpassungen in diesem Repo unterliegen Übersetzung, Fenster-Bedienung, Reiter, OneDrive-Sync u. a.) unterliegen
ebenfalls der GPL v3. ebenfalls der GPL v3.