himitsu-secret-service(5)

💖 himitsu-secret-service 💖

okay bestie, so this is the file formats manual page for himitsu-secret-service(5) — the one that explains what the heck is actually inside your Himitsu key store 👑✨

---

🌸 NAME 🌸

himitsu-secret-service — the format of the entries that himitsu-secret-service(7) uses 🎀

---

✨ DESCRIPTION ✨

So like, this page? It's the full tea on the format of the entries stored in the Himitsu key store by himitsu-secret-service 🫶. If you actually wanna know how to use himitsu-secret-service, that's a whole different vibe — go read himitsu-secret-service(7) instead, iykyk 💅.

---

🔑 KEY FORMAT 🔑

The Himitsu keys that himitsu-secret-service uses all have proto=secret-service, and then they define a bunch of other fields that can totally vary depending on which type of entry you're looking at 🌈. Here are the keys that every entry has in common, no cap:

• proto — literally just secret-service 💫
• xdg:collection — the collection this entry belongs to 🎀
• type — what kind of entry this is, and it can be collection, alias or item

The type is the main character here — it decides which other parameters show up 🌟. Dates are stored in the ISO 8601 datetime format, in UTC ⏰. UUIDs get used inside ids and they're stored without slashes, periodt ✂️.

Items hold the secret values plus some extra attributes, and items are grouped together into a collection 🧺. A collection can have multiple aliases, slay 💅.

---

🗂️ collection

A collection entry stores its name alongside other meta info 💖

• type — collection
• label — the user visible name of the collection 🏷️
• created — the date the collection was created at 📅
• modified — the date the collection was last modified at 🔄
• xdg:collection — the id of the collection, in the form of an object path like /org/freedesktop/secrets/collection/{uuid} 🛤️

---

🏷️ alias

An alias is just a different name for a collection — like a nickname but official ✨

• type — alias
• alias — the actual alias 💫
• xdg:collection — the id of the collection the alias points to 🎯

---

🔐 item

An item stores the secret value plus additional attributes, as provided by the applications that create them 👀

• type — item
• id — the id of an item, in the form of an object path like /org/freedesktop/secrets/item/{uuid} 🛤️
• label — the user visible name of the item 🏷️
• created — the date the item was created at 📅
• modified — the date the item was last modified at 🔄
• xdg:collection — the id of the collection the item belongs to 🧺
• secret-type — the mime type of the secret 🎭
• secret! — the secret encoded in base64 🔒
• attr:{name} — an item can have zero or more attributes. The attr: prefix denotes an attribute, followed by its name. If the name contains UTF-8 characters, it's stored as punycode with the IDNA prefix xn- 🔤

---

👀 SEE ALSO 👀

himitsu-secret-service(7) — go read it bestie, it's the how-to-use one 🫶

---

that's the whole page fr fr — no notes, you ate that 💅✨

and yeah, this icon was brought to you by himitsu-secret-service(5), dated 2026-04-05 — mwah, drink some water and go secure those secrets 🍓💜