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 KDE 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 | grep Konversation

Sample output: Konversation: 1.2

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 kdeversion

This script is used to output the result of the command "kde4-config --version"

Example: To output your current kdeversion.

/exec kdeversion

Sample output: Qt: 4.5.1 KDE: 4.2.85 (KDE 4.2.85 (KDE 4.3 Beta1)) kde4-config: 1.0

/exec mail [KMail Email Folder]

This script is used to show the current unread mail and total mail count in KMail.

Example: To output the current unread mail count in your inbox folder.

/exec mail inbox

Sample output: Email folder inbox has 30 unread messages, out of 800

/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), Noatun (audio, video), Kaffeine (video, audio), KMPlayer (video, audio), KPlayer (video, audio), KsCD (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 sayclip [Optional Delay]

This script outputs the contents of klipper to the current channel tab with a delay to provide flood protection.

Example: To output the contents of klipper with a 1 second delay.

/exec sayclip 1s

Sample output: Konversation sure is awesome!

/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': Linux 2.6.28-12-generic running KDE 4.2.85 (KDE 4.2.85 (KDE 4.3 Beta1)), CPU: Intel(R) Core 2 Quad CPU Q9450 @ 2.66GHz at 2666 MHz (5333 bogomips), HD: 370/445GB, RAM: 1965/2012MB, 232 proc's, 98.15d 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.