BB Bollinger Bands Breakout Scanner All Pair Time Frame
Bollinger Bands Breakout Scanner Dashboard is a technical analysis utility and multi-symbol, multi-timeframe market scanner engineered for MetaTrader 4 (MT4). The software continuously monitors multiple currency pairs, commodities, or indices across user-defined timeframes to detect confirmed Bollinger Bands breakout setups. Every detected signal is evaluated through an optional modular confirmation suite and automatically paired with volatility-based Stop Loss (SL) and Risk-to-Reward Take Profit (TP1 and TP2) reference levels calculated via the Average True Range (ATR).
1. Operating Principle and Signal Methodology
- Core Detection Architecture: The scanner evaluates price action relative to the upper and lower bands of the standard Bollinger Bands indicator across each configured symbol and timeframe slot.
- Confirmed Closed-Bar Evaluation (Non-Repainting): All calculations begin from the first completed candlestick (Bar 1) backward through the user-defined lookback window. Because the indicator does not evaluate unclosed live ticks on Bar 0 for signal generation, confirmed signals remain fixed in history and do not repaint or disappear after candlestick closure.
- Bullish Breakout Condition (BUY): A BUY signal is registered when a completed bullish candlestick closes above the upper Bollinger Band while demonstrating structural interaction with the band boundary, subject to all active confirmation filters.
- Bearish Breakout Condition (SELL): A SELL signal is registered when a completed bearish candlestick closes below the lower Bollinger Band while demonstrating structural interaction with the band boundary, subject to all active confirmation filters.
- Modular Multi-Filter Verification: Before a breakout is displayed on the dashboard or triggers an alert, it can be routed through up to 15 independent technical filter modules (including trend, momentum, volatility, and price-structure checks). Only setups passing every enabled module are validated.
- Dynamic ATR Risk and Target Levels: Upon signal validation, the engine measures market volatility at the signal bar using ATR to compute a structured Stop Loss distance, followed by two progressive Take Profit targets (TP1 and TP2) scaled by user-defined Risk-to-Reward multipliers.
2. Key Software Capabilities
- Multi-Symbol and Multi-Timeframe Matrix: Scans up to 15 symbols simultaneously across any combination of standard MT4 timeframes (M1, M5, M15, M30, H1, H4, D1, W1, MN1) using a single chart instance.
- Market Watch Integration: Supports either a custom comma-separated symbol list or automatic synchronization with all active symbols in the MT4 Market Watch window.
- Interactive On-Chart Dashboard Panel: Displays real-time scan results in a clean tabular layout featuring sortable columns (Pair, Timeframe, Direction, Signal Time), calculated Entry, SL, TP1, TP2, Band value, Signal Age, and one-click chart switching.
- Automatic Chart Level Visualization: Selecting any row via the OPEN button—or viewing an active scanned pair on the current chart—automatically plots directional arrows along with horizontal Entry, SL, TP1, and TP2 reference lines and price labels.
- State Persistence and Responsive Scaling: Includes draggable panel positioning, a minimize/maximize toggle bar, manual refresh and object cleanup controls, persistent UI coordinates via terminal Global Variables, and full DPI scaling (70% to 180%).
- Multi-Channel Alert System: Dispatches customizable notifications via MT4 pop-up alerts, WAV audio playback, mobile MetaQuotes ID push notifications, and SMTP email alerts, with duplicate-alert prevention per signal timestamp.
3. Interface Guide and Computational Efficiency
- Color Coding Conventions: Bullish (BUY) signals, arrows, and Take Profit levels are highlighted in green tones; Bearish (SELL) signals, arrows, and Stop Loss levels are highlighted in red tones; Entry reference lines and active sort headers are accented in blue; neutral or inactive fields appear in muted gray.
- Interactive Controls: Click the header bar to drag the panel anywhere on the chart; click PAIR, TF, DIR, or TIME headers to sort ascending or descending; click OPEN on any row to switch the current chart symbol and timeframe directly to that setup; use REFRESH to force an immediate rescan, CLEAR to remove panel objects, or MIN/MAX to collapse the interface.
- CPU and Memory Management: Because multi-pair scanning processes historical bars across multiple timeframes every few seconds, the engine enforces a controlled bar-copy buffer and a timer interval (minimum 3 seconds). To maintain optimal terminal responsiveness, limit InpMaxSymbols to the pairs you actively monitor and avoid running multiple heavy dashboard instances on the same terminal.
4. Operation and Setup Recommendations
- Supported Instruments: Compatible with all Forex major, minor, and exotic pairs, as well as metals (such as XAUUSD), indices, and CFDs available in your broker's Market Watch.
- Recommended Timeframes: Suitable for intraday trading (M5, M15, M30, H1) and swing analysis (H4, D1). Lower timeframes (M1, M5) generate more frequent breakout signals and benefit from stricter trend or momentum filters.
- Broker and Account Environment: Works on both Hedging and Netting account types. Ensure sufficient historical bar data (at least 150 bars per timeframe) is downloaded in MT4 before launching the scanner so all symbols and filters initialize properly.
5. Complete Input Parameters Reference
Group 1: Scanner Engine Settings
- InpGroup1 (Default: "=== Scanner Engine Settings ===") -> Visual section header in the Inputs tab.
- InpSymbols (Default: "EURUSD,GBPUSD,USDJPY,AUDUSD,USDCAD,USDCHF,NZDUSD,EURJPY,GBPJPY,XAUUSD") -> Comma-separated list of symbols to scan when InpUseWatch is disabled.
- InpTimeframes (Default: "M5,M15,M30,H1,H4") -> Comma-separated list of timeframes to scan for each symbol.
- InpUseWatch (Default: true) -> Enables automatic scanning of all symbols currently visible in the MT4 Market Watch window; overrides InpSymbols when true.
- InpMaxSymbols (Default: 15) -> Maximum number of symbols processed per scan cycle to control CPU load.
- InpScanSec (Default: 7) -> Automated background scan interval in seconds (enforced minimum of 3 seconds).
- InpBarsCopy (Default: 150) -> Number of historical bars retrieved per symbol and timeframe for indicator and filter calculations (minimum 100 bars required).
- InpLookback (Default: 100) -> Maximum number of closed bars backward from Bar 1 searched to find the most recent valid breakout signal.
- InpDirection (Default: 0) -> Directional signal filter mode: 0 scans both BUY and SELL, 1 scans BUY only, 2 scans SELL only.
Group 2: Bollinger Bands Breakout (Entry Logic)
- InpGroup2 (Default: "=== Bollinger Bands Breakout (Entry Logic) ===") -> Visual section header in the Inputs tab.
- InpBBPeriod (Default: 20) -> Averaging period (in bars) used to calculate the Bollinger Bands midline and standard deviation.
- InpBBDeviation (Default: 0.5) -> Standard deviation multiplier defining the upper and lower Bollinger Band distance from the midline.
- InpBBPrice (Default: PRICE_CLOSE) -> Applied price source used in the Bollinger Bands calculation.
Group 3: ATR SL and TP Targets
- InpGroup3 (Default: "=== ATR SL & TP Targets ===") -> Visual section header in the Inputs tab.
- InpATRPeriod (Default: 14) -> Lookback period (in bars) for the Average True Range (ATR) volatility calculation.
- InpATRMultSL (Default: 1.5) -> Multiplier applied to the signal-bar ATR value to determine Stop Loss distance from the entry price.
- InpTP1_RR (Default: 1.0) -> Risk-to-Reward ratio multiplier applied to the Stop Loss distance to calculate the first Take Profit target (TP1).
- InpTP2_RR (Default: 2.0) -> Risk-to-Reward ratio multiplier applied to the Stop Loss distance to calculate the second Take Profit target (TP2).
Group 4: Modular Confirmation Filters
Sub-Group 4.1: RSI Cross Filter
- InpFilter1 (Default: "=== 1. RSI CROSS FILTER ===") -> Visual section header for the RSI crossover filter module.
- Use_RSI_Cross_Filter (Default: false) -> Enables or disables Relative Strength Index (RSI) threshold crossover confirmation.
- RSI_Length (Default: 14) -> Calculation period (in bars) for the RSI oscillator.
- RSI_Price_Source (Default: PRICE_CLOSE) -> Applied price source for the RSI calculation.
- RSI_Oversold (Default: 30.0) -> Lower RSI threshold level used to validate bullish momentum recovery.
- RSI_Overbought (Default: 70.0) -> Upper RSI threshold level used to validate bearish momentum reversal.
Sub-Group 4.2: ADX Trend Strength Filter
- InpFilter2 (Default: "=== 2. ADX FILTER ===") -> Visual section header for the ADX trend filter module.
- Use_ADX_Filter (Default: false) -> Enables or disables Average Directional Index (ADX) minimum trend strength filtering.
- ADX_Period (Default: 10) -> Calculation period (in bars) for the ADX indicator.
- ADX_Min_Level (Default: 20.0) -> Minimum ADX main-line reading required to validate sufficient market trend strength.
Sub-Group 4.3: Single Moving Average Filter
- InpFilter3 (Default: "=== 3. SINGLE MA FILTER ===") -> Visual section header for the Single MA trend filter module.
- Use_MA_Filter (Default: false) -> Enables or disables directional trend filtering relative to a single Moving Average.
- MA_Period (Default: 50) -> Averaging period (in bars) for the Moving Average line.
- MA_Method (Default: MODE_SMA) -> Smoothing method for the Moving Average (SMA, EMA, SMMA, or LWMA).
- MA_Shift (Default: 0) -> Horizontal bar shift applied to the Moving Average calculation.
Sub-Group 4.4: Ichimoku Senkou Span B Filter
- InpFilter4 (Default: "=== 4. ICHIMOKU SENKOU SPAN B FILTER ===") -> Visual section header for the Ichimoku filter module.
- Use_Ichimoku_Filter (Default: false) -> Enables or disables cloud baseline filtering using Ichimoku Senkou Span B.
- Ichimoku_Tenkan (Default: 9) -> Tenkan-sen (Conversion Line) calculation period in bars.
- Ichimoku_Kijun (Default: 26) -> Kijun-sen (Base Line) calculation period in bars.
- Ichimoku_SenkouB (Default: 52) -> Senkou Span B (Leading Span B) calculation period in bars.
Sub-Group 4.5: Long-Period RSI Trend Filter
- InpFilter5 (Default: "=== 5. RSI 75 FILTER ===") -> Visual section header for the long-period RSI filter module.
- Use_RSI75_Filter (Default: false) -> Enables or disables macro momentum equilibrium filtering around the 50 midpoint using a long-period RSI.
- RSI_Filter_Period (Default: 75) -> Calculation period (in bars) for the macro RSI trend filter.
Sub-Group 4.6: Double Moving Average Filter
- InpFilter6 (Default: "=== 6. DOUBLE MA FILTER ===") -> Visual section header for the Dual Moving Average alignment filter.
- Use_DoubleMA_Filter (Default: false) -> Enables or disables trend alignment confirmation between fast (MA A) and slow (MA B) Moving Averages.
- MA_A_Period (Default: 30) -> Averaging period (in bars) for the fast Moving Average (MA A).
- MA_A_Method (Default: MODE_EMA) -> Smoothing method for MA A.
- MA_A_Applied (Default: PRICE_CLOSE) -> Applied price source for MA A.
- MA_A_Shift (Default: 0) -> Horizontal bar shift for MA A.
- MA_B_Period (Default: 140) -> Averaging period (in bars) for the slow Moving Average (MA B).
- MA_B_Method (Default: MODE_EMA) -> Smoothing method for MA B.
- MA_B_Applied (Default: PRICE_CLOSE) -> Applied price source for MA B.
- MA_B_Shift (Default: 0) -> Horizontal bar shift for MA B.
Sub-Group 4.7: Awesome Oscillator Filter
- InpFilter7 (Default: "=== 7. AWESOME OSCILLATOR FILTER ===") -> Visual section header for the Awesome Oscillator module.
- Use_AO_Filter (Default: false) -> Enables or disables Bill Williams Awesome Oscillator (AO) momentum confirmation.
- Use_AO_Volume_Filter (Default: false) -> Enables minimum positive/negative AO amplitude threshold validation.
- AO_Buy_Min (Default: 4.0) -> Minimum AO value required for BUY signals when Use_AO_Volume_Filter is active.
- AO_Sell_Max (Default: -4.0) -> Maximum AO value allowed for SELL signals when Use_AO_Volume_Filter is active.
- Use_AO_Color_Filter (Default: false) -> Requires AO histogram slope direction (rising for BUY, falling for SELL) to match trade direction.
- Use_AO_Zero_Filter (Default: false) -> Requires AO histogram to be on the matching side of the zero line alongside directional slope.
Sub-Group 4.8: Parabolic SAR Filter
- InpFilter8 (Default: "=== 8. PARABOLIC SAR FILTER ===") -> Visual section header for the Parabolic SAR filter module.
- Use_SAR_Filter (Default: false) -> Enables or disables Parabolic Stop and Reverse (SAR) directional dot alignment.
- SAR_Step (Default: 0.02) -> Acceleration factor step increment for the Parabolic SAR calculation.
- SAR_Maximum (Default: 0.2) -> Maximum acceleration factor cap for the Parabolic SAR calculation.
Sub-Group 4.9: Heiken Ashi Filter
- InpFilter9 (Default: "=== 9. HEIKEN ASHI FILTER ===") -> Visual section header for the Heiken Ashi filter module.
- Use_HeikenAshi_Filter (Default: false) -> Enables or disables smoothed Heiken Ashi candlestick polarity confirmation on the signal bar.
Sub-Group 4.10: CCI Trend Filter
- InpFilter10 (Default: "=== 10. CCI TREND FILTER ===") -> Visual section header for the CCI zero-line trend filter.
- Use_CCI_Filter (Default: false) -> Enables or disables Commodity Channel Index (CCI) directional bias filtering relative to the zero line.
- CCI_Period (Default: 50) -> Calculation period (in bars) for the trend CCI filter.
- CCI_Applied (Default: PRICE_CLOSE) -> Applied price source for the trend CCI filter.
Sub-Group 4.11: CCI Overbought/Oversold Momentum Filter
- InpFilter11 (Default: "=== 11. CCI OB & OS FILTER ===") -> Visual section header for the CCI extreme-level filter.
- Use_CCI_OBOS_Filter (Default: false) -> Enables or disables secondary CCI threshold filtering for breakout momentum confirmation.
- CCI_OBOS_Period (Default: 14) -> Calculation period (in bars) for the secondary CCI oscillator.
- CCI_OBOS_Applied (Default: PRICE_CLOSE) -> Applied price source for the secondary CCI oscillator.
- CCI_Overbought (Default: 100.0) -> Upper CCI threshold level for bullish momentum validation.
- CCI_Oversold (Default: -100.0) -> Lower CCI threshold level for bearish momentum validation.
Sub-Group 4.12: Relative Vigor Index (RVI) Filters
- InpFilter12 (Default: "=== 12. RVI FILTERS ===") -> Visual section header for the RVI filter module.
- Use_RVI_Filter (Default: false) -> Enables or disables RVI main-line polarity filtering relative to the zero level.
- RVI_Period (Default: 75) -> Calculation period (in bars) for the RVI zero-line trend filter.
- Use_RVI_Signal_Filter (Default: false) -> Enables or disables RVI main-line versus signal-line crossover alignment.
- RVI_Signal_Period (Default: 20) -> Calculation period (in bars) for the RVI signal-line crossover filter.
Sub-Group 4.13: MACD Filters
- InpFilter13 (Default: "=== 13. MACD FILTERS ===") -> Visual section header for the MACD filter module.
- Use_MACD_Filter (Default: false) -> Enables or disables MACD histogram polarity confirmation (main line vs. signal line).
- MACD_FastEMA (Default: 12) -> Fast Exponential Moving Average period (in bars) for MACD.
- MACD_SlowEMA (Default: 26) -> Slow Exponential Moving Average period (in bars) for MACD.
- MACD_SignalSMA (Default: 9) -> Signal line Simple Moving Average period (in bars) for MACD.
- MACD_Applied (Default: PRICE_CLOSE) -> Applied price source for MACD calculation.
- Use_MACD_Zero_Filter (Default: false) -> Enables or disables MACD main-line position filtering relative to the zero line.
Sub-Group 4.14: Support/Resistance and Fibonacci Filters
- InpFilter14 (Default: "=== 14. SR & FIBONACCI FILTERS ===") -> Visual section header for the price-structure filter module.
- Use_SR_Filter (Default: false) -> Enables or disables structural Support and Resistance zone proximity validation.
- SR_Period (Default: 50) -> Lookback window (in bars) used to identify recent swing high resistance and swing low support levels.
- SR_Zone_Points (Default: 80) -> Proximity tolerance zone around Support/Resistance levels measured in broker points.
- Use_Fib_Filter (Default: false) -> Enables or disables automated Fibonacci retracement zone interaction filtering.
- Fib_Level_1 (Default: 0.382) -> First Fibonacci retracement ratio boundary (e.g., 38.2%).
- Fib_Level_2 (Default: 0.618) -> Second Fibonacci retracement ratio boundary (e.g., 61.8%).
- ZigZag_Depth (Default: 12) -> Minimum bar depth used to detect swing highs and lows for Fibonacci anchoring.
- ZigZag_Deviation (Default: 5) -> Minimum price deviation (in points) required to validate a new swing point.
- ZigZag_Backstep (Default: 3) -> Minimum bar separation required between consecutive swing points.
Sub-Group 4.15: Supertrend Filter
- InpFilter15 (Default: "=== 15. SUPERTREND FILTER ===") -> Visual section header for the ATR-based Supertrend filter.
- Use_Supertrend_Filter (Default: false) -> Enables or disables dynamic ATR Supertrend directional regime alignment.
- ST_AtrPeriod (Default: 10) -> ATR smoothing period (in bars) used inside the Supertrend calculation.
- ST_Factor (Default: 3.0) -> Volatility band multiplier applied to ATR inside the Supertrend calculation.
Group 5: Alert and Notification Settings
- InpGroup4 (Default: "=== Alert & Notifications ===") -> Visual section header in the Inputs tab.
- InpAlertPopup (Default: false) -> Enables or disables native MT4 pop-up alert windows when a valid signal is detected.
- InpAlertSound (Default: false) -> Enables or disables audible WAV sound alerts on signal detection.
- InpSoundFile (Default: "alert2.wav") -> File name of the WAV audio file located in the MT4 Sounds folder.
- InpAlertPush (Default: false) -> Enables or disables push notifications to the MetaTrader mobile app via MetaQuotes ID.
- InpAlertEmail (Default: false) -> Enables or disables email notifications using the MT4 terminal SMTP configuration.
- InpEmailSubject (Default: "BB Breakout Signal") -> Custom subject line prefix for outgoing signal emails.
- InpAlertOnlyNew (Default: false) -> Restricts alerts strictly to newly formed signal timestamps that are newer than the previously alerted bar.
Group 6: Display and Layout Settings
- InpGroup5 (Default: "=== Display & Layout ===") -> Visual section header in the Inputs tab.
- InpX (Default: 12) -> Initial horizontal X-coordinate (in pixels) of the dashboard panel from the top-left chart corner.
- InpY (Default: 28) -> Initial vertical Y-coordinate (in pixels) of the dashboard panel from the top-left chart corner.
- InpScale (Default: 100) -> Global interface scaling percentage (valid range: 70 to 180) for high-DPI monitors.
- InpRowH (Default: 18) -> Base height of each table row in pixels.
- InpFont (Default: 8) -> Base font size for table cells and headers.
- InpPadX (Default: 8) -> Left and right internal horizontal padding of the dashboard in pixels.
- InpWPair (Default: 68) -> Width of the PAIR column in pixels.
- InpWTF (Default: 34) -> Width of the TF (Timeframe) column in pixels.
- InpWArah (Default: 44) -> Width of the DIR (Direction) column in pixels.
- InpWTime (Default: 96) -> Width of the TIME column in pixels.
- InpWEntry (Default: 64) -> Width of the ENTRY price column in pixels.
- InpWSL (Default: 64) -> Width of the SL (Stop Loss) price column in pixels.
- InpWTP1 (Default: 64) -> Width of the TP1 price column in pixels.
- InpWTP2 (Default: 64) -> Width of the TP2 price column in pixels.
- InpWBand (Default: 58) -> Width of the BAND (Bollinger Band value) column in pixels.
- InpWUmur (Default: 42) -> Width of the AGE (elapsed time since signal) column in pixels.
- InpWOpen (Default: 44) -> Width of the interactive OPEN button column in pixels.
- InpShowEmpty (Default: false) -> Displays symbol/timeframe rows that currently have no active signal when set to true.
- InpMaxRows (Default: 18) -> Maximum number of signal rows displayed simultaneously in the dashboard table.
Group 7: Sorting Settings
- InpGroup6 (Default: "=== Sorting ===") -> Visual section header in the Inputs tab.
- InpSortBy (Default: SORT_TIME) -> Default table sorting criterion (SORT_TIME, SORT_PAIR, SORT_TF, or SORT_DIR).
- InpSortNewest (Default: true) -> Sorts results in descending order (newest signals or highest rank on top) when true.
Group 8: Draw Signal on Current Chart Settings
- InpGroup7 (Default: "=== Draw Signal On Current Chart ===") -> Visual section header in the Inputs tab.
- InpDrawOnChart (Default: true) -> Enables or disables plotting signal arrows and trade levels directly on the active chart.
- InpShowArrow (Default: true) -> Displays directional Wingdings arrows at the signal candlestick.
- InpShowLevels (Default: true) -> Draws horizontal trendlines and price labels for Entry, SL, TP1, and TP2.
- InpExtendBars (Default: 30) -> Length of the horizontal level lines extended forward into the future (in chart bars).
- InpArrowCodeBuy (Default: 233) -> Wingdings character code used for bullish BUY signal arrows.
- InpArrowCodeSell (Default: 234) -> Wingdings character code used for bearish SELL signal arrows.
- InpArrowSize (Default: 2) -> Width/size scale of the plotted signal arrows.
- InpArrowDistance (Default: 15) -> Vertical offset distance (in broker points) between the arrow and the entry price level.
Group 9: Theme and Color Settings
- InpGroup8 (Default: "=== Theme & Colors ===") -> Visual section header in the Inputs tab.
- InpColBg (Default: C'18,22,28') -> Main dashboard background color.
- InpColHead (Default: C'32,38,48') -> Header bar and button background color.
- InpColRow (Default: C'24,28,36') -> Even-numbered table row background color.
- InpColRow2 (Default: C'28,33,42') -> Odd-numbered table row background color.
- InpColText (Default: C'220,225,230') -> Primary table text color.
- InpColBull (Default: C'0,230,118') -> Text color for BUY direction labels.
- InpColBear (Default: C'255,82,82') -> Text color for SELL direction labels.
- InpColMute (Default: C'120,128,140') -> Muted text color for status info, hints, and inactive items.
- InpColAccent (Default: C'41,98,255') -> Accent color for the dashboard title, active sort column, and OPEN buttons.
- InpColArrowBuy (Default: C'0,230,118') -> Color of bullish BUY arrows plotted on the chart.
- InpColArrowSell (Default: C'255,82,82') -> Color of bearish SELL arrows plotted on the chart.
- InpColEntry (Default: C'41,98,255') -> Color of the plotted Entry level line and label.
- InpColSL (Default: C'255,82,82') -> Color of the plotted Stop Loss level line and label.
- InpColTP1 (Default: C'0,200,83') -> Color of the plotted Take Profit 1 (TP1) level line and label.
- InpColTP2 (Default: C'0,230,118') -> Color of the plotted Take Profit 2 (TP2) level line and label.
6. Risk Disclaimer
Trading foreign exchange, commodities, indices, and other financial instruments carries a high level of risk and may not be suitable for all investors. Past performance or historical signal behavior does not guarantee future results. This software is an analytical and visual screening tool designed solely to assist traders with technical chart analysis; it does not execute trades automatically and does not guarantee financial profit. Always test the indicator thoroughly on a demo account to understand its operational behavior and parameter sensitivity before using it in live trading decisions.