pfstag(1)

✨ pfstag — bestie edition ✨

okay so this is pfstag, a lil member of the General Commands Manual family, and it's here to set tags on or yeet tags off your pfs stream 💖

🌸 NAME 🌸

pfstag — set tags onto a pfs stream, or remove them from it. that's the whole job, and she does it flawlessly 💅

🎀 SYNOPSIS 🎀

pfstag [--set [channel:]name=value] [--remove [channel:]name]

🦋 DESCRIPTION 🦋

so like, use this command when you wanna set tags or remove tags from the pfs-stream, periodt. tags are these extra lil info bits that get added to pfs frames, and they're formatted like this: 'name=value'. if you wanna go deeper on tags (and honestly, main character behaviour), go read 'Specification of the PFS File Format' 📖

tags get set/removed to/from all pfs frames in the stream. every single one. no skipping, no favourites.

⚠️ lowkey important: currently only the OpenEXR file format supports tags. so if you're out here tagging some other format and wondering why nothing's happening… that's why bestie 😭

✨ OPTIONS ✨

• --set [channel:]name=value], -s [channel:]name=value], --add [channel:]name=value] — change an existing tag with that name, or add a brand new one 🫶 if you don't give a channel, the tags get added to the frame. simple as that.
• --remove [channel:]name], -r [channel:]name] — remove the tag with that name. if the tag doesn't even exist? it just ignores you, no drama, no error, she's unbothered 💅 if you don't give a channel, the tags get removed from the frame.

🌈 EXAMPLES 🌈

pfsin memorial.hdr | pfstag --add "EXTRA_INFO=foo" | pfsout
memorial_ei.exr

this one adds the tag "EXTRA_INFO=foo" to the memorial image and saves it as memorial_ei.exr. iconic, honestly 👑

👑 SEE ALSO 👑

pfsin(1) pfsout(1) — go say hi to the rest of the squad 🧚

💀 BUGS 💀

found a bug? got comments? please report them to Rafal Mantiuk <mantiuk@mpi-sb.mpg.de> — he wants to hear it fr fr 🙈

and that's the whole page babes 💜 this was pfstag(1) from the General Commands Manual, your fave lil tag-wrangler, signing off — stay tagged, stay slay ✨🎀💖