lowercase(1) General Commands Manual lowercase(1)
NAME
lowercase - rename files to all lowercase filenames
SYNOPSIS
lowercase [-g(it)] [-h(elp)] [-q(uiet)] [-x(tension_only)]
[-X(tensions_only)] [-v(erbose)[ file...
DESCRIPTION
lowercase renames files to all lowercase filenames. If a filespec
containing path information is send to lowercase, only the filename
portion itself will be renamed.
OPTIONS
-g Rename files using "git mv" instead of perl's internal rename
function.
-h Print help and quit.
-q Be quiet. Suppress the usual messages that describe file
renames that actually occur.
-v Be verbose. Generate messages for file renames that are skipped
because the name does not change.
-x Change the case of the main file extension only. This yields
different results from the -X option only when a file has
multiple extensions, e.g. ".Tar.Lz". Files that begin with "."
(e.g. ".bashrc") will not be renamed.
-X Change the case of all file extensions. This yields different
results from the -x option only when a file has multiple
extensions, like ".Tar.Lz". Files that begin with "." (like
".bashrc") will be renamed.
EXAMPLES
lowercase is quite simple to use, as shown in the examples below:
lowercase FOObar_A.JPG fooBAR_B.png
lowercase -x Source_A.Tar.Lz
lowercase -X Source_B.Tar.Lz
However, if you're trying to rename an entire directory hierarchy,
including the directories, the best way to handle it is probably as
follows:
find . -depth -mindepth 1 -type d -print0 | xargs -0 lowercase
find . -type f -print0 | xargs -0 lowercase
BUGS
Symbolic links are not well handled by lowercase. For example, suppose
you have a file called "FOObar" and a symbolic link called "BARfoo"
pointing to it. If you rename both of them using lowercase, the
symlink will become broken, as it will still point to "FOObar".
SEE ALSO
convmv(1), git(1)
COPYRIGHT
Copyright (C) 2005-2020 by Brian Lindholm. This program is free
software; you can use it, 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, or (at your option) any later
version.
This program 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.
littleutils 2025 Jul 27 lowercase(1)
littleutils 1.2.8 - Generated Sun Oct 19 09:13:52 CDT 2025