Garfield
14c4e7da2f
- show-latest-report.sh: Auto-finds and displays latest MT5 report - parse-report.py: Python parser for HTML reports with full stats - Updated UTILS.md with documentation - No browser needed - prevents VM crashes - Shows account info, P&L, trade stats, performance assessment
94 lines
2.2 KiB
Markdown
94 lines
2.2 KiB
Markdown
# MT5 Helper Utilities
|
|
|
|
This directory contains helper scripts for managing MT5 trading and extracting data safely.
|
|
|
|
## Scripts
|
|
|
|
### view-report.sh
|
|
View MT5 HTML trading reports without browser (prevents VM crash).
|
|
|
|
```bash
|
|
./view-report.sh /path/to/ReportHistory-XXXX.html
|
|
```
|
|
|
|
### parse-deals.py
|
|
Parse MT5 binary deal files to extract trading data.
|
|
|
|
```bash
|
|
python3 parse-deals.py
|
|
```
|
|
|
|
Output: Account summary with P&L, trade counts, win/loss stats.
|
|
|
|
### export-history.sh
|
|
Guide for safely exporting trade history from MT5.
|
|
|
|
```bash
|
|
./export-history.sh
|
|
```
|
|
|
|
## Why These Are Needed
|
|
|
|
MT5 in Wine/VM crashes when generating reports because:
|
|
1. MT5 tries to open HTML in default browser
|
|
2. No browser installed in Wine environment
|
|
3. Browser launch fails → VM crash
|
|
|
|
These scripts work around that limitation.
|
|
|
|
## Report File Locations
|
|
|
|
### Binary Data (Internal)
|
|
```
|
|
~/mt5-docker/config/.wine/drive_c/Program Files/MetaTrader 5/Bases/
|
|
├── MetaQuotes-Demo/trades/104125640/deals_2026.03.dat
|
|
├── MetaQuotes-Demo/trades/103477358/deals_2026.02.dat
|
|
└── ...
|
|
```
|
|
|
|
### HTML Reports (User Generated)
|
|
```
|
|
~/mt5-docker/config/.wine/drive_c/users/abc/Desktop/ReportHistory-XXXX.html
|
|
```
|
|
|
|
### Text Logs
|
|
```
|
|
~/mt5-docker/config/.wine/drive_c/Program Files/MetaTrader 5/MQL5/Logs/YYYYMMDD.log
|
|
~/mt5-docker/config/.wine/drive_c/Program Files/MetaTrader 5/logs/YYYYMMDD.log
|
|
```
|
|
|
|
## show-latest-report.sh
|
|
|
|
Automatically finds and displays the latest MT5 trading report.
|
|
|
|
```bash
|
|
./show-latest-report.sh # Show latest report
|
|
./show-latest-report.sh --save # Save to text file
|
|
```
|
|
|
|
**Features:**
|
|
- Automatically finds the most recent `ReportHistory-*.html` file
|
|
- Displays formatted summary with colors
|
|
- Shows account info, P&L, trade stats, and performance assessment
|
|
- No browser needed (prevents VM crash)
|
|
|
|
## parse-report.py
|
|
|
|
Python parser for MT5 HTML reports (used by show-latest-report.sh).
|
|
|
|
```bash
|
|
python3 parse-report.py # Auto-find latest
|
|
python3 parse-report.py /path/to/file.html # Parse specific file
|
|
```
|
|
|
|
**Output includes:**
|
|
- Account name and company
|
|
- Net profit, gross profit/loss
|
|
- Profit factor
|
|
- Total trades, win/loss count
|
|
- Win rate percentage
|
|
- Largest win/loss
|
|
- Balance and return calculation
|
|
- Performance assessment
|
|
|