Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/umutsevdi/rofi-applets
Various useful applets developed with Rofi and shell-scripts.
https://github.com/umutsevdi/rofi-applets
i3 i3wm linux rofi rofi-config rofi-menus rofi-scripts wm
Last synced: about 1 month ago
JSON representation
Various useful applets developed with Rofi and shell-scripts.
- Host: GitHub
- URL: https://github.com/umutsevdi/rofi-applets
- Owner: umutsevdi
- License: mit
- Created: 2022-08-27T19:43:50.000Z (over 2 years ago)
- Default Branch: master
- Last Pushed: 2023-06-16T06:32:11.000Z (over 1 year ago)
- Last Synced: 2023-06-16T07:28:31.410Z (over 1 year ago)
- Topics: i3, i3wm, linux, rofi, rofi-config, rofi-menus, rofi-scripts, wm
- Language: Shell
- Homepage:
- Size: 36.4 MB
- Stars: 5
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
Rofi Applets
Bundle of easy to configure useful Rofi Applets
Developed by Umutcan Sevdi
Table of Contents
## 1- Project
Rofi is an amazing tool to create pop-ups and small applications. Here I built a CLI and
bunch of useful applets.
## 2- Installation
This project requires [Rofi](https://github.com/davatorium/rofi). It's a very powerful
pop-up/switcher that allows anyone to create powerful menus. You can download
it from the package manager of your choice.
```sh
$sudo dnf install rofi
```
You can then clone this repository any directory of your choice.
```sh
$git clone https://github.com/umutsevdi/rofi-applets.git
```
By default the `applet` CLI checks the `$HOME/.dotfiles/applets` directory for available
applets. However you can change this by overwriting the `ROFI_APPLETS_PATH` variable.
```sh
$export ROFI_APPLETS_PATH=/path/to/rofi-applets
```
Now link the CLI to a directory where your binaries are.
```sh
$ln -s /path/to/rofi-applets/applet ~/bin
```
You are ready to go! You can now run any applet either by calling their launchers
directly or by using the CLI.
## 3- How To Use
After installation run the applet command.
```sh
$applet
applet.sh - Applet Launcher Interface
──────────────────────────────────────────────
Command line interface to run Rofi Applets
Syntax: [-r]
Options:
┌────────────────────────────────────────────┐
│ -h/--help Prints this menu. │
│ -r/--run $app Runs selected applet │
└────────────────────────────────────────────┘
Available Applets:
- emoji
- filebrowser
- launcher
- player
- powermenu
- tab
```
If the applet can not detect any applet, it will prompt an error like this. It means
you made a mistake while defining the `ROFI_APPLETS_PATH` variable.
```sh
$applet
ls: cannot access '/home/user/applets/*/': No such file or directory
error: No applet were found at /home/user directory.
Either move applets to the /home/user or define $ROFI_APPLETS_PATH at .bashrc
applet.sh - Applet Launcher Interface
──────────────────────────────────────────────
Command line interface to run Rofi Applets
```
If there are no errors you can simply run any available applet using `applet -r`.
## 4- Customization
You can customize or build new applets easily.
- All applets read color values from `applets/global.rasi`. Editing color hexcodes
will update all existing applets.
- You can make your own applets with following logic. Create a directory at
`ROFI_APPLETS_PATH`. Then open two files. `config.rasi` and `launch.sh`. Instead
of defining your own color values, import all of them from global.rasi for
consistency. Develop rest like any other rofi applet. Write your launch script
to the `launch.sh`. Applet CLI will automatically recognize your applet on the
next run.
## 5- License
Distributed under the MIT License. See `LICENSE` for more information.
## 6- Contact
You can contact to me for any suggestion or information.
Project: [umutsevdi/rofi-applets](https://github.com/umutsevdi/rofi-applets)
Developed by [Umutcan Sevdi](https://github.com/umutsevdi)