TangoPlayer Dokumentation
| Installation | |||||||||||||||||
| Das Programm benötigt keine
Installation. Es reicht die RAR-Datei an einer beliebigen Stelle zu
entpacken. Es werden keine Registry-Einträge vorgenommen und auch
keinerlei Dateien in andere Verzeichnisse kopiert.Um das Programm wieder
loszuwerden muss man nur das Verzeichnis löschen. Diese Dateien sind in dem RAR-Archiv enthalten:
Gestartet wird die Datei "Tangoplayer.exe".
Es kann nur eine Instanz gestartet werden! Beim ersten Start werden zwei
neue Dateien erzeugt: - Das Programm kann auch mit Parametern gestartet werden um verschiedene Ini-Dateien und Datenbanken zu verwenden: TangoPlayer.exe -s Inidatei -d Datenbank Datenbank und Inidatei sind die Dateinamen und Pfade zu den gewünschten Dateien. wird kein Pfad angegeben dann werden die Dateien im Anwendungsverzeichnis gesucht und ggf. angelegt.
Abstürze:
|
| Datenbank | |||||||||||||||||||||||||||||||||||
| TangoPlayer benutzt eine
SQLite-Datenbank (ver.3) als zentrales Element um die Musik zu
organisieren. Die Datenbank ist eine einzelne Datei mit dem Namen
'archive.db3'. Alle Informationen über die Musik wird darin abgelegt.
Beim Importieren von Musik werden die ID3-Tags der einzelnen Songs
ausgelesen und in der Datenbank gespeichert.Sie sind dann direkt vom
Programm aus änderbar und können auch in die Songdateien zurück
geschrieben werden. (s. "Editiere ID3 Tags") Die Titel-Datenbank verwaltet einen Record pro Musikdatei der folgende Informationen enthält:
Es existieren noch weitere
Datenbanktabellen die Sammlungen, Histories, Cortinas, Importe etc.
verwalten. |
| Die verschiedenen Fenster | |
|
Allgemeines
|
| Playerfenster | ||||||||||||||||||||||||||||||
| Das Fenster stellt die
Bedienelemente für Volume, Balance sowie die Steuerungen
Stop-Start-Pause-Next bereit. Innerhalb eines Stückes kann über Klick in den Fortschrittsbalken positioniert werden. Die Aussteuerungsanzeige ist erst ab Windows-Vista und darüber vorhanden! Der Player bedient das Interface welches unter "Einstellungen-Audio" als Player-Interface konfiguriert wurde. Im unteren Teil sieht man die aktuelle Queue, den momentan geladenen Song und darüber die Liste der schon gespielten Songs. Die Queue kann per Drag-Drop gefüllt und umsortiert werden. Das Entfernen von selektierten Einträgen aus der Queue ist per "Entf"-Taste möglich. Der aktuelle Song kann mit "Entf" nur nach "Stop" gelöscht werden. Die Liste der gespielten Songs kann nicht mehr verändert werden, Songs können aber immer noch per Drag-Drop zurück in die Queue kopiert werden um sie wiederholt abzuspielen. Als Besonderheit können in die Queue auch Songs per Drag-Drop aus dem Windows-Explorer abgelegt werden. Damit ist ein Spielen von Musik die nicht vorher in die Datenbank importiert wurde möglich. Die Listen sind als Splitfenster organisiert, d.h. das Größenverhältnis zwischen Queue und Historie kann individuell eingestellt werden bis zum totalen Verschwinden der Historie und der Listenüberschrift. Damit kann die Displayfläche optimal angepasst werden Eine weitere Möglichkeit Platz zu optimieren ist die Umschaltung des Steuerelementebereiches in eine kleinere Ansicht. Im Gegensatz zu den Sammlungen und Abfragelisten werden in den Playerlisten weniger Informationen angezeigt:
Die gewünschten Spalten werden mittels Rechtsklick-Menü auf den Tabellenkopf ein- oder ausgeschaltet. Für jede der Listen öffnet sich bei
Rechts-Klick mit der Maus ein angepasstes Kontextmenü.
Mittels des Skip-wertes kann eine
einstellbare Zeit am Beginn eines Titels übersprungen werden. Diese
Einstellung ist temporär und wird nicht gespeichert |
||||||||||||||||||||||||||||||
| Navigationsfenster | ||||||||||||||||||||||||||||||
| Das Fenster verwaltet in
einer Hierarchischen Baumansicht den Zugriff auf die Songdatenbank über
verschiedene Suchkriterien: - Selbst definierte Datenbankabfragen - Sortierung nach Genres - Anzeige und Import von Playlisten - Zusammenstellung eigener Sammlungen - Anzeige der gespeicherten Abspielhistorie - Anzeige und Administration der Musik-Importe (s. "Einstellungen_Div") - Anzeige der Importierten Musik im Dateibaum (s. "Einstellungen_Div") Abhängig von der selektierten Ebene öffnet sich auf Rechts-Klick ein Kontextmenü für weitere Funktionen. Am unteren Rand des Fensters finden sich drei weitere Funktionen: - Auswahl der anzuzeigenden Listen - Öffnen des Quick-Suchfensters - Sperren der Datenbank gegen zufällige Änderungen |
||||||||||||||||||||||||||||||
| Listenfenster | ||||||||||||||||||||||||||||||
Folgende Informationen sind
für jede Zeile der Liste verfügbar:
Klick auf den Header eine Spalte sortiert
die Liste alphabetisch/numerisch.
Der Unterschied zwischen Playlisten und
Sammlungen besteht darin dass Playlisten externe Dateien sind die
Dateipfade zu Songs enthalten die nicht in der Datenbank enthalten sein
müssen. (werden beim ersten Mal automatisch importiert). Sammlungen
dagegen beziehen sich auf Songs die in der Datenbank enthalten sind und
werden auch dort gespeichert. |
| Schnellsuche | ||
| Das ist eine spezielle
Liste die es ermöglicht Songs nach ausgewählten Kriterien schnell zu
finden. Geöffnet wird sie über Klick in die linke, obere Ecke einer beliebigen Liste oder auf das Lupensymbol im Navigationsfenster. Gesucht werden kann nach:
Die eingegebenen Suchkriterien (auch nur
Textteile) werden UND verknüpft nach diesem Schema: |
| Cortinas | ||
| Das ist ein spezialisiertes
Fenster um häufig benutzte Musikstück schnell verfügbar zu haben.
Vergleichbar etwa mit einer Kurzwahltaste kann man Songs einem Button
zuordnen. Bei Klick wird der Song an das Ende der Playerqueue angefügt.
Neue Songs werden durch Auswahl oder Drag-Drop in die Cortinaliste
aufgenommen. Dazu: Klick auf den Einstellungsbutton. Jetzt können Songs aus anderen Listen in das Fenster gezogen werden. Eine Auswahl über den Dateidialog ist durch Klick auf den Button '+' möglich. Das Hinzufügen von Cortinas wird durch Klick auf den Haken beendet. Cortinas sollen manchmal lauter oder leiser als die eigentliche Musik abgespielt werden. Dazu kann man eine Verstärkung oder Dämpfung für alle Cortinas gemeinsam einstellen.Mit diesem Wert wird die aktuell eingestellte Lautstärke beim Abspielen einer Cortina korrigiert. Die Einstellung erfolgt in 3dB Schritten.(Wird der Maximalpegel überschritten hat die Einstellung keine Wirkung mehr!) Vorhören ist durch Klick auf den Kopfhörerbutton möglich. In diesem Modus werden die Cortinas auf Klick im Vorhörplayer abgespielt und nicht an die Queue angehängt. |
| Einstellungen | |
| Der Einstellungsdialog ist ein
Popupfenster das entweder über das Symbol am unteren Rand des Players
oder über das Kontextmenü jeder Liste geöffnet wird. Die unterschiedlichen Einstelloptionen sind in Tabs organisiert und werden beim OK-Schließen des Dialogs in der INI-datei oder der Datenbank gespeichert. |
| Audio | |||||||||||||||||||||
| Der Programm unterstützt zwei
unabhängige Audioschnittstellen. Eine wird für die Ausgabe des Players
verwendet die andere für den Vorhörplayer.
(Bei Verwendung eines Notebooks empfiehlt es sich die eingebaute
Audioschnittstelle für das Vorhören zu verwenden und dem Hauptplayer
eine externe USB-Audioschnittstelle zuzuweisen. Die interne
Schnittstelle produziert häufig mehr Störgeräusche.) Wird die Möglichkeit des Vorhörens nicht benötigt kann die Konfiguration des Vorhörplayers auf "Nicht benutzt" gesetzt werden. Damit werden auch die Playbuttons in allen Listen ausgeblendet. Die Anzeigegröße des Miniplayers kann zwischen groß und klein eingestellt werden. (Voreingestellt klein) |
|||||||||||||||||||||
| Kompressor | |||||||||||||||||||||
| Der Kompressor ist ein Hilfsmittel um
die Aussteuerung unterschiedlicher Songs etwas anzugleichen. Die Einstellungen sollten nicht zu aggressiv gewählt werden um die Musik nicht zu verfälschen.
|
|||||||||||||||||||||
| Tongenerator | |||||||||||||||||||||
| Der Tongenerator erzeugt unabhängig für
den rechten und linken Kanal Sinustöne unterschiedlicher Frequenz oder
Rauschen in verschiedenen Pegeln. Kann zum Soundcheck und optimalen Einstellung der Beschallung verwendet werden. Der Ton wird automatisch mit dem Schließen des Einstellungsdialogs beendet. |
|||||||||||||||||||||
| Playerfarben | |||||||||||||||||||||
| Dieser Dialog erlaubt es die
Farbdarstellung der Playerqueue anzupassen. Einstellbar sind die Hintergrundfarbe für jedes Genre separat sowie die Textfarbe und die Default Hintergrundfarbe (alternierend) |
|||||||||||||||||||||
| Listenfarben | |||||||||||||||||||||
| Dieser Dialog erlaubt es die
Farbdarstellung der Playerqueue anzupassen. Jede Liste kann eine eigene
Farbdarstellung erhalten. Die Einstellung erfolgt immer für das Fenster aus dessen Kontextmenü der Dialog aufgerufen wurde. Zusätzlich besteht noch die Möglichkeit die Liste mit Gitterlinien anzuzeigen und die Einstellung auch gleich auf alle Listen zu übertragen. |
|||||||||||||||||||||
| Stil & Sprache | |||||||||||||||||||||
| Das Aussehen der Oberfläche wird primär
über eine Konfigurationsdatei (.qss) gesteuert. Einige Konfigurationen
sind im Programm bereits eingebaut. Weiter liegen im Applikationsverzeichnis. Diese sind Textdateien und können als Vorlage zur Erstellung eigener Skins dienen. Die Farbeinstellungen der Dialoge "Listenfarben" und "Playerfarben" überschreiben die Skineinstellungen. Die Einstellung des Schriftfonts erfolgt für alle Fenster und Listen des Programms gleichzeitig. |
|||||||||||||||||||||
| Datenbank | |||||||||||||||||||||
| Über den Datenbankdialog lassen sich
verschiedene Datenbankoperationen anstoßen. Da die Datenbank zu diesem
Zeitpunkt geöffnet ist lassen sich bestimmte Funktionen nicht unmittelbar ausführen. In solchen Fällen wird die Anforderung beim nächsten Start des Programms bearbeitet.
|
|||||||||||||||||||||
| Div | |||||||||||||||||||||
|
|||||||||||||||||||||
| Tags | |||||||||||||||||||||
|
Der Dialog ermöglicht es alle
Datenbankeinträge mit den Daten aus den ID3-Tags der einzelnen Songs zu
aktualisieren. Es werden nur die Tags aktualisiert die über die Checkboxen ausgewählt sind. Der ReplayGain-Wert wird nicht in den Songs gespeichert und nur zurückgesetzt! |
|||||||||||||||||||||
| Über' | |||||||||||||||||||||
| Zeigt Copyright, aktuelle Version und Builddatum. |
| Sonstige Funktionen und zusätzliche Dialoge | ||||||||||||||||||
| Miniplayer | ||||||||||||||||||
| Ein kleines Playerwidget zum Vorhören
das geöffnet wird wenn auf einen der Vorhörbuttons in den Listen
geklickt wird. Dem Miniplayer wird eine eigene Audioschnittstelle
zugeordnet über die man z.B. mit Kopfhörer vorhören kann. Der Miniplayer
wird initial in der Nähe des Vorhörbuttons positioniert, kann aber
beliebig verschoben und festgepinnt werden. Die Bedienelemente sind
selbsterklärend: Play/Pause, Stop, Nächster, Vorheriger. Positionierung
ist über Klick in den Fortschrittsbalken möglich. Die Lautstärke kann über Klick auf das Lautsprechersymbol eingestellt werden. Der Miniplayer kann auch über Tasten bedient werden:
|
||||||||||||||||||
| "Neue Suche" | ||||||||||||||||||
| Mit Hilfe dieses Dialogs aus dem
Kontextmenü des Navigationsfensters lassen sich Datenbankabfragen
komfortabel erstellen und dauerhaft speichern. Als Suchkriterien können folgende Daten verknüpft werden:
Die Kriterien können logisch UND bzw.
ODER verknüpft werden. |
||||||||||||||||||
| "Editiere ID3 Tags" | ||||||||||||||||||
| Dieser Dialog wird aus dem Kontextmenü
der Listenfenster geöffnet. ID3 Tags eines Songs lassen sich direkt in einer Liste editieren sofern die Datenbank nicht gesperrt ist. (s. Navigationsfenster) In Fällen wo mehrere Einträge gleichzeitig editiert werden sollen empfiehlt sich dieser Dialog. Man markiert die zu editierenden Zeilen und öffnet den Dialog über das Kontextmenü. Die freigegebenen Einträge werden in alle Tags der selektierten Listenzeilen eingetragen. Das Schreiben erfolgt üblicherweise sowohl in die Datenbank als auch in die Musikdateien selbst (MP3 und FLAC). Das Schreiben in die Songdateien kann explizit ausgeschaltet werden! |
||||||||||||||||||
| "Importpfad neuzuordnen" | ||||||||||||||||||
| Dieser Dialog wird über das Kontextmenü
des Importbaumes im Navigationsfenster aktiviert. Das Problem ist folgendes: Liegen die Songs nicht auf der internen Festplatte sondern auf einem USB-Laufwerk dann ist nicht gewährleistet das die Laufwerksbezeichnung beim wiederholten Anstecken die Gleiche ist. Das Programm versucht diese Änderung beim Start zu erkennen und automatisch zu korrigieren. Es gibt aber Fälle in denen das nicht gelingt. Zum Beispiel auch beim Verschieben von Ordnern. In diesem Fall kann der Pfad eines Importes manuell neu zugewiesen werden. |
||||||||||||||||||
| "Exportiere Musik & Playliste" | ||||||||||||||||||
| Manchmal möchte man eine komplette Liste
von Musik in ihrer Reihenfolge auf einen anderen Datenträger auslagern.
Dazu hilft diese Funktion die über das Kontextmenü aller Listenfenster und des Historiebaumes aktiviert wird. Exportiert werden Songs und eine dazu gehörige Playliste an einen beliebigen Ort (z.B. USB-Stick) Aus Datenbanklisten werden die selektierten Songs exportiert, aus dem Historiebaum die komplette ausgewählte Historie. |
||||||||||||||||||
| "Als Playliste speichern" | ||||||||||||||||||
| Die Funktion wird über das Kontextmenü
der Listenfenster und des Players aktiviert. Speichert die selektierten Einträge als M3U-Playliste. So erzeugte Playlisten werden im Verzeichnis ./playlists abgelegt. |
||||||||||||||||||
| "Eigenschaften" | ||||||||||||||||||
| Zeigt alle verfügbaren Informationen für
einen selektierten Eintrag in den Listenfenstern oder dem Player an. Wird Über das Kontextmenü der Listenfenster und des Players aktiviert. |
||||||||||||||||||
| "Aus der Datenbank löschen" | ||||||||||||||||||
| Löscht die selektierten Einträge aus der
Datenbank, die Datei bleibt aber erhalten. Wird über das Kontextmenü der Listenfenster aktiviert. |
||||||||||||||||||
| "Vom Datenträger löschen" | ||||||||||||||||||
| Löscht die selektierten Einträge aus der
Datenbank und aus dem Dateisystem. Wird über das Kontextmenü der Listenfenster aktiviert. |
||||||||||||||||||
| "ID3-Tags neu laden" | ||||||||||||||||||
| Aktualisiert die Informationen in der
Datenbank für die selektierten Einträge durch erneutes Einlesen der
ID3-Tags aus den Songdateien. Wird über das Kontextmenü der Listenfenster aktiviert. |
||||||||||||||||||
| "Zur Schnellsammlung hinzufügen" | ||||||||||||||||||
| Fügt die selektierten Einträge zur Schnellsammlung hinzu. Existiert diese nicht wird sie erzeugt. Die Schnellsammlung ist nützlich wenn man beim Suchen Songs schnell merken will ohne sie erst per DragDop in eine Sammlung zu schieben. Ansonsten kann die Schellsammlung wie jede andere Sammlung benutzt, also auch einfach umbenannt werden. Bei Bedarf wird eine neue erzeugt. | ||||||||||||||||||
| "Editiere Playlist" | ||||||||||||||||||
| Öffnet den Playlisteditor. Playlisten sind Textdateien die die Pfadnamen als Referenzen zu den gesammelten Songs enthalten. Playlisten werden nur mittels ihres Namens durch das Programm verwaltet aber nicht verändert wenn sich beispielsweise der Dateipfad ändert. Das muß von Hand geschehen und genau dazu dient der Playlisteditor. | ||||||||||||||||||
| "Testen und Reparieren MP3 " | ||||||||||||||||||
| Testet und ggf. repariert kaputte MP3 Dateien. Die Originaldateien werden umbenannt mit der Endung '.org' . Reparierte MP3 sind logisch korrekt, es kann aber trotzdem sein das sie sich nicht oder nur mit Aussetzern abspielen lassen. | ||||||||||||||||||