Skip to main content

Tool to renumber image sequences.

Project description

About renumseq

renumseq is a Unix/Linux command-line-utility for renumbering image-sequences which are most typically used in CG post-production.

renumseq allows you to renumber sequences with an offset, or give them a new 'start' frame. It also allows you adjust the padding of the frame numbers.

renumseq borrows the syntax of the native output of lsseq to specify the sequence to be renumbered. Therefore it is recommended to also install lsseq as it makes using renumseq easier.

For example, use lsseq to list a sequence, then cut and paste its output as the arguments to renumseq with appropriate optional arguments for setting the offset etc.

renumseq was written to be safe in that it won't unintentionally overwrite any existing files during the renumbering. If renumseq finds that by renumbering a sequence it will write over another frame outside the range specified then it will skip renumbering that sequence (printing a warning) and go onto the next sequence in the list. Naturally there is an option to force renumseq to overwrite those files if desired.

renumseq doesn't need to make temporary copies of files during the renumbering (it does a move of the file), so it's fast.

renumseq also has a useful option, called --replaceUnderscore to change files of this form:

    filename_[n-m].extension

...to this,

    filename.[n-m].extension

which, as you can see, replaces the underscore-separator with a dot-separator.
Protip: If all you want to do is switch the separator from an underscore to a dot, then use a zero offset, plus the --replaceUnderscore argument.

Installing renumseq

python3 -m pip install renumSeq

Testing renumseq

After installing try the following:

$ cd ~
$ mkdir tmp
$ cd tmp
$ touch aaa.001.tif aaa.002.tif aaa.003.tif aaa.004.tif aaa.005.tif
$ lsseq -Z
aaa.[001-005].tif
$ renumseq --verbose --offset 10 aaa.[001-005].tif
aaa.005.tif -> aaa.015.tif
aaa.004.tif -> aaa.014.tif
aaa.003.tif -> aaa.013.tif
aaa.002.tif -> aaa.012.tif
aaa.001.tif -> aaa.011.tif
$ lsseq -Z
aaa.[011-015].tif

Note that you may get an error from your shell when you try to run the renumseq command, that might look something like this:

% renumseq -o 10 aaa.[001-005].tif
renumseq: No match.

In which case you need to "escape" the square brackets as they are special characters as far as the shell is concerned. Escape them like this:

% renumseq -v -o 10 aaa.\[001-005\].tif
aaa.005.tif -> aaa.015.tif
aaa.004.tif -> aaa.014.tif
aaa.003.tif -> aaa.013.tif
aaa.002.tif -> aaa.012.tif
aaa.001.tif -> aaa.011.tif

Alternatively you can just enclose the argument in quotes like this: 'aaa.[001-005].tif'.

Type this:

$ renumseq --help

...for much more useful info.

Please contact j a m e s a l p h a - e l e v e n . c o m with any bug reports, suggestions or praise as the case may be.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

renumSeq-1.2.0.tar.gz (8.2 kB view details)

Uploaded Source

Built Distribution

renumSeq-1.2.0-py3-none-any.whl (9.7 kB view details)

Uploaded Python 3

File details

Details for the file renumSeq-1.2.0.tar.gz.

File metadata

  • Download URL: renumSeq-1.2.0.tar.gz
  • Upload date:
  • Size: 8.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.4.1 importlib_metadata/4.6.1 pkginfo/1.7.1 requests/2.25.1 requests-toolbelt/0.9.1 tqdm/4.61.2 CPython/3.6.8

File hashes

Hashes for renumSeq-1.2.0.tar.gz
Algorithm Hash digest
SHA256 c2f9bf9362a49efc9170741d228a75df63976d48582904ca4ae5e467e26a9c59
MD5 a9f4c8c942c7760d7d363e36f5789d2c
BLAKE2b-256 01695ad90da8ddf03b9c706e30baaa8677954d213ecdbd6b8d9dff3dbfe0b733

See more details on using hashes here.

File details

Details for the file renumSeq-1.2.0-py3-none-any.whl.

File metadata

  • Download URL: renumSeq-1.2.0-py3-none-any.whl
  • Upload date:
  • Size: 9.7 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.4.1 importlib_metadata/4.6.1 pkginfo/1.7.1 requests/2.25.1 requests-toolbelt/0.9.1 tqdm/4.61.2 CPython/3.6.8

File hashes

Hashes for renumSeq-1.2.0-py3-none-any.whl
Algorithm Hash digest
SHA256 58d53584818fd27e1e6487d371e8a616b84791e26e1e3eb7fb3fcea20afc5cc6
MD5 310988b5cd3d75b206d806c9d9f4d7da
BLAKE2b-256 74e9bbd5d252b4c39f9e9b4d0baa67170b3e080a20cb605bd5987833317bce42

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page