HIMDCLI(1)

💖 HIMDCLI 💖

okay bestie so this is himdcli from the General Commands Manual section, and it's literally your backstage pass to a HiMD Walkman 💅

✨ NAME ✨

himdcli — the command line interface for accessing a HiMD Walkman, no cap 🎀

🌸 SYNOPSIS 🌸

himdcli <HiMD path> <command>

🦋 DESCRIPTION 🦋

So himdcli is a command line interface for accessing a HiMD Walkman. It uses the libhimd library to read and write audio tracks from a HiMD filesystem, and that filesystem can be mounted directly from a physical HiMD Walkman or from an image file of a HiMD you made earlier 🫶 You have to hand over the mount point of the HiMD filesystem as an argument to himdcli, together with the command you want it to do. Both. Every time. That's the deal.

Right now, libhimd — and therefore himdcli — implements full read access for PCM, ATRAC-3+ and MP3 tracks, plus experimental write support for MP3 tracks. (Quick note bestie: MP3 playback is only supported by second and third generation HiMD Walkmans, so if you've got a first-gen one, that's giving ✨vintage✨ in the bad way.) Non-MP3 tracks are protected by Sony's DRM software stack OpenMG, which requires a sophisticated calculation of keys and access control lists. Writing of non-MP3 tracks is therefore currently not yet supported — that door is locked and Sony has the key 😭

On top of all the transfer capabilities, himdcli also serves up some commands for debugging purposes. Those include:

• strings — displays all strings found in the track list file (TRKIDX##.HMA)
• tracks and tracks verbose — display (detailed technical) track information
• discid — displays the disc id, which is comparable to the filesystem ID of FAT formatted volumes and is used by the OpenMG encryption
• mp3key — displays the MP3 encryption key for a given MP3 track on disc
• holes — displays the holes in a non-contiguous ATDATA##.HMA file, aka the container file where all the tracks are stored on a HiMD filesystem 👑

🔥 COMMANDS 🔥

himdcli currently accepts the following commands:

• help — show the command overview list. strings dumps all strings found in the tracklist file.
• tracks — lists all tracks on disc.
• tracks verbose — lists details of all tracks on disc.
• discid — reads the disc id of the inserted medium.
• holes — lists all holes on disc.
• mp3key <TRK> — shows the MP3 encryption key for track #<TRK>.
• dumptrack <TRK> — dumps track #<TRK>.
• dumpmp3 <TRK> — dumps MP3 track #<TRK>.
• dumpnonmp3 <TRK> — dumps non-MP3 track #<TRK>.
• writemp3 <FILE> — writes the MP3 file <FILE> to disc.

Not me pointing out that when you invoke himdcli without any arguments at all, it outputs a short message with usage information 🙈 like it's gently nudging you bestie, "ma'am, the arguments?"

👀 SEE ALSO 👀

netmdcli(1), qhimdtransfer(1) — go read those too, iykyk 🌈

💜 AUTHOR 💜

The linux-minidisc project — <https://wiki.physik.fu-berlin.de/linux-minidisc>.

This manual page was written by John Paul Adrian Glaubitz <glaubitz@physik.fu-berlin.de>.

okay that's the whole thing, and honestly? iconic. this page came from the General Commands Manual, dated November 23, 2012 — a vintage moment fr fr, but she still ate 💅✨🎀