External Editor Configuration

This dialog allows user to add new editors or modify the system ones. It is available in the menu Edit ▸ Preferences ▸ Configure Editors .

The Editors dialog shows list of all relevant editors i.e. all installed desktop files that are designated either:

Categories=Graphics
Categories=X-Geeqie

The list has the following columns:

Name

Editor name as specified in desktop file, and is the name displayed in menus.

Hidden

An editor can be Hidden for one of these reasons:

the desktop file contains Hidden=TRUE or NoDisplay=TRUE
TryExec binary was not found
MimeType list does not contain images
MimeType list is empty and Categories does not contain X-Geeqie

Desktop file: Name of the desktop file, used as an identifier in Keyboard Options .
Path: Full path to the desktop file. Desktop files in user directories override the system ones with the same name.

New opens a text editor with a desktop file template. You must amend the line

Exec=command %f

to contain the command you wish to execute. If it is more than a single command, you must create a script file and call that. If the location of the script file is not in your $PATH environment variable, you must include the full pathname.

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 editor will appear, instead of in the default Edit ▸ External Editors , 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
        SelectMenu/EditMenu
        SelectMenu/ExternalMenu
        SelectMenu/EditSection
        SelectMenu/OrientationMenu
        SelectMenu/PropertiesSection
        SelectMenu/PreferencesMenu
        SelectMenu/PreferencesSection
        ViewMenu
        ViewMenu/WindowSection
        ViewMenu/FileDirMenu
        ViewMenu/FileDirMenu/FolderSection
        ViewMenu/FileDirMenu/ListSection
        ViewMenu/DirSection
        ViewMenu/ZoomMenu
        ViewMenu/ZoomMenu/ConnectZoomMenu
        ViewMenu/SplitMenu
        ViewMenu/ColorMenu
        ViewMenu/OverlayMenu
        ViewMenu/ViewSection
        ViewMenu/ToolsSection
        ViewMenu/SlideShowSection
        HelpMenu
        HelpMenu/HelpSection

If you want an editor 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 external editor 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 editor 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 an editor 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 editor command can be displayed with the following command:

X-Geeqie-Verbose=true

The editor can be restricted to run on only certain file types, for example:

X-Geeqie-File-Extensions=.jpg; .cr2

The entries are case insensitive.

X-Geeqie-Keep-Verbose-Multi=

TBD

The key or key combination to execute this function can be set with:

X-Geeqie-Hotkey=

Key combinations are of the form:

X-Geeqie-Hotkey=<control>y

This value may conflict with a setting in Keyboard Options

External Editor Configuration

12.2.1. Editor Configuration Dialog

12.2.2. Adding new editor

12.2.3. Modifying an existing editor

12.2.4. Deleting an editor

12.2.5. Special editors

12.2.6. Geeqie desktop file keys