1ORG.BLUEZ.MEDIAFOLDER(5) Linux System Administration ORG.BLUEZ.MEDIAFOLDER(5)
2
3
4
6 org.bluez.MediaFolder - BlueZ D-Bus MediaFolder API documentation
7
9 Service
10 unique name (Target role) org.bluez (Controller role)
11
12 Interface
13 org.bluez.MediaFolder1
14
15 Object path
16 freely definable (Target role) [variable pre‐
17 fix]/{hci0,hci1,...}/dev_XX_XX_XX_XX_XX_XX/playerX (Controller
18 role)
19
20 Methods
21 object Search(string value, dict filter)
22 Return a folder object containing the search result.
23
24 To list the items found use the folder object returned and pass to
25 ChangeFolder.
26
27 Possible Errors:
28
29 org.bluez.Error.NotSupported
30
31 org.bluez.Error.Failed
32
33 array{objects, properties} ListItems(dict filter)
34 Return a list of items found
35
36 Possible Errors:
37
38 org.bluez.Error.InvalidArguments
39
40 org.bluez.Error.NotSupported
41
42 org.bluez.Error.Failed
43
44 void ChangeFolder(object folder)
45 Change current folder.
46
47 Note: By changing folder the items of previous folder might be de‐
48 stroyed and have to be listed again, the exception is NowPlaying
49 folder which should be always present while the player is active.
50
51 Possible Errors:
52
53 org.bluez.Error.InvalidArguments
54
55 org.bluez.Error.NotSupported
56
57 org.bluez.Error.Failed
58
59 Properties
60 uint32 NumberOfItems [readonly]
61 Number of items in the folder
62
63 string Name [readonly]
64 Folder name:
65
66 Possible values:
67
68 "/Filesystem/..."
69 Filesystem scope
70
71 "/NowPlaying/..."
72 NowPlaying scope
73
74 Note: /NowPlaying folder might not be listed if player is stopped,
75 folders created by Search are virtual so once another Search is per‐
76 form or the folder is changed using ChangeFolder it will no longer
77 be listed.
78
79 Filters
80 uint32 Start
81 Offset of the first item.
82
83 Default value: 0
84
85 uint32 End
86 Offset of the last item.
87
88 Default value: NumbeOfItems
89
90 array{string} Attributes
91 Item properties that should be included in the list.
92
93 Possible Values:
94 "title", "artist", "album", "genre", "number-of-tracks",
95 "number", "duration"
96
97 Default Value: All
98
99
100
101
102BlueZ September 2023 ORG.BLUEZ.MEDIAFOLDER(5)