sirula - GitLite

KO | EN

gitlite — search

#javascript #python #hacktoberfest #react #golang #go #machine-learning #windows #awesome #vue #awesome-list #ios #openai #open-source

sirula

(★ 562)

Simple app launcher for wayland written in rust

File Explorer

Download Latest Version (.zip)

- .gitignore
- launcher.iml
- misc.xml
- modules.xml
- vcs.xml
- launch.json
- settings.json
- tasks.json
- - config.toml
  - readme.md
  - sirula.gif
  - style.css
- - config.toml
  - readme.md
  - sirula.png
  - style.css
- - config.toml
  - README.md
  - screenshot.png
  - style.css
- - config.toml
  - readme.md
  - screenshot.png
  - style.css
- - config.toml
  - readme.md
  - sirula.gif
  - style.css
- default-config.toml
- - desktop_entry.rs
  - mod.rs
- config.rs
- consts.rs
- history.rs
- locale.rs
- main.rs
- util.rs
.gitignore
Cargo.lock
Cargo.toml
COPYING
README.md

# Installation Guide

1. Get the code

git clone https://github.com/DorianRudolph/sirula

Downloads the entire project code from GitHub to your computer.

cd sirula

Moves into the project folder you just downloaded.

2. Rust

Medium Recommended

Prerequisites

Git Needed to download the project code from GitHub.
Rust (rustup) Installing via rustup also installs cargo.

cargo build --release

Compiles the Rust project.

cargo run

Builds and then immediately runs the program.

✅ If cargo build finishes without errors, it worked. The executable is created under target/.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Sirula

Sirula (simple rust launcher) is an app launcher for wayland.
Currently, the only feature is launching apps from `.desktop` files.
Feel free to submit pull requests for any feature you like.

I wrote sirula partially to learn rust, so do not expect perfect rust code.
I'd be happy to hear any criticism of my code.

## Examples

`sample-config/a`:

[![](https://raw.githubusercontent.com/DorianRudolph/sirula/master/sample-config/a/sirula.gif)](https://raw.githubusercontent.com/DorianRudolph/sirula/master/sample-config/sirula.gif)

`sample-config/e`: Overlay in the center of the screen with some simple CSS animations.

[![](https://raw.githubusercontent.com/DorianRudolph/sirula/master/sample-config/e/sirula.gif)](https://raw.githubusercontent.com/DorianRudolph/sirula/master/sample-config/sirula.gif)

## Building

- Dependency: [gtk-layer-shell](https://github.com/wmww/gtk-layer-shell)
- Build: `cargo build --release`
  - Optionally, `strip` the binary to reduce size
- Alternatively, install with `cargo install --path .`
- There is also an unofficial [AUR package](https://aur.archlinux.org/packages/sirula-git/)

## Configuration

Use `config.toml` and `style.css` in your `.config/sirula` directory.
See `sample-config` for documentation.

## Launching

Simply run `sirula`.

## Daemon mode

**! Latest git only !**

Run `sirula` with `--daemon` to start the daemon.
To show the window, simply run `sirula` again or use `--toggle` to toggle the window.

`sirula --reload`, `sirula --reload-or-restart`, `Ctrl+R` and `F5` will reload all desktop, config and styling files.

See `--help` for more options.

### DE Integration example: sway

Add this to your sway config file:
```
exec_always sirula --reload-or-restart
bindsym --no-repeat --release Super_L exec sirula --toggle
```