---------------------------------------------------------------------------

             Rename files sequentially in DirectoryOpus 4.x

---------------------------------------------------------------------------

-----------------------
>> ChangeLog
-----------------------

  * 20211203 - Properly process files and directories with spaces.

-----------------------
>> About
-----------------------

This ARexx script will rename selected files sequentially in Directory Opus
4 based on an input file-name prefix and sequential pattern template whilst
retaining the original file-name extensions as they are.

In other words, it satisfies a necessity to be able to sequentially rename
files: for example, suppose that you have the following files in a window
pane:


  meinthepark.jpg
  meathome.jpg
  meupyournostrills.jpg

and that you wish to rename the files sequentially to obtain:

  Photo_01.jpg
  Photo_02.jpg
  Photo_03.jpg
   
in that case, this script will do it for you.

When the script runs from Directory Opus, it will ask you for two
parameters:
  * a file-name prefix - following the example above, you would enter
    "Photo_"
  * a rename pattern - following the example above, you would enter "01"

The sequential rename is alpha-numerical where the range 0..9 represents one
numeric rotation and a..z represents one alphabetic rotation. This is
performed with carry, such that if the rename pattern would have been
specified as "0y8", then the following sequence would be achieved:

  0y8
  0y9
  0z0
  0z1
  0z2
  0z3
  0z4
  0z5
  0z6
  0z7
  0z8
  0z9
  1a0
  1a1
  ...
  
In other words, this would allow you to rename files like:

  Photo_aaa.jpg
  Photo_aab.jpg
  Photo_aac.jpg
  ...
  
as well as mixing-in numbers and letters in the sequence.

-----------------------
>> How to install
-----------------------

  1.) Extract the archive
  2.) Place DOpus4-SeqRename.rexx wherever you see fit. (It is tidy, for
      example, to create an ARexx directory in DOPUS4: and then place your
      scripts there.)
  3.) Open DirectoryOpus4 and right-click and go to  Project->Configure
  4.) On the screen that pops-up, go to Buttons and create a new button
      somewhere where you see fit.
      4a.) Give the button a name ("SeqRename", for example) and create a
           new entry.
      4b.) Set the cycler to ARexx and click the magnifying glass to enter
           the path to the DOpus4-SeqRename.rexx script.
  5.) You do not need to set any flags.
  6.) Save and exit and you are done.


-----------------------
>> How to use
-----------------------

Select some files and press the SeqRename button. You will be prompted for a
file-name prefix and a pattern. After those parameters are supplied to the
ARexx script, the script will rename all your files sequentially.

-----------------------
>> Caveats
----------------------

  * If your files contain either the asterisk (*) character or the
forward-slash character (/), which are reserved AmigaDOS characters, the
script will fail.

-----------------------
>> Project Website
-----------------------

http://grimore.org/amiga/directoryopus/4/sequence_rename

-----------------------
>> Feedback
-----------------------

You can reach us at:

   Wizardry and Steamworks
   e-mail: officegrimore.org

PERMISSION  UID  GID    PACKED    SIZE  RATIO METHOD CRC     STAMP     NAME
---------- ----------- ------- ------- ------ ---------- ------------ ----------
[unknown]                 1445    3553  40.7% -lh5- 8d09 Dec  3 09:02 DOpus4-SeqRename/DOpus4-SeqRename.readme
[unknown]                  453     886  51.1% -lh5- 9d47 Dec  3 09:00 DOpus4-SeqRename/DOpus4-SeqRename.readme.info
[unknown]                 1461    4774  30.6% -lh5- c881 Dec  3 08:58 DOpus4-SeqRename/DOpus4-SeqRename.rexx
[unknown]                  587     859  68.3% -lh5- 36ff Dec  3 09:00 DOpus4-SeqRename/DOpus4-SeqRename.rexx.info
[unknown]                  598    1233  48.5% -lh5- e2ba Dec  3 09:00 DOpus4-SeqRename.info
---------- ----------- ------- ------- ------ ---------- ------------ ----------
 Total         5 files    4544   11305  40.2%            Dec  4 04:00