Masher

FAQ und Fehlerbehebung

Antworten auf häufige Fragen, Lösungen für Verbindungs-, Audio- und Routingprobleme und ein Glossar.

Inhalt

Häufige Fragen

Wie bekomme ich Masher auf meinen PC?

Auf der Seite Download und Installation die ZIP-Datei laden, entpacken und Masher-starten.bat doppelklicken. Voraussetzungen sind Windows 10 oder 11, Voicemeeter und Node.js.

Warum braucht Masher Node.js?

Masher wird aus seinem Projektordner gestartet, die Pakete lädt npm, das zu Node.js gehört. Wer keine Entwicklungsumgebung auf dem Zielrechner möchte, baut einmal eine portable EXE mit npm run dist. Siehe Portable EXE bauen.

Verändert Masher meine Voicemeeter-Konfiguration?

Masher ändert nur, was du in der App einstellst oder was eine Regel auslöst. Zusätzlich führt es eine eigene Kopie deiner Konfiguration: Zehn Sekunden nach der letzten Änderung entsteht automatisch eine Sicherung, vor jedem Wiederherstellen sichert es den aktuellen Stand. Siehe Konfiguration sichern.

Kann ich Masher ohne Voicemeeter auf demselben PC nutzen?

Ja, über das Netzwerk: per VBAN (eingeschränkt lesbar) oder per Fernzugriff, wenn auf dem Voicemeeter-PC ebenfalls Masher läuft (alle Funktionen). Siehe Verbindung zu Voicemeeter und Zweiter PC.

Wo liegen meine Einstellungen?

Alles, was auf jedem PC gleich sein soll (Pads, MIDI, Regeln, Skin), liegt in settings/shared.json im Projektordner. Was zu einem PC gehört (Fensterposition, Verbindung, Autostart), liegt in %APPDATA%\Masher\config.json. Voicemeeter-Sicherungen liegen in %APPDATA%\Masher\voicemeeter-backups.json. Details unter Wo liegen die Daten?

Unter welcher Lizenz steht Masher?

Masher steht unter der MIT-Lizenz. Der optionale Plugin-Host nutzt JUCE (AGPLv3 oder kommerzielle Lizenz), das ist für den privaten Gebrauch unkritisch und bei einer Weitergabe der gebauten App zu beachten.

Brauche ich Voicemeeter Potato?

Nein, die App funktioniert auch mit Banana und Standard. Manche Funktionen (z. B. zusätzliche Busse) gibt es nur in größeren Editionen.

Ist die App ein Ersatz für Voicemeeter?

Nein. Voicemeeter bleibt die Audio-Engine. Die App ersetzt dessen Oberfläche und Macro Buttons.

Läuft sie auch auf Mac oder Linux?

Nein. Voicemeeter, der Audio-Helfer und der Plugin-Host sind Windows-spezifisch.

Kann ich Voicemeeters Fenster ausblenden?

Ja, unter System → Voicemeeter → Fenster ausblenden.

Läuft alles auch bei geschlossenem Fenster?

Ja, solange die App im Tray läuft (Beim Schließen in den Tray). Regeln, Ducking, App-Routing, MIDI und Tastenkürzel laufen im Hauptprozess.

Ist die Verbindung zwischen zwei PCs verschlüsselt?

Nein. Das Kennwort schützt vor Fremdzugriff im selben Netz, aber der Verkehr ist nicht verschlüsselt. Nur im eigenen Netzwerk nutzen.

Kann ich Macro Buttons aus Voicemeeter importieren?

Noch nicht. Die Funktionen lassen sich aber über Skript-Aktionen und die Skript-Konsole nachbauen.

Fehlerbehebung und FAQ

Verbindung

Oben steht „Suche Voicemeeter …“ (gelb)

Läuft Voicemeeter? Die App startet es selbst, wenn Einstellungen → App → Voicemeeter automatisch starten an ist (nur lokal).
Voicemeeter muss installiert sein, und Windows muss danach einmal neu gestartet worden sein.
Auf dem Voicemeeter-PC: Verbindungsart auf Automatisch oder Nur lokal – Remote API stellen.
Im Netzwerk: IP, Port und Stream-Name prüfen (siehe unten).

Rot: Verbindungsfehler

Die Meldung steht neben der Anzeige und in den Einstellungen. Häufige Ursachen:

Falsche IP oder falscher Port
Fernzugriff am PC ausgeschaltet
Firewall blockiert

Remote API nicht nutzbar

In den Einstellungen steht dann der Grund unter dem Status („Remote API nicht nutzbar: …“). Die App fällt in diesem Fall auf VBAN zurück.

Nur VBAN: Pads reagieren nicht

In Voicemeeter unter Menu → VBAN muss VBAN eingeschaltet sein, und bei den Incoming Streams muss ein Text-Stream mit dem Namen Command1 (wie in der App eingestellt) und der IP des steuernden PCs aktiv sein. Die App muss auf die IP des Voicemeeter-PCs und Port 6980 zeigen.

Viele Regler sind gestrichelt

Im Modus Nur VBAN sind nur Pegel, Mute, Routing, Gain und Namen lesbar. Alle anderen Regler senden nur und sind deshalb gestrichelt markiert. Für den vollen Umfang nutze die Remote API (am Voicemeeter-PC) oder den Fernzugriff.

Fernzugriff geht nicht

Kennwort, IP und Port auf beiden PCs prüfen.
Am Voicemeeter-PC: Karte Fernzugriff zeigt „Fernzugriff an“? Sonst steht der Fehler dort.
Windows-Firewall: Zugriff im privaten Netzwerk erlauben. Ist das Netzwerk als „öffentlich“ eingestuft, blockiert Windows eingehende Verbindungen.
Port bereits belegt: einen anderen Port wählen und am Laptop auch eintragen.

Apps und Routing

Eine App wechselt das Gerät nicht

Manche Apps (z. B. einige Spiele) übernehmen ein neues Gerät erst nach einem Neustart. Das ist eine Eigenheit von Windows.

Eine App taucht im Apps-Board nicht auf

Apps erscheinen erst, wenn sie Audio abspielen oder eine Audio-Sitzung geöffnet haben. Im Bereich „mehr anzeigen“ unter dem Board stehen weitere Apps. Bei Bedarf unter Routing-Regeln den Programmnamen von Hand eintragen.

Eine App landet nicht in meinem Voicemeeter-Kanal

Der Kanal muss ein Wiedergabegerät sein, also ein virtueller Eingang (oder VAIO-Erweiterung). Hardware-Eingänge sind keine Wiedergabegeräte.

Audio

Knacken oder Aussetzer

Puffer in Treiber → Voicemeeter-Engine erhöhen.
Anderen Treiber probieren (WDM, KS, ASIO).
Bei Plugin-Ketten: Modus Standard statt niedriger Latenz, größeren Puffer.

Rückkopplung bei der Plugin-Kette

Der Strip, der das bearbeitete Signal empfängt (z. B. AUX), darf nicht wieder auf den Bus liegen, von dem das Signal kommt (z. B. B1). Siehe VST3-Plugins.

Testrauschen ist zu laut oder hört nicht auf

Das Testrauschen schaltet nach 2 Minuten von selbst ab. Sofort stoppen geht über den Knopf im EQ. Den Pegel beim ersten Mal niedrig halten.

Plugins

„Plugin-Host noch nicht gebaut“

npm run build-host ausführen. Voraussetzung sind die Visual Studio Build Tools. Siehe Installation.

Ein Plugin lässt sich nicht finden

Plugins suchen ausführen.
Nur VST3 wird unterstützt, keine VST2-Plugins.
Ist das Plugin 32-Bit? Der Host ist 64-Bit.
Ein Plugin, das die Suche zum Absturz bringt, wird übersprungen (Blacklist).

MIDI

Siehe MIDI – Fehlerbehebung.

Allgemein

Die App startet nicht

npm install ausgeführt? Fehlt node_modules, startet nichts.
Beim ersten Start wird der Audio-Helfer mit dem C#-Compiler des .NET Framework übersetzt. Das .NET Framework 4 muss vorhanden sein (bei Windows 10/11 dabei).
Im Terminal mit npm start starten: Fehlermeldungen erscheinen dort.

Fenster ist verschwunden

Die App liegt wahrscheinlich im Tray (Symbol unten rechts). Ein Klick darauf holt sie zurück. „Beim Schließen in den Tray“ steuert dieses Verhalten.

Wo sind meine Einstellungen?

Siehe Wo liegen die Daten?.

Ich habe etwas verstellt und will es zurück

Voicemeeter: System → Konfiguration sichern enthält automatische Versionen, die du wiederherstellen kannst.
C5-Limiter: Rückgängig auf der C5-Seite.
EQ: Rückgängig im EQ-Editor.
Pads, MIDI, Tastenkürzel: Profil-Export oder eine Kopie von settings/shared.json.

Merge-Konflikt in `settings/shared.json`

Die Datei ist sortiert und zeilenweise formatiert, deshalb lassen sich Konflikte meist von Hand lösen. Alternativ die Version eines PCs behalten und die Änderungen des anderen nachtragen.

Glossar

Begriff	Bedeutung
A1–A5	Hardware-Ausgänge (Busse) von Voicemeeter, z. B. Lautsprecher oder Kopfhörer
Apps-Board	Die Seite Apps: Spalten pro Wiedergabegerät, Apps darauf ziehen
ASIO	Audio-Treiberschnittstelle mit sehr niedriger Latenz
Attack	Wie schnell ein Effekt (z. B. Ducking) einsetzt
AUX	Zusätzlicher virtueller Eingang von Voicemeeter („Voicemeeter AUX Input“)
B1–B3	Virtuelle Ausgänge (Busse), z. B. für Stream oder Chat
Backend	Der Weg zu Voicemeeter: Remote API, Relay oder VBAN
Banana / Potato	Größere Voicemeeter-Editionen mit mehr Ein- und Ausgängen
Bus	Ausgang von Voicemeeter (A1–A5, B1–B3)
C5	Der 5-Band-Kompressor und Limiter von Voicemeeter
CC	MIDI „Control Change“: Nachricht von Reglern und Fadern
Ducking	Andere Kanäle leiser machen, solange ein Quellkanal (z. B. Mikro) laut ist
Fader	Lautstärkeregler; auch ein Pad, das einen Kanal oder eine App steuert
FadeTo	Voicemeeter-Befehl für eine Überblendung. Damit fährt das Ducking seine Rampen
Fernzugriff / Relay	Die App am Voicemeeter-PC bietet sich einer zweiten App an; alle Funktionen sind verfügbar
Gate	Schaltet Signale unter einer Schwelle stumm
Hold	Wie lange ein Zustand (z. B. Ducking) nach dem Auslöser erhalten bleibt
Kanal	Strip oder Bus. Bei Plugins: eine Effektkette
KS	Kernel Streaming: Treiber mit geringer Latenz, sperrt das Gerät für andere Programme
MME	Älteste Windows-Audioschnittstelle mit hoher Latenz
Notch	Schmaler Filter, der eine störende Frequenz entfernt
Pad	Taste oder Fader auf der Seite Pads
Pitch Bend	MIDI-Nachricht, die Motorfader vieler Controller nutzen
Plugin-Host	Eigenes Programm (`PluginHost.exe`), in dem die VST3-Plugins laufen
Profil	Seiten, Pads, MIDI-Zuweisungen und Tastenkürzel
Push-to-Talk	Mikrofon nur öffnen, solange eine Taste gehalten wird
Release	Wie schnell ein Effekt nach dem Auslöser wieder zurückkehrt
Remote API	Voicemeeters Programmierschnittstelle für lokale Steuerung
Regel	„Wenn … (nur wenn …) dann …“ in der Automation
Skin	Farbwelt der Oberfläche
Strip	Eingangskanal von Voicemeeter (Hardware oder virtuell)
Szene	Gespeicherter Zustand des Mixers oder einzelner Kanäle
Tally	Mikrofon-Feld in der Kopfleiste (LIVE/STUMM)
Tray	Bereich neben der Uhr in der Taskleiste, in dem die App im Hintergrund läuft
VAIO	Virtuelle Voicemeeter-Audiogeräte (VAIO, AUX, VAIO3)
VBAN	Netzwerkprotokoll von VB-Audio für Audio und Textbefehle
VST3	Plugin-Format für Effekte und Instrumente
WDM	Standard-Treiber unter Windows 10/11