https://github.com/buster/rrun
minimalistic command launcher in rust
https://github.com/buster/rrun
Last synced: 7 months ago
JSON representation
minimalistic command launcher in rust
- Host: GitHub
- URL: https://github.com/buster/rrun
- Owner: buster
- License: gpl-2.0
- Created: 2014-11-11T19:16:35.000Z (almost 11 years ago)
- Default Branch: master
- Last Pushed: 2018-11-14T16:02:45.000Z (almost 7 years ago)
- Last Synced: 2025-04-04T05:46:37.627Z (7 months ago)
- Language: Rust
- Size: 915 KB
- Stars: 112
- Watchers: 7
- Forks: 14
- Open Issues: 7
-
Metadata Files:
- Readme: README.rst
- License: LICENSE
Awesome Lists containing this project
- awesome-rust-cn - buster/rrun - ci.org/buster/rrun.svg?branch=master">](https://travis-ci.org/buster/rrun) (应用 / System tools)
- awesome-rust - buster/rrun - ci.org/buster/rrun.svg?branch=master">](https://travis-ci.org/buster/rrun) (Applications / System tools)
- awesome-rust - buster/rrun
- awesome-rust - buster/rrun - A command launcher for Linux, similar to gmrun (Applications / System tools)
- awesome-rust - buster/rrun - ci.org/buster/rrun.svg?branch=master">](https://travis-ci.org/buster/rrun) (应用 Applications / 系统工具 System tools)
- fucking-awesome-rust - buster/rrun - A command launcher for Linux, similar to gmrun (Applications / System tools)
- fucking-awesome-rust - buster/rrun - A command launcher for Linux, similar to gmrun (Applications / System tools)
- awesome-rust-cn - buster/rrun
- awesome-rust-zh - buster/rrun - Linux 的命令启动器，类似于 gmrun[<img src="https://api.travis-ci.org/buster/rrun.svg?branch=master">](https://travis-ci.org/buster/rrun) (应用 / 系统工具)
README
.. image:: https://travis-ci.org/buster/rrun.svg?branch=master
:target: https://travis-ci.org/buster/rrun
.. image:: https://img.shields.io/crates/v/rrun.svg
:target: https://crates.io/crates/rrun
.. image:: https://cdn.rawgit.com/syl20bnr/spacemacs/442d025779da2f62fc86c2082703697714db6514/assets/spacemacs-badge.svg
:target: http://github.com/syl20bnr/spacemacs
rrun
====
Note: Apart from the occasional fix, this project is not actively developed anymore. rrun works fine and should run/compile for the time being on rust stable. Alternatives to rrun are gmrun and rofi.
Feel free to fork, request ownership or commit pull requests.
rrun is a minimalistic command launcher in rust similar to gmrun.
It started as a playground to learn Rust, but since i use it all day for months now, it's probably useful for others as well.
It replaced gmrun and gnome-do on my laptop.
rrun has few features, it can do bash completion and run commands and that's it.
It will also append the commands being run to your bash history.
.. image:: rrun.gif
Dependencies
""""""""""""
GTK3.10+
Installation
""""""""""""
You have several options:
#. download a Debian package from https://github.com/buster/rrun/releases
#. install from crates.io with "cargo install rrun"
#. compile yourself with "cargo build"
Usage
"""""
- enter a command and press Return to execute it
- press TAB for tab completion of available commands
- Press Ctrl + Return to display the command output in the text field
Set up rrun as command helper on Capslock
"""""""""""""""""""""""""""""""""""""""""
I have mapped the unused, needless CapsLock key to some other key and set up Gnome or whatever (i3wm in my case) to launch rrun on keypress.
My ~/.Xmodmap::
remove Lock = Caps_Lock
keysym Caps_Lock = XF86HomePage
Don't forget to run "xmodmap ~/.Xmodmap" after login.
The relevant parts of ~/.i3/config::
bindsym XF86HomePage exec rrun
for_window [title="rrun"] floating enable
exec --no-startup-id xmodmap ~/.Xmodmap
How to build the package
""""""""""""""""""""""""
Creation of a cowbuilder image
''''''''''''''''''''''''''''''
The build process needs pbuilder/cowbuilder installed in debian (apt-get install cowbuilder pbuilder).
A Debian testing buid image can be created with::
sudo cowbuilder --create --distribution testing
Eatmydata Installation
''''''''''''''''''''''
Install eatmydata (on build machine and in the image) to speeding up dpkg (from https://wiki.debian.org/cowbuilder ):
On the build machine::
apt-get install eatmydata
In the build image::
sudo cowbuilder --login --save
apt-get install eatmydata
For eatmydata (>=82-2), add this /etc/pbuilderrc (on the build machine)::
if [ -z "$LD_PRELOAD" ]; then
LD_PRELOAD=libeatmydata.so
else
LD_PRELOAD="$LD_PRELOAD":libeatmydata.so
fi
export LD_PRELOAD
Package Build Process
'''''''''''''''''''''
The debian package can be built with the following commands:
- `make deb` just creates the .deb file without touching the changelog
- `make snapshot` creates a snapshot .deb without incrementing the version number (but updating the changelog)
- `make release` creates a new release and bumps the minor version number
Contributors
""""""""""""
@nightscape
@tshepang