Lyrics Juke­box

Inbetriebnahme

Übersicht
Windows	Linux	Mac	Amiga usw.
Herun­ter­laden	Herun­ter­laden	Herun­ter­laden, aber nicht mit Sa­fari	Herun­ter­laden
Ent­packen	Ent­packen	Ent­packen	Ent­packen
	ausführ­bar machen	ausführ­bar machen
Musik­da­teien in den Stan­dard-Musik­ordner ko­pieren	Musik­da­teien in den Stan­dard-Musik­ordner ko­pieren	Musik­da­teien in den Stan­dard-Musik­ordner ko­pieren	Musik­da­teien in den Stan­dard-Musik­ordner ko­pieren
		Quaran­täne auf­heben
Starten	Starten	Starten	Starten

Herunterladen und Entpacken
Wenn Sie Lyrics Jukebox ausprobieren möchten, dann laden Sie das für Ihr Betriebssystem passende Archiv von der Downloadseite herunter und entpacken Sie es. Mac-Benutzer sollten möglichst nicht Safari zum Download nehmen, lesen Sie dazu bitte unten unter Probleme und Lösungen den Abschnitt zur Quarantäne beim Mac.
Das heruntergeladene Archiv enthält ein übergeordnetes Verzeichnis Lyrics_Jukebox.
Darin befinden sich acht Dateien (fünf unter MacOS) und fünf Verzeichnisse bzw. Ordner:

• Catalogs – Verzeichnis mit Übersetzungen der Programmeldungen
• Fonts – Verzeichnis, in das vom Programm zu benutzende Schriften abgelegt werden können
• Lyrics – Verzeichnis, in das anzuzeigende Liedtexte abgelegt werden können
• Music – Verzeichnis, in dessen Unterverzeichnissen Musikdateien erwartet werden
• Plugin_license_files – Verzeichnis mit Readme- und Linzenzdokumenten der Plugins
• avcodec.hwp – Plugin zur Medienwiedergabe (FFmpeg-Bibliothek)
• svgimage.hwp – Plugin für die Benutzung von SVG-Grafiken
• Lyrics_Jukebox RadioURLs.txt – Textdatei mit Streaming-URLs fürs Internetradio
• Lyrics_Jukebox-Hyphenation.txt – Liste mit Trennvorschlägen für Interpret oder Titel
• HTML_entities.txt – Liste zu ersetzender HTML-Entitäten
• Lyrics_Jukebox.config – die Konfigurationsdatei von Lyrics Jukebox
• Lyrics_Jukebox.exe (Windows) oder Lyrics_Jukebox (andere Betriebssysteme) – das ausführbare Programm
• Lyrics_Jukebox_Service.exe (Windows) oder Lyrics_Jukebox_Service (andere Betriebssysteme) – die Servicekomponente von Lyrics Jukebox

Die Verzeichnisse Fonts und Lyrics sind leer, Music enthält die zwei ebenfalls leeren Unterverzeichnisse Standard und Reserve, die für Ihre Musikdateien vorgesehen sind.
Unter MacOS sind die beiden Plugin-Dateien (.hwp) und das Serviceprogramm Bestandteil des Anwendungspakets und liegen daher nicht hier.

Ausführbar machen
Bei den unixartigen Betriebssystemen Linux oder macOS ist es jetzt noch nötig, die beiden Programmdateien Lyrics_Jukebox und Lyrics_Jukebox_Service ausführbar zu machen. Bei Linux sollte dann alles betriebsbereit sein, beim Mac funktioniert das Programm erst dann richtig, wenn es nicht mehr in der Quarantäne steckt, die durch das Herunterladen und automatische Entpacken durch Safari ausgelöst wird.
(Detailliertere Anleitungen dazu finden Sie für den Mac unten bei Probleme und Lösungen. Beim Mac können Sie das Programm zum Ausprobieren auch auf einen wie üblich mit FAT32 oder exFAT formatierten USB-Stick speichern, da braucht es nicht erst ausführbar gemacht zu werden. Die Quarantäne-Problematik ist damit aber nicht behoben.)

Musikdateien in den Standard-Musikordner kopieren
Würden Sie das Programm Lyrics_Jukebox jetzt starten, bekämen Sie aber noch eine Warnmeldung, wenn sich im Verzeichnis Music/Standard noch keine MP3-Datei befindet. Sobald das Programm beim Start dort wenigstens eine Musikdatei findet, geht es los.
Probieren Sie anfangs am besten mit nur wenigen Musikdateien, damit auch die Jukebox-Funktion gleich zur Verfügung steht.
Anstelle die Musikdateien in die vorbereiteten Ordner zu kopieren, könnten Sie auch die Pfadeinträge in der Konfigurationsdatei so ändern, daß sie auf Ihre Musikordner zeigen, aber für einen unkomplizierten Einstieg empfehle ich, die mitgelieferte Konfigurationsdatei erstmal unverändert zu lassen.
Liedtexte müssen denselben Dateinamen wie die entsprechende Musikdatei haben, unsynchronisierte die Namenserweiterung .txt, synchronisierte die Namenserweiterung .lrc. Die Texte können im Verzeichnis für Texte (hier Lyrics) gesammelt werden, dürfen sich aber auch im selben Verzeichnis wie das zugehörige Musikstück befinden.

Starten
Beim ersten Start liest Lyrics_Jukebox die ID3-Tags aller Musikdateien für seine interne Wiedergabeliste, legt einen Bildercache an und extrahiert alle Coverbilder, berechnet die Zufallsreihenfolge für die Wiedergabe und korrigiert entstandene Wiederholungen von Interpreten oder Musikstücken. Der Fortschritt wird dabei durch eine Textzeile am unteren Bildrand gemeldet.
Die Musikbox-Betriebsart kann erst aufgerufen werden, nachdem die Vorgänge abgeschlossen sind. Wie lange das dauert, hängt von Ihrer Hardware und der Anzahl der Musikdateien ab, rechnen Sie beispielsweise mit einer Minute je 100 Dateien. Wird das Jukebox-Symbol vorher betätigt, erscheint eine Sanduhr, an der Sie den Fortschritt ebenfalls sehen.

Konfiguration bearbeiten
Um die Einstellungen des Programms zu verändern, muß man einen Texteditor bemühen und die mitgelieferte Konfiguration (Lyrics_Jukebox.config) bearbeiten. Die Einträge dort sind kommentiert, und hier finden Sie auf der Seite Konfi­guration diese Beschreibungen ebenfalls. Lassen Sie sich nicht durch die Vielzahl an Parametern abschrecken, die meisten davon brauchen Sie nicht zu ändern. Am wichtigsten sind die beiden Angaben der Verzeichnisse für Musik und für die Textdateien.

Hinweise

Plugins: Um lauffähig zu sein, benötigt Lyrics_Jukebox die beiden Plugin-Dateien avcodec.hwp und svgimage.hwp, die ich gleich mitliefere. Das Verzeichnis Plugin-Lizenzen enthält die für ihre Weitergabe erforderlichen Lizenzdokumente und Readme-Dateien.
Diese Plugins stammen aus dem Hollywood-Download­bereich. Die Downloadlinks befinden sich dort in den Zeilen AVCodec und SVG in der Spalte für Ihr Betriebssystem. Ab und zu gibt es Updates dieser Plugins, die ich hier vielleicht nicht so schnell aktualisiere, dann kann es sinnvoll sein, sich neuere Versionen direkt herunterzuladen. Die Versionsnummern der Plugins finden Sie in den README-Dateien.

Besonderheit beim Mac: Beim Betrieb unter macOS sucht Lyrics Jukebox an mehreren Stellen nach der Konfigurationsdatei Lyrics_Jukebox.config. Wenn sie, so wie bei den Versionen für andere Betriebssysteme, neben dem Programm (der „App“) liegt, verhält sich Lyrics Jukebox genauso wie beschrieben. Falls Sie das Programm aber beispielsweise in Ihren Applications-Ordner legen wollen, dann ist das nicht zweckmäßig. Daher können Sie die Konfigurationsdatei auch entweder in den Ordner Resources des Anwendungspakets legen oder (besser) in den Ordner ~/Library/Application Support/LyricsJukebox. In beiden Fällen ist dieser Ordner LyricsJukebox dann der Ausgangspunkt für relative Pfadangaben in der Konfiguration.
Diese Variante würde ich auch empfehlen, wenn Sie Lyrics Jukebox dauerhaft auf Ihrem Mac behalten wollen: Die App also nach /Applications (im Finder „Programme“ genannt) und alles andere aus dem heruntergeladenen MacOS-Ordner in den ausgehend von Ihrem Benutzerordner (ggf. neu anzulegenden) Ordner Library/Application Support/LyricsJukebox.

Probleme und Lösungen

• Erscheint beim Programmstart eine Fehlermeldung der Art
  This program requires avcodec.hwp!
  dann fehlt das genannte Plugin oder es ist die Version für ein anderes Betriebssystem. Auch die Prozessorarchitektur (32 oder 64 Bit) muß stimmen.

• Wie kann man das Programm auf dem Mac ausführbar machen?
  Das geht auf verschiedene Weise. Einfach ist es mit einem Dateimanager wie beispielsweise Disk Order.
  Wer keine Scheu vor der Kommandozeile hat, kann aber auch Bordmittel benutzen:
  Nachdem Sie das Zip-Archiv entpackt haben, klicken Sie mit der rechten Maustaste (oder Control-Click bzw. Strg-Klick) auf das Programmsymbol Lyrics-Jukebox. Wählen Sie dann den Menüpunkt „Paketinhalt zeigen“, und öffnen Sie den Ordner Contents, darin den Ordner MacOS. Dort sehen Sie die zwei Dateien des noch nicht ausführbaren Programms.
  Öffnen Sie jetzt das Terminal (Launchpad aufrufen, „Terminal“ eintippen und das Terminalsymbol anklicken) und geben Sie folgendes ein:
  chmod +x 
  (ein Leerzeichen nach dem x). Ziehen Sie dann das Programmsymbol von Lyrics_Jukebox mit der Maus aus dem Finderfenster auf das Terminalfenster und lassen Sie es los. Das schreibt den Pfad und den Programmnamen ins Terminal hinter das Leerzeichen. Falls das Fenster unter älteren macOS-Versionen dabei nicht aktiv wird, wechseln Sie zum Terminalfenster (reinklicken). Drücken Sie nun Enter, um die Befehlszeile auszuführen.
  Wiederholen Sie das chmod noch für das Serviceprogramm Lyrics_Jukebox_Service.
  Verlassen Sie im Finder das Paket (dreimal auf Zurück). Jetzt sollte sich Lyrics-Jukebox starten lassen.
  Wenn sich der Mac dann noch beschwert, weil ich kein verifizierter Entwickler bin, dann öffnen Sie das Programm einmalig per Strg-Klick und Öffnen.

• Wie löst man auf dem Mac Probleme mit der Quarantäne?
  Wenn Sie auf dem Mac mit Safari ein Zip-Archiv aus dem Internet herunterladen, wird es (bei Safari-Standardeinstellungen) automatisch entpackt und manchmal in einen Quarantäne-Status versetzt (wann das passiert und wann nicht, das weiß nur Apple). Enthält dieses Archiv ausführbare Programme, die nicht signiert sind, dann kann man sie, sobald sie ausführbar gemacht wurden, zwar starten, aber dabei wird eine zusätzliche Sicherheitsfunktion aktiviert, die das Programm in einen zufällig gewählten neuen Pfad verlagert und dort mit Einschränkungen startet. Lyrics Jukebox kann dann seine im Update 0.9.220 hinzugekommene Servicekomponente nicht aktivieren und zeigt eine Warnmeldung an.
  Nachfolgend beschreibe ich, wie man diesen Zustand vermeidet oder behebt, aber das gilt wahrscheinlich nicht für alle macOS-Versionen, so daß Sie vielleicht etwas probieren müssen. (Stichwörter für eine Internetsuche sind „App Translocation“, „Gatekeeper Path Randomization“ und „com.apple.quarantine“.)

  • Laden Sie Lyrics Jukebox nicht mit Safari, sondern mit Chrome herunter. Oder benutzen Sie einen anderen Computer und bringen Sie das Programm auf einem USB-Stick zum Mac. Damit vermeiden Sie, daß das Programm in Quarantäne gerät.
  • Wenn Lyrics Jukebox bereits in Quarantäne ist, dann gehen Sie fogendermaßen vor:
    Starten Sie das Terminal (vergl. den vorherigen Abschnitt zum Ausführbarmachen). Führen Sie den Befehl xattr auf Lyrics_Jukebox aus, um die erweiterten Attribute anzuzeigen. Liegt das Programm beispielsweise im Ordner Programme (der unübersetzt eigentlich Applications heißt), dann sollte die Befehlszeile dafür so aussehen:
    xattr /Applications/Lyrics_Jukebox.app
    Wenn die Quarantäne zugeschlagen hat, dann wird als Ant­wort darauf com.apple.quarantine ange­zeigt. Ist das der Fall, dann geben Sie fol­gende Zeile ein:
    sudo xattr -cr /Applications/Lyrics_Jukebox.app
    Das sudo fordert Administrator­rechte an, also fragt es nach dem Paß­wort, und xattr löscht mit dem Argu­ment -cr alle erweiter­ten Attri­bute aller Ob­jekte des Anwendungs­pakets und damit auch den Quaran­täne-Zu­stand com.apple.quarantine.
    Danach sollte Lyrics Jukebox laufen.
  
  
• Radio läßt sich nicht starten
  
  • VLC-Player fehlt
  • VLC-Player ist nicht im Standardpfad installiert.
    Überprüfen Sie den Konfigurationseintrag VLCExecutable, mit dem man den Pfad ändern kann. Die Standardpfade finden Sie dort auch.
    
  • VLC-Player läuft bereits im Teminalmodus, aber mit einem unbekannten Paßwort.
    Überprüfen Sie den Konfigurationseintrag VLCPassword.
  • Die Liste der Radiostationen, die in der Konfiguration bei RadioStations angegeben ist, wurde nicht gefunden.