>_clihub
DATE2NAME(1)

NAME

date2name — Handling time-stamps and date-stamps in file names

SYNOPSIS

$pip install date2name

INFO

92 stars
11 forks
0 views
PythonShell & Terminal
source

DESCRIPTION

Handling time-stamps and date-stamps in file names

README

  • Handling time-stamps and date-stamps in file names

#+BEGIN_HTML #+END_HTML

[[file:bin/screencast.gif]]

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 such as:

: Options: : -h, --help show the extended help message and exit : -d, --directories modify only directory names : -f, --files modify only file names : -S, --short use short datestamp (YYMMDD) : -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) : -r, --remove remove all known datestamps : -m, --mtime take modification time for datestamp [default] : -c, --ctime take creation time for datestamp : --delimiter overwrite default delimiter : --nocorrections do not convert existing datestamps to new format : -q, --quiet do not output anything but just errors on console : -v, --verbose enable verbose mode : -s, --dryrun enable dryrun mode: just simulate what would happen, do : not modify files or directories : --version display version and exit

  • Installation

First, you need the programming platform [[https://www.python.org/downloads/][Python]] installed.

Then, you can

  1. get =date2name= manually from [[https://github.com/novoid/date2name][GitHub]] OR
  2. install it via =pip install date2name= which is simplest method.

[[https://0dependencies.dev/0dependencies.svg]] → [[https://0dependencies.dev/][learn more about 0dependencies]]

  • Integration Into Common Tools

** Integration into Windows File Explorer

The easiest way to integrate =date2name= into File Explorer ("Send to" context menu) is by using [[https://github.com/novoid/integratethis][integratethis]].

Execute this in your command line environment:

: pip install date2name integratethis : integratethis date2name : integratethis time2name

*** Manual Integration into Windows Explorer for single files

Use this only if the [[https://github.com/novoid/integratethis][integratethis]] method can not be applied:

Create a registry file =add_date2name_to_context_menu.reg= and edit it to meet the following template. Please make sure to replace the paths (python, =USERNAME= and =date2name.py=) accordingly:

#+BEGIN_EXAMPLE Windows Registry Editor Version 5.00

;; for files:

[HKEY_CLASSES_ROOT*\shell\date2name] @="date2name (single file)"

[HKEY_CLASSES_ROOT*\shell\date2name\command] @="C:\Python36\python.exe C:\Users\USERNAME\src\date2name\date2name.py -i "%1"" #+END_EXAMPLE

Execute the reg-file, confirm the warnings (you are modifying your Windows registry after all) and cheer up when you notice "date2name (single file)" in the context menu of your Windows Explorer.

As the heading and the link name suggests: [[https://stackoverflow.com/questions/6440715/how-to-pass-multiple-filenames-to-a-context-menu-shell-command][this method works on single files]]. So if you select three files and invoke this context menu item, you will get three different filetag-windows to tag one file each.

** Integration into Thunar

[[https://en.wikipedia.org/wiki/Thunar][Thunar]] is a popular GNU/Linux file browser for the xfce environment.

Unfortunately, it is rather complicated to add custom commands to Thunar. I found [[https://askubuntu.com/questions/403922/keyboard-shortcut-for-thunar-custom-actions][a good description]] which you might want to follow.

To my disappoinment, even this manual confguration is not stable somehow. From time to time, the IDs of $HOME/.config/Thunar/uca.xml and $HOME/.config/Thunar/accels.scm differ.

For people using Org-mode, I automated the updating process (not the initial adding process) to match IDs again:

Script for checking "tag": do it tag-ID and path in accels.scm match? : #+BEGIN_SRC sh :var myname="tag" : ID=egrep -A 2 "<name>$myname" $HOME/.config/Thunar/uca.xml | grep unique-id | sed 's#.*<unique-id>##' | sed 's#<.*$##' : echo "$myname-ID of uca.xml: $ID" : echo "In accels.scm: "grep -i "$ID" $HOME/.config/Thunar/accels.scm : #+END_SRC

If they don't match, following script re-writes accels.scm with the current ID: : #+BEGIN_SRC sh :var myname="tag" :var myshortcut="t" : ID=egrep -A 2 "<name>$myname" $HOME/.config/Thunar/uca.xml | grep unique-id | sed 's#.*<unique-id>##' | sed 's#<.*$##' : echo "appending $myname-ID of uca.xml to accels.scm: $ID" : mv $HOME/.config/Thunar/accels.scm $HOME/.config/Thunar/accels.scm.OLD : grep -v ""$myshortcut"" $HOME/.config/Thunar/accels.scm.OLD > $HOME/.config/Thunar/accels.scm : rm $HOME/.config/Thunar/accels.scm.OLD : echo "(gtk_accel_path "/ThunarActions/uca-action-$ID" "$myshortcut")" >> $HOME/.config/Thunar/accels.scm : #+END_SRC

** Integration into FreeCommander

[[http://freecommander.com/en/summary/][FreeCommander]] is a [[https://en.wikipedia.org/wiki/File_manager#Orthodox_file_managers][orthodox file manager]] for Windows. You can add date2name as an favorite command:

  • Tools → Favorite tools → Favorite tools edit... (S-C-y)
    • Create new toolbar (if none is present)
    • Icon for "Add new item"
      • Name: date2name
      • Program or folder:
      • =date2name.bat= looks like: (please do modify the paths to meet your requirement) : C:\Python36\python.exe C:\Users\YOURUSERNAME\src\date2name\date2name %* : REM optionally: set /p DUMMY=Hit ENTER to continue...
      • Start folder: =%ActivDir%=
      • Parameter: =%ActivSel%=
      • Enclose each selected item with ="=
      • Hotkey: select next available one such as =Ctrl-1= (it gets overwritten below)
      • remember its name such as "Favorite tool 01"
    • OK

So far, we've got =date2name= added as a favorite command which can be accessed via menu or icon toolbar and the selected keyboard shortcut. If you want to assign a different keyboard shortcut than =Ctrl-1= like =Alt-d= you might as well follow following procedure:

  • Tools → Define keyboard shortcuts...
    • Scroll down to the last section "Favorite tools"
    • locate the name such as "Favorite tool 01"
    • Define your shortcut of choice like =Alt-d= in the right hand side of the window
      • If your shortcut is taken, you'll get a notification. Don't overwrite essential shortcuts you're using.
    • OK
  • Related Tools and Workflows

--- BEGIN SHARED: filetags_tools --- see https://github.com/novoid/screencasts/

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 [[http://karl-voit.at/managing-digital-photographs/][this blog posting]] you might like to read and in the video which is linked above.

In short:

--- END SHARED: filetags_tools --- see https://github.com/novoid/screencasts/

  • How to Thank Me and Contribute to the Project

--- BEGIN SHARED: how_to_thank_me --- see https://github.com/novoid/screencasts/

I'm glad if you like my tool. I've got way more projects on:

If you want to support me:

If you want to contribute to this cool project, please fork and contribute!

I am using [[http://www.python.org/dev/peps/pep-0008/][Python PEP8]] and occasionally some ideas from [[http://en.wikipedia.org/wiki/Test-driven_development][Test Driven Development (TDD)]]. I fancy Python3 with [[https://typing.python.org/en/latest/spec/annotations.html][type annotations]], although I'm not using them everywhere at the moment. Starting with 2025, I began to use help from Claude.ai which is a huge improvement, given my lack of programming practice and knowledge.

After all, each of my tools was developed because I needed its functionality and could not get it elsewhere - at least to my knowledge or taste.

--- END SHARED: how_to_thank_me --- see https://github.com/novoid/screencasts/

SEE ALSO

fzf(1)— A command-line fuzzy finder — interactive Unix filter for any liststarship(1)— The minimal, blazing-fast, and infinitely customizable prompt for any shellzoxide(1)— A smarter cd command — learns your habits and jumps instantlyblade-code(1)— AI-powered CLI coding agent with 20+ built-in tools, MCP support, and multi-model providersqrrs(1)— CLI QR code generator and reader written in rust
clihub3/4/2026DATE2NAME(1)