+ Script info

+ List of available parameters and their script set defaults (null'ed items unless specified get UNSET()):

+ Importing 'cats.ini' key => value pairs from all directories starting in [DOCUMENT_ROOT] thru /sean/code/renamer...

+ UNSET()'ing any parameters = 'null'....7 parameters removed

+ Current [PARAM]eters for this page (CATS.INI::[defaults] + URL-based parameters)

+ Current [KEYWORDS] for this page (CATS.INI / [keywords])

+ Retrieving templates...

+ Combining templates; [RECORD]set=>[TABLE]=>[BODY]=>[PAGE]<=NAV

+ Applying S&R on tokenized entries (parameter, _SERVER, keyword, and script)...shrum.net/sean/code/renamer
 
Wednesday, Feb 4th  2026 @ 19:01:47  
 
 
  
www . shrum.net /sean/code/renamer
All scripting, coding, html, layout, design, .... basically everything here done by yours truly. - S

  

  
 
 
x86 news
 
filter
 clear search
 
 
Relocate

 Renamer

A command-line / GUI based tool for doing mass file renames.  Supports a number of token based entities for generating date and time based renames as well as user defined enumeration.
 

Introduction

This is a tool I wrote to allow me to quickly rename a large number of files (particularly in my case a large collection of IMAGE_###.jpg files) so that I could extract them from one source (my digital camera) and store them on my PC without worrying about overwrites.  Can be run directly (without parameters; launches the GUI) or used via the command line for batch processes.

It's Windows-based, open source (GNU), and solely written, maintained, hosted, and supported by me, Sean Shrum. Source code is written with AutoIT (.au3) and the most recent version can be found via the source link in the navbar above.  If you're just looking for the latest binary build, it can be downloaded from the binary link in the navbar above.


Usage

Running the renamer.exe will display a builder mode GUI that can be used to define your initial rename process.  There is a button on the GUI (Make shortcut) that will allow you to create a command line like shortcut to reuse the renaming definition that you define so you can use it again and again.  Please make note that Renamer will only rename files in their current folders....it will not move them to a different location.

Alternatively, you can structure your own command line call as well.  Here are the available arguments:

  • Directory
    ...[required] the source folder that contains the files you want to rename
  • Subdirectories
    ...y/n; whether or not to search and rename files in subdirectories under the source folder
  • Find
    ...[required] text string to find to trigger a rename; omit for all
  • Case-sensitive
    ...y/n; whether or not to match the find text via case-sensitivity
  • Replacement
    ...string of text to replace over the find text; leave blank to have the find text removed
  • Token
    ...the complete new name for any file that matches the find text (must contain at least [enum] or [basename] otherwise dupes can be made).  See Tokens below for a complete list.
  • Enumeration
    ...(used with token); number to start enumerating at; defaults to 1
  • Zeropad
    ...(used with token); number of 0's to pad the enumeration at, defaults to 3
  • Increment
    ...(used with token); increment value of the enumeration; defaults to 1

You can use the full argument name or just the first letter like this:

renamer d="s:\my photos" f=.jpg c=y t="[year][mnum0][mdaynum0] [enum].[ext]"

Note that any argument whose value contains a <space> in it must be contained within dbl-quotes.

Ultimately, if you are uncomfortable with creating the command-line, just run Renamer and use the GUI interface to create the shortcut for you.


Tokens

Renamer has the following tokens that can be used:

[basename] [ext] [enum] [year] [yr] [mnum0] [mnum] [month] [mon] [mdaynum0] [mdaynum] [wdaynum0] [wdaynum] [weekday] [wday] [hour24] [hour0] [hour] [ampm] [min] [sec]

These are pretty self explanatory so if your confused with one or more of them, test them out on a test folder of files.  Additionally, these tokens are listed in the Builder mode GUI interface.

Minimally, at least [basename] or [enum] must be present in any token renames as the omission of one of these tokens will result in duplicate filenames.  Renamer will warn you if this situation is encountered.

 
 
top

Page generation time = 0.0015/s
Page size (minus graphic elements) = 29kb

bookmark

feedback print

back

Since 1992 - shrum.net

Copyright 2026 Sean Shrum

 
 
CATS.PHP [C]ontent [A]cquisition and [T]emplating [S]cript v.4.14 [ 2025.12.14 ] by Sean Shrum