Beepsticks Tick Direction Sound Indicator
- Indikatoren
- Pawel Albert Jelec
- Version: 1.92
- Aktivierungen: 5
# Beepsticks v1.92 - Erweiterte technische Beschreibung
Piepsticks:
- Für diejenigen, die ihre Augen ausruhen wollen und es vorziehen, jeden Tick zu hören!
- Für diejenigen, die die Kontrolle über das ordnungsgemäße Funktionieren ihrer Handelsplattform und ihrer Verbindung behalten wollen, auch wenn sie den Bildschirm für eine gewisse Zeit nicht beobachten können.
Benutzerhandbuch für Beepsticks v1.92 - Tick & Candle Direction Sound Alert Indicator für MetaTrader 5 Plattform
---
## 1. Beschreibung
Der "Beepsticks"-Indikator gibt auf der MetaTrader 5-Plattform bei jeder Kursänderung einen akustischen Alarm aus. Mit jedem neuen Tick:
- Wenn der Preis steigt, ertönt der Ton "up",
- Wenn der Kurs sinkt, wird der "Down"-Sound abgespielt.
Zusätzlich kann für jede neue Kerze (Balken) ein Ton abgespielt werden, wobei für steigende und fallende Kerzen getrennte Töne zu hören sind.
Auf diese Weise können Sie Kursbewegungen und Kerzenwechsel mit Hilfe von Tönen verfolgen, ohne ständig auf den Bildschirm starren zu müssen.
---
## 2. Funktionen & Konfiguration
Beepsticks bietet eine flexible Konfiguration durch Eingabeparameter. Alle Einstellungen sind im Eigenschaften-Panel des Indikators verfügbar, wenn dieser an ein Diagramm angehängt wird.
### **Indikator-Eingabeparameter**
| Name des Parameters | Typ | Beschreibung |
|----------------------- |---------------------- |---------------------------------------------------------------------------------------------- |
| `Language` | LanguageOptions enum | Legt die Sprache der Schaltflächen- und Statustexte fest. Große Auswahl: Englisch, Polnisch, Esperanto, usw. |
| `Mode` | ModeOptions enum | Betriebsmodus: `MODE_TICK` (Ton bei Tick), `MODE_BAR` (Ton bei Kerze), `MODE_TICK_BAR` (beides). |
| `TickUpSound` | TickUpSoundOptions | Sound (aus den Sounds der Plattform) für Kursanstieg bei Tick.|
| `TickDownSound` | TickDownSoundOptions | Sound für Preisrückgang auf Tick. |
| `CandleUpSound` | CandleUpSoundOptions | Sound für steigende Kerze (Close > Open) auf neuem Bar.|
| `CandleDownSound` | CandleDownSoundOptions| Sound für fallende Kerze (Close < Open) auf neuem Balken.|
| `DojiSound` | DojiSoundOptions | Sound für Doji-Kerze (sehr kleine Differenz zwischen Open und Close).|
| `DojiThreshold` | double | Absolute Differenz (in Preiseinheiten) zwischen Open und Close als "Doji".|
| `SoundInterval` | ENUM_TIMEFRAMES | Zeitrahmen für Kerzentöne (kann sich vom Chart-Zeitrahmen unterscheiden).|
| `BlockTickAfterCandle` | bool | Wenn true, wird der Tick-Sound kurz nach einem Candle-Sound blockiert.|
| `BlockTickSeconds` | double | Wie viele Sekunden der Tick-Ton nach einem Kerzen-Ton blockiert werden soll.|
| `ButtonColor` | color | Hintergrundfarbe der Schaltfläche. |
| `ButtonTextColor` | Farbe | Textfarbe der Schaltfläche. |
| `ButtonWidth` | int | Schaltflächenbreite in Pixel. |
| `ButtonHeight` | int | Schaltflächenhöhe in Pixeln. |
| `ButtonPosX` | int | Button X-Position vom linken Rand des Diagramms (Pixel).|
| `ButtonPosY` | int | Button Y-Position vom oberen Rand des Diagramms (Pixel).|
| | `ButtonFontSize` | int | Schriftgröße für die Schaltfläche. |
---
### **Detaillierte Erklärungen zu den Parametern**
#### **Sprache**
Legt die Sprache für die EIN/AUS-Taste und den Statustext fest. Große Auswahl an Sprachen, darunter Englisch, Polnisch, Esperanto, Französisch, Deutsch und viele mehr. Umschalten durch Auswahl aus dem Dropdown-Menü.
#### **Modus**
- MODE_TICK": Ton bei jedem Tick (Kursänderung) abspielen.
- MODE_BAR": Der Ton wird nur abgespielt, wenn sich eine neue Kerze (Balken) bildet.
- MODUS_TICK_BAR": Ton bei jedem Tick UND beim Öffnen/Schließen einer Kerze abspielen.
#### **TickUpSound / TickDownSound**
Wählen Sie aus, welcher Sound abgespielt werden soll, wenn der Kurs bei einem Tick steigt oder fällt. Wählen Sie aus den Standard-MetaTrader 5-Sounds (z.B. `tick.wav`, `alert.wav`, `expert.wav`, etc.).
#### **KerzenAufTon / KerzenAbTon**
Legen Sie Sounds für steigende oder fallende Kerzen (Balken) fest. Wird abgespielt, wenn sich eine neue Kerze bildet und ihre Richtung bestimmt wird.
#### **DojiSound / DojiThreshold**
- **DojiSound**: Ton, der bei einer "Doji"-Kerze (offen ≈ geschlossen) abgespielt wird.
- **DojiThreshold**: Wenn `abs(open - close) <= DojiThreshold`, gilt die Kerze als Doji und löst den DojiSound aus.
#### **SoundInterval**.
Ermöglicht die Auswahl des Zeitrahmens für kerzenbasierte Sounds unabhängig vom Zeitrahmen des Charts (z.B. Abspielen von Kerzentönen bei H1-Balken, auch wenn der Chart M1 ist).
#### **BlockTickAfterCandle / BlockTickSeconds**
- Wenn diese Option aktiviert ist, werden die Tick-Sounds für einen kurzen Zeitraum nach dem Abspielen eines Candle-Sounds unterdrückt (um Überschneidungen zu vermeiden).
- Die Dauer der Unterdrückung wird durch `BlockTickSeconds` festgelegt.
#### **ButtonColor / ButtonTextColor / ButtonWidth / ButtonHeight / ButtonFontSize / ButtonPosX / ButtonPosY**
Anpassen des Aussehens und der Position der ON/OFF-Schaltfläche, die im Diagramm angezeigt wird.
---
### **Auswahl der Tondatei**
- Sie können nur aus den Standard-Sounddateien des MetaTrader 5 (z.B. `alert.wav`, `expert.wav`, `tick.wav`, etc.) auswählen, die sich im Verzeichnis `Sounds` der Plattform befinden.
- Diese Version unterstützt weder das Hochladen von Benutzerdateien noch benutzerdefinierte Sounds.
- Wenn ein ausgewählter Sound fehlt, wird ein Fehler im MetaTrader-Terminalprotokoll aufgezeichnet.
---
### **Bedienungselemente**
- **EIN/AUS-Schaltfläche:**
Erscheint auf dem Chart; klicken Sie darauf, um die akustischen Warnungen des Indikators umzuschalten.
- **Beschriftung der Schaltflächen:**
- Englisch: "Ton: EIN" / "Ton: AUS"
- Polnisch: "Dźwięk: wł." / "Dźwięk: wył."
- **Position und Aussehen der Tasten:**
Gesteuert über Eingabeparameter.
---
### **Beispiel Use Cases**
- **Augen aufhalten:** Hören Sie jede Marktbewegung, ohne auf den Bildschirm zu schauen.
- **Überwachen Sie hohe Volatilität:** Akustisches Feedback für jeden Tick oder jede Kerze.
- **Anpassen der Töne:** Weisen Sie unterschiedliche Töne für steigende/fallende Ticks oder Kerzen zu, oder verwenden Sie denselben Ton für alle Ereignisse.
---
## 3. Vorteile
- Keine stillen Charts mehr - jede Bewegung wird kommentiert.
- Gönnen Sie Ihren Augen eine Pause - Sie müssen nicht ständig auf den Bildschirm schauen.
- Konzentrieren Sie sich oder machen Sie etwas anderes und bleiben Sie trotzdem informiert.
- Unterstützt eine schnellere Erkennung von Richtung und Kursverhalten.
- Besonders hilfreich bei hoher Volatilität oder erhöhter Marktaktivität.
- Entlastet den mentalen Druck und hilft, die Aufmerksamkeit aufrechtzuerhalten.
### Zusätzlicher Vorteil: Erkennen von Plattformunterbrechungen
Der Indikator hilft bei der Erkennung von Unterbrechungen in der Funktionsweise der MetaTrader 5-Plattform, z. B. bei einem Einfrieren der Plattform oder einem Verlust der Internetverbindung.
Diese Ereignisse äußern sich in einem plötzlichen Ausbleiben von Tonsignalen des Indikators.
Diese Funktion ist besonders nützlich, wenn Sie die Plattform für eine gewisse Zeit nicht visuell überwachen können, aber dennoch die Kontrolle über Ihre Handelsumgebung behalten möchten.
Wenn Sie bemerken, dass die erwarteten Tonsignale ausbleiben, kann dies als sofortiger Hinweis auf mögliche Probleme mit der Plattform oder der Verbindung dienen, so dass Sie rechtzeitig Maßnahmen ergreifen können.
---
## 4. Wichtige technische Hinweise & Warnungen
- **MetaTrader 5 kann nur einen Ton gleichzeitig abspielen.**
Andere Alarme (von EA, Systembenachrichtigungen usw.) können während der Wiedergabe stummgeschaltet, unterbrochen oder abgeschnitten werden.
- Wenn die ausgewählte Sounddatei fehlt oder nicht abgespielt werden kann, wird eine Fehlermeldung im MetaTrader-Log ausgegeben.
- Mit dem Parameter **SoundInterval** können Sie Kerzenklänge auf jedem Zeitrahmen abspielen, unabhängig vom Chart.
- **Synchronisation:**
Die Kerzentöne sind immer auf die Zeitrahmen der Plattform abgestimmt; es besteht kein Risiko einer Zeitverschiebung.
- **BlockTickAfterCandle** verhindert Audioüberschneidungen bei schnellen Marktveränderungen.
### Technischer Hinweis: Kerzen-Tonwiedergabe und Beschränkungen
Aufgrund der Tatsache, dass einzelne Kursänderungen (Ticks) relativ häufig auftreten können, kommt es häufig vor, dass der Kerzenton (Balkenklang) nicht wie vorgesehen wiedergegeben wird. Dies kann passieren, weil sich die Töne überschneiden, unterbrochen werden oder auf andere Weise durch technische Einschränkungen des MetaTrader 5 an der korrekten Wiedergabe gehindert werden (z. B. wenn nur ein Ton gleichzeitig abgespielt wird oder wenn schnelle Tick-Aktivitäten einen Kerzenton unterbrechen).
Diese Situation kann recht häufig auftreten, insbesondere in Zeiten hoher Marktaktivität oder Volatilität.
**Kerzengeräusche sollten daher als sekundäre, zusätzliche Benachrichtigung behandelt werden, die einem höheren Fehlerrisiko und häufigen Unterbrechungen unterliegt.
Sie liefern zusätzliche Informationen, aber man kann sich nicht darauf verlassen, dass sie absolut genau oder konsistent sind.
Einige in diesem Handbuch beschriebene Funktionen und Einstellungen (z. B. das Blockieren von Tick-Tönen nach einem Kerzenton) helfen, dieses Problem zu minimieren.
Es wird dringend empfohlen, das Handbuch gründlich zu lesen und mit verschiedenen Einstellungen zu experimentieren, um die Konfiguration zu finden, die ihren Bedürfnissen und ihrem Handelsstil am besten entspricht.
### Haftungsausschluss bezüglich Einstellungen und Plattformbetrieb
Das Programm bietet eine breite Palette an benutzerkonfigurierbaren Einstellungen. Der Autor übernimmt keine Verantwortung für Probleme im Zusammenhang mit der Funktionsweise der MetaTrader-Plattform, eines bestimmten Charts oder einer anderen auf dem Gerät installierten Software sowie für das Betriebssystem, auf dem der Indikator verwendet wird, die sich aus der Verwendung bestimmter Einstellungen ergeben.
Der Autor haftet auch nicht für Fehler in der Funktion des Indikators, die sich aus den gewählten Einstellungen oder aus Konflikten mit anderen Einstellungen oder Programmen auf der Plattform ergeben können.
Obwohl der Indikator getestet wurde, kann nicht garantiert werden, dass keine technischen Probleme auftreten. In bestimmten Fällen können Probleme wie Datenverluste, Abstürze der Plattform, unerwartete Abschaltungen, Einfrieren der Plattform, der Charts oder des Indikators selbst oder andere ähnliche Situationen auftreten.
Durch die Nutzung des Beepsticks-Indikators erkennt der Nutzer diese Risiken an und verzichtet auf jegliche Ansprüche gegenüber dem Autor, die sich aus solchen Situationen ergeben.
### Haftungsausschluss bezüglich der Sprachversionen für den Button
Der Autor hat sich bemüht, eine größere Anzahl von Sprachversionen für die EIN/AUS-Taste des Indikators als angenehme Verbesserung anzubieten. Der Autor garantiert jedoch nicht, dass die Übersetzungen vollständig korrekt sind oder dass der Text der Schaltfläche auf jedem Gerät des Benutzers korrekt angezeigt wird.
Diese mehrsprachigen Funktionen werden als sekundär und hilfreich angesehen.
Der Autor bittet daher um Verständnis, falls die Beschreibungen der Schaltflächen ungenau sind, sprachliche Fehler enthalten oder nicht richtig angezeigt werden.
Wenn Ihnen Probleme auffallen oder Sie dem Autor helfen wollen, die Qualität der Beschreibungen zu verbessern, sind Sie herzlich eingeladen, uns Ihr Feedback per E-Mail zu schicken.
### Wichtiger Hinweis zu Standard-Sounddateien
Der Indikator geht davon aus, dass die MetaTrader 5-Plattform, auf der er läuft, alle Standard-Sounddateien enthält, die sich im entsprechenden Verzeichnis `Sounds` befinden.
Wenn diese Sounddateien entfernt, umbenannt, ersetzt oder anderweitig verändert wurden, kann es sein, dass der Indikator keine Sounds abspielt, nicht richtig funktioniert oder sogar kritische Probleme verursacht, wie z.B. das Einfrieren oder Herunterfahren des Indikators, das Einfrieren des Charts oder in seltenen Fällen das Nichtreagieren der gesamten Plattform.
Den Benutzern wird dringend davon abgeraten, die mit der MetaTrader-Plattform gelieferten Standard-Sounddateien zu löschen, umzubenennen oder zu verändern.
Derartige Änderungen können zu Instabilität, Funktionsverlust oder unerwarteten technischen Problemen bei der Verwendung des Beepsticks-Indikators führen.
---
## 5. Installationsanleitung
1. Kopieren Sie die Datei `Beepsticks_v1.92.mq5` nach:
`MQL5\Indicators\`.
2. Starten Sie Ihre MetaTrader 5-Plattform oder starten Sie sie neu.
3. Suchen Sie im Fenster "Navigator" den Indikator "Beepsticks" und ziehen Sie ihn auf Ihren Chart.
4. Stellen Sie Ihre gewünschte Konfiguration ein:
- Wählen Sie Sounddateien aus den Dropdowns,
- Wählen Sie die Sprache,
- Position und Aussehen der Schaltflächen anpassen.
Fertig!
---
## 6. Haftungsausschluss & Nutzungsbedingungen
Dieser Indikator wird nur als hilfreiches Werkzeug zur Verfügung gestellt.
- Der Autor übernimmt **keine Verantwortung** für finanzielle Verluste, Fehlinterpretationen von Signalen oder Handelsentscheidungen, die während der Verwendung dieses Tools getroffen werden.
- Der Indikator funktioniert möglicherweise nicht unter allen Bedingungen ordnungsgemäß, insbesondere dann, wenn auch andere klangbasierte Tools aktiv sind.
- Die Verwendung erfolgt auf eigene Gefahr.
**Durch die Installation oder Ausführung des Indikators akzeptieren Sie diese Bedingungen. Wenn Sie nicht einverstanden sind, dürfen Sie den Beepsticks-Indikator nicht installieren oder verwenden.**
### Hinweis zur Aktualität und Genauigkeit der Dokumentation
Aufgrund möglicher Aktualisierungen und Änderungen im Programmcode behält sich der Autor das Recht vor, bestimmte Teile dieser Beschreibung nicht sofort oder kontinuierlich zu aktualisieren.
Infolgedessen kann es zu Abweichungen zwischen der Dokumentation und dem tatsächlichen Zustand des Indikators, einschließlich seiner Merkmale, Funktionalität oder Benutzeroberfläche, kommen.
Solche Diskrepanzen können auch durch versehentliche Fehler, Auslassungen oder technische Mängel in der Dokumentation entstehen.
**Der Autor übernimmt keine Verantwortung für Schäden oder Verluste, die sich für den Benutzer aus solchen Abweichungen oder Fehlern in der Dokumentation ergeben können.
Diese Dokumentation wird nur zu allgemeinen Informationszwecken zur Verfügung gestellt und stellt keine Garantie für die Vollständigkeit, Richtigkeit oder laufende Aktualität dar.
Die Benutzer sind angehalten, die aktuellste Version des Indikators zu konsultieren und sich nach eigenem Ermessen auf die Dokumentation und Beschreibungen zu stützen.
Durch die Verwendung des Beepsticks-Indikators erkennt der Benutzer an und akzeptiert, dass die Dokumentation möglicherweise nicht den aktuellen Stand des Programms wiedergibt, und verzichtet auf jegliche Ansprüche gegen den Autor, die sich aus solchen Unstimmigkeiten ergeben.
---
## 7. FAQ
### **Candle Sound Timeframe vs. Chart Timeframe**
**Q:** Wenn ich das Intervall für den Kerzenton (`SoundInterval`) auf einen anderen Zeitrahmen als meinen Chart einstelle, werden dann der Indikator und der Chart nicht mehr synchronisiert?
**A:**
Nein, Sie müssen sich keine Sorgen über Zeitverschiebungen oder Unstimmigkeiten machen. Die Kerzen-Sound-Ereignisse werden immer durch die exakte Eröffnungszeit der Balken im ausgewählten `SoundInterval`-Zeitrahmen ausgelöst, ausgerichtet an der Serverzeit des Brokers.
**Wird das Programm weiterentwickelt?**
**A:**
Ja, Aktualisierungen und Verbesserungen sind geplant.
### **Wie kann ich den Autor kontaktieren?**
**A:**
Für Rückmeldungen, Fragen oder Unterstützung wenden Sie sich bitte an: Paweł Albert Jelec, beepsticks@comf.pl
---
## 8. Vollständige Liste der Eingabeparameter (Kurzreferenz)
| Parameter | Typ | Beispielwert| Beschreibung |
|-------------------------|-----------------------|-------------------------|--------------------------------------------------------------|
| `Sprache` | LanguageOptions enum | Englisch| Sprache der Schaltfläche |
| `Modus` | ModeOptions enum | MODE_TICK | Tonmodus (Tick, Kerze, Tick+Kerze) |
| `TickUpSound` | TickUpSoundOptions | TICKUP_SOUND_TICK | Sound für Tick Up |
| `TickDownSound` | TickDownSoundOptions | TICKDOWN_SOUND_EXPERT | Sound für Tick down |
| `CandleUpSound` | CandleUpSoundOptions | CANDLEUP_SOUND_NEWS | Sound für Kerze aufwärts |
| `CandleDownSound` | CandleDownSoundOptions| CANDLEDOWN_SOUND_ALERT2 | Sound für Kerze unten |
| `DojiSound` | DojiSoundOptions | DOJI_SOUND_NONE| Sound für Doji Kerze |
| `DojiThreshold` | double | 0.0001 | Open/Close-Differenz für Doji |
| `SoundInterval` | ENUM_TIMEFRAMES | PERIOD_CURRENT | Zeitrahmen für Kerzentöne |
| `BlockTickAfterCandle` | bool | true | Blockiert den Tick-Sound nach dem Kerzen-Sound |
| `BlockTickSeconds` | double | 1.0 | Sekunden bis zum Blockieren des Tick-Tons |
| `ButtonColor` | color | clrSilver | Button-Hintergrundfarbe |
| `ButtonTextColor` | Farbe | clrBlack | Button-Textfarbe |
| `ButtonWidth` | int | 120 | Button-Breite (Pixel) |
| `ButtonHeight` | int | 25 | Button-Höhe (Pixel) |
| `ButtonPosX` | int | 100 | Button-Position X (Pixel von links) |
| `ButtonPosY` | int | 20 | Button-Position Y (Pixel von oben) |
| `ButtonFontSize` | int | 12 | Button-Schriftgröße |
---
**Ende der technischen Beschreibung**
