home > projects

pt

pt is a command line tool transfers photos and videos from a source directory to a destination using variables.

pt requires exiftool to be installed and available within the PATH.

Install

Download latest version:

$ wget https://download.compounddata.com/projects/pt/v0.4/pt_linux_amd64.tar.xz
$ tar xvf pt_linux_amd64.tar.xz

Only linux builds on amd64 and arm64 are supported at this time.

Arguments

Variables

Example

Copy photos and videos from /media/camera/DCIM/100MSDCF to ~/photos using full year of the recording as directory and rename file to when it was created in the format of YYYYmmDD-HHMMSSmmm.JPG.

$ pt -source /media/camera/DCIM/100MSDCF \
    -destination /data/photos/%YR/%YR%mmmR%dR-%HR%MmR%SsR%MSR.%EuP
copy /media/camera/DCIM/100MSDCF/DSC09877.JPG -> /data/photos/2026/20260615-095208422.JPG
copy /media/camera/DCIM/100MSDCF/DSC09878.JPG -> /data/photos/2026/20260615-095236463.JPG

Use -mtime -10 to process files that have a modification timestamp that is 10 days or less from now:

$ pt -source /media/camera/DCIM/100MSDCF \
    -destination /data/photos/%YR/%mmmR/%YR%mmmR%dR-%HR%MmR%SsR%MSR.%EuP \
    -mtime -10
copy /media/camera/DCIM/100MSDCF/P1040737.JPG -> /data/photos/2026/08/20260815-091823078.JPG
copy /media/camera/DCIM/100MSDCF/P1040738.JPG -> /data/photos/2026/08/20260815-091912201.JPG

Source

code.compounddata.com/pt