Appendice B. Interfaccia D-Bus

Indice

Esempi di D-Bus
API D-Bus
Aprire un file o una cartella
Scaricare i tag di tutti i file che non sono stati modificati o selezionati
Salvare tutti i file modificati
Ricevere un messaggio di errore dettagliato fornito da alcuni metodi
Ripristina le modifiche nei file selezionati
Avvia un'importazione in serie automatica
Importare i tag da un file
Importare i tag da altri tag
Importare i tag da altri tag sui file selezionati
Scaricare la copertina dell'album
Esportare tag in un file
Creare una scaletta
Ottenere gli elementi di una scaletta
Impostare gli elementi di una scaletta
Uscire dall'applicazione
Selezionare tutti i file
Deselezionare tutti i file
Impostare il primo file come file attuale
Impostare il file precedente come file attuale
Impostare il file successivo come file attuale
Selezionare il primo file
Selezionare il file precedente
Selezionare il file successivo
Selezionare il file attuale
Espandere o contrarre l'elemento attuale se è una cartella
Applicare il formato del nome del file
Applicare il formato del tag
Applicare la codifica del testo
Impostare il nome della cartella dai tag
Impostare i numeri di traccia successivi nei file selezionati
Filtrare i file
Convertire i tag ID3v2.3 in ID3v2.4
Convertire i tag ID3v2.4 in ID3v2.3
Ottenere il percorso della cartella
Ottenere il nome del file attuale
Impostare il nome del file selezionato
Impostare il formato da utilizzare quando si imposta il nome file dai tag
Impostare i nomi dei file selezionati dai tag
Ottenere il valore del frame
Impostare il valore del frame
Ottenere tutti i frame da un tag
Ottenere informazioni tecniche sul file
Impostare un tag dal nome del file
Impostare un tag da un altro tag
Copiare un tag
Incollare un tag
Rimuovere un tag
Elaborare nuovamente la configurazione
Riproduce i file selezionati

Esempi di D-Bus

Su Linux®. un'interfaccia D-Bus può essere utilizzata per controllare Kid3 tramite script. Gli script possono essere scritti in qualsiasi linguaggio con associazioni D-Bus (ad es. in Python) e possono essere aggiunti alle Azioni dell'utente per estendere le funzionalità di Kid3.

L'artista nel tag 2 del file attuale può essere impostato sul valore «One Hit Wonder» con il seguente codice:

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

o più semplicemente con qdbus di Qt™ (qdbusviewer può essere utilizzato per esplorare l'interfaccia in una GUI):

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");