Many thanks to abr for participating in the development of Tagger. Many features are based on his testing, feedback and suggestions.
This new version requires at least DOpus v.12.2.3 to work. There's an older Version for DOpus 11 here.
Short description:
Tagger is a Script Add-In for Directory Opus that provides a resizable dialog. DOpus will remember size and position of the dialog.
The purpose of Tagger is to comfortably show, find, edit, replace, add or delete Tags or Comment and Rating for files and folders. When you start Tagger the tags, comments and ratings of all files in the current folder are read and stored in a dictionary for performance reasons. So if you are in a folder with a lot of files it may take a few seconds until the dialog appears.
The dialog shows all tags or the comment of a single file in a list where you can directly edit each entry.
You can also select a range of files. Tagger will then show tags or comment and rating if they exist in all selected files.
You can search for a certain tag, a rating value (0-5) or for comments containing a certain string by entering the search string in the main input field and pressing the hotkey alt+f. Tagger will select all files containing the specified tag, comment or rating and show the shared string in the list or in the rating input field. For comment Tagger will show all comments containing the search string in the list and the index of the file that contains the comment in a second column.
You can sort all tags in all files in the current folder alphabetically by pressing the hotkey alt+s.
You can always edit tags or comment in the list, change rating or add/replace/delete tags or comment for each selected file or folder using the "Apply" or "Remove" button.
Installation:
- Download the file Command.File_Tagger.vbs.txt and copy it to /dopusdata/Script AddIns or drag it into the settings window Settings => Preferences => Toolbar => Scripts
- Go to Settings => Preferences => Toolbar => Scripts. Click the entry Command.File: Tagger.
- Language: Select the language in which you want to show the dialog. Currently available are english, deutsch and français. "default" shows the dialog in the current language of DOpus if available, otherwise in english.
- ShowIndexColumn: By default Tagger always shows the column "Index". If you don't want this change this option to "False".
- Hot_[x]: You can change the default hotkeys here. See the discription of each hotkey at the bottom of the script configuration window.
- vHot_[x]: These hotkeys are only available when working with the standalone viewer (Argument VIEWER). Nearly all default hotkeys of the viewer are also available from the Tagger GUI. Several of the original hotkeys needed to be modified by an additional modifier key. Download the file TaggerHotkeys.txt for a complete list of supported hotkeys.
- MyHotkey: You can specify a user defined hotkey like "alt+v" here.
- MyCommand: Specify the command the hotkey "MyHotkey" will execute.
Create and configure a button or hotkey:
- Create a button or hotkey with the command Tagger. If you want to start Tagger in Comment mode press the modifier key Strg on the keyboard when you click the button (not working if Tagger is called by an embedded command).
- You can add several arguments:
- APP: provide path and command line options of an application to open the selected file. Example for Foobar2000: APP="/programfilesx86\foobar2000\foobar2000.exe /immediate"
- CLOSEAPP: together with the Argument VIEWER this will close the standalone viewer together with Tagger. For other applications you can provide a command to close the application. Example for Foobar2000: CLOSEAPP="/programfilesx86\foobar2000\foobar2000.exe /exit"
- CONFIRMDELETE: show a confirmation dialog when deleting Tags or comments.
- FILTER: apply a filter if you want to work work with certain file types only. Other files will be hidden. Examples : FILTER=*.(jpg|png) or FILTER=grp:images
- NOFOLDERS: hide folders. If you use the argument VIEWER you don't need to provide this argument because folders are always hidden (the standalone viewer doesn't like folders). If this argument was provided and a single folder is selected at start, Tagger will open this folder and select the first file.
- OPACITY: make the dialog transparent (0= fully transparent, 255 = opaque). This is especially useful when you're working with the standalone viewer.
- READONLY: apply this argument if you only want to watch the metadata of the files and prevent to make any changes to the files. Several dialog controls will be disabled in this mode.
- VIEWER: if you want to use the standalone viewer use this argument for a button in the toolbar of the viewer. If you want to start Tagger from a lister toolbar you'll have to start the viewer first and start Tagger with an embedded command like this:
Show FULLSCREEN AUTOFILELIST [ Tagger VIEWER FILTER=grp:images CLOSEAPP CONFIRMDELETE OPACITY=180 ]
The dialog and it's controls:
- List: in the listview control you'll see the tags or the comment of the currently selected file. Above the listview control you'll see the count of existing tags. If you select more than one file the list will only show tags or comment if they exist in all selected files. You can inline rename each entry and the changes will be written to the files. If you delete all characters from an entry the tag or comment will be deleted. Doubleclick a listview item to copy it to the main input.
- Name field: if only one file is currently selected this field will show the index and the name of the file. Otherwise it will only show how many files are currently selected. In some situations you may see a notification here.
- Main input: write tags or comment you want to apply to all selected files using the "Apply" button here. For tags you can enter any semicolon-separated string according to the rules documented in Keywords for SetAttr META. You can also use the main input for the Find feature of Tagger: Enter a string representing a tag and press the hotkey alt+f to find and select all files containing this tag ("+" or "-" at the beginning and ";" at the end of the string will be ignored). In comment mode Tagger will find all files with a comment containing the searchstring and show all these comments in the list. In a second column of the listview control the index of the file containing the comment will be shown. If you enter a number between 0 and 5 Tagger will find all files rated with this value. If you want to find all files rated 3,4 or 5 enter "3,4,5".
- Lock checkbox: by default, the main input will be cleared when the Apply or Remove button was clicked. Enable the checkbox to preserve the content of the main input. This can be useful to collect tags from several files using the "doubleclick listview item" feature and afterwards write them to others. The hotkey alt+l toggles the state of the checkbox.
- Combobox1: select Tags or Comment mode. The hotkey alt+m toggles this control.
- Combobox2: choose the behaviour of Tagger when the Apply or Remove button was clicked: arrow down: select next file arrow up: select previous file square: stay here
- Button "C" (Copy): click this button to copy all tags or the comment shown in the list to the main input. Hotkey: alt+c
- Rating input: provides a scrollable list of rating values 0-5. If more than one file is selected this control will only show a value if all files have the same rating value. Otherwise it will be empty. If you change the value of this control, the rating value will always be written to the selected files when you click the Apply or Remove button. Hotkeys: alt+[0-5] or alt+[NUM0-NUM5].
- Range input: this control will always show the index or range of the selected files. You can enter a index or range to select files. If you delete the content of the input field Tagger will select the last single selected file. Tagger will also select the last single file if several files are selected and you click the Next or Previous button or the Apply or Remove button according to the setting of Combobox2.
- Next Button (arrow down): select the next single file without writing anything to selected files. Hotkeys: alt++ and alt+NUM+
- Previous Button (arrow up): select the previous single file without writing anything to selected files. Hotkey: alt+- and alt+NUM-
- Apply button: apply tags or comment written to the main input and rating written to the rating input to all selected files. If the main input is empty or just "+" or "-" nothing new will be written to the files but if you are in Tags mode and a single file is selected the tags of the file will be alphabetically sorted and rewritten to the file. Hotkey: alt+a
- Remove button: the Remove button will delete all tags or the comment of all selected files if no items are selected in the list. Otherwise the button will only delete the selected items from all selected files. Hotkey: alt+d
Other features:
Some features are only available by pressing a hotkey on the keyboard:
- Find (alt+f):. see short description and description of the main input dialog control.
- Sort (alt+s): this will rewrite the tags of all files in the source folder alphabetically sorted. Since this needs some time for many files you'll see a notification in the name field until all files are written.
- Refresh (alt+F5): Tagger will notice if the sourcepath from which it was started or the number of files in the folder has changed and automatically refresh the dictionary in which the informations about all files are stored. You will be notified about this event in the name field. However, not all possible changes are detected by Tagger. If you made changes to the files outside of Tagger (replace files, manually write tags to files) you should use this hotkey to refresh Tagger. Otherwise Tagger may show false information about existing tags.
-
TaggerFocus: Tagger will move the focus from the viewer window to the Tagger GUI when the global Variable TaggerFocus exists. To use this feature create a viewer hotkey with this command:
@set glob!:TaggerFocus = True
Currently DOpus can't move the focus from the Tagger GUI to the viewer but you can use the command line tool nircmd.exe and MyHotkey/MyCommand described above to do this. To toggle the focus from Tagger to the viewer window MyCommand would be:[path to]nircmd.exe win activate stitle "Tagger - "
Apply the same hotkey like "alt+v" to the viewer hotkey and MyHotkey to get a hotkey that toggles the focus between Tagger GUI and viewer window.
Translations:
I'm not sure if my french translation is good because I'm not good in french. Please shout if something should be changed.
If you want to have Tagger in your own language feel free to download the provided text file LanguageStrings.txt, translate the strings and upload your translation here. I'll be glad to add new languages.
Tagger_Hotkeys.txt (2.07 KB)
Command.File_Tagger.vbs.txt (155 KB)
LanguageStrings.txt (1.06 KB)