Benutzer-Werkzeuge

Webseiten-Werkzeuge


coverart

shadowman's coverart

Diese Beschreibung ist eine Kombination aus Info aus dem Thread unten sowie der readme Datei, die dem Tool beiliegt. Bis version 0.40 von shadowman auf Aktualität und Konsistenz gecheckt.

Funktionsweise

Es wurde ein Hintergrundservice erstellt, der permament den Fidel bzgl. des aktuell gespielten Titels befragt, hierzu ein Coverimage von Amazon herunterlädt und zur Anzeige bringt. Die ermittelten Cover werden in einem Cache gespeichert und stehen zukünftig offline zur Verfügung.

Ein Hintergrundprozess optimiert die Cover zusätzlich auf die von Leonore verwendete Grösse von 200×200 Pixeln.

Das Paket stellt im Verzeichnis bin die ausführbaren Dateien artwork.sh, coverart und setenv.sh zur Verfügung. coverart implementiert die eigentliche Fuktionalität. setenv.sh definiert das Environment und artwork.sh ist das Skript zum installieren, deintallieren sowie starten und stoppen des Hintergrunddienstes.

Das Installationsscript importiert die mitgebrachte Apache Konfiguration in die bestehende Installation. Nach dem Aufruf von artwork.sh install sollte in der Datei /opt/apache/conf/httpd.conf folgender Eintrag vorhanden sein.

Include "/audio/opt/coverart/apache/http.coverart.conf"

Das hiermit geladene Apache Modul mod_ext_filter sorgt zusammen mit dem Script leonore.hook für die integration des Web GUI.

Installation

Installieren

Die Datei coverart.tgz herunterladen und ins Importverzeichnis speichern. Telnetsession starten und folgende Kommandos eingeben:

# evtl. vorhandenen Service Stoppen 
artwork.sh stop 

# Datei entpacken 
tar -xzf /audio/import/coverart.tgz -C /audio 

# Environment setzten 
source /audio/opt/coverart/bin/setenv.sh 

# Service installieren, MUSS unbedingt aufgerufen werden !! 
artwork.sh install 

# Service Starten 
artwork.sh start 

# Apache Durchstarten 
/etc/init.d/httpd restart

Ab dem nächsten Systemstart sollte das Enviroment automatisch gesetzt und der Dienst gestartet werden.

Deinstallieren

komplett deinstallieren

# Services deregistrieren 
/audio/opt/coverart/bin/artwork.sh uninstall 

# Verzeichnis löschen 
rm -rf /audio/opt/coverart 

Nur den Cache löschen

# Service stoppen 
/audio/opt/coverart/bin/artwork.sh stop 

# Cache löschen 
 rm /audio/opt/coverart/db/coverartwork.db 

# Service starten 
/audio/opt/coverart/bin/artwork.sh start

Befehle

./artwork.sh {start|stop|install|uninstall}:
  start   ...  Starts the coverart Service.
  stop    ...  Stops the coverart Service.
  install  ..  Installs the coverart Service.
  uninstall .  Uninstalls the coverart Service.

Coverart Web Interface

Durch einen Doppelklick in Leonore auf das im Player angezigte Cover wird die Coverart Web GUI gestartet. Hier stehen zur Zeit drei Funktionen zur Verfügung. Die Funktionen für Hochladen und Vorschläge anschauen beziehen sich auf den Song der gespielt wurde, ald die GUI startete.

Cover hochladen Mittels File-Upload kann ein neues Cover eingespielt werden.
web-gui-upload.jpg

Vorschläge ansehen Standardmäßig wird immer das erste von Amazon gefundene Cover verwendet. Da sich die Qualität der Images je nach Amazon Site unterscheidet können hier die Vorschläge gesichtet und manuell ausgewählt werden.
web-gui-suggest2.jpg

Einstellungen Die Services können auf verschiedene Weise parametrisiert werden.
web-gui-settings.jpg

Die Einstellungen des CoverCache haben folgende Auswirkungen Das aktivieren von „Cover optimieren“ schaltet das Image resampling auf 200×200 Pixel ein. Falls die zweite Option “.. während abspielen optimieren“ deaktiviert ist werden die images erst resampled falls der Hifidelio Player gestoppt ist.

Die zu verwendenden Amazon Sites können per drag'n drop Aus- bzw. Abgewählt werden. Bei mir haben sich die Sites .de und .com als praktikabel herausgestellt. Die Reihenfolge der aufgerufenen Amazon Sites kann wird ebenfalls über diesen Weg eingestellt. Die Qualität der von Amazon gelieferten Images unterscheidet sich teilweise graviered je nach Site.

Manuelles Bearbeiten

Da die automatische Funktion keine 100% Trefferquote bietet, kann der Cache über die Kommandozeile bearbeitet werden:

Funktionen:

Service Optionen Funktion
coverart query --artist --album --title fragt den Cache ab
coverart update --key --url Wird zum manuellen Bearbeiten eines Eintrages genutzt
coverart insert --artist --album --url
coverart delete --key Löscht einen vorhandenen Eintrag aus dem Cache
coverart showempty Zeigt Einträge für die kein Cover ermittelt werden konnte und eine manuelle Nachbearbeitung nötig ist


Optionen (entsprechend der Programmhilfe in Englisch):

--help, -h prints this message
--cachedb=name -c name is the full qualified filename for the cache database
The database will be created on demand
--noresample disables image resampling
--nocache disables image caching
--key The Cache-Key to use for update or delete command
--url=name The Filename which indentifies the image to load or store into
set to --url=http://.... to load an image from web
set to --url=file:/audio/import/image.png to load a local file
--artist=name The artist to query. Set to % for all.
--album=name The album to query. Set to % for all
--title=name The title to query. Set to % for all


coverart query - fragt den Cache ab

usage: coverart query  --artist --album|--title
options are:
      --artist=name   - The artist to query. Set to % for all.
      --album=name    - The album to query. Set to % for all.
      --title=name    - The title to query. Set to % for all

Beispiel:

coverart query --artist="k's choi%"
Query Database /audio/opt/coverart/db/coverartwork.db for k's choi%, %
Query Cached  Albumcover for Artist: k's%
   ID - Artist - Album/Title:
    6 - K's Choice - Live
  257 - K's Choice - Paradise In Me
  316 - K's Choice - Almost Happy
  439 - K's Choice - The Great Subconscious Club

coverart update - Wird zum manuellen Bearbeiten eines Eintrages genutzt.

usage: coverart update --key --url|--empty
options are:
      --key       - The Cache-Key to use for update or delete command
      --url=name  - The Filename which indentifies the image to load or store into
                  - set to --url=http://.... for load an image from web
                  - set to --url=file:/audio/import/image.png to load a local file.
      --empty     - Sets the cache entry to an empty image.

Beispiel:

coverart update --key=529 --url=http://images.bol.de/images-adb/2c/bc/2cbc1491-77d7-4c53-a373-ab061852962b.jpg
Update Database /audio/opt/coverart/db/coverartwork.db for Key 529
Try downloading from http://images.bol.de/images-adb/2c/bc/2cbc1491-77d7-4c53-a373-ab061852962b.jpg
OK
Updating Record,
  Id     = 529
  Artist = Huey Lewis & The News
  Title  =
  Album  = The Heart Of Rock 'n' Roll
  Image  = 17798 Bytes from http://images.bol.de/images-adb/2c/bc/2cbc1491-77d7-4c53-a373-ab061852962b.jpg
Updating Image for Key: 529

coverart delete - Löscht einen vorhandenen Eintrag aus dem Cache

coverart delete --key=123

coverart showempty - Zeigt alle Einträge für die kein Cover ermittelt werden konnte und eine manuelle Nachbearbeitung nötig ist.

Ein Aufruf von coverart –help gibt eine Hilfe aus.

Stopworte

Die Stopworte können über die Optionen eingepflegt werden. Jede Zeile wird als ein Ausdruck gewertet. Es werden auch Reguläre Ausdrücke ausgewertet. Ein Onlinetutorial mit Testmöglichkeit gibt es unter http://www.regular-expressions.info

Zunächst sind drei Ausdrücke konfiguriert:

  1. \(*CD *[0-9]\)*
  2. Remastered
  3. \(*disc *[0-9]\)*

Für den Ausdruck 1 werden im Albumtitel vor der Suche folgende Worte entfernt: CD1, CD 1, (CD1), (CD 2). Analog dazu arbeitet Ausdruck 3. Ausdruck 2 entfernt nur das Wort „Remastered“.

Mausrad

Im Leonore Browser kann zum Scrollen das Mausrad verwendet werden

Features

Version 0.1

  • Automatisches Ermitteln und Anzeige von Coverartworks in Leonore
  • Hintergrundprozess für Image Resampling auf 200×200 Pixeln
  • Nachbearbeitung über Kommandozeile

Version 0.2

  • Resourcenverbrauch wurde optimiert
  • Die Titelsuche wurde etwas flexibler
  • Spontanes löschen und neuladen des Covers sollte nicht mehr auftreten
  • Beim installieren wird der link zum automatischen Starten nach dem Hochfahren gesetzt

Version 0.3

  • In Leonore integrietes Webinterface - Upload von Images mittels Browser
  • Blättern und Auswahl der Vorschläge von Amazon
  • Einstellungen
  • Mausrad im Browser

Version 0.35

  • Der eingebettete HTTP Server wurde wegen Speicher- und Stabilitätsproblemen entfernt. Die Web-Schnittstelle ist jetzt als CGI Programm implementiert. Dies hat zwar neg. Auswirkungen auf die Performance, aber ich denke Stabilität ist hier wichtiger.
  • Aus dem grund wurde die gesamte Funktionalität ist eine Shared Library gelinkt.
  • Die Apache-Module mod_proxy.so und mod_proxy_http.so sind nicht mehr notwendig und wurden entfernt.
  • Der Resourcenverbrauch im Hintergrundbetrieb wurde optimiert.
  • Die Images werden von Veronica besser erkannt.
  • Fehlermeldungen in der GUI wurden überarbeitet.
  • Nach einem Firmwareupdate entffällt das manuelle neu registrieren im Apache.
  • Erkennen von schnellem „Weiterzappen“ und anzeigen des korrekten Covers

Version 0.40

  • Selbstständiges löschen und Wiederanzeigen des aktuellen Cover wurde behoben
  • Für mp3 Dateien werden die ermittelten Cover in die ID3 Tags geschrieben. Das Feature ist Standardmäßig deaktiviert, kann aber über die Optionen aktiviert werden.

Version 0.42

  • Das GUI wurde überarbeitet. Es ist jetzt möglich das Popupfenster zu verschieben oder in der größe zu ändern.
  • Die Ermitteln der Cover-Vorschläge wurde verbessert.
  • Auf besonderen Wunsch von RESISTOR werden Stopworte zur Titelabfrage verwendet.
  • Die Felder für Titel und Interpret sind editierbar. Die hier eingegebenen Werte werden zur Abfrage bei Amazon verwendet. Für eines der beiden Felder kann ein Leerstring eingegeben werden. So werden entweder alle Alben mit dem gewünschten Namen abgefragt, oder es werden Informationen für den eingegebenen Interpreten abgefragt. Der Button 'Suchen' startet die Abfrage bei Amazon.
  • Die untere Auswahlbox stellt folgende Informationen zur Verfügung:
    • Album - Der im Fidel bekannte Albumtitel
    • Titel - Der im Fidel bekannte Songtitel
    • Albumvorschläge - von musicbrainz.org ermittelte Vorschläge, auf welchem Album der Song vorhanden ist.

Bekannte Probleme

  • Zur Zeit keine.
coverart.txt · Zuletzt geändert: 2007/08/20 11:41 (Externe Bearbeitung)