TRACKER-XDG-PORTAL(1)

💅 tracker-xdg-portal-3 — the Tracker manual, bestie edition ✨

okay so real talk: this page is from the Tracker manual, and it's about tracker-xdg-portal-3, aka the portal to Tracker endpoints 🎀

---

✨ NAME ✨

tracker-xdg-portal-3 — portal to Tracker endpoints, no cap 🫶

---

🌸 SYNOPSIS 🌸

tracker-xdg-portal-3 [--version | -v]

that's it. that's the whole synopsis. lowkey iconic of it 💅

---

🦋 DESCRIPTION 🦋

so this daemon is literally the bouncer at the club 🧚 — it lets people access Tracker endpoints, but in a controlled manner. main character energy, honestly.

by default, access to every single service is disallowed. like, all of them. closed. gone. not invited 🙈

services can get whitelisted though, through extra policy in the .flatpak-info file ✨

and when you do whitelist services, the policy can be specific about it — it may define:

• specific graph names to allow access to
• the default keyword, which allows access to the default unnamed graph
• the * keyword, which allows access to all graphs 👑

---

🎀 CONFIGURATION 🎀

when it's interacting with sandboxed clients, the service expects this exact format in the .flatpak-info file, bestie:

[Policy Tracker3]
dbus:org.example.SparqlEndpoint1=graphA;graphB;default
dbus:org.example.SparqlEndpoint2=*

ok so what does that mean? it means access is allowed to the endpoints behind the org.example.SparqlEndpoint1 and org.example.SparqlEndpoint2 bus names 💖

but not just "all access, do whatever" — nope. on the first endpoint it's only the graphA and graphB graph IRIs plus the default unnamed graph. and on the second endpoint it's all graphs. slay 🦋

you can set this policy when building or running the sandboxed application, through the --add-policy option ✨ and you've got options, queen:

• via finish-args in the flatpak manifest
• specified along the build chain in flatpak-build-finish(1)
• modified at start time with flatpak-run(1)

for example, check it:

$ flatpak run \
  --add-policy=Tracker3.dbus:org.example.SparqlEndpoint1=graphA \
  --add-policy=Tracker3.dbus:org.example.SparqlEndpoint1=graphB \
  --add-policy=Tracker3.dbus:org.example.SparqlEndpoint1=default \
  --add-policy=Tracker3.dbus:org.example.SparqlEndpoint2=* \
  org.freedesktop.TrackerSandbox

fruit snacks for everyone who reads that without squinting 🍓

---

👀 SEE ALSO 👀

go read these too, iykyk 💜

• flatpak-build-finish(1)
• flatpak-override(1)
• flatpak-run(1)

---

okay that's the whole page!! mwah 💋

this masterpiece is version 3.7.3, dated 10/29/2024, from the Tracker manual — go forth and portal responsibly, bestie 🌈👑