diff --git a/README.org b/README.org index 5dbf427..d72cc44 100644 --- a/README.org +++ b/README.org @@ -41,6 +41,119 @@ Run "date2name --help" for usage hints Get it from [[https://github.com/novoid/date2name][GitHub]] or install it via «pip install date2name». +* Integration Into Common Tools + +** 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 "$myname" $HOME/.config/Thunar/uca.xml | grep unique-id | sed 's#.*##' | 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 "$myname" $HOME/.config/Thunar/uca.xml | grep unique-id | sed 's#.*##' | 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 Windows Explorer for single files + +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 Windows Explorer for single and multiple selected files + +Create a batch file in your home directory. Adapt the paths to meet +your setup. The content looks like: + +: C:\Python36\python.exe C:\Users\USERNAME\src\date2name\date2name.py -i %* + +If you want to confirm the process (and see error messages and so +forth), you might want to append as well following line: + +: set /p DUMMY=Hit ENTER to continue ... + +My batch file is located in =C:\Users\USERNAME\bin\date2name.bat=. Now +create a lnk file for it (e.g., via Ctrl-Shift-drag), rename the lnk +file to =date2name.lnk= and move the lnk file to +=~/AppData/Roaming/Microsoft/Windows/SendTo/=. + +This way, you get a nice entry in your context menu sub-menu "Send to" +which is also correctly tagging selection of files as if you put the +list of selected items to a single call of date2name. + +** 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 +filetags 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%= + - [X] 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 This tool is part of a tool-set which I use to manage my digital files