ODFUSERFIELD(1)

💖 NAME 💖

okay so bestie, welcome to the odfuserfield(1) page — this is the manual for odfuserfield, and its whole thing is list or change the user-field declarations in an ODF file. iconic behavior, honestly. 💅

---

🌸 SYNOPSIS 🌸

odfuserfield [-l] [-L] [-x field...] [-X field...] [-s field:value...]
             [-o path] path

---

✨ DESCRIPTION ✨

so Odfuserfield is a program that will list or change the user variable declarations in an OpenDocument file. periodt. 🫶

there are, like, two kinds of variables in OpenDocument:

• Simple variables can take different values at different positions, throughout a document.
• User variables have the same value throughout a document.

and because user variables are global like that — the original says “due to the latter´s global nature” — it is safe to change them with an external application. no cap. 🔥

use odfuserfield to fill out form letters before printing or giving to the user. that’s the whole vibe. 🎀

“Path” is assumed to be an OpenDocument file of text, spreadsheet or presentation type. so like, text docs, spreadsheets, presentations — those are the accepted main-character file types here. 🌈

---

💅 OPTIONS 💅

• -l — List (extract) all known user-fields. simple, clean, slay. ✨
• -L — List (extract) all known user-fields with type and value. okay, now we’re getting the full tea. 🍓
• -x field — Extract the contents of this field from the file.
• -X field — Same as -x, but also preserves/includes the field name and type. so you get the name AND the type AND the content — generous. 👑
• -s field:value — Set the value of an existing user field. The field type will be the same. no changing the type, bestie, just the value. 💜
• -o path — Filename to write modified ODT file to. If no -o option is provided, the ODT file will be written to stdout. so like, pipe it or redirect it if you don’t give it a home. 😭

---

🌟 EXAMPLE 🌟

bestie, here’s the example, literally right here:

odfuserfield -L odf-file

that’s it. that’s the moment. 💖

---

🦋 SEE ALSO 🦋

go check out formail(1) and id3tag(1) too — the manual said so, and we listen. 🫶

---

🧚 TODO 🧚

Implement formulas. See OpenDocument v1.0 specification section 6.3.5. This requires a different syntax for -s arguments.

so yeah, formulas are not implemented yet, and the -s syntax would need to change for that. noted. 💀

---

👑 AUTHORS 👑

• Søren Roug — Original author
• Michael Howitz — gocept gmbh & co. kg — Refactoring

---

and that’s the page, bestie: source/version odfpy, dated 03/15/2009, and yes — it’s the ODFUSERFIELD(1) manual. mwah. 💋🎀