Files
MyStart/README.md
2026-07-27 08:19:25 +02:00

177 lines
6.1 KiB
Markdown
Raw Blame History

This file contains invisible Unicode characters
This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# MyStart
Deine persönliche Startseite / neue-Tab-Seite als eigenständige Windows-App
angepasst aus dem quelloffenen Projekt **nightTab**.
---
## 🚀 Schnellstart
1. **`MyStart.exe`** doppelklicken.
2. Beim ersten Start meldet sich evtl. **Windows SmartScreen**
(„Der Computer wurde durch Windows geschützt"), weil die Datei nicht
signiert ist. → **Weitere Informationen****Trotzdem ausführen**.
Das ist bei selbstgebauten Programmen normal.
3. Fertig MyStart öffnet sich in einem eigenen Fenster.
> **Startzeit:** Erster Start ~2 Sekunden, danach praktisch **sofort**.
Keine Installation nötig. Du kannst `MyStart.exe` beliebig verschieben
(Desktop, USB-Stick, anderer PC) deine Einstellungen bleiben erhalten.
---
## ✨ Funktionen
- **Lesezeichen & Gruppen** frei anordnen, benennen, mit Icon/Bild/Buchstabe
- **Design komplett anpassbar:** Farben, Akzent, Schriftarten, Hintergrund
(Farbe, Verlauf, Bild oder Video), Radius, Schatten, Deckkraft
- **Kopfzeile** mit Begrüßung, Uhr, Datum und Suchfeld
- **Suche** über die gewünschte Suchmaschine direkt aus dem Startbildschirm
- **Komplett auf Deutsch**
---
## 🇩🇪 Deutsche Oberfläche
Die gesamte Bedienoberfläche ist auf Deutsch Menüs, Einstellungen,
Schaltflächen, Hilfetexte und Meldungen.
*Kleine Ausnahme:* Die Farbnamen im Akzent-Farbwähler
(z. B. „Light grey", „Dark red") sind englisch geblieben. Sie hängen technisch
mit internen Funktionen zusammen und lassen sich nicht gefahrlos übersetzen.
Es sind reine Bezeichnungen von Farbkacheln die Funktion ist unberührt.
---
## ⚙️ Technik / Voraussetzung
MyStart zeigt die Oberfläche über **Microsoft Edge WebView2** an eine
Komponente, die auf praktisch jedem aktuellen Windows 10/11 bereits vorhanden
ist (Teil von Edge). Dadurch ist die App klein (~48 MB) und startet schnell.
Nur auf einem sehr alten oder frisch aufgesetzten Windows ohne diese Komponente
müsste sie einmalig (kostenlos von Microsoft) nachinstalliert werden auf
deinem PC ist sie vorhanden.
---
## 💾 Einstellungen, Lesezeichen & Backups
**Speicherort deiner Daten:**
```
%LOCALAPPDATA%\MyStart
```
(entspricht `C:\Users\<DeinName>\AppData\Local\MyStart`)
Deine Einstellungen und Lesezeichen bleiben erhalten auch wenn du die
`MyStart.exe` verschiebst oder umbenennst.
**Sicherung erstellen:** Einstellungen → **Daten****Sichern**
**Sicherung einspielen:** Einstellungen → **Daten****Wiederherstellen**
> Der Import akzeptiert **beide** Backup-Typen: die von **MyStart** erstellten
> *und* alte **nightTab**-Sicherungen.
**Alles zurücksetzen:** den Ordner `%LOCALAPPDATA%\MyStart` löschen.
---
## Info-Seite (Einstellungen → MyStart)
Zeigt Logo, Name, Version und deine Links:
- **Website:** https://m-viper.de
- **Git:** https://git.viper.ipv64.net
Alle Links (auch normale Lesezeichen) öffnen sich in deinem
**Standard-Browser**, nicht innerhalb der App.
---
## 🔧 Was gegenüber dem Original geändert wurde
- Umbenannt von **nightTab****MyStart** (überall)
- Menüpunkte **„Support"** und **„Coffee"** (Spenden) entfernt
- **Info-Seite** vereinfacht: Logo + Name + Version 1.0.0 + deine Links
- Externe Links öffnen im **Standard-Browser**
- Import nimmt **nightTab- und MyStart-Sicherungen** an
- **Komplette deutsche Übersetzung** der Oberfläche
- Als **eigenständige, schnelle `.exe`** verpackt (kein Browser-Add-on,
keine Installation)
---
## ⚠️ Gut zu wissen
- **SmartScreen-Warnung** beim ersten Start ist normal (siehe Schnellstart).
- Als **echte neue-Tab-Seite** im Browser (automatisch bei jedem Tab)
funktioniert nur eine echte Browser-Erweiterung das ist eine
Chrome-Beschränkung. MyStart öffnest du bewusst per Doppelklick.
---
## 📦 Inhalt des Backup-Ordners
```
MyStart-Backup\
├─ MyStart.exe Die fertige App (schnell, WebView2, ~48 MB)
├─ MyStart-App.html Dieselbe App als einzelne HTML-Datei (Notfall-Variante,
│ in jedem Browser öffenbar)
├─ README.md Diese Datei
├─ LIESMICH.txt Kurzanleitung als Textdatei
└─ projekt\ Alle Dateien zum Neubauen / Weiteranpassen
├─ bundle.js Baut die angepasste, deutsche App aus der Quelle
├─ quelle-nightTab\ Unveränderte Original-Quelle (nightTab 7.3.0)
├─ webview2\ >>> AKTUELLE, SCHNELLE VARIANTE (WebView2 / .NET) <<<
│ ├─ Program.cs Fensterlogik, externe Links im Standardbrowser
│ ├─ MyStart.csproj Bau-Einstellungen (.NET)
│ ├─ app-index.html Die fertig angepasste, deutsche App
│ ├─ app.ico App-Icon
│ └─ build\icon.ico
└─ electron\ Alternative: voll autarke Variante (größer, langsamer)
├─ main.js
├─ package.json
├─ de.json / de2.json Deutsche Übersetzungen
├─ app\index.html
└─ build\icon.ico
```
---
## 🛠️ Neu bauen (nur bei Änderungen nötig)
### Schritt 1 angepasste deutsche App erzeugen (für beide Varianten)
Voraussetzung: **Node.js** installiert. Im Ordner `projekt`:
```bash
node bundle.js "./electron/app/index.html"
# danach die erzeugte App auch für die WebView2-Variante kopieren:
copy .\electron\app\index.html .\webview2\app-index.html
```
> `bundle.js` liest die Quelle aus `C:\Users\Viper\Desktop\nightTab`.
> Fehlt dieser Ordner, in `bundle.js` den Pfad auf `projekt\quelle-nightTab`
> anpassen.
### Schritt 2a schnelle WebView2-.exe bauen (empfohlen)
Voraussetzung: **.NET SDK** installiert. Im Ordner `projekt\webview2`:
```bash
dotnet publish -c Release -r win-x64 -o ./out
# Ergebnis: projekt\webview2\out\MyStart.exe (~48 MB, schneller Start)
```
### Schritt 2b voll autarke Electron-.exe bauen (Alternative)
Voraussetzung: **Node.js**. Im Ordner `projekt\electron`:
```bash
npm install
npx electron-builder --win portable --x64
# Ergebnis: projekt\electron\dist\MyStart.exe (~72 MB, Start ~11 s)
```
---
## 📄 Herkunft & Lizenz
MyStart basiert auf **nightTab** von zombieFox
(https://github.com/zombieFox/nightTab), veröffentlicht unter der
**GNU General Public License v3.0**. Diese Anpassung ist zum persönlichen
Gebrauch bestimmt.