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