initial release: GizerBridge v1.0

2026-05-22 12:27:27 +02:00
commit b2e4a8b46a
23 changed files with 2773 additions and 0 deletions
@@ -0,0 +1,157 @@
+# GizerBridge – Sierra Chart → Tralgo Analytics
+
+**Automatically transfers completed trades from Sierra Chart to Tralgo Analytics — on Linux.**
+
+Sierra Chart runs on Linux via Wine/Bottles/Lutris. Tralgo Analytics has no official importer for this setup. GizerBridge fills that gap.
+
+> Built and used daily in live ES/NQ futures trading.
+
+---
+
+## How it works
+
+GizerBridge connects directly to Sierra Chart via the **DTC Protocol** (TCP on `localhost:11099`).  
+No log file polling. No manual export. Trades are detected and transferred in real time as they close.
+
+```
+Sierra Chart (DTC Server)
+        │
+        │  TCP · localhost:11099
+        ▼
+   GizerBridge
+        │
+        │  HTTPS · Tralgo Analytics API
+        ▼
+  Tralgo Analytics
+```
+
+- Already-sent trade IDs are stored locally → no duplicate uploads
+- Manual import available for historical trades
+- Runs as a system tray app (AppImage, no installation required)
+
+---
+
+## Requirements
+
+- Linux (any distribution)
+- Sierra Chart running via Wine / Bottles / Lutris
+- DTC Protocol Server enabled in Sierra Chart
+- Active Tralgo Analytics account
+- Firefox (for session authentication)
+
+### Enable DTC in Sierra Chart
+
+`Global Settings → Data/Trade Service Settings → DTC Protocol Server`  
+→ Enable, Port: `11099`
+
+---
+
+## Installation
+
+**Option A – AppImage (recommended, no install needed)**
+
+1. Download the latest `GizerBridge.AppImage` from [Releases](../../releases)
+2. Make it executable:
+   ```bash
+   chmod +x GizerBridge.AppImage
+   ```
+3. Run it:
+   ```bash
+   ./GizerBridge.AppImage
+   ```
+
+**Option B – From source**
+
+```bash
+git clone https://github.com/gizerlabs/gizerbridge.git
+cd gizerbridge
+bash install.sh
+```
+
+---
+
+## First Start – Setup
+
+On first launch, the settings window opens automatically:
+
+| Field | What to enter |
+|---|---|
+| **API Key** | Your `transfer_token` from Tralgo Analytics |
+| **Tralgo E-Mail** | Your login e-mail (display only) |
+| **SC DTC Host** | `localhost` (default) |
+| **SC DTC Port** | `11099` (default) |
+| **Accounts** | Account names exactly as shown in Sierra Chart |
+| **Instruments** | Enable instruments, verify tick sizes and values |
+
+Save → the app connects immediately and starts monitoring.
+
+---
+
+## Tralgo Login (once every 30 days)
+
+The app reads the session cookie from Firefox — your password is never stored or transmitted.
+
+1. Open Firefox and go to `tralgo.app`
+2. Log in with your e-mail and password
+3. Enter the 2FA code from your e-mail
+4. **Enable "Remember for 30 days"** ← required
+
+---
+
+## System Tray
+
+After start, a colored status dot appears on the tray icon:
+
+| Color | Status |
+|---|---|
+| 🟢 Green | Running, monitoring for new trades |
+| 🟡 Yellow | Initializing |
+| 🔴 Red | Error (session expired, connection issue) |
+
+Right-click the tray icon → Open · Manual Import · Settings · Log · Quit
+
+**No tray icon on GNOME?**  
+Install the [AppIndicator Extension](https://extensions.gnome.org/extension/615/appindicator-support/) and restart the app.
+
+---
+
+## Security
+
+- No password is stored or transmitted
+- Firefox cookie database is read as a temporary copy — never modified
+- Config file (`~/.gizerbridge_config.json`) is stored with permissions `600`
+- API key is stored locally, never logged or shared
+
+---
+
+## Troubleshooting
+
+| Problem | Solution |
+|---|---|
+| "Cookie missing" popup | Log in to tralgo.app in Firefox, enable "Remember for 30 days" |
+| Red icon / transfer error | Check internet connection; open Status window for details |
+| No trades detected | Verify account names in settings match Sierra Chart exactly |
+| DTC connection failed | Confirm DTC Protocol Server is enabled in Sierra Chart on port 11099 |
+
+Last 50 events: Right-click tray icon → **Log**
+
+---
+
+## Built with
+
+- Python 3.11
+- [DTC Protocol](https://www.sierrachart.com/index.php?page=doc/DTCProtocol.html) (Sierra Chart)
+- [Tralgo Analytics API](https://tralgo.app)
+- `requests`, `Pillow`, `pystray`
+
+---
+
+## Status
+
+Active development. Used daily in live trading on ES/NQ futures.  
+Feedback and issues welcome → open a [GitHub Issue](../../issues).
+
+---
+
+*Not affiliated with Sierra Chart or Tralgo Analytics.*  
+*A [GizerLabs](https://gizerlabs.com) project.*