qstardict man page

qstardict — a Qt4 dictionary

Description

QStarDict is a StarDict clone written with Qt4. The user interface is similar to StarDict. You can start QStarDict from the menu or by running the qstardict command.

Translation Reformatting and Abbreviation Expansion

QStarDict can reformat translations and expand dictionary abbreviations. For example this translation:

1> First _val. of _w. 2> Second _val. of _w. ...

can be shown as

1. Fist value of word
2. Second value of word
3. ...

But reformatting and expanding takes additional CPU time. If the translation reformatting and instant search are both turned on this can decrease QStarDict performance.

Dictionaries

Dictionaries for StarDict plugin are in StarDict format and by default must be placed into /usr/share/stardict/dic or ~/.stardict/dic directories. A dictionary must consist of three files:

- .dict[.dz] file - main dictionary file
- .idx - index file
- .ifo - description file

These files must be placed together in one directory.

Pronouncing Programs

QStarDict can pronounce words using external program when popup window is shown. You must set a voice program to pronounce text from stdin. By default this is festival with --tts option.

D-Bus

QStarDict supports D-Bus message bus. List of available methods:

void org.qstardict.dbus.showPopup(QString text)
void org.qstardict.dbus.showTranslation(QString text)
QString org.qstardict.dbus.translate(QString text)
QString org.qstardict.dbus.translateHtml(QString text)
QDBusVariant org.freedesktop.DBus.Properties.Get(QString interface_name, QString property_name)
void org.freedesktop.DBus.Properties.Set(QString interface_name, QString property_name, QDBusVariant value)
QString org.freedesktop.DBus.Introspectable.Introspect()

List of available properties:

readwrite int org.qstardict.dbus.mainWindowVisible

You can call these methods from your applications or by using the qdbus program. This command

qdbus org.qstardict.dbus /qstardict org.qstardict.dbus.showPopup "text"

will show a QStarDict popup window with a translation of the "text".

If you want to show/hide QStarDict window using keyboard shortcuts you must bind the following command to a shortcut:

qdbus org.qstardict.dbus /qstardict org.freedesktop.DBus.Properties.Set \

org.qstardict.dbus mainWindowVisible \

$(( ! $(qdbus org.qstardict.dbus /qstardict \

org.freedesktop.DBus.Properties.Get org.qstardict.dbus mainWindowVisible)))

Homepage

QStarDict website

Author

QStarDict was written by Alexander Rodin <rodin.alexander@gmail.com>.

This manual page was written by Alexander Rodin <rodin.alexander@gmail.com>, for the Debian project (but may be used by others).

See Also

stardict(1) sdcv(1) qdbus(1)

Info

November 11, 2007