README.md aktualisiert
This commit is contained in:
173
README.md
173
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.
|
||||
|
||||
Reference in New Issue
Block a user