Skip to content

Latest commit

 

History

History
170 lines (133 loc) · 8.69 KB

README.md

File metadata and controls

170 lines (133 loc) · 8.69 KB

KDE Service Menus

KDE service menus, or Dolphin service menus, are mainly INI files implementing the recommendations of the Freedesktop Desktop Entry Specification, and provide a method to embed in the contextual menu of KDE applications dedicated to file management, like Dolphin, Krusader, Konqueror, and KFind), shortcuts that recall an application useful to manipulate the selected files.

In an attempt to include the snippets I usually recall from the command line, I decided to write my personal collection and arrange them following my guidelines:

  • Essential bundle: no extra script besides the installer is bundled, all the commands go into the desktop file and the final size shouldn't exceed the order of the tens of Kbytes, indeed the files included in the archive are:
    • The installer that is in charge of installing and uninstalling the service;
    • The README file for documentation;
    • A simple Makefile for those who don't like to read the README file;
    • The LICENSE file;
    • The desktop file containing the service.
  • Different levels of documentation and reference are also very important:
    • In the desktop file itself;
    • In the README file;
    • In the KDE-store page;
    • In the Blog page.
  • POSIX compatibility to run flawlessly on the two basic shells: Bash and Dash;
  • The best integration level possible making use of KDialog and other common practices.

With time I realized that the integration wasn't fully accomplished until the messages provided by the Kdialog's dialogs would not have been fully translated into one of the supported languages.

The shortest and most effective workaround to solve that problem has been the implementation of a translating system based on a list of strings to replace inside a script template to generate the final service menu, a file for each supported language.

Last but not least, speaking about integration, it is also important for me to be able to install the services within the three KDE environments: KDE 4 (for legacy), Plasma 5, and the new Plasma 6.

The available services

My personal KDE service menus collection includes the following scripts:

  • Compare with Kompare: Cache and retrieve the file to compare with the selected one, using the clipboard area or a cache file;
  • Compose with Betterbird: compose a new email with the Betterbird email client using the selected files as attachments;
  • Compose with Betterbird (Flatpak edition): compose a new email with the Betterbird email client using the selected files as attachments (Flatpak edition);
  • Compose with Thunderbird: compose a new email with Thunderbird email client using the selected files as attachments;
  • Compose with Thunderbird (Flatpak edition): compose a new email with Thunderbird email client using the selected files as attachments (Flatpak edition);
  • Copy Filelist to Klipper: copy the result of several types of finding, accomplished through the find command, in the clipboard area using the Klipper D-Bus service;
  • Copy to Klipper: copy the selected filename name, or parts of it, in the clipboard area using the Klipper D-Bus service;
  • Download with youtube-dl here: download a file in the current folder using the youtube-dl command line tool;
  • Download with yt-dlp here: download a file in the current folder using the yt-dlp command line tool;
  • Open Konsole Here: open the selected path in the first or last Konsole window, current or new session;
  • Open with gVIM: displays all the selected files in different gVIM tabs instead of opening them in hidden buffers;
  • Open Yakuake Here: open the selected path in the current or new Yakuake's session, within the current terminal with or without splitting it horizontally or vertically;
  • Scan with ClamAV: scan the current directory or selected folder/file with ClamAV using either Yakuake or Konsole;
  • SQLite Tools: useful commands to perform on SQLite database files.

Install

There are several ways to install the service menus listed in this repository. The best option is always using the KDE store service from Dolphin or Discover, but in case something goes wrong, one of the other methods might come in handy for debugging purposes.

From Dolphin

All service menus are available at the KDE store and, at the same time, in the twin websites (Opendesktop, Pling), that way the installation can be easily performed from the settings interface:

Settings > Services > Download new Services

Just fill the text box with the service name, and once found, install it using the install button.

When multiple localizations are provided the interface expands on an overlay frame that allows to select the best option.

From the same interface uninstall the service menu as well.

From the tar archive

Once the archive has been downloaded there are two ways to proceed.

Using the Makefile

After extracting the archive:

$ tar -xvf <archive-name.tgz>

And enter the folder:

$ cd <project_folder>

To install the service menu:

$ make install

To remove the service:

$ make uninstall

Using servicemenuinstaller

It is a Dolphin utility that automatically installs the archives downloaded from the KDE store:

$ servicemenuinstaller install <archive-name.tgz>

To uninstall the service:

$ servicemenuinstaller uninstall <archive-name.tgz>

Contributing

Besides reporting bugs or asking for new features on the issues page, another way to lend your help is by translating the strings used within the service menus.

To make the services fully compliant to a particular language, I created a system to embed the strings directly within the exec line and generate a different package for each one.

The translated strings are available under the path of this repo:

<service_folder>/locale/<language_code>.yaml

The placeholders are quite self-explanatory, all the translations are based on the en.yaml file and respect the YAML format.

Get Help

More info is available at: