This tool integrates other tools in common programs.
For example, I wrote some awesome Python command line tools such as
filetags, date2name, or appendfilename. Once installed via pip
install, they can only be used on the command line such as cmd.exe
or a shell.
To install all the supported tools, use the following command:
pip install date2name appendfilename filetags integratethis
Using this tool, I can integrate them for example to the “Send to” context menu of the Windows Explorer using commands like:
integratethis date2name integratethis time2name integratethis appendfilename --confirm integratethis filetags --confirm integratethis filetags --parameter="--filter" --displayname "filetags filter" integratethis filetags --parameter="--filter --recursive" --displayname "filetags filter recursive" integratethis filetags --parameter="--tagtrees --recursive --tagtrees-handle-no-tag no-tags" --displayname "TagTrees recursive" integratethis filetags --parameter="--tagtrees --tagtrees-depth 3" --displayname "TagTrees lvl3"
Note that integratethis time2name is a shortcut for:
integratethis date2name --parameter="--withtime %*" --displayname "time2name"
Of course, you can remove the commands using the --delete parameter
as well.
- Target group: users who are fine to use command line tools
- Hosted on github: https://github.com/novoid/integratethis
This tool needs Python 3 to be installed.
You can install filetags either via pip which is the recommended way. Or you can install filetags using the source code, e.g., by cloning the GitHub repository of integratethis.
If you have installed Python 2 and Python 3 in parallel, make sure to
use the correct pip version. You might need to use pip3 instead of
pip. If you only have Python 3 installed, you don’t have to care ;-)
On Microsoft Windows (only), you are going to need pip install
pypiwin32 as prerequisite.
Now install filetags via pip: pip install integratethis
You get updates by executing the very same pip command again.
If you use the GitHub sources (and not pip), the executable is
integratethis/__init__.py. You might want to create a (symbolic) link named
“integratethis” to that file.
usage: integratethis [-h] [--overwrite] [--parameter PARAMETERS]
[--confirm] [--into PROGRAM]
[--displayname DISPLAYNAME] [--delete] [-v]
[-q]
command
This program integrates arbitrary commands to various tools.
For example, you can add a program named "filetags" to the "Send to"
folder of the context menu of the Windows File explorer via
integratethis filetags
The integration method used differs from tool to tool. For the Windows Explorer,
a batch file is placed within the AppData\Roaming folder in case of additional
parameters have to be added to the command and a lnk file to it is created in
the "Send to" folder so that you can use the command from the context menu of
the Windows Exporer. If no additional parameters are required, a lnk file to the
command itself is placed in the "Send to" folder. For details, please look at
the source code or read the help info for the --into parameter.
You can overwrite pre-configured parameters using the command line options.
positional arguments:
command The command to integrate. For a defined set of tools
which can be installed via "pip3 install", parameters
are pre-configured: filetags, appendfilename,
date2name, time2name (date2name but with time-stamp),
and more to come in the future. The path for the
command is looked up using "where" (Windows) or
"which" (all other operating systems) so that the
command has to be found in the path of the current
environment.
optional arguments:
-h, --help show this help message and exit
--overwrite Do not warn when a previous batch- or lnk-file for
integration get overwritten.
--parameter PARAMETERS
Optional parameter string which replaces any pre-
defined parameter set and gets appended after the
command when being invoked. For example, 'filetags' as
this pre-configured to "--interactive *" (on non-
Windows) in order to use the interactive mode and
operate on all selected files. Since this parameter
replaces pre-defined parameter sets, you have to make
sure to include '%*' (Windows) or '"${*}"' (non-
Windows) if you need to process marked files.
--confirm Ask the user to confirm by pressing RETURN/ENTER
before closing the dialog window of the batch file to
run the command.
--into PROGRAM Explicitely define, where to integrate the program to.
Valid values (according to your operating system) are:
windowsexplorer (same as File Explorer; default for
Windows), and more to come in future.
--displayname DISPLAYNAME
Optional name that should be used instead of the
command name when being linked.
--delete Instead of integrate the program, remove its
integration. Command or displayname has to match the
existing integration point.
-v, --verbose enable verbose mode
-q, --quiet enable quiet mode
:copyright: (c) by Karl Voit <tools@Karl-Voit.at>
:license: GPL v3 or any later version
:URL: https://github.com/novoid/integratethis
:bugreports: via github or <tools@Karl-Voit.at>
:version: 2019-10-29
·
- 2018-04-25: initial version
- 2019-10-29: bugfix version
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 filetags 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 filetags.
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.
I’m glad you like my tools. If you want to support me:
- Send old-fashioned postcard per snailmail - I love personal feedback!
- see my address
- 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