DICOMFIND(1)

💖 DICOMFIND 💖

ok bestie, this is DICOMFIND(1), a User Commands situation, and honestly? she's giving "UNIX find but make it ✨medical imaging✨". no cap. 🩻💅

---

🌸 NAME 🌸

dicomfind — the vtk-dicom CLI 🎀

---

✨ DESCRIPTION ✨

🫶 usage:

dicomfind [options] <directory> ...

💅 options:

here's the whole menu, every single one, no skipping, periodt:

• -L — Follow symbolic links (this is the default, she does it anyway).
• -P — Do not follow symbolic links.
• -k tag=value — Give her an attribute to query and match on.
• -q <query.txt> — Hand her a file that describes the find query.
• -u <uids.txt> — Hand her a file containing a list of UIDs.
• -maxdepth n — Set the maximum directory depth.
• -name pattern — Set a pattern to match, with "*" or "?".
• -image — Restrict the search to files that have PixelData.
• -series — Find all files in a series if even one file matches.
• -print — Print the filenames of all matched files (default behaviour, she's chill like that).
• -print0 — Print the filenames with a terminating null, for xargs besties.
• -exec ... + — Execute the given command for every series matched.
• -exec ... \; — Execute the given command for every file matched.
• -execdir ... + — Go to the directory and execute the command on every series.
• -execdir ... \; — Go to the directory and execute the command on every file.
• --directory-only — Do not scan the files themselves if a DICOMDIR is present.
• --ignore-dicomdir — Ignore the DICOMDIR file even if it is present.
• --charset <cs> — Charset to use if SpecificCharacterSet is missing.
• --help — Print a brief help message.
• --version — Print the software version.

---

okay so the way this works is iconic actually: this command is like the UNIX "find" command, but for DICOM files. 🦋

When you're searching for files with a specific attribute (with -k), the tag can be in its hexadecimal form GGGG,EEEE or in its keyword form Modality=MR. Or, alternatively, the tags can be listed in a query file with the -q option — one tag per line, no stress. 📝 Attributes nested within sequences can be specified by giving a tag path like -k Tag1/Tag2/Tag3. Either a forward slash or a backslash can separate the components of the path, she's flexible like that. 🌈 Private tags should be preceded by the private dictionary name in square brackets. 🔍

The -exec and -execdir arguments cause dicomfind to run the specified program on the found files. For example, to dump each file one would use -exec dicomdump {} \; — where each instance of {} gets replaced by a found file, and ; indicates the end of the args to dicomdump. 💫 Alternately, if + is used to end the args, then the program will be run on each DICOM series and {} will be replaced by all files in the series. The -execdir argument is similar, except that it runs the program from within the directory of the file (or files), and {} is replaced by just the filenames instead of the full paths. 🎀

bestie pls note: the difference between + and \; is not a vibe check, it genuinely changes what {} expands to and how many times your command runs. respect the semicolon. 😭

---

👑 AUTHOR 👑

This manual page was written by Mathieu Malaterre <malat@debian.org> for the Debian GNU/Linux system, but may be used by others. 💜

---

and that's the whole page, bestie — sourced from dicomfind 0.8.17, dated August 2026, manual page DICOMFIND(1). slay, go find some DICOM files. 🫶🌟