MQL5-Google-Onedrive/README.md

SMC + Trend Breakout (MTF) for Exness MT5

This repo contains:

• mt5/MQL5/Indicators/SMC_TrendBreakout_MTF.mq5: visual indicator (BOS/CHoCH + Donchian breakout + lower-timeframe confirmation).
• mt5/MQL5/Experts/SMC_TrendBreakout_MTF_EA.mq5: Expert Advisor (alerts + optional auto-trading).

☁️ Cloud Deployment

Deploy to cloud platforms:

• Render.com: Auto-deploy with render.yaml
• Railway.app: Deploy with railway.json
• Fly.io: Deploy with fly.toml
• Docker: Build and deploy anywhere

Quick Deploy:

# Setup all platform configs
python scripts/deploy_cloud.py all

# Deploy to specific platform
python scripts/deploy_cloud.py render
python scripts/deploy_cloud.py railway
python scripts/deploy_cloud.py flyio
python scripts/deploy_cloud.py docker --build

📖 For detailed cloud deployment instructions, see Cloud Deployment Guide

Render workspace

My Blue watermelon Workspace tea-d1joqqi4d50c738aiujg

Install into Exness MetaTrader 5

⚠️ Note: Custom Indicators and EAs are not supported on the Exness Web Terminal. You must use the Desktop version of MT5.

📖 For detailed deployment instructions, see Exness Deployment Guide

Quick start:

1. Open Exness MT5.
2. Go to File → Open Data Folder.
3. Copy:
   • SMC_TrendBreakout_MTF.mq5 to MQL5/Indicators/
   • SMC_TrendBreakout_MTF_EA.mq5 to MQL5/Experts/
4. In MT5, open MetaEditor (or press F4) and compile the files.
5. Back in MT5: Navigator → Refresh.

🚀 Automated Startup (NEW!)

Quick Start:

• Windows: powershell -ExecutionPolicy Bypass -File scripts\startup.ps1
• Linux/WSL: ./scripts/startup.sh

Auto-Start on Boot:

• Windows: powershell -ExecutionPolicy Bypass -File scripts\startup.ps1 -CreateScheduledTask
• Linux: ./scripts/startup.sh --setup-systemd

📚 Documentation:

• Quick Reference Guide - Command cheat sheet
• Verification Report - System status and test results
• Startup Automation Guide - Complete guide
• Quick Start - Quick start instructions

The automation system handles:

• MT5 Terminal startup
• Python scripts execution
• Scheduled tasks configuration
• Process monitoring and logging
• Windows Task Scheduler integration
• Linux systemd/cron integration

Optional: package / deploy helpers

• Create a zip you can copy to your PC:
  • bash scripts/package_mt5.sh → outputs dist/Exness_MT5_MQL5.zip
• Copy directly into your MT5 Data Folder (run this on the machine that has MT5 installed):
  • bash scripts/deploy_mt5.sh "/path/from/MT5/File->Open Data Folder"

GitHub automation (reviews, CI, auto-merge, OneDrive sync)

This repo includes GitHub Actions workflows under .github/workflows/:

• CI (CI): runs on pull requests and pushes to main/master
  • Validates repo structure
  • Builds dist/Exness_MT5_MQL5.zip and uploads it as an artifact
• Auto-merge enablement (Enable auto-merge (label-driven)): if a PR has the label automerge, it will enable GitHub’s auto-merge (squash). Your branch protection rules still control when it can merge (required reviews, required CI, etc.).
• OneDrive sync (Sync to OneDrive (rclone)): on pushes to main (and manual runs), syncs mt5/MQL5 to OneDrive via rclone.

Recommended repo settings (GitHub → Settings):

• Branch protection (main):
  • Require pull request reviews (at least 1)
  • Require status checks: CI / validate-and-package
  • (Optional) Require CODEOWNERS review
• Auto-merge: enable “Allow auto-merge” in repo settings

OneDrive sync setup (required secrets):

• RCLONE_CONFIG_B64: base64 of your rclone.conf containing a OneDrive remote.

Example (run locally, then paste into GitHub Secrets):

rclone config
base64 -w0 ~/.config/rclone/rclone.conf

Optional secrets:

• ONEDRIVE_REMOTE: remote name in rclone.conf (default: onedrive)
• ONEDRIVE_PATH: destination folder path (default: Apps/MT5/MQL5)

Firefox Relay API key (optional secrets):

• SCRSOR
• COPILOT

Set both to your Firefox Relay profile API key (https://relay.firefox.com/accounts/profile/). Store these as GitHub Secrets or in a local .env file (see .env.example). Do not commit secret values.

Use the indicator

• Attach SMC_TrendBreakout_MTF to a chart (your main timeframe).
• Set LowerTF to a smaller timeframe (ex: main = M15, lower = M5 or M1).
• Signals require lower-TF confirmation by default (EMA fast/slow direction).

Use the EA (push to terminal + optional auto trading)

• Attach SMC_TrendBreakout_MTF_EA to a chart.
• Enable Algo Trading in MT5 if you want auto entries.
• If you want phone push alerts:
  • MT5 → Tools → Options → Notifications
  • enable push notifications and set your MetaQuotes ID.
• For web request integrations (ZOLO-A6-9V-NUNA- plugin):
  • Enable EnableWebRequest parameter
  • Add https://soloist.ai/a6-9v to MT5's allowed URLs list:
    • MT5 → Tools → Options → Expert Advisors
    • Check "Allow WebRequest for listed URL"
    • Add the URL: https://soloist.ai/a6-9v

Auto SL/TP + risk management (EA)

In SMC_TrendBreakout_MTF_EA:

• SLMode
  • SL_ATR: SL = ATR × ATR_SL_Mult
  • SL_SWING: SL beyond last confirmed fractal swing (with SwingSLBufferPoints), fallback to ATR if swing is missing/invalid
  • SL_FIXED_POINTS: SL = FixedSLPoints
• TPMode
  • TP_RR: TP = RR × SL distance
  • TP_FIXED_POINTS: TP = FixedTPPoints
  • TP_DONCHIAN_WIDTH: TP = Donchian channel width × DonchianTP_Mult (fallback to ATR width if needed)
• RiskPercent
  • If RiskPercent > 0, lots are calculated from SL distance so the money at risk ≈ RiskPercent of Equity (or Balance if you disable RiskUseEquity).
  • RiskClampToFreeMargin can reduce lots if required margin is too high.

Notes / safety

• This is a rules-based implementation of common “SMC” ideas (fractal swing BOS/CHoCH) and a Donchian breakout.
• Test in Strategy Tester and/or demo before using real funds.

Project links

• Developer tip window project: https://chatgpt.com/g/g-p-691e9c0ace5c8191a1b409c09251cc2b-window-for-developer-tip/project
• Plugin Integration: ZOLO-A6-9V-NUNA-
• GitHub Pages: https://github.com/Mouy-leng/-LengKundee-mql5.github.io.git
• Soloist.ai Endpoint: https://soloist.ai/a6-9v

Contact

• Email: Lengkundee01.org@domain.com
• WhatsApp: Agent community