ICMD(1)

💅 ICMD(1) — the manual, but make it cute

okay so bestie, this page is about imv and icp — two little icons that rename or copy a file by letting you edit the destination name with GNU readline. yes. literally that. 💖

---

✨ NAME ✨

imv, icp — rename or copy a file by editing the destination name using GNU readline.

---

🌸 SYNOPSIS 🌸

imv [OPTION] FILE...

icp [OPTION] FILE...

---

🦋 DESCRIPTION 🦋

This manual page documents the icmd, imv, and icp commands. three of them. a whole little family. 🫶

imv is a program that interactively renames a single file. the way it does that is by letting you edit the file name inline with GNU readline. it's giving major mv(1) energy, like when you type out a filename on the shell command-line and edit it — except there's one exception, and the exception is iconic: the filename does not have to be typed twice. no cap. 💅

Normally imv runs mv(1) to do the actual renaming. but you can swap that out with the --command option if you're feeling different. 🔥

icp is literally identical to imv, except a file gets copied with cp(1) instead. that's the whole difference. Both of these commands are symbolic links to the icmd command. periodt. 👑

---

✨ OPTIONS ✨

These programs follow the usual GNU command line syntax, with long options starting with two dashes (`-`).

🚨 important bestie: all options except the ones listed below are passed to either mv, cp, or the command specified by --command. so like, they're not this program's options, they're just being handed over. iykyk.

• --command=FILE — Specify a command to run instead of the default mv or cp. You do not need to specify the directory name of FILE if FILE is found in the current path (as set by the $PATH environment variable).

It is assumed that the command you specified accepts the same set of long and short options that require an argument as mv or cp. If it doesn't, you should specify those options with --arg-options (see below). Also note that --arg-options is not needed as long as you specify option and option value in a single word, like `--suffix=bak` instead of `--suffix bak` when passing extra options to mv via imv. 🎀

• --arg-options=OPTION[,OPTION...] — Specify what comma-separated options for mv, cp, or the command specified with --command require an argument. Options may be short (e.g. -S) as well as long (e.g. --suffix). The default list for mv is `t,S,reply,suffix,target-directory`, and the list for cp is `t,S,Z,no-preserve,sparse,suffix,context,target-directory`. (These lists are complete and correct for GNU Coreutils 5.97.)

This list is necessary because icmd needs to know what arguments specified on the command line are files to move/copy, or option values (following an option). like, it has to tell the difference. it can't just guess. 😭

• --pass-through — Run mv/cp (or the command specified with --command) if two or more arguments are specified. This way imv/icp can be used as an alias for mv/cp (see below). 🔥
• --help — Show summary of options.
• --version — Output version information and exit.

---

💖 EXAMPLES 💖

Using imv as a Bash alias for mv:

alias mv=imv --pass-through -i

---

😭 REPORTING BUGS 😭

Report bugs to <oskar@osk.mine.nu>.

---

🌈 SEE ALSO 🌈

mv(1), cp(1)

---

👑 AUTHOR 👑

The author of renameutils and this manual page is Oskar Liljeblad <oskar@osk.mine.nu>.

---

🎀 COPYRIGHT 🎀

Copyright © 2001, 2002, 2004, 2005, 2007, 2008 Oskar Liljeblad

This is free software; see the source for copying conditions. There is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.

---

okay that's the whole thing, you ate it up fr fr 💜

this page is from icmd (renameutils), dated December 1, 2007, and yeah it's literally titled ICMD(1) — go rename something, bestie 🦋✨