Variables

A lot of information is extracted from files or can be computed based on different elements.
Each of these information can be used in a rename expression through a "variable".

Based on their origin, they have been assembled into different groups :



Don't be frightened by the quantity. Tools like the completion window or the right click on a value will avoid you to remember them.

Some variables are clickable links. They point to the specific modifier associated to them.



Group of "base" information

Available for all files whatever their type is.
For the systems other than Windows, "DOS" variables are the same as their "non DOS" equivalent.



%fthe name without the path
%fathe file name with the absolute path
%fcthe file name as displayed (or computed)
%fdthe DOS name without the path
%bthe "base" name (ie for "autoexec.bat" it is "autoexec")
%bdthe base of the DOS name
%ethe name extension (ie for "autoexec.bat" it is "bat")
%edthe extension of the DOS name
%sthe file size in the most appropriate unit
%sbthe file size in bytes
%skthe file size in kibibytes
%smthe file size in mebibytes
%sgthe file size in gibibytes
%asome attributes
%ythe type
%dmthe modification date and time
%dmdthe modification date
%dmtthe modification time
%dcthe creation date and time
%dcdthe creation date
%dctthe creation time
%dathe last access date and time
%dadthe last access date
%datthe last access time
%cmMD5 checksum
%csSHA1 checksum
%ccCRC32 checksum
%N a number contained in the base file name.
A digit can indicate its position (1 by default).
For example, for "Fic2_15zzz784.txt" :
%Ngives2
%N1gives2
%N2gives15
%N3gives784
%N4gives"" (empty string)
%NN the "opposite" of %N : a non numeric string contained in the base file name.
A digit can indicate its position (1 by default).
For example, for "Fic2_15zzz784.txt" :
%NNgivesFic
%NN1givesFic
%NN2gives_
%NN3giveszzz
%NN4gives"" (empty string)
%nthe selection number
%np the selection number relative to the file path.
For example :
File%n%np
\Dir1\Img1.jpg001001
\Dir1\Img2.jpg002002
\Dir2\Img3.jpg003001
\Dir2\Img4.jpg004002
%nc the selection number relative to a name "collision" (same beginnings), the expression part following "%nc" is not taken into account.
For example, with the expression : %dmd_%nc.%e
FileModification dateResult
Image1.jpg01/01/200420040101_001.jpg
Image2.jpg12/12/200420041212_001.jpg
Image3.jpg01/01/200420040101_002.jpg
Image4.jpg12/12/200420041212_002.jpg
Image5.jpg12/12/200420041212_003.jpg
Image6.gif12/12/200420041212_004.gif
%ncs same principle as "%nc" except that it is empty for the first element of the "collision group" and prefixed by a "_" for the others.
For example, with the expression : %dmd%ncs.%e
FileModification dateResult
Image1.jpg01/01/200420040101.jpg
Image2.jpg12/12/200420041212.jpg
Image3.jpg01/01/200420040101_001.jpg
Image4.jpg12/12/200420041212_001.jpg
Image5.jpg12/12/200420041212_002.jpg
Image6.gif12/12/200420041212_003.gif
%ncf same as "%nc" except that the path is not taken into account. Only the file name parts are compared
%ncfssame as "%ncs" but on the file name parts
%nsthe number of selected files
%p a parent directory (a digit can indicate the level).
For example, for "C:\IMAGE\SPORT\2006\IMG001.jpg" :
%pgives2006
%p2givesSPORT
%p3givesIMAGE
%pathe absolute path to the file (ending with a path separator character, '\' under Windows)
%prthe relative path to the file (ending with a path separator character, '\' under Windows)

The following variables are independant of the file they are computed on.


%P Siren's current path.
For example, for "C:\IMAGE\SPORT\2006\IMG001.jpg" :
In standard loading mode :
%pagivesC:\IMAGE\SPORT\2006\
%prgives"" (empty string)
%PgivesC:\IMAGE\SPORT\2006\
In the loading mode with the sub directories, if Siren's current directory is "C:\IMAGE" :
%pagivesC:\IMAGE\SPORT\2006\
%prgivesSPORT\2006\
%PgivesC:\IMAGE\
%Pethe path to Siren's executable file
%Dthe current date and time
%Ddthe current date
%Dtthe current time
%Rn a pseudo random numeric string.
It can be followed by a {} modifier.
The usage is : { l, i, a }
  • l : length
  • i : minimum value, optional
  • a : maximum value, optional
%Raa pseudo random alphabetical string
%Rsa pseudo random alphanumeric string
%C line extracted from the clipboard following the file selection order.
A digit can indicate an absolute line number. It can be specified between "{}" too.
Examples :
The Group - %C.%e
%C1 - %C{2} - %f
%T line extracted from a text file following the file selection order.
A digit can indicate an absolute line number.
It can be followed by a {} modifier.
The usage is : { "f", n }
  • f : the file name from which the line has to be extracted, optional
  • n : line number, optional
As the character '\' is an escape character, the ones present in the paths have to be doubled.
If the file name is not indicated then the last previously named is used.
There is no limit to the number of files that can be referenced in an expression.
Examples :
%T{"C:\\fr.txt"}
%T{"C:\\fr.txt",2}
%T1{"C:\\fr.txt"}_%T2(10,2)
Fic_%T{"C:\\temp\\fa.txt"} - %T1 - %T{"D:\\fb.txt"}.txt


Group of "audio" information


%Abthe bitrate
%Asthe sampling rate
%AMthe mode (mono/stereo/...)
%Adthe duration
%Adhthe duration in hours, minutes and seconds
%Admthe duration in minutes and seconds
%Adsthe duration in seconds
%Aisome information


Group of "id3v1 tag" information


%mtthe title
%mathe artist
%mAthe album
%mythe year
%mcthe comment
%mTthe track number
%mgthe genre


Group of "audio tag" information


%Atthe title
%Aathe artist
%AAthe album
%Aythe year
%Acthe comment
%ATthe track number
%Anthe number of tracks
%Akthe track (text)
%ADthe disk
%Agthe genre
%Apthe composer
%Aothe original artist
%ACthe copyright
%Authe URL
%Aeencoded by
%AIfthe format of an attached image


Group of "video" information


%Vxthe width
%Vythe height
%Vsthe sampling rate
%VMthe mode (mono/stereo/...)
%Vdthe duration
%Vdhthe duration in hours, minutes and seconds
%Vdmthe duration in minutes and seconds
%Vdsthe duration in seconds
%Vfthe number of frames per second
%Visome information


Group of "video tag" information


%Vtthe title
%VUthe subject
%Vathe artist
%Vcthe comment
%Vkthe keywords
%VEthe engineer
%VTthe technician
%Vgthe genre
%Vnthe creation date
%VOthe source
%VCthe copyright
%VSthe software used to create the file
%VIfthe format of an attached image
%VDdthe date of a DV avi
%VDddthe date of a DV avi "date part"
%VDdtthe date of a DV avi "time part"
%VDtthe time code of a DV avi


Group of "image" information


%Ixthe width
%Iythe height
%Ibthe number of bits per pixel
%Iisome information


Group of "exif" information

The "official" name of the tag is used as description.



%XdeImageDescription
%XmkMake
%XmoModel
%XorOrientation
%XxrXResolution
%XyrYResolution
%XruResolutionUnit
%XsoSoftware
%XarArtist
%XdtDateTime
%XdtdDateTime "date part"
%XdttDateTime "time part"
%XStSubsecTime
%XwpWhitePoint
%XpcPrimaryChromaticities
%XycYCbCrCoefficients
%XypYCbCrPositioning
%XbwReferenceBlackWhite
%XcyCopyright
%XeoExifOffset
%XgoGPSOffset
%XtoThumbnailOffset
%XtsThumbnailSize
%XetExposureTime
%XfnFNumber
%XepExposureProgram
%XsySpectralSensitivity
%XsrISOSpeedRatings
%XveExifVersion
%XdoDateTimeOriginal
%XdodDateTimeOriginal "date part"
%XdotDateTimeOriginal "time part"
%XSoSubsecTimeOriginal
%XddDateTimeDigitized
%XdddDateTimeDigitized "date part"
%XddtDateTimeDigitized "time part"
%XSdSubsecTimeDigitized
%XccComponentConfiguration
%XbpCompressedBitsPerPixel
%XssShutterSpeedValue
%XavApertureValue
%XbvBrightnessValue
%XevExposureBiasValue
%XmaMaxApertureValue
%XsdSubjectDistance
%XmmMeteringMode
%XlsLightSource
%XfaFlash
%XflFocalLength
%XfeFlashEnergy
%XucUserComment
%XfvFlashPixVersion
%XcsColorSpace
%XiwExifImageWidth
%XihExifImageHeight
%XsfRelatedSoundFile
%XfxFocalPlaneXResolution
%XfyFocalPlaneYResolution
%XfuFocalPlaneResolutionUnit
%XeiExposureIndex
%XsmSensingMethod
%XfsFileSource
%XstSceneType
%XcrCustomRendered
%XemExposureMode
%XwbWhiteBalance
%XdzDigitalZoomRatio
%XfLFocalLengthIn35mmFilm
%XscSceneCaptureType
%XgcGainControl
%XctContrast
%XsuSaturation
%XshSharpness
%XsDSubjectDistanceRange
%XuiImageUniqueID
%XgvGPSVersionID
%XlAGPSLatitudeRef
%XlaGPSLatitude
%XlOGPSLongitudeRef
%XloGPSLongitude
%XaLGPSAltitudeRef
%XalGPSAltitude
%XTSGPSTimeStamp
%XsaGPSSatellites
%XusGPSStatus
%XmMGPSMeasureMode
%XdpGPSDOP
%XsPGPSSpeedRef
%XspGPSSpeed
%XtRGPSTrackRef
%XtrGPSTrack
%XiDGPSImgDirectionRef
%XidGPSImgDirection
%XmdGPSMapDatum
%XLAGPSDestLatitudeRef
%XLaGPSDestLatitude
%XLOGPSDestLongitudeRef
%XLoGPSDestLongitude
%XbEGPSDestBearingRef
%XbeGPSDestBearing
%XDRGPSDestDistanceRef
%XDrGPSDestDistance


Group of "iptc" information

The "official" name of the tag is used as description.



%YblByLine
%YbtBylineTitle
%YcyCopyright
%YcrCredit
%YsrSource
%YcwCaptionWriter
%YcpCaption
%YhlHeadLine
%YsiSpecialInstr
%YonObjectName
%YdcDateTimeCreated
%YdcdDateTimeCreated "date part"
%YdctDateTimeCreated "time part"
%YdrDateTimeReleased
%YdrdDateTimeCreated "date part"
%YdrtDateTimeCreated "time part"
%YctCity
%YslSubLocation
%YstState
%YccCountryCode
%YcoCountry
%YotOriginalTrsf
%YcaCategory
%YscSupplCategories
%YesEditStatus
%YjiJobId
%YpgProgram
%YpvProgramVersion
%YprPriority
%YocObjectCycle
%YkwKeywords


Group of "document" information


%Otthe title
%Osthe subject
%Ovthe version
%Oathe author
%Odthe destination
%Octhe comments
%Oisome information
%OIthe ID
%Okthe keywords
%Onthe creation date
%Ondthe creation date "date part"
%Ontthe creation date "time part"
%Omthe modification date
%Omdthe modification date "date part"
%Omtthe modification date "time part"
%OAthe application
%ONthe company
%OCthe copyright
%OTthe trademarks
%Outhe URL
%OFthe number of files
%OPthe number of pages
%OLthe number of lines
%OWthe number of words
%OBthe number of chars