Files
gizerbridge/README.de.md
T

119 lines
3.5 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
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.
# GizerBridge Sierra Chart → Tralgo Analytics
Überträgt abgeschlossene Trades automatisch von Sierra Chart (Wine/Bottles/Lutris)
an Tralgo Analytics.
---
## Installation
### Schritt 1 Terminal öffnen
Rechtsklick auf den Desktop → **"Terminal öffnen"**
(oder im App-Menü nach "Terminal" suchen)
### Schritt 2 In den App-Ordner wechseln
```
cd ~/Downloads/gizerbridge
```
### Schritt 3 Installations-Script ausführen
```
bash install.sh
```
Das Script installiert alle benötigten Komponenten automatisch.
### Schritt 4 App starten
Im App-Menü (z. B. Activities) nach **"GizerBridge"** suchen und starten.
---
## Erster Start Einrichtung
Beim ersten Start öffnet sich automatisch das **Einstellungs-Fenster**:
| Feld | Was hier einzutragen ist |
|------|--------------------------|
| **API Key** | Der `transfer_token` aus deinem Tralgo-Konto |
| **Tralgo E-Mail** | Deine Login-E-Mail (nur zur Anzeige) |
| **SC DTC Host** | Normalerweise `localhost` |
| **SC DTC Port** | Normalerweise `11099` |
| **Konten** | Kontonamen genau wie in Sierra Chart (z. B. `4PRO-RQTPUT`, `Sim1.simulated`) |
| **Instrumente** | Gewünschte Instrumente aktivieren, Tick-Werte prüfen |
Nach dem Speichern startet die App sofort mit der Überwachung.
---
## Tralgo-Login (einmalig pro 30 Tage)
Damit die App Zugriff auf dein Konto hat, muss Firefox bei tralgo.app eingeloggt sein:
1. **Firefox öffnen** und `tralgo.app` aufrufen
2. Mit **E-Mail und Passwort** einloggen
3. Den **2FA-Code** aus der E-Mail eingeben
4. **"Für 30 Tage merken" aktivieren** ← Das ist wichtig!
Die App liest den Login-Cookie aus Firefox dein Passwort wird nirgends gespeichert oder übertragen.
---
## System-Tray Icon
Nach dem Start erscheint ein farbiger Status-Dot auf dem Tray-Icon:
- **Grün** App läuft, wartet auf neue Trades
- **Gelb** Initialisierung
- **Rot** Fehler (Cookie abgelaufen, Verbindungsproblem, o.ä.)
Rechtsklick auf das Icon → Öffnen · Manueller Import · Einstellungen · Log · Beenden
### Kein Tray-Icon sichtbar? (GNOME)
GNOME zeigt Tray-Icons nur mit der **AppIndicator Extension**:
1. Im Browser `extensions.gnome.org` öffnen
2. Nach **"AppIndicator and KStatusNotifierItem Support"** suchen
3. Extension installieren und aktivieren
4. GizerBridge neu starten
---
## Was passiert im Hintergrund?
- Die App verbindet sich via DTC-Protokoll direkt mit Sierra Chart (localhost:11099)
- Beim **ersten Start** werden bereits vorhandene Trades als "bekannt" markiert
und **nicht** übertragen (verhindert Duplikate)
- Nur **neue** Trades nach dem Start werden an Tralgo gesendet
- Bereits gesendete Trade-IDs werden in `~/.gizerbridge_sent.json` gespeichert
- Die Konfiguration liegt in `~/.gizerbridge_config.json` (nur für dich lesbar)
---
## Sicherheit
- **Kein Passwort** wird gespeichert oder übertragen
- Die Firefox-Cookie-Datenbank wird nur als temporäre Kopie gelesen (nie verändert)
- Die Config-Datei mit dem API Key hat Zugriffsrechte `600` (nur dein Benutzer)
---
## Fehlerbehebung
| Problem | Lösung |
|---------|--------|
| "Cookie fehlt" Popup | In Firefox bei tralgo.app neu einloggen, "Für 30 Tage merken" aktivieren |
| Rotes Icon, Übertragungsfehler | Internetverbindung prüfen; Status-Fenster für Details öffnen |
| Keine Trades erkannt | Kontonamen in den Einstellungen mit SC-Kontonamen abgleichen |
| DTC-Verbindungsfehler | Sierra Chart öffnen, DTC-Server auf Port 11099 aktivieren |
Log der letzten 50 Aktionen: Rechtsklick auf Tray-Icon → **"Log"**
---
*Ein Projekt von [GizerLabs](https://gizerlabs.com)*