Blackbay Trading — NinjaTrader Instant Tab Switcher (Mouse Click)
Version 1.0 — 2025-08-17

LICENSE & DISCLAIMER
- FREE for personal use. Redistribution is not allowed without permission.
- USE AT YOUR OWN RISK. Test in a safe environment before using live.

WHAT THIS DOES
- Jump directly to specific NinjaTrader chart tabs with a single hotkey (no cycling).
- Uses per-tab screen coordinates you set once.
- Multi-monitor friendly; great with Stream Deck hotkeys.

REQUIREMENTS
1. Windows + NinjaTrader 8
2. AutoHotkey v2 (64-bit recommended): https://www.autohotkey.com
3. This folder (script + INI auto-generated on first save)

INSTALL
1. Install AutoHotkey v2 and double-click BlackbayTabSwitcher.ahk to run.
3. A tray icon appears when active.
4. Create a permanent folder, e.g. C:\AHK Scripts\BlackbayTabSwitcher
5. Copy the script into that folder.


HOTKEYS (default)
- Alt+1 … Alt+0 → Jump to Tab #1 … #10 (clicks saved point)
- Ctrl+Alt+1 … Ctrl+Alt+0 → Save current cursor point as Tab #1 … #10 (auto-saves)
- Alt+C → Preview all saved tabs (sequential tooltip markers, no clicks)
- Ctrl+Alt + Arrow keys → Nudge last-used tab by ±1 px (Hold Shift = ±5 px) — auto-saves

CALIBRATION (quick)
1. Focus your NinjaTrader chart window with tabs.
2. Hover the center of Tab #1 → press Ctrl+Alt+1. (make sure not to hover over or too close to the small [x] that closes the chart)
3. Repeat for each tab you want (… up to Ctrl+Alt+0 for Tab #10).
4. Done. Your points are saved automatically.
5. Test with Alt+1 … Alt+0. Use Alt+C to preview all saved positions.

STREAM DECK (optional)
- Add a “Hotkey” action per tab and assign Alt+1 … Alt+0.
- Label buttons after your tabs (e.g., ES 2000 Tick, ES 10K Tick, NQ 1500 Tick).

OPTIONS (edit at top of script)
- RestoreMouse := true — Return cursor to original spot after clicking (set false to leave it).
- ActivateNinjaTrader := false — Optionally focus NinjaTrader before the click (still uses screen coords).
- DoubleClickTabs := false — Double-click the saved point instead of single click.
- ClickDelayMs := 40 — Delay between the two clicks when DoubleClickTabs is enabled.

TIPS
- Screen-coordinate saves are tied to your monitor layout. If you move charts to a different monitor or change scaling, re-save those tabs.
- For pixel-perfect targeting, save once then fine-tune with Ctrl+Alt+Arrows (Shift for larger steps).
- If your theme needs a double-click to activate tabs, set DoubleClickTabs := true.

TROUBLESHOOTING
- Alt+[number] does nothing → Save that tab first with Ctrl+Alt+[number].
- Clicks slightly off → Use Ctrl+Alt+Arrows to nudge; changes auto-save.
- After changing monitor layout → Re-calibrate the affected tabs.

SUPPORT / CONTACT
- Website: https://blackbaytrading.com
- Email: mail@blackbaytrading.com

© 2025 Blackbay Trading. All rights reserved.
