Script Reference Guide

Konversation comes with several scripts installed by default, please refer to this guide to learn how to use them.

/exec bug [Bug Number|Search String]

This script is used to open your browser to search for the given string or bug number on KDE's Bugzilla.

Example: To open your browser to search for bug 123456

/exec bug 123456

Sample action: The default browser in your System Settings should open to http://bugs.kde.org/show_bug.cgi?id=123456

/exec cmd [command line arguments]

This script is used to have the output of the command line arguments to be written to your current channel.

Example: To show everyone in your current channel what version of Konversation you have installed.

/exec cmd konversation --version

Sample output: Konversation: 1.6

WARNING! The output of the entire command is posted to everyone in the current channel tab! Please use with care.

/exec fortune

This script when run will output a Random Fortune.

Example: To output a random fortune to your current channel tab.

/exec fortune

Sample output: Random Fortune: Never make any mistaeks. -- Anonymous, in a mail discussion about to a kernel bug report

/exec gauge [percentage]

This script shows a simple text based progress bar for the given percentage.

Example: To output a progress bar with 50% completion to the current channel tab.

/exec gauge 50

Sample output: Beer load [ | ] 50%

/exec media [audio|video|{player}]

This is a Now Playing script for various media players. It also features a method to show Now Playing information for only audio players, or only video players via the optional command arguments audio and video. Additionally, it's possible to specify the media player you wish to query.

The following media players are supported: Amarok (audio), JuK (audio), Kaffeine (video, audio), KMPlayer (video, audio), KPlayer (video, audio), kdetv (video), Yammi (audio), Audacious (audio), MPD (audio).

Example: To output your currently playing song in Amarok.

/exec media amarok

Sample output: * user is listening to You Give Love A Bad Name by Bon Jovi on Slippery When Wet [Amarok]

/exec sysinfo

This script outputs some detailed information about your system by combining the outputs of several commands and formatting them appropriately.

Example: To output some information about your system to the current channel tab.

/exec sysinfo

Sample output: Sysinfo for 'user-desktop': Running inside KDE Plasma 5.6.5 on Ubuntu 16.04.1 LTS (Xenial Xerus) powered by Linux 4.4.0-47-generic, CPU: Intel(R) Core(TM) i7-4910MQ CPU @ 2.90GHz at 2996-3338/3900 MHz, RAM: 15795/15967 MB, Storage: 1591/2281 GB, 406 procs, 47.59h up

/exec tinyurl [Link Address]

This script uses Tinyurl's api to turn the given link into a tinyurl that is then sent to the current channel tab.

Example: To give someone a short link to http://konversation.kde.org

/exec tinyurl http://konversation.kde.org

Sample output: http://tinyurl.com/n3pdum

/exec uptime

This script outputs the result of the command "uptime" and formats it appropriately.

Example: To show off your rock solid 98 day uptime.

/exec uptime

Sample output: Uptime: 98 days, 15 hours and 2 minutes

All these scripts have predefined command aliases. In Konversation's settings dialog select BehaviorCommand Aliases to view, add, remove or edit command aliases.

For more information about scripting please read the Userbase Scripting guide