org.bluez.obex.Message(5)

💌 NAME 💌

okay so this is the manual page for org.bluez.obex.Message, aka the BlueZ D-Bus OBEX Message API documentation 😭💖. It's from the Linux System Administration manual, and we're gonna walk through the service/interface/object path situation, the Get method, and every single property — no skipping, bestie, periodt ✨.

🦋 INTERFACE 🦋

here's the identity card, no cap:

• Service — org.bluez.obex 💅
• Interface — org.bluez.obex.Message1 🫶
• Object path — [Session object path]/message{#} 🎀

✨ METHODS ✨

📥 object, dict Get(string targetfile, boolean attachment)

okay so this method downloads the message and stores it in the target file. literally that's the whole vibe. 💾✨

If an empty targetfile is given, a temporary file will be automatically generated — the system's got you, bestie. 🧚

The returned path represents the newly created transfer, and you should use it to find out if the content has been successfully transferred or if the operation fails. important!! 😭

The properties of this transfer are also returned along with the object path, to avoid a call to GetProperties — see org.bluez.obex.Transfer(5) for the possible list of properties. iykyk 👑

Possible errors:

• org.bluez.obex.Error.InvalidArguments
• org.bluez.obex.Error.Failed

💅 PROPERTIES 💅

vibe check on every property, incoming:

• string Folder [readonly] — the folder which the message belongs to 🗂️
• string Subject [readonly] — message subject 💌
• string Timestamp [readonly] — message timestamp ⏰
• string Sender [readonly] — message sender name 🫶
• string SenderAddress [readonly] — message sender address 📮
• string ReplyTo [readonly] — message Reply-To address ↩️
• string Recipient [readonly] — message recipient name 🎀
• string RecipientAddress [readonly] — message recipient address 📬
• string Type [readonly] — message type 🌈
  • possible values:
    • "email"
    • "sms-gsm"
    • "sms-cdma"
    • "mms"
• uint64 Size [readonly] — message size in bytes 📏
• string Status [readonly] — message reception status 📥
  • possible values:
    • "complete"
    • "fractioned"
    • "notification"
• boolean Priority [readonly] — message priority flag 🔥
• boolean Read [read/write] — message read flag 👀
• boolean Deleted [writeonly] — message deleted flag 🗑️
• boolean Sent [readonly] — message sent flag 🚀
• boolean Protected [readonly] — message protected flag 🔒
• string DeliveryStatus [readonly] [optional] — message delivery status 🚚
  • possible values:
    • "delivered"
    • "sent"
    • "unknown"
• uint64 ConversationId [readonly] [required] — message conversation id sent by Server which serves as unique identification of the conversation 🧵
• string ConversationName [readonly] [optional] — human readable name of the conversation 💬
• string Direction [readonly] [required] — indicate the direction of the message 🧭
  • possible values:
    • "incoming"
    • "outgoing"
    • "outgoingdraft"
    • "outgoingpending"
• string AttachmentMimeTypes [readonly] [optional] — MIME type of the attachment 📎

---

and that's the whole manual page, bestie — slay 💖. source/version is BlueZ, date is October 2023, and the page is org.bluez.obex.Message(5). periodt ✨🫶