A desktop-wide extension service used by elementary OS
Vala Meson
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
data
src
.gitignore
.travis.yml
CODE_OF_CONDUCT.md Create CODE_OF_CONDUCT.md (#14) Jun 17, 2017
COPYING
README.md
meson.build

README.md

Contractor

Building, Testing, and Installation

It's recommended to create a clean build environment

mkdir build
cd build/

Run cmake to configure the build environment and then make to build

cmake -DCMAKE_INSTALL_PREFIX=/usr ..
make

To install, use make install

sudo make install

Writing Contract Files

elementary Files, Photos and other apps support adding options to the context menu by the way of Contract files.

These Contract files can be made system wide available by adding them to: /usr/share/contractor or for specific users by adding them to: ~/.local/share/contractor

Simple .contract file example:

[Contractor Entry]
Name=Mount
MimeType=application/x-cd-image;application/x-raw-disk-image
Exec=gnome-disk-image-mounter %f
  • Name: Text displayed in the right click context menu.
  • MimeType: Mimetype(s) of files it should be shown for.
  • Exec: Command to execute. More info.

Tips:

  • Use pkexec to ask for root permissions. Example: Exec=pkexec chmod +x %U

Examples