Download und Installation

Download

Prüfsumme in der PowerShell kontrollieren: Get-FileHash .\Masher-1.0.0.zip -Algorithm SHA256

Installation in vier Schritten

1. Voicemeeter installieren. Standard, Banana oder Potato von vb-audio.com. Voicemeeter einmal starten und danach Windows neu starten, sonst fehlen dessen virtuelle Audiogeräte.
2. Node.js installieren. Die LTS-Version von nodejs.org mit den Standardeinstellungen.
3. Masher entpacken. Die ZIP-Datei oben herunterladen und an einen festen Ort entpacken, zum Beispiel nach C:\Masher. Die spätere Verknüpfung startet Masher aus diesem Ordner, er sollte danach nicht mehr verschoben werden.
4. Starten. Doppelklick auf Masher-starten.bat. Beim ersten Start installiert sie die Pakete, legt die Verknüpfung „Masher“ auf Desktop und im Startmenü an und startet die App. Beim allerersten Start übersetzt Masher außerdem seinen Audio-Helfer, das dauert einen Moment.

Hinweis: Windows zeigt für die Datei möglicherweise eine SmartScreen-Warnung, weil sie nicht signiert ist. Mit „Weitere Informationen“ und „Trotzdem ausführen“ lässt sie sich starten. Der Inhalt der Datei ist ein kurzes Skript im Klartext, du kannst es vorher im Editor lesen.

Auf demselben PC ist sonst nichts einzurichten: Masher findet Voicemeeter über die Remote API und startet es bei Bedarf selbst. Oben rechts steht dann die Edition mit Version, daneben „lokal · Remote API“ mit grünem Punkt. Wie es weitergeht, steht unter Erste Schritte.

Wer lieber im Terminal arbeitet, öffnet im entpackten Ordner eine Eingabeaufforderung und führt npm install und danach npm start aus. npm run shortcut legt die Verknüpfung an.

Abhängigkeiten

Alles, was Masher braucht, auf einen Blick. Die Pflichtangaben stehen in den Schritten oben.

Auf dem PC

Pakete, die npm install lädt

Eigene Helfer

In die Taskleiste anheften

npm run shortcut

Das legt die Verknüpfung „Masher“ auf dem Desktop und im Startmenü an. Rechtsklick darauf → „An Taskleiste anheften“. Windows erlaubt Programmen nicht, sich selbst anzuheften.

Die Verknüpfung startet die App direkt aus dem Projektordner. Dadurch werden Code-Änderungen sofort übernommen:

• Änderungen an der Oberfläche laden das Fenster neu.
• Änderungen am Hauptprozess starten die App neu. Lag sie im Tray, bleibt sie dort.

Ein Klick auf das Symbol holt die laufende App nach vorne. Unter Einstellungen → App gibt es Mit Windows starten und Voicemeeter automatisch starten.

Portable EXE bauen

Wer keine Entwicklungsumgebung auf dem Zielrechner möchte, baut eine einzelne EXE:

npm run dist

Die Datei entsteht mit electron-builder als portable Windows-Anwendung. Sie hat einen festen Stand und übernimmt spätere Code-Änderungen nicht. Der Plugin-Host (native/plughost/bin) wird mitgepackt, falls er vorher gebaut wurde.

In gepackten Builds liegen alle Einstellungen in %APPDATA%\Masher\config.json (kein settings/shared.json im Projektordner).

Plugin-Host bauen (optional)

Nur nötig, wenn du die Seite Plugins nutzen willst (VST3-Effektketten, siehe VST3-Plugins).

1. Visual Studio Build Tools mit C++-Workload installieren (kostenlos):

bash winget install Microsoft.VisualStudio.2022.BuildTools --override "--passive --wait --add Microsoft.VisualStudio.Workload.VCTools --includeRecommended"

1. Plugin-Host bauen:

bash npm run build-host

Der erste Lauf lädt JUCE (ca. 100 MB) und kompiliert es. Das dauert einige Minuten. Das Ergebnis liegt in native/plughost/bin/PluginHost.exe und ist nicht im Repository.

Lizenzhinweis: JUCE steht unter AGPLv3 (oder kommerzieller Lizenz). Für den privaten Gebrauch ist das unkritisch. Bei einer Weitergabe der gebauten App ist die Lizenz zu beachten.

Windows-Firewall

Wenn du den Fernzugriff einschaltest, fragt die Windows-Firewall beim ersten Mal, ob die App im Netzwerk kommunizieren darf. Im privaten Netzwerk erlauben. Siehe Zweiter PC.

Aktualisieren

Die neue ZIP-Datei von der Download-Seite in den bestehenden Ordner entpacken und Dateien überschreiben. Deine Einstellungen (settings/shared.json) sind nicht im Archiv und bleiben erhalten. Danach im Ordner ausführen:

npm install

Läuft die App aus dem Projektordner, übernimmt sie die Änderungen automatisch. Bei einer portablen EXE muss neu gebaut werden (npm run dist).

Deinstallieren

• Verknüpfungen auf Desktop und im Startmenü löschen, dazu ggf. den Taskleisten-Eintrag lösen.
• Einstellungen → App → Mit Windows starten vorher ausschalten.
• Projektordner löschen.
• Optional: %APPDATA%\Masher löschen. Dort liegen die PC-spezifischen Einstellungen und die Voicemeeter-Sicherungen.

Voicemeeter selbst bleibt davon unberührt.

Wo liegen die Daten?