SMFSH(1)

💖 SMFSH(1) 💖

okay bestie, sit down, hydrate, because today we're talking about smfsh — the SMF shell. yes that's the whole NAME section, she's lowkey mysterious like that. 🎀

---

✨ SYNOPSIS ✨

smfsh [ -V ] [ file ]

that's it. that's the whole vibe. two little things and she's ready to go 💅

---

🌸 OPTIONS 🌸

• -V — prints the libsmf version and then dips immediately. no cap, just version and exit. ✨
• file — loads the file. that's it, that's the job 🫶

---

💜 DESCRIPTION 💜

smfsh, aka the "SMF shell", is an interactive, command-driven frontend to libsmf. it's genuinely useful for modifying MIDI files by hand — like, actually by hand, typing at it, living your main character life 😭. fun fact: she started her whole life as a debugging aid for libsmf. she was born in the lab and now she's serving in production, iconic behavior fr fr.

there are four groups of commands:

• SMF level
• track level
• event level
• others

and we're gonna go through ALL of them because we don't skip. periodt. 💅

---

🔥 SMF LEVEL COMMANDS 🔥

SMF level commands display or change properties of smf (i.e. the MIDI file) as a whole. the whole file. the entire girl. 👑

• save file — save a file. if the file name is not given, the last file name is used.

⚠️ bestie. listen. this will not ask for confirmation. no "are you sure?", no "really?", nothing. she just does it. be careful with your fingers 🙈

• load file — load a file. if the file name is not given, the last file name is used.

also! instead of using load, you can just pass the file name on the command line. two ways to get the same result, we love options 💖

• ppqn new-ppqn — show (if used without parameter) or change PPQN (Pulses Per Quarter Note, aka Division). no param = show me, param = change me. simple as. ✨
• format new-format — show (if used without parameter) or change format. same energy as above, different setting 🎀
• tempo — show the tempo map. the tempo map is computed automatically from the SMF contents — so if you wanna modify a tempo, just add a Tempo Change event using the add command. no direct tempo editing bestie, that's the rule 🦋
• length — show the total length of the song. just like the tempo map, the file length is computed from the SMF contents. it's giving "i read the file so you don't have to" 💅

---

🌈 TRACK LEVEL COMMANDS 🌈

track level commands display or change properties of tracks. an SMF may contain one or more tracks — so like, plural, a whole little friend group 🫶

• tracks — show the list of tracks in the SMF. the roster. the lineup. 👑
• track track-number — show details of a track (if called without parameter), or select the track with the given number — for example, in order to display (events) the events it contains. no param = peek, param = pick. 😌
• trackadd — create a new track. baby track. brand new. fresh out the box 🎀
• trackrm track-number — remove the track. if the track number is not given, this will remove the track currently selected. bye bestie 😭

---

🦋 EVENT LEVEL COMMANDS 🦋

event level commands display or change properties of events. events are grouped into tracks. a track may contain any number of events, including zero. yes, zero. empty track. she's resting. 💀

• events — show the list of events in the current track. 🔥
• event event-number — show information about the current event (if used without parameter) or select the event. peek or pick, you know the drill by now ✨
• add time-in-seconds midi-message-as-hex — add a new event to the currently selected track. note the args bestie: time-in-seconds and midi-message-as-hex. hex. hexagons. hex code. don't forget 🧚
• rm event-number — remove the event. if the event number is not given, this will remove the event currently selected. she's gone, gone gone 🙈

---

⭐ OTHER COMMANDS ⭐

there are three commands in the "other" category:

1. help
2. version
3. exit

their meaning should be self expanatory. (yes, that's exactly how the original spells it, and honestly? iconic spelling, we keep it 💅✨)

---

💖 and that's the whole page bestie. four command groups, one cute little shell, zero skipped details. slay. 🫶

---

smfsh 1.3 — dated 21 March 2010 🌸 mwah, love u, bye! 💜🎀✨