Bijlage B. D-Bus-interface

Inhoudsopgave

Voorbeelden met D-Bus
D-Bus API
Bestand of map openen
Ontlaad de tags van alle bestanden die niet zijn gewijzigd of geselecteerd
Alle gewijzigde bestanden opslaan
Krijgt een gedetaileerde foutmelding geleverd door sommige methoden
Draait wijzigingen in de geselecteerde bestanden terug
Start een automatische bulkimport
Tags importeren uit een bestand
Tags importeren uit andere tags
Tags importeren uit andere tags uit geselecteerde bestanden
Hoesillustratie van album downloaden
Tags exporteren naar een bestand
Een afspeellijst aanmaken
Items uit een afspeellijst halen
Items van een afspeellijst instellen
Sluit de toepassing
Alle bestanden selecteren
Selectie van alle bestanden ongedaan maken
Het eerste bestand als het huidige bestand instellen
Het vorige bestand als het huidige bestand instellen
Het volgende bestand als het huidige bestand instellen
Het eerste bestand selecteren
Het vorige bestand selecteren
Het volgende bestand selecteren
De huidige bestand selecteren
Het huidige bestandsitem uit- of invouwen als het een map is
Het bestandsnaamformaat toepassen
Het tagformaat toepassen
Tekst-codering toepassen
Mapnaam uit de tags instellen
Opvolgende tracknummers instellen in de geselecteerde bestanden
De bestanden filteren
ID3v2.3 tags naar ID3v2.4 converteren
ID3v2.4 tags naar ID3v2.3 converteren
Pad van map ophalen
Naam van huidig bestand ophalen
Naam van geselecteerd bestand instellen
Te gebruiken formaat instellen bij instellen van de bestandsnaam uit de tags
De bestandsnamen van de geselecteerde bestanden instellen uit de tags
Waarde van frame ophalen
Stelt waarde van frame in
Alle frames van een tag ophalen
Technische informatie over bestand ophalen
Tag uit bestandsnaam instellen
Tag instellen uit andere tag
Tag kopiëren
Tag plakken
Tag verwijderen
De configuratie opnieuw inlezen
Speelt de geselecteerde bestanden

Voorbeelden met D-Bus

Op Linux® kan een D-Bus-interface gebruikt worden om Kid3 te besturen door scripts. Scripts kunnen geschreven worden in elke taal met D-Bus-bindingen (bijv. in Python) en kunnen toegevoegd worden aan de Gebruikeracties om de functionaliteit van Kid3 uit te breiden.

De artiest in tag 2 van het huidige bestand kan ingesteld worden op de waarde "One Hit Wonder" met de volgende code:

Shell
dbus-send --dest=org.kde.kid3 --print-reply=literal \
/Kid3 org.kde.Kid3.setFrame int32:2 string:'Artist' \
string:'One Hit Wonder'

of gemakkelijker met qdbus (qdbusviewer van Qt™ om het interface in een GUI te onderzoeken):

qdbus org.kde.kid3 /Kid3 setFrame 2 Artist \
'One Hit Wonder'
Python
import dbus
kid3 = dbus.SessionBus().get_object(
  'org.kde.kid3', '/Kid3')
kid3.setFrame(2, 'Artist', 'One Hit Wonder')
Perl
use Net::DBus;
$kid3 = Net::DBus->session->get_service(
  "org.kde.kid3")->get_object(
  "/Kid3", "org.kde.Kid3");
$kid3->setFrame(2, "Artist", "One Hit Wonder");