# 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** | Dein API Key aus den Tralgo Analytics Einstellungen |
| **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.

---

## 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 (Verbindungsproblem, ungültiger API Key, 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
- Authentifizierung per API Key — gespeichert in `~/.gizerbridge_config.json` mit Zugriffsrechten `600`

---

## Fehlerbehebung

| Problem | Lösung |
|---------|--------|
| 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)*