METAMORPHOSE2(1)

💅 METAMORPHOSE2 💅

okay so bestie, this is a page from the General Commands Manual — say hi to Métamorphose2, aka your new favorite mass-renamer ✨

---

🌸 NAME 🌸

Métamorphose2 — a graphical mass renaming tool for files and folders. yes. graphical. mass. renaming. it's giving organized-queen energy 👑

---

🎀 SYNOPSIS 🎀

metamorphose2 [/path/to/open/spaces ok]
metamorphose2 [-t] [-d] [-p /path/to/open] [[-c /path/to/file.cfg] [-a level (0-3)]] [-l language]

---

🦋 DESCRIPTION 🦋

so it's a GUI renaming tool, right, but not like a baby one — it's got many powerful functions and it's genuinely so good for anyone who has to rename a lot of files and/or folders on a regular basis. like, if that's your life, this is your app, no cap 💖

and it's not just for general usage operations either — it's also lowkey iconic for:

• photo collections 📸
• music collections 🎵
• webmasters 🌐
• programmers 💻
• legal and clerical folks 📋
• et cetera, et cetera, iykyk

there's also support for automating GUI tasks via command line, using the options described below. yes bestie, you can script it. main character automation energy fr fr ⚡

---

✨ OPTIONS ✨

okay this is the part where you pay attention, because there are two modes for options. two. like a vibe check for your arguments 🌈

Mode one 🎀 — the only available option is a path to open. it's simply passed as the only argument to the command, and spaces may be used. this mode cannot be used with any other options. that's it, that's the whole mode.

Mode two 🦋 — all options can be used, but the option type must be declared. this is similar to almost all Unix type commands. a path to open would be specified using -p, and spaces must be escaped.

modes are switched automatically, based on the structure of the options. so it just… knows. slay 💅

🫶 Available Options:

• -h, --help — show the help screen and exit. your lil "what is this" button 🥺
• -t, --timer — show the time taken to complete operations. stopwatch moment ⏱️
• -d, --debug — show debugging information. for when you gotta know why 🔍
• -p, --path — specify a directory to load. 📁
• -c, --config — specify a configuration file to load. ⚙️
• -a, --auto — specify the automatic mode level to use with the configuration file:
  • 0 = do not preview items
  • 1 = auto preview items
  • 2 = auto rename items
  • 3 = auto rename items and exit on success 🔥
• -l, --language — override the preferred language. 🌍
• -w, --wxversion — specify the wxPython Version — use at your own risk! 💀

---

🍓 FILES 🍓

• ~/.metamorphose2/ — user-specific preference files live here. do not edit these files directly, use the preferences menu, bestie 🙈 if there are problems with the application that persist after reinstalling it, try deleting this folder. (yes, the classic "have you tried deleting it" move, it still works 💀)
• ~/.metamorphose2/undo/ — undo logs are stored here by default; this can be changed in preferences. ↩️
• ~/.metamorphose2/configs/ — configuration files are stored here by default. ⚙️

---

🧚 RESOURCES 🧚

• Python 2.7
• wxPython 2.8
• Python Imaging Library (PIL)
• mutagen

(the whole squad, assembled 🫶)

---

👑 SEE ALSO 👑

• python(1)

---

💜 COPYRIGHT 💜

Métamorphose2 is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

Métamorphose2 is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. see the GNU General Public License for more details.

you should have received a copy of the GNU General Public License along with this program. if not, see <http://www.gnu.org/licenses/>.

---

😭 BUGS 😭

please check the bug reports at the project page:

https://github.com/metamorphose/metamorphose2

---

⭐ AUTHOR ⭐

Ianaré Sévi (ianare@gmail.com)

---

okay that's the whole page bestie, go forth and rename things beautifully 🌸💅✨

signing off — this was the METAMORPHOSE2(1) page, dated 2010-12-05, mwah 💖