Skip to main content

Integration of scripts into various Unix file managers

Project description


file_manager_integration on PyPI Code style: black License: GPL v3

A small utility for integrating scripts into various Unix/Linux file managers.

It uses a file named file_manager_integration.json specifying the script and the parameters of the file manager integration.


Python 3.6 or newer


pip install file-manager-integration

I recommend either installing into a virtual environment or doing a user install:

pip install --user file-manager-integration


The utility can be invoked on the command line either directly (file_manager_integration) or via python3 -m (python -m in a Python 3 virtual environment):

python3 -m file_manager_integration

In the following examples, the short variant is used.

List supported file managers

file_manager_integration list-supported

Show configuration

Reads file_manager_integration.json from the current working directory and shows its contents.

file_manager_integration list-supported

Edit / create a configuration

Interactively asks the user for each parameter of a new configuration and writes the new configuration to file_manager_integration.json in the current working directory. If the file already existed before, values are read from it and used as presets.

file_manager_integration configure

Do the integration

Call file_manager_integration install with at least the name of the file manager and optionally the integration mode (actionor script). If the integration mode is omitted, the first one listed for the file manager when calling file_manager_integration list-supported will be used (that’s usually action if supported).

The action integration mode creates files, and the script integration modes creates symbolic links, both in locations specific to the file manager (see the file_managers module source).

file_manager_integration install [ Options ] <file manager> [ <integration mode> ]


  • --interactive asks for each parameter interactively, using the values from the file_manager_integration.json file as presets.
  • --force-create-directories creates required directories if they do not exist yet.
  • --force-overwrite overwrites pre-existing target files or symbolic links
  • --force-rename-existing renames an existing symbolic link pointing to the same path as the script to be integrated to the name specified in the parameters.

Scripts requirements

The scripts being integrated must support the following:

  • For script integration: Read the selected file or directory from environment variables set by the file manager:
  • For action integration: Read the selected file or directory as a single command line argument.

The scripts should provide a graphical user interface.

Supported file managers


  • Caja (MATE)
  • Nautilus (GNOME)
  • Nemo (Cinnamon)

planned support

  • KDE file manager
  • PCManFM (LXDE)
  • Thunar (XFCE)

Bugs / Feature requests

Feel free to open an issue here

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

file_manager_integration-0.2.2.tar.gz (25.6 kB view hashes)

Uploaded source

Built Distribution

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page