Buraq MQL5 & MQL4

A premium Visual Studio Code extension delivering comprehensive language support, compilation workflows, and developer productivity tools for MetaQuotes Language (MQL4/MQL5) used in MetaTrader platforms.

🚀 Features

Buraq MQL5 & MQL4 Features Overview

📦 Installation

From Marketplace

Search for Buraq MQL5 & MQL4 in the Extensions panel (Ctrl + Shift + X), or install directly via CLI:

code --install-extension sarfrazfrompk.buraq-mql5-mql4

🛒 Marketplace: https://marketplace.visualstudio.com/items?itemName=sarfrazfrompk.buraq-mql5-mql4
🐙 GitHub: https://github.com/sarfrazfrompk/buraq-mql5-mql4

From VSIX (Local Build)

# Install the VSCE packaging tool
npm install -g vsce

# Build a VSIX package from the project root
vsce package

# Install the generated package
code --install-extension ./buraq-mql5-mql4-0.8.0.vsix

🛠️ Usage

Open any .mq4, .mq5, or .mqh file — the extension activates automatically.
Use the Editor Title Bar Buttons or the Command Palette (Ctrl + Shift + P) to trigger compile actions.
Right-click anywhere in an MQL document to access Context Menu helpers for inserting headers, resources, and comment blocks.

⌨️ Keybindings

Action	Shortcut
🔨 Compile MQL File	Ctrl + Shift + X
🔍 Check File Syntax	Ctrl + Shift + Z
🚀 Compile using Script	Ctrl + Shift + C
📖 Open MQL Help Reference	F1

⚙️ Configuration

Configure the extension under Settings (Ctrl + ,) or in .vscode/settings.json.

🔧 Click to expand Configuration Settings

Setting Key	Type	Default	Description
`buraq_mql5_mql4.Metaeditor.Metaeditor4Dir`	string	`"C:\\MT4_Install\\MetaTrader\\metaeditor.exe"`	Path to MetaEditor (MT4) executable
`buraq_mql5_mql4.Metaeditor.Metaeditor5Dir`	string	`"C:\\MT5_Install\\MetaTrader\\metaeditor.exe"`	Path to MetaEditor (MT5) executable
`buraq_mql5_mql4.Metaeditor.Include4Dir`	string	`""`	Optional additional include directory for MT4
`buraq_mql5_mql4.Metaeditor.Include5Dir`	string	`""`	Optional additional include directory for MT5
`buraq_mql5_mql4.LogFile.DeleteLog`	boolean	`true`	Auto-delete temporary compilation logs
`buraq_mql5_mql4.LogFile.NameLog`	string	`""`	Custom log file path (auto-generated if empty)
`buraq_mql5_mql4.ShowButton.Compile`	boolean	`true`	Show Compile button in editor title bar
`buraq_mql5_mql4.ShowButton.Check`	boolean	`true`	Show Check button in editor title bar
`buraq_mql5_mql4.ShowButton.Script`	boolean	`true`	Show Script button in editor title bar
`buraq_mql5_mql4.Script.MiniME`	boolean	`true`	Minimize MetaEditor when compiling via script
`buraq_mql5_mql4.Script.Timetomini`	number	`500` (min `100`)	Delay before minimizing MetaEditor (ms)
`buraq_mql5_mql4.Script.CloseME`	boolean	`true`	Close MetaEditor after script finishes
`buraq_mql5_mql4.Help.HelpON`	boolean	`true`	Enable F1 offline help resolution
`buraq_mql5_mql4.Help.MQL4HelpLanguage`	string	`"English"`	Help language for MQL4
`buraq_mql5_mql4.Help.MQL5HelpLanguage`	string	`"English"`	Help language for MQL5
`buraq_mql5_mql4.Help.HelpVal`	number	`500` (min `150`)	Help operation timeout (ms)
`buraq_mql5_mql4.context`	boolean	`false`	Enable extra context menu commands in Explorer
`buraq_mql5_mql4.ShowChart.BrandingEnabled`	boolean	`true`	Enable MQL-Media branding on chart views
`buraq_mql5_mql4.ShowChart.BrandingPosition`	string	`"top-right"`	Branding position (`top-right`, `top-left`, `bottom-right`, `bottom-left`)
`buraq_mql5_mql4.author`	string	`"sarfrazfrompk"`	Author name inserted into new file templates
`buraq_mql5_mql4.link`	string	`"https://sarfrazfrompk.com"`	Author website inserted into new file templates
`buraq_mql5_mql4.codeLens.enabled`	boolean	`true`	Enable Code Lens reference count indicators

🎨 Customizing Syntax Highlighting

You can customize MQL syntax colors using VS Code's editor.tokenColorCustomizations setting.

Step 1: Use Ctrl + Shift + P → Developer: Inspect Editor Tokens and Scopes to identify the TextMate scope of any token.

Step 2: Add your custom colors to settings.json:

{
  "editor.tokenColorCustomizations": {
    "textMateRules": [
      {
        "scope": "comment.line.double-slash.mql",
        "settings": { "foreground": "#00FF00", "fontStyle": "italic" }
      },
      {
        "scope": "keyword.control.mql",
        "settings": { "foreground": "#569CD6", "fontStyle": "bold" }
      },
      {
        "scope": "entity.name.function.mql",
        "settings": { "foreground": "#DCDCAA" }
      },
      {
        "scope": "storage.type.mql",
        "settings": { "foreground": "#4EC9B0" }
      }
    ]
  }
}

📋 Common MQL TextMate Scopes

Scope	Applies To
`comment.line.double-slash.mql`	Single-line comments `//`
`comment.block.mql`	Multi-line comments `/* */`
`keyword.control.mql`	Control statements (`if`, `else`, `for`, `while`)
`keyword.control.preprocessor.mql`	Preprocessor directives (`#include`, `#property`)
`storage.type.mql`	Primitive types (`int`, `double`, `string`, `bool`)
`storage.modifier.mql`	Modifiers (`extern`, `input`, `static`, `sinput`)
`entity.name.function.mql`	Function names
`string.quoted.double.mql`	String literals
`constant.numeric.integer.mql`	Integer constants

📋 Commands Reference

📌 Click to expand full Commands list

Command ID	Description
`buraq_mql5_mql4.compileFile`	Compile MQL file using MetaEditor
`buraq_mql5_mql4.checkFile`	Check MQL syntax without compiling
`buraq_mql5_mql4.compileScript`	Compile MQL file using automation script
`buraq_mql5_mql4.help`	Get MQL4/MQL5 help for word at cursor
`buraq_mql5_mql4.configurations`	Apply recommended VS Code settings for MQL
`buraq_mql5_mql4.Showfiles`	Toggle `.ex4`/`.ex5` binary file visibility
`buraq_mql5_mql4.openInME`	Open current file directly in MetaEditor
`buraq_mql5_mql4.commentary`	Insert standardized function block comment
`buraq_mql5_mql4.showChartView`	Show chart view panel with MQL-Media branding
`buraq_mql5_mql4.newExpertAdvisor`	Create a new Expert Advisor from template
`buraq_mql5_mql4.newIndicator`	Create a new Indicator from template
`buraq_mql5_mql4.newScript`	Create a new Script from template
`buraq_mql5_mql4.newLibrary`	Create a new Library from template
`buraq_mql5_mql4.quickFixAll`	Apply all available quick fixes in document
`buraq_mql5_mql4.detectIncludePaths`	Auto-detect MT4/MT5 Include directories
`buraq_mql5_mql4.autoConfigureIncludePaths`	Auto-configure detected Include paths in settings
`buraq_mql5_mql4.showCompiledFileInfo`	Display compiled binary metadata
`buraq_mql5_mql4.compareCompiledFiles`	Compare two compiled MQL binary outputs
`buraq_mql5_mql4.compileAllWorkspace`	Compile all non-ignored MQL files in workspace
`buraq_mql5_mql4.compileMainFile`	Compile the main `.mq5` file in workspace root