English
资源说明：MOVED https://gitlab.com/queria/qsrun - Simple C++/Qt tool for launching applications like xf4run, fbrun etc.
QSRun
=====
QSRun is simple Qt/C++ app for launching other applications.
It is similiar to other *runners* like xf4run, fbrun and other *Run ...* dialogs.
About/Motivation/Features
-------------------------
I required few features from QSRun:
- be simple to tweak (using source code)
- **complete app names** from $PATH
- launch apps not only from system but also from $PATH modified by user (added ~/bin etc) - (so respects .bash{rc,_profile} like when run from xterm)
- **NOT** launch non-existant apps (like xf4run opens unknown commands in browser - *hate it*)
- should remember **history of apps launched by you** and prefer them before others in typing-completion
- remembered history should be **easy to modify**
All this is fullfilled at the moment ;)
And as addition QSRun:
- **hides to tray** after successfull launch of app or after pressing Escape
- uses dbus to work as **single-instance app**
- uses inotify to auto-refresh list of available apps
- provides basic 'ECMAScript' calculations/evaluation
* to start **calculator** mode type equal-sign (**=**), then You can enter your expression
* expression will be evaluated using QScriptEngine
* You can use most of basic ECMAScript (like JavaScript) expressions like *12/4* or *Math.sqrt(9)*
* actually it can process QtScript_
- provides **currency conversion** using `Google's Finance Convert`_
* to use it, again start *calculator* mode (type **=**) and enter Your request
* request can take a form of ``[value_number] [source_currency] in [target_currency]``
* for example ``12 eur in usd`` to convert 12 U.S. dollars to Euro
* this feature, of course, requires internet connection
First version of QSRun was written in Python+Qt (PySide), you can get it from old-pyside_ branch.
Requirements
-------------------
Most of them are probably already installed in your linux distribution.
Rest can be (*maybe?*) installed using package manager (aptitude/emerge/pacman...).
* Working DBus_
* Qt_
* inotify_ enabled (Linux Kernel >= 2.6.13 with CONFIG_INOTIFY)
Build
-------------------
For tweaking and modification you can use QtCreator.
For simple usage:
::
$ cd ~/apps/
$ git clone 'git@github.com:queria/qsrun.git' qsrun
$ cd qsrun
$ qmake
$ make
$ ./build/qsrun # <- launch
You can copy ./build/qsrun to (or make symlink) ~/bin/ or some
other directory which is in your PATH.
You can add hotkey bindings for example to Alt+F2:
Fluxbox example
::
$ echo "Mod1 F2 :Exec ~/apps/qsrun/build/qsrun" >> ~/.fluxbox/keys
Or use your Desktop Environment hotkeys configuration utility (in xfce you can use xfce4-keyboard-settings and so on).
History file is located in ``~/.cache/qsrun/`` and it uses JSON_ format.
(Actually Qt/C++ version of qsrun uses only simple parsing of history file,
so be carefull ... only array/list of strings is supported in this file,
like [ "item1", "item2" ] (newlines are skipped).
Author(s)
-------------------
`Queria Sa-Tas`_
Licensing
-------------------
Copyright (C) 2011 by Queria Sa-Tas
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in
all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
THE SOFTWARE.
.. _inotify: http://en.wikipedia.com/wiki/inotify
.. _Qt: http://qt.nokia.com
.. _DBus: http://dbus.freedesktop.org
.. _JSON: http://json.org/example.html
.. _old-pyside: https://github.com/queria/qsrun/tree/old-pyside
.. _Google's Finance Convert: http://www.google.com/finance/converter
.. _QtScript: http://en.wikipedia.org/wiki/QtScript
.. _Queria Sa-Tas: https://sa-tas.net/
本源码包内暂不包含可直接显示的源代码文件，请下载源码包。
