XML2PMX(1)

💖 XML2PMX 💖

okay bestie, sit down, hydrate, because we're talking about xml2pmx — the little icon of the XML2PMX(1) manual page, section 1, and she's here to serve ✨

---

🎀 DESCRIPTION 🎀

xml2pmx translates MusicXML files into input that's suitable for PMX processing. that's it. that's the whole job. she takes your MusicXML and hands PMX something it can actually eat 🍓

---

✨ SYNOPSIS ✨

xml2pmx [-v | --version | -h | --help]

xml2pmx input.xml output.pmx [ p | d | v | s | l ] ..

also, real talk: the musixtex.lua script from version 0.23 supports xml2pmx as a pre-preprocessor for MusicXML files. so if you're living in musixtex.lua land, she's already plugged in, no extra setup needed 🫶

---

💅 OPTIONS 💅

the letter options mean the following, and yes they're single letters, she's minimal like that:

• p — XML parser output. not recommended unless the terminal window process has enough storage, because she will absolutely flood it, no cap 😭
• d — information on "directions" (dynamical marks etc). the drama marks. the little feelings written into the score 🎭
• v — distribution of voices over instruments and measures. who's singing where, basically.
• s — statistics of MusicXML tags like <note>, <measure> etc. she's counting everything, she's nosy, we love her for it 👑
• l — for extracting lyrics in a separate file. lyrics girlies rise 🎤

---

💀 BUGS 💀

xml2pmx processes input in UTF-8 encoding only. that is a hard line, bestie, she will not budge.

MusicXML files in UTF-16 encoding should be converted first, using for example recode (in Unix-like systems), or by importing into an editor like notepad and saving it in UTF-8 encoding. convert first, then feed her. do not test her. 🙈

---

🌈 SEE ALSO 🌈

pmx(1) obc(1) musixtex(1) recode(1)

(the whole friend group, go say hi 💜)

---

👑 AUTHORS 👑

this man page was written by Bob Tennent <rdt@cs.queensu.ca>.

xml2pmx was written by Dieter Gloetzel <d.gloetzel@web.de>, and adapted for compilation by obc (the Oxford Oberon Compiler) by Mike Spivey <mike@cs.ox.ac.uk>.

---

and that's the page, main character energy from top to bottom 🌸 version date on the tin is 2021-01-23, stamped XML2PMX(1), and she ate. periodt 💅✨