Beast Mode - Flux Oscillator

Beast Mode – Flux Oscillator (BM-FLUX) is a momentum + volatility-compression oscillator designed to help traders visualize (1) directional momentum shifts and (2) “pressure build-up” periods where volatility contracts and expansion risk increases. It combines a MACD-style momentum core with a Bollinger Bands vs. Keltner Channels squeeze filter, displayed in a clean oscillator pane (overlay=false).

---

What makes it useful/original:

1) You can switch the smoothing method between EMA and VWMA. When VWMA is enabled, the fast/slow averages are volume-weighted, which can help emphasize momentum moves that occur on higher participation.

2) It includes built-in volatility squeeze context by detecting when Bollinger Bands are inside Keltner Channels and marking those compression periods on the zero line, helping you interpret momentum signals differently during contraction vs. expansion regimes.

---

How it works (overview):

Momentum core:
- The script calculates a fast MA and slow MA from close (EMA or VWMA depending on the “Weight with Volume?” setting).
- The Fast Flux (MACD line) is: fast_ma − slow_ma
- The Slow Flux (signal line) is: EMA(macd_line, Signal Length)
- The Flux Histogram is: macd_line − signal_line

Squeeze detection:
- Bollinger Bands are calculated using BB Length and BB Mult.
- Keltner Channels are built using the same basis and a True Range average over KC Length scaled by KC Mult.
- A squeeze is active when the Bollinger Bands are fully inside the Keltner Channels.

---

How to read it:

Histogram colors (direction + acceleration):
- Bright green = above zero and rising (bullish momentum strengthening)
- Dark green = above zero but falling (bullish momentum weakening)
- Bright red = below zero and falling (bearish momentum strengthening)
- Dark red = below zero but rising (bearish momentum weakening)

Lines:
- Teal line = MACD line (Fast Flux)
- Orange line = Signal line (Slow Flux)

Squeeze dots:
- A white dot on the zero line indicates “Squeeze Active” (volatility compression).

---

Alerts:

- Flux Cross UP: MACD crosses above signal (momentum turns bullish)
- Flux Cross DOWN: MACD crosses below signal (momentum turns bearish)
- Squeeze Active: volatility compression detected (BB inside KC)

Alerts are informational conditions and do not guarantee outcomes.

---

Limitations / notes:

- This is an indicator (not a strategy) and does not provide backtest results.
- Like most momentum tools it can whipsaw in ranging markets.
- Squeeze conditions highlight volatility compression but do not predict direction by themselves.
- Always use proper risk management and confirm signals with your broader trading plan.