This dialog allows user to add new plugins or modify the system ones. It is available in the menu Edit ▸ Configure Plugins .
The Plugins dialog shows list of all relevant plugins i.e. all installed desktop files that are designated either:
Plugin name as specified in desktop file, and is the name displayed in menus.
New opens a text editor with a desktop file template. You must amend the line
Exec=command %f
Edit opens a text editor with existing desktop file. For desktop files that are not writable by user, it allows saving to a Geeqie specific directory, where it overrides the system file (but only for Geeqie).
Delete can delete user writable desktop files. System desktop files can't be deleted directly, but it is possible to edit them and set Hidden=TRUE , see above.
A desktop file with one of the following names has a special function. It will replace the corresponding internal command.
geeqie-copy-command.desktop geeqie-move-command.desktop geeqie-rename-command.desktop geeqie-delete-command.desktop geeqie-folder-command.desktop
This can be used for example for a custom trash command or for manipulation of files under version control.
A desktop file for use only by Geeqie should have the following entries:
Categories=X-Geeqie; OnlyShowIn=X-Geeqie;
A menu path where the plugin will appear, instead of in the default Plugins , can be set by including:
X-Geeqie-Menu-Path=<FileMenuPath>
Possible vales for FileMenuPath are:
FileMenu FileMenu/OpenSection FileMenu/SearchSection FileMenu/PrintSection FileMenu/FileOpsSection FileMenu/QuitSection GoMenu SelectMenu SelectMenu/SelectSection SelectMenu/ClipboardSection SelectMenu/MarksSection EditMenu/EditMenu EditMenu/EditSection EditMenu/OrientationMenu EditMenu/RatingMenu EditMenu/PropertiesSection EditMenu/PreferencesSection PluginsMenu ViewMenu ViewMenu/WindowSection ViewMenu/FileDirMenu ViewMenu/FileDirMenu/FolderSection ViewMenu/FileDirMenu/ListSection ViewMenu/DirSection ViewMenu/ZoomMenu ViewMenu/ZoomMenu/ConnectZoomMenu ViewMenu/SplitMenu ViewMenu/StereoMenu ViewMenu/ColorMenu ViewMenu/OverlayMenu ViewMenu/ViewSection ViewMenu/ToolsSection ViewMenu/SlideShowSection HelpMenu HelpMenu/HelpSection
If you want a plugin to use a user-definable path, the following entry must be made in the desktop file:
X-Geeqie-Filter=true
Desktop files containing this entry will be displayed in the Folder action list of the Sort Manager Sidebar . The path of the bookmark clicked will be used by the desktop file.
If the desktop file is called from the menu, when the plugin is executed you are presented with a dialogue which enables a path to be selected. The path selected, appended by the filename currently being processed, is made available to the shell script either as an environment variable or via a call to geeqie --remote. The following code demonstrates the use of both methods:for file in "$@" do destination=$(geeqie --remote --get-destination:"$file") echo "$destination" echo $GEEQIE_DESTINATION done
If you want to run a plugin in full-screen mode and wish full-screen to be maintained, include the following entry in the desktop file:
X-Geeqie-Keep-Fullscreen=true
Any terminal output from the plugin command can be displayed with the following command:
X-Geeqie-Verbose=true
The plugin can be restricted to run on only certain file types, for example:
X-Geeqie-File-Extensions=.jpg; .cr2
X-Geeqie-Keep-Verbose-Multi=
The key or key combination to execute this function can be set with:
X-Geeqie-Hotkey=
X-Geeqie-Hotkey=<control>y