Skip to content

Commit 04128b9

Browse files
Mouses007claude
andauthored
Add trading-positions@trading-journal desklet (#1770)
* Add Trading Positions desklet Desktop widget for Crypto Trading Journal (github.com/Mouses007/Crypto-Trading-Journal). Shows open Bitunix futures positions with real-time PnL from live Bitunix API. Includes i18n support with German translation. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com> * trading-positions@trading-journal: update to v1.2.0 Add running Pionex bots section, style settings (font sizes, background opacity, min-width), toggles for mark/realized PnL, and Soup 3 support for newer Cinnamon versions. * trading-positions@trading-journal: English UI + translation support (v1.3.0) Address review request: use English messages in all files and offer translations. - desklet.js: wrap all user-facing strings with _() and bind the UUID text domain; all strings and code comments are now English - settings-schema.json / metadata.json: English descriptions - po/trading-positions@trading-journal.pot regenerated with cinnamon-xlet-makepot from the actual sources - po/de.po: German translation added * trading-positions: use GLib.get_user_data_dir() for locale path Address best-practices scanner: avoid hardcoding .local/share; use GLib.get_user_data_dir() + "/locale" which respects XDG_DATA_HOME. * trading-positions@trading-journal: v1.4.0 — key-based endpoint + neutral bots - Fetch the public /api/esp32/display endpoint with X-ESP32-Key instead of the session-gated broker routes → works with the journal's password gate. - New 'ESP32 API key' setting. - Neutral grid bots shown as NEUTRAL (grey) instead of long/short. - po regenerated (new strings; removed 'Connecting to %s…'); de.po updated. * trading-positions@trading-journal: v1.4.1 — group by exchange + unified LONG/SHORT side - Group open positions by exchange (Bitunix/Bitget/Pionex) with a per-broker section header + summed PnL. - Show side uniformly as LONG/SHORT/NEUTRAL (not BUY/SELL). - Neutral grid bots shown in grey. * trading-positions@trading-journal: add README.md --------- Co-authored-by: Mouses007 <Mouses007@users.noreply.github.com> Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>
1 parent 52e8bc2 commit 04128b9

10 files changed

Lines changed: 1246 additions & 0 deletions

File tree

Lines changed: 31 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,31 @@
1+
# Trading Positions Desklet
2+
3+
Shows your open positions and running bots from a self-hosted
4+
[Crypto Trading Journal](https://github.com/Mouses007/Crypto-Trading-Journal)
5+
instance directly on your desktop, with live PnL — grouped by exchange.
6+
7+
## Features
8+
- Open futures positions from **Bitunix** and **Bitget**, plus running **Pionex** bots
9+
- Grouped per exchange with a per-broker summed PnL
10+
- Per position: symbol, side (LONG/SHORT/NEUTRAL), leverage, entry/mark price,
11+
unrealized & realized PnL; bots show entry/liquidation and PnL in the margin coin
12+
- Auto-refreshes on a configurable interval (default 30 s)
13+
- Adjustable font sizes, background opacity and width
14+
15+
## Requirements
16+
- A running **Crypto Trading Journal** instance reachable from this machine
17+
(LAN or VPN).
18+
- An **ESP32 API key** from the journal: open **Settings → External displays
19+
(ESP32 / Widget / Desklet)** and generate a key. The desklet uses the journal's
20+
read-only, key-authenticated endpoint, so it keeps working even when the
21+
journal's optional password protection is enabled.
22+
23+
## Setup
24+
1. Add the desklet to your desktop (right-click desktop → *Add Desklets*).
25+
2. Right-click the desklet → *Configure* and enter:
26+
- **Server host / IP** (e.g. `192.168.178.100`) and **port** (default `8080`)
27+
- **ESP32 API key** (from the journal settings above)
28+
- Optional: refresh interval, which columns to show, font sizes, opacity, width
29+
30+
## Links
31+
- Project & documentation: https://github.com/Mouses007/Crypto-Trading-Journal

0 commit comments

Comments
 (0)