pestctrl/date2name
1
0
Fork 0
forked from Github/date2name
Code Issues Pull requests Projects Releases Packages Wiki Activity
Handling time-stamps and date-stamps in file names
21 commits 1 branch 0 tags 5 MiB
Python 97.5%
Makefile 2.5%
Find a file
Karl Voit fc258999e1 migrated to Python 3 via 2to3
2017-08-22 13:05:23 +02:00
date2name migrated to Python 3 via 2to3 2017-08-22 13:05:23 +02:00
date2name.1.txt Fixed broken URL to datestamps.org 2015-01-04 13:31:07 -06:00
README.org added installation instructions to README 2016-09-11 17:38:44 +02:00
requirements.txt added pip setup 2016-09-11 17:30:37 +02:00

README.org

Handling time-stamps and date-stamps in file names

Per default, date2name gets the modification time of matching files and directories and adds a datestamp in standard ISO 8601+ format YYYY-MM-DD (http://datestamps.org/index.shtml) at the beginning of the file- or directoryname.

If an existing timestamp is found, its style will be converted to the selected ISO datestamp format but the numbers stays the same. Executed with an examplefilename "file" this results e.g. in "2008-12-31_file".

Note: Other that defined in ISO 8601+ the delimiter between hours, minutes, and seconds is not a colon but a dot. Colons are causing several problems on different file systems and are there fore replaced with the (older) DIN 5008 version with dots.

Usage:
         date2name [options] file ...

Run "date2name –help" for usage hints

Options:
  -h, --help         show this help message and exit
  -d, --directories  modify only directory names
  -f, --files        modify only file names
  -C, --compact      use compact datestamp             (YYYYMMDD)
  -M, --month        use datestamp with year and month (YYYY-MM)
  -w, --withtime     use datestamp including seconds   (YYYY-MM-DDThh.mm.ss)
  -m, --mtime        take modification time for datestamp [default]
  -c, --ctime        take creation time for datestamp
  -q, --quiet        do not output anything but just errors on console
  -v, --verbose      enable verbose mode
  --nocorrections    do not convert existing datestamps to new format
  -s, --dryrun       enable dryrun mode: just simulate what would happen, do
                     not modify files or directories
  --version          display version and exit

Installation

Get it from GitHub or install it via «pip install date2name».

Related tools and workflows

This tool is part of a tool-set which I use to manage my digital files such as photographs. My work-flows are described in this blog posting you might like to read.

In short:

For tagging, please refer to filetag and its documentation.

See date2name for easily adding ISO time-stamps or date-stamps to files.

For easily naming and tagging files within file browsers that allow integration of external tools, see appendfilename (once more) and filetag.

Moving to the archive folders is done using move2archive.

Having tagged photographs gives you many advantages. For example, I automatically choose my desktop background image according to the current season.

Files containing an ISO time/date-stamp gets indexed by the filename-module of Memacs.

How to Thank Me

I'm glad you like my tools. If you want to support me:

  • Send old-fashioned postcard per snailmail - I love personal feedback!

  • Send feature wishes or improvements as an issue on GitHub
  • Create issues on GitHub for bugs
  • Contribute merge requests for bug fixes
  • Check out my other cool projects on GitHub