TURTLE PATH MT4 / MT5
USER GUIDE / ИНСТРУКЦИЯ ПОЛЬЗОВАТЕЛЯ

============================================================
ENGLISH
============================================================

1. Product Overview

Turtle Path MT4 / MT5 is a visual breakout indicator based on the logic of Turtle Trading and Donchian Channels.

The indicator shows:
- Buy and Sell breakout signals.
- Entry level.
- Take Profit level.
- Stop Loss level.
- Donchian channel lines.
- Exit channel lines.
- Signal arrows on the chart.
- Alerts when a new signal appears.

The indicator does not open trades automatically. It is not an Expert Advisor. It is used only for market analysis and visual signal support.

2. Installation

For MetaTrader 4:
1. Open MetaTrader 4.
2. Click File -> Open Data Folder.
3. Open the MQL4 -> Indicators folder.
4. Copy the .mq4 indicator file into this folder.
5. Restart MetaTrader 4 or refresh the Navigator window.
6. Open Navigator -> Indicators.
7. Drag Turtle Path MT4 onto the chart.

For MetaTrader 5:
1. Open MetaTrader 5.
2. Click File -> Open Data Folder.
3. Open the MQL5 -> Indicators folder.
4. Copy the .mq5 indicator file into this folder.
5. Restart MetaTrader 5 or refresh the Navigator window.
6. Open Navigator -> Indicators.
7. Drag Turtle Path MT5 onto the chart.

3. Basic Logic

The indicator uses Donchian Channel logic.

A Buy signal appears when price breaks above the upper entry channel.
A Sell signal appears when price breaks below the lower entry channel.

After a signal appears, the indicator draws:
- Entry line.
- Take Profit line.
- Stop Loss line.
- Signal arrow.
- Channel levels.

4. Take Profit and Stop Loss

Take Profit and Stop Loss are set in points.

Example:
If Take Profit = 600 and Stop Loss = 300, the indicator will draw:
- TP 600 points away from the entry price.
- SL 300 points away from the entry price.

For Buy signals:
- Take Profit is above the entry price.
- Stop Loss is below the entry price.

For Sell signals:
- Take Profit is below the entry price.
- Stop Loss is above the entry price.

5. Main Settings

Entry Channel Period:
The period used to calculate the breakout channel. A larger value gives fewer signals. A smaller value gives more signals.

Exit Channel Period:
The period used to calculate the exit channel.

Take Profit Points:
Distance from the entry price to the Take Profit level, in points.

Stop Loss Points:
Distance from the entry price to the Stop Loss level, in points.

Use Closed Candle:
If enabled, signals are calculated only after the candle closes. This is usually safer and reduces false signals.
If disabled, signals may appear on the current candle and can change before the candle closes.

Show History:
Controls how many previous signals and levels are displayed on the chart.

Colors:
Allows changing the colors of channel lines, entry lines, TP lines, SL lines, and signal arrows.

6. Alerts

The indicator can send alerts when a new signal appears.

Available alert types may include:
- Terminal pop-up alert.
- Sound alert.
- Push notification.
- Email notification.
- Terminal log message.

Important:
Push notifications must be enabled in MetaTrader settings.
Email alerts must be configured in MetaTrader settings before they can work.

7. How to Use the Indicator

1. Add the indicator to the chart.
2. Select the desired timeframe.
3. Set the Entry Channel Period and Exit Channel Period.
4. Set Take Profit and Stop Loss in points.
5. Enable the alert types you need.
6. Wait for a Buy or Sell signal.
7. Check the displayed Entry, TP, and SL levels.
8. Use your own risk management before entering a trade.

8. Recommended Use

Turtle Path is best suited for:
- Trend trading.
- Breakout trading.
- Donchian Channel strategies.
- Visual market structure analysis.
- Traders who want clear Entry, TP, and SL levels on the chart.

The indicator can be used on Forex, metals, indices, commodities, and other instruments available in MetaTrader. Settings should be adjusted for each symbol and timeframe.

9. Important Notes

The indicator does not guarantee profitable trades.
The indicator does not predict the market.
Signals can be false, especially in flat or low-volatility markets.
Always test settings on a demo account first.
Always use proper risk management.

10. Disclaimer

Turtle Path MT4 / MT5 is a technical analysis tool only. It does not provide financial advice. Trading involves risk. You are fully responsible for your trading decisions and results.

============================================================
РУССКИЙ
============================================================

1. Обзор продукта

Turtle Path MT4 / MT5 — это визуальный индикатор пробоев, основанный на логике Turtle Trading и каналов Donchian.

Индикатор показывает:
- сигналы Buy и Sell при пробое;
- уровень входа;
- уровень Take Profit;
- уровень Stop Loss;
- линии канала Donchian;
- линии канала выхода;
- стрелки сигналов на графике;
- оповещения при появлении нового сигнала.

Индикатор не открывает сделки автоматически. Это не советник. Он предназначен только для анализа рынка и визуальной поддержки торговых решений.

2. Установка

Для MetaTrader 4:
1. Откройте MetaTrader 4.
2. Нажмите File -> Open Data Folder.
3. Откройте папку MQL4 -> Indicators.
4. Скопируйте файл индикатора .mq4 в эту папку.
5. Перезапустите MetaTrader 4 или обновите окно Navigator.
6. Откройте Navigator -> Indicators.
7. Перетащите Turtle Path MT4 на график.

Для MetaTrader 5:
1. Откройте MetaTrader 5.
2. Нажмите File -> Open Data Folder.
3. Откройте папку MQL5 -> Indicators.
4. Скопируйте файл индикатора .mq5 в эту папку.
5. Перезапустите MetaTrader 5 или обновите окно Navigator.
6. Откройте Navigator -> Indicators.
7. Перетащите Turtle Path MT5 на график.

3. Основная логика

Индикатор использует логику каналов Donchian.

Сигнал Buy появляется, когда цена пробивает верхнюю границу входного канала.
Сигнал Sell появляется, когда цена пробивает нижнюю границу входного канала.

После появления сигнала индикатор строит:
- линию входа;
- линию Take Profit;
- линию Stop Loss;
- стрелку сигнала;
- уровни каналов.

4. Take Profit и Stop Loss

Take Profit и Stop Loss задаются в пунктах.

Пример:
Если Take Profit = 600, а Stop Loss = 300, индикатор построит:
- TP на расстоянии 600 пунктов от цены входа;
- SL на расстоянии 300 пунктов от цены входа.

Для сигнала Buy:
- Take Profit находится выше цены входа;
- Stop Loss находится ниже цены входа.

Для сигнала Sell:
- Take Profit находится ниже цены входа;
- Stop Loss находится выше цены входа.

5. Основные настройки

Entry Channel Period:
Период для расчёта канала пробоя. Чем больше значение, тем меньше сигналов. Чем меньше значение, тем больше сигналов.

Exit Channel Period:
Период для расчёта канала выхода.

Take Profit Points:
Расстояние от цены входа до уровня Take Profit в пунктах.

Stop Loss Points:
Расстояние от цены входа до уровня Stop Loss в пунктах.

Use Closed Candle:
Если включено, сигналы рассчитываются только после закрытия свечи. Обычно это безопаснее и уменьшает количество ложных сигналов.
Если выключено, сигналы могут появляться на текущей свече и изменяться до её закрытия.

Show History:
Определяет, сколько предыдущих сигналов и уровней отображается на графике.

Colors:
Позволяет менять цвета линий каналов, линии входа, TP, SL и стрелок сигналов.

6. Оповещения

Индикатор может отправлять уведомления при появлении нового сигнала.

Доступные типы оповещений могут включать:
- всплывающее окно в терминале;
- звуковой сигнал;
- push-уведомление;
- email-уведомление;
- сообщение в журнале терминала.

Важно:
Для push-уведомлений их нужно включить в настройках MetaTrader.
Для email-уведомлений нужно заранее настроить email в MetaTrader.

7. Как использовать индикатор

1. Добавьте индикатор на график.
2. Выберите нужный таймфрейм.
3. Установите Entry Channel Period и Exit Channel Period.
4. Задайте Take Profit и Stop Loss в пунктах.
5. Включите нужные типы оповещений.
6. Дождитесь появления сигнала Buy или Sell.
7. Проверьте уровни Entry, TP и SL на графике.
8. Перед входом в сделку используйте собственный риск-менеджмент.

8. Рекомендуемое применение

Turtle Path лучше всего подходит для:
- трендовой торговли;
- торговли на пробой;
- стратегий на основе Donchian Channel;
- визуального анализа структуры рынка;
- трейдеров, которым нужны понятные уровни Entry, TP и SL на графике.

Индикатор можно использовать на Forex, металлах, индексах, сырьевых товарах и других инструментах, доступных в MetaTrader. Настройки нужно подбирать отдельно для каждого инструмента и таймфрейма.

9. Важные замечания

Индикатор не гарантирует прибыльные сделки.
Индикатор не предсказывает рынок.
Сигналы могут быть ложными, особенно во флэте или при низкой волатильности.
Сначала тестируйте настройки на демо-счёте.
Всегда используйте правильный риск-менеджмент.

10. Отказ от ответственности

Turtle Path MT4 / MT5 является только инструментом технического анализа. Он не является финансовой рекомендацией. Торговля связана с риском. Вы полностью отвечаете за свои торговые решения и результаты.