mirror of
https://github.com/adi1090x/rofi.git
synced 2025-12-10 20:30:11 +01:00
494 lines
30 KiB
Markdown
494 lines
30 KiB
Markdown
# Rofi Applets & Menus
|
|
|
|
<p align="left">
|
|
<img src="https://img.shields.io/badge/Maintained%3F-Yes-blueviolet?style=flat-square">
|
|
<img src="https://img.shields.io/github/license/adi1090x/rofi?style=flat-square">
|
|
<img src="https://img.shields.io/github/stars/adi1090x/rofi?color=red&style=flat-square">
|
|
<img src="https://img.shields.io/github/forks/adi1090x/rofi?style=flat-square">
|
|
<img src="https://img.shields.io/github/issues/adi1090x/rofi?style=flat-square">
|
|
</p>
|
|
|
|
<p align="left">
|
|
<a href="https://www.buymeacoffee.com/adi1090x"><img src="https://raw.githubusercontent.com/adi1090x/files/master/other/bmac.png" alt="Buy Me A Coffee"></a>
|
|
<a href="https://ko-fi.com/adi1090x"><img src="https://raw.githubusercontent.com/adi1090x/files/master/other/kofi.png" alt="Support me on ko-fi"></a>
|
|
</p>
|
|
|
|
A collection of custom *applets* and *menus* made using [rofi](https://github.com/davatorium/rofi) and its dmenu emulation.
|
|
|
|
|Menus|Applets|
|
|
|-|-|
|
|
|||
|
|
|
|
|Launchers|Sidemenus|
|
|
|-|-|
|
|
|||
|
|
|
|
<details>
|
|
<summary>Quick Links</summary>
|
|
|
|
- [Installation](https://github.com/adi1090x/rofi#installation)
|
|
- [Album](https://www.buymeacoffee.com/adi1090x/posts)
|
|
- [Applets](https://github.com/adi1090x/rofi#applets)
|
|
- [Menus](https://github.com/adi1090x/rofi#menus)
|
|
- [Sidemenus](https://github.com/adi1090x/rofi#android-style-sidemenus)
|
|
- [Launchers](https://github.com/adi1090x/rofi#app-launchers)
|
|
- [Ribbon](https://github.com/adi1090x/rofi#rofi-ribbon-launchers-rofi-git)
|
|
- [Slates](https://github.com/adi1090x/rofi#rofi-slates-rofi-git)
|
|
- [Colorschemes](https://github.com/adi1090x/rofi#colorschemes)
|
|
- [Usage](https://github.com/adi1090x/rofi#tips)
|
|
* [Polybar](https://github.com/adi1090x/rofi#use-with-polybar)
|
|
* [I3wm](https://github.com/adi1090x/rofi#use-with-i3)
|
|
* [Openbox](https://github.com/adi1090x/rofi#use-with-openbox)
|
|
|
|
</details>
|
|
|
|
### Dependencies
|
|
|
|
| Applets/Menus | Package(s) | Note |
|
|
|------------|--------------------------------------------------------------|-----------|
|
|
| Apps | `termite`, `thunar`, `geany`, `firefox`, `lxmusic`, `xfce4-settings-manager` | Or any other softwares you use most, just change this in *~/.config/rofi/scripts/apps.sh* & also in *menu*.|
|
|
| Backlight | `xbacklight`, `dunst` | Adjust brightness & Notify. |
|
|
| Battery | `acpi` & `xfce4-power-manager-settings` | To get battery info & launch power manager.|
|
|
| MPD | `mpd` and `mpc` | `mpc` is a cli based client for `mpd`.|
|
|
| Network | `dnsutils`, `nmcli`, `nmtui`, `bmon`, `nm-connection-editor` & `termite` | `Termite` is required to open `nmtui` & `bmon`, or any other terminal you use, just change this in *~/.config/rofi/scripts/network.sh* & also in *menu*. |
|
|
| Powermenu | `systemctl`, `i3lock` | By default `systemctl` is used for most actions, `i3lock` is used for locking, `openbox --exit` is used to log out. you might want to change these commands to match your setup. |
|
|
| Quicklinks | `firefox` (or `chromium`) | By default `firefox` is used to open links, you can use any other browser if you want, change accordingly. |
|
|
| Screenshot | `scrot` `maim` & `viewnior` | `scrot` to take shot & `viewnior` to open it after taking screenshot, you can change to whatever you use. |
|
|
| Time | - | - |
|
|
| Volume | `amixer` | To set the volume. |
|
|
|
|
### Fonts
|
|
|
|
+ **Comfortaa** Used for normal text, ([preview](https://www.dafont.com/comfortaa.font) and [source](https://www.deviantart.com/aajohan/art/Comfortaa-font-105395949)).
|
|
+ **Hurmit Nerd Font Mono** Used for icons, ([preview](https://app.programmingfonts.org/#hermit) and [source](https://github.com/ryanoasis/nerd-fonts/tree/master/patched-fonts/Hermit)).
|
|
+ **Feather** For icons used in android style sidemenus, [Here](https://github.com/adi1090x/rofi/blob/master/fonts/feather.ttf)
|
|
+ **Fantasque** For App launchers, [Here](https://github.com/adi1090x/rofi/blob/master/fonts)
|
|
+ **Iosevka** For App launchers, [Here](https://github.com/adi1090x/rofi/blob/master/fonts)
|
|
+ **Noto Sans** For Some App launchers, [Here](https://github.com/googlefonts/noto-fonts)
|
|
|
|
**Warning:** Do not change the `@icon-font` variable to another font, or you will end up messing with all applets/menus layout.
|
|
|
|
### Installation
|
|
|
|
+ First of all make sure you have `rofi` installed:
|
|
``` bash
|
|
# Arch / Arch-based
|
|
pacman -S rofi
|
|
|
|
# Debian / Ubuntu
|
|
apt-get install rofi
|
|
|
|
# Fedora
|
|
dnf install rofi
|
|
```
|
|
|
|
+ Then, clone this repository
|
|
|
|
```
|
|
# 1. Go in rofi's config folder
|
|
cd ~/.config/rofi
|
|
|
|
# 2. Clone this repo
|
|
git clone https://github.com/adi1090x/rofi.git
|
|
|
|
# 3. Make sure the scripts are executables
|
|
cd rofi && chmod +x scripts/*
|
|
|
|
# 4. Copy necessary files to the right location
|
|
cp -r bin scripts themes config.rasi ~/.config/rofi
|
|
|
|
# 5. Clean up rofi's config folder
|
|
cd .. && rm -r rofi
|
|
|
|
# 6. Call the scripts (from the scripts folder)
|
|
cd scripts
|
|
./backlight.sh
|
|
|
|
# (or from anywhere)
|
|
. ~/.config/rofi/scripts/backlight.sh
|
|
```
|
|
|
|
### Applets
|
|
|
|
 <br />
|
|
|
|
> Created & Tested With Rofi Version : **1.5.4**
|
|
|
|
- **Apps:** Shortcuts for most used applications.
|
|
- **Backlight:** Display and adjust screen brightness.
|
|
- **Battery:** Display battery percentage & charging-discharging status with dynamic icons.
|
|
- **MPD:** Control the song play through [mpd](https://github.com/MusicPlayerDaemon/).
|
|
- **Network:** Display Online-Offline status with dynamic icons.
|
|
- **Powermenu:** A classic power menu, with Uptime.
|
|
- **Quicklinks:** Bookmarks shortcuts for most used sites.
|
|
- **Screenshot:** Take screenshots using [scrot](https://github.com/dreamer/scrot).
|
|
- **Time:** Display Time, Day & Date.
|
|
- **Volume:** Display and control volume with dynamic icons for mute status.
|
|
|
|
<details><summary>Previews</summary>
|
|
|
|
|Powermenu|Time|Network|Battery|
|
|
|--|--|--|--|
|
|
|||||
|
|
|
|
|Volume|Backlight|Screenshot|MPD|
|
|
|--|--|--|--|
|
|
|||||
|
|
|
|
|Quicklinks|Apps|
|
|
|--|--|
|
|
|||
|
|
|
|
</details>
|
|
|
|
### Menus
|
|
|
|
 <br />
|
|
|
|
> Created & Tested With Rofi Version : **1.5.4**
|
|
|
|
- **Apps:** Shortcuts for most used applications.
|
|
- **Backlight:** Display and adjust screen brightness.
|
|
- **Battery:** Display battery percentage & charging-discharging status with dynamic icons.
|
|
- **MPD:** Control the song play through [mpd](https://github.com/MusicPlayerDaemon/).
|
|
- **Network:** Display SSID, IP, Online-Offline status with dynamic icons.
|
|
- **Powermenu:** A classic power menu, shows Uptime, CPU & Memory usages.
|
|
- **Quicklinks:** Bookmarks shortcuts for most used sites.
|
|
- **Screenshot:** Take screenshots using [scrot](https://github.com/dreamer/scrot).
|
|
- **Time:** Display Time, Day, Month, Date.
|
|
- **Volume:** Display and control volume with dynamic icons for mute status.
|
|
|
|
<details><summary>Previews</summary>
|
|
|
|
|Powermenu|Time|Network|Battery|
|
|
|--|--|--|--|
|
|
|||||
|
|
|
|
|Volume|Backlight|Screenshot|MPD|
|
|
|--|--|--|--|
|
|
|||||
|
|
|
|
|Quicklinks|Apps|
|
|
|--|--|
|
|
|||
|
|
|
|
</details>
|
|
|
|
### Android Style Sidemenus
|
|
|
|
> Created & Tested With Rofi Version : **1.5.4**
|
|
|
|
- **Apps:** Shortcuts for most used applications.
|
|
- **Backlight:** Adjust screen brightness.
|
|
- **MPD:** Control the song play through [mpd](https://github.com/MusicPlayerDaemon/).
|
|
- **Powermenu:** Android like Powermenu.
|
|
- **Quicklinks:** Bookmarks shortcuts for most used sites.
|
|
- **Screenshot:** Take screenshots using [scrot](https://github.com/dreamer/scrot).
|
|
- **Volume:** Control volume with dynamic icons for mute status.
|
|
|
|
 <br />
|
|
|
|
### Colorschemes
|
|
|
|
The files are stored in *~/.config/rofi/themes/colorschemes*.
|
|
To change the active colorscheme simply change the import line in *~/.config/rofi/themes/colors.rasi*.
|
|
|
|
If you wish to change the colorscheme for only one specific applet/menu, you can add the line below after `@import "colors.rasi"` to the *~/.config/rofi/themes/<menu-name>.rasi* or *~/.config/rofi/themes/menu/<menu-name>.rasi* file.
|
|
|
|
``` css
|
|
@import "colorschemes/<colorscheme-name>.rasi"
|
|
```
|
|
|
|
<details><summary>Previews</summary>
|
|
|
|
|Material Dark|Material Light|
|
|
|--|--|
|
|
|||
|
|
|
|
|Adapta-Nokto|Adapta|Arc-Dark|Arc|
|
|
|--|--|--|--|
|
|
|||||
|
|
|
|
|adwaita|gruvbox|dark|armchair|darkpink|
|
|
|--|--|--|--|--|
|
|
||||||
|
|
|
|
|fresh|inside|party|sirin|minimo|
|
|
|--|--|--|--|--|
|
|
||||||
|
|
|
|
</details>
|
|
|
|
### App Launchers
|
|
|
|
A collection for application launcher, works with `rofi` from official arch repo.
|
|
|
|
> Created & Tested With Rofi Version : **1.5.4**
|
|
|
|
***Stuff you need***
|
|
+ *Icon pack* : [Papirus](https://github.com/PapirusDevelopmentTeam/papirus-icon-theme)
|
|
+ *Fonts* : [Fantasque & Iosevka](https://github.com/adi1090x/rofi/blob/master/fonts)
|
|
+ *Compton_tryone* : For Blur, [Here](https://github.com/tryone144/compton)
|
|
|
|
***Styling***
|
|
+ Edit the `launcher.sh` file and change the **style** variable to set the style you like.
|
|
+ Edit the selected `.rasi` file and *uncomment* the desired color/style.
|
|
|
|
<details><summary>Previews</summary>
|
|
|
|
An Album is [Here](https://www.buymeacoffee.com/p/45388).
|
|
|
|
> Click on thumbnails to enlarge the image/gif.
|
|
|
|
|Icons|Icons Rainbow|Icons Fullscreen|Icons Sidebar|Icons Popup|Simple Dark|
|
|
|--|--|--|--|--|--|
|
|
|||||||
|
|
|
|
|Grid|Grid Round|Grid Full|Purple|Rainbow Sidebar|Rainbow|
|
|
|--|--|--|--|--|--|
|
|
|||||||
|
|
|
|
</details>
|
|
|
|
### App Launchers (rofi-git)
|
|
|
|
> These themes/configs only works with `rofi-git(aur)`. You need to build latest rofi if you're not using *archlinux*.
|
|
>
|
|
> Tested With Rofi Version : **1.5.4-76-gca067234**
|
|
|
|
***Stuff you need***
|
|
+ *Latest Rofi* : [Here...](https://github.com/davatorium/rofi)
|
|
+ *Icon pack* : [Papirus](https://github.com/PapirusDevelopmentTeam/papirus-icon-theme) & [Breeze](https://github.com/KDE/breeze-icons)
|
|
+ *Fonts* : [Fantasque](https://github.com/adi1090x/rofi/blob/master/fonts) & [Noto Sans](https://github.com/googlefonts/noto-fonts)
|
|
+ *For Blur* : [Compton Tryone](https://github.com/tryone144/compton)
|
|
|
|
***Styling***
|
|
+ Edit the `launcher.sh` file and change the **style** variable to set the style you like.
|
|
+ Edit the selected `.rasi` file and *uncomment* the desired color/style.
|
|
|
|
<details><summary>Previews</summary>
|
|
|
|
|Blurry|Launchpad|
|
|
|--|--|
|
|
|||
|
|
|
|
|Slingshot Light|Slingshot Dark|
|
|
|--|--|
|
|
|||
|
|
|
|
|Simple Menu Light|Simple Menu Dark|Krunner Light|Krunner Dark|
|
|
|--|--|--|--|
|
|
|||||
|
|
|
|
|AppDrawer Light|AppDrawer Dark|AppFolder Light|AppFolder Dark|
|
|
|--|--|--|--|
|
|
|||||
|
|
|
|
|Row Light|Row Dark|Column Light|Column Dark|
|
|
|--|--|--|--|
|
|
|||||
|
|
|
|
|RowCenter Light|RowCenter Dark|Row dock|Row Dropdown|
|
|
|--|--|--|--|
|
|
|||||
|
|
|
|
|Screen Light|Screen Dark|
|
|
|--|--|
|
|
|||
|
|
|
|
|GnomeDo Classic|GnomeDo Light|GnomeDo Black|GnomeDo Transparent|
|
|
|--|--|--|--|
|
|
|||||
|
|
|
|
</details>
|
|
|
|
### Rofi Ribbon Launchers (rofi-git)
|
|
|
|
> These themes/configs only works with `rofi-git(aur)`. You need to build latest rofi if you're not using *archlinux*.
|
|
>
|
|
> Tested With Rofi Version : **1.5.4-76-gca067234**
|
|
|
|
<!--  -->
|
|
|
|
***Stuff you need***
|
|
+ *Latest Rofi* : [Here...](https://github.com/davatorium/rofi)
|
|
+ *Icon pack* : [Oranchelo](https://github.com/OrancheloTeam/oranchelo-icon-theme) (You can use any other icon pack as well)
|
|
+ *Fonts* : [Fantasque](https://github.com/adi1090x/rofi/blob/master/fonts)
|
|
|
|
***Styling***
|
|
+ Edit the `launcher.sh` file and change the **style** variable to set the style you like.
|
|
+ Edit `~/.config/rofi/launchers-ribbon/styles/colors.rasi` file and *set* the desired color/style.
|
|
|
|
<details><summary>Previews</summary>
|
|
|
|
|Ribbon Top|Ribbon Top Round|Ribbon Top Single|Ribbon Top Single Round|
|
|
|--|--|--|--|
|
|
|||||
|
|
|
|
|Ribbon Left|Ribbon Left Round|Ribbon Left Single|Ribbon Left Single Round|
|
|
|--|--|--|--|
|
|
|||||
|
|
|
|
|Ribbon Bottom|Ribbon Bottom Round|Ribbon Bottom Single|Ribbon Bottom Single Round|
|
|
|--|--|--|--|
|
|
|||||
|
|
|
|
|Ribbon Right|Ribbon Right Round|
|
|
|--|--|
|
|
|||
|
|
|
|
|Ribbon Full Left|Ribbon Full Bottom|Ribbon Full Top|Ribbon Full Right|
|
|
|--|--|--|--|
|
|
|||||
|
|
|
|
<details><summary>Styles</summary>
|
|
|
|
|Bluish|Berry|Nordic|Nightly|
|
|
|--|--|--|--|
|
|
||||
|
|
|
|
|Gotham|Mask|Faded|Cocoa|
|
|
|--|--|--|--|
|
|
||||
|
|
|
|
|Cocoa|Nordic|Nightly|Berry|
|
|
|--|--|--|--|
|
|
||||
|
|
|
|
</details>
|
|
|
|
</details>
|
|
|
|
### Rofi Slates (rofi-git)
|
|
|
|
> These themes/configs only works with `rofi-git(aur)`. You need to build latest rofi if you're not using *archlinux*.
|
|
>
|
|
> Tested With Rofi Version : **1.5.4-76-gca067234**
|
|
|
|
<!--  -->
|
|
|
|
***Stuff you need***
|
|
+ *Latest Rofi* : [Here...](https://github.com/davatorium/rofi)
|
|
+ *Icon pack* : [Tela](https://github.com/vinceliuice/Tela-icon-theme) (You can use any other icon pack as well)
|
|
+ *Fonts* : [Fantasque](https://github.com/adi1090x/rofi/blob/master/fonts)
|
|
|
|
***Styling***
|
|
+ Edit `~/.config/rofi/launchers-slate/styles/colors.rasi` file and set the `color` you like.
|
|
+ Edit the selected `color file` and *uncomment* the desired color/style.
|
|
|
|
<details><summary>Previews</summary>
|
|
|
|
|Amber|Amber Alt|Blue|Blue Alt|Blue-gray|Blue-gray Alt|Brown|Brown Alt|
|
|
|--|--|--|--|--|--|--|--|
|
|
|||||||||
|
|
|
|
|Cyan|Cyan Alt|Deep-orange|Deep-orange Alt|Deep-purple|Deep-purple Alt|Green|Green Alt|
|
|
|--|--|--|--|--|--|--|--|
|
|
|||||||||
|
|
|
|
|Indigo|Indigo Alt|Light-blue|Light-blue Alt|Light-green|Light-green Alt|Lime|Lime Alt|
|
|
|--|--|--|--|--|--|--|--|
|
|
|||||||||
|
|
|
|
|Orange|Orange Alt|Pink|Pink Alt|Purple|Purple Alt|Red|Red Alt|
|
|
|--|--|--|--|--|--|--|--|
|
|
|||||||||
|
|
|
|
|Teal|Teal Alt|Yellow|Yellow Alt|Gray|Gray Alt|Black|Black Alt|
|
|
|--|--|--|--|--|--|--|--|
|
|
|||||||||
|
|
|
|
</details>
|
|
|
|
## Tips
|
|
|
|
### Simple way to execute applets/menus
|
|
|
|
You can copy links from `bin` folder to your `$PATH` variable so that entering `appsmenu` in the terminal (or executing this command) will summon the appsmenu. you can do it by -
|
|
|
|
``` bash
|
|
mkdir ~/.bin
|
|
cp -r ~/.config/rofi/bin/* ~/.bin
|
|
# Add folder to the $PATH variable
|
|
echo "PATH=$PATH:~/.bin" >> ~/.profile
|
|
```
|
|
|
|
**Note:** after doing this your `$PATH` variable won't be updated, so you will need to log out and then back in to be able to summon the menus this way.
|
|
|
|
### Use With polybar
|
|
|
|
This is a simple example on how can you use these applets with polybar by adding modules and giving full paths of selected applet like *~/.config/rofi/scripts/backlight.sh* or simply name if you followed the above method -
|
|
|
|
```bash
|
|
[module/backlight]
|
|
type = custom/text
|
|
content =
|
|
|
|
content-background = ${color.bg}
|
|
content-foreground = ${color.cyan}
|
|
|
|
click-left = ~/.config/rofi/scripts/backlight.sh
|
|
|
|
## Or...
|
|
|
|
[module/backlight]
|
|
type = custom/text
|
|
content =
|
|
|
|
content-background = ${color.bg}
|
|
content-foreground = ${color.green}
|
|
|
|
click-left = backlightmenu
|
|
|
|
```
|
|
|
|
Here's How it looks on polybar with different colorschemes for each applet...
|
|
|
|
<p align="left">
|
|
<img src=https://raw.githubusercontent.com/adi1090x/files/master/rofi/images/bar.gif>
|
|
</p>
|
|
|
|
### Use With i3
|
|
|
|
You can call the scripts by giving their fulls paths like *~/.config/rofi/scripts/<script-name>.sh* or follow method above to call the menus in one word. Then add these lines to your i3 config file:
|
|
|
|
```bash
|
|
set $mod Mod4
|
|
set $Alt Mod1
|
|
bindsym $mod+m exec --no-startup-id mpdmenu
|
|
bindsym $mod+n exec --no-startup-id networkmenu
|
|
bindsym $mod+p exec --no-startup-id ~/.config/rofi/scripts/powermenu.sh
|
|
#etc
|
|
```
|
|
|
|
### Use With Openbox
|
|
|
|
Same thing can be done with openbox by adding these lines to rc.xml file:
|
|
|
|
```xml
|
|
<keybind key="W-m">
|
|
<action name="Execute">
|
|
<command>~/.config/rofi/scripts/mpd.sh</command>
|
|
</action>
|
|
</keybind>
|
|
<!-- Or -->
|
|
<keybind key="W-m">
|
|
<action name="Execute">
|
|
<command>mpdmenu</command>
|
|
</action>
|
|
</keybind>
|
|
<!-- etc -->
|
|
```
|
|
|
|
### Support This Project
|
|
<p align="left">
|
|
<a href="https://www.paypal.me/adi1090x" target="_blank"><img alt="undefined" src="https://img.shields.io/badge/paypal-adi1090x-blue?style=for-the-badge&logo=paypal"></a>
|
|
<a href="https://www.buymeacoffee.com/adi1090x" target="_blank"><img alt="undefined" src="https://img.shields.io/badge/BuyMeAcoffee-adi1090x-orange?style=for-the-badge&logo=buy-me-a-coffee"></a>
|
|
<a href="https://ko-fi.com/adi1090x" target="_blank"><img alt="undefined" src="https://img.shields.io/badge/KoFi-adi1090x-red?style=for-the-badge&logo=ko-fi"></a>
|
|
</p>
|
|
|
|
### Bottom Line
|
|
+ PR's, Issues, Contributions are welcome.
|
|
+ No PR's for color-schemes, they always endup looking similar.
|
|
+ Have Fun!
|