# 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)*
