TINYSPARQL-XDG-POR(1)

✨ NAME ✨

okay so this is tinysparql-xdg-portal-3 β€” the Portal to Tracker endpoints, bestie πŸ’… and yes we're diving into the TinySPARQL manual rn, buckle up πŸŽ€


πŸ¦‹ SYNOPSIS πŸ¦‹

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

that's it. that's the whole vibe check 😌 short and iconic πŸ‘‘


πŸ”₯ DESCRIPTION πŸ”₯

so this little daemon right here lets you access TinySPARQL endpoints in a controlled manner β€” like, it's not just handing out keys to the whole kingdom, it's giving bouncer-at-the-club energy πŸ’€

by default, access to every single service is disallowed. nothing. nope. zero. zilch πŸ™ˆ the services only get let in if you whitelist them through some extra policy in the .flatpak-info file ✨

and when you do whitelist a service, the policy can 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 🌈 (iconic, honestly)

🧚 CONFIGURATION 🧚

when it's interacting with sandboxed clients, the service expects this exact format in the .flatpak-info file πŸ‘‡

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

so what does that actually do, you ask? πŸ€” it allows access to the endpoints behind the org.example.SparqlEndpoint1 and org.example.SparqlEndpoint2 bus names 🚌✨ but listen carefully:

  • on the first endpoint, only to the graphA and graphB graph IRIs and the default unnamed graph πŸŽ€
  • on the second endpoint, to all graphs 🌸

ngl that's a pretty clean policy, periodt πŸ’…

you can set this policy when building or running the sandboxed application through the --add-policy option πŸ”§ it can be set via finish-args in the flatpak manifest, specified along the build chain in flatpak-build-finish(1), or modified at start time with flatpak-run(1) ⭐ for example:

$ 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.ExampleSandbox

look at that manifest go 😭 it's giving organizational queen πŸ‘‘

⚠️ real talk: those --add-policy values have to match the .flatpak-info format exactly β€” no improvising, no freestyle, bestie πŸ™

πŸ’– SEE ALSO πŸ’–

go read these next, iykwyk 🫢


and that's the whole page, bestie!! πŸŽ‰ this was TinySPARQL manual 3.12.0, dated 09/15/2026 β€” screenshot it, cite it, live by it, mwah πŸ’‹πŸŒΈ

πŸ“¦ where this page comes from