Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/pznguin-kyun/pengurice

🍙 pznguin-kyun's Auto Rice Bootstrapping Script
https://github.com/pznguin-kyun/pengurice

bspwm dotfiles linux rice themes unixporn

Last synced: about 1 month ago
JSON representation

🍙 pznguin-kyun's Auto Rice Bootstrapping Script

Awesome Lists containing this project

README

        

✨ pengurice ✨


📜 A script that rice your Linux/*nix system.






# **Table of Contents**
- [About ⁉️](#about-%EF%B8%8F)
- [Starring 🌠](#starring-)
- [Gallery 📷](#gallery-)
- [Installation 🛠️](#installation-%EF%B8%8F)
- [Keybindings ⌨️](#keybindings-%EF%B8%8F)
- [Credits 👨‍🔧](#credits-)
- [Support 💝](#support-)
- [License](#license)

# **About ⁉️**
## Hello! Thanks for dropping by 👋
This is pengurice, a script that automatically rice your Linux system. I made this for people who wants a simple, productive and eyecandy Linux desktop.

# **Starring 🌠**

- [pengudotfiles](https://github.com/pznguin-kyun/pengudotfiles): default dotfiles
- [bspwm ⚽](https://github.com/baskerville/bspwm): window manager
- [alacritty ❤️](https://alacritty.org/): terminal
- [firefox 🦊](https://www.mozilla.org/en-US/firefox/): browser
- [ranger](https://ranger.github.io/) and [nemo](https://github.com/linuxmint/nemo): file manager
- [neovim](https://neovim.io): editor
- [cmus](https://cmus.github.io/): music player
- [calcurse](https://www.calcurse.org/): calendar
- [btop](https://github.com/aristocratos/btop): system monitor

and so on!

# **Gallery 📷**
| bloom | catppuccin | dracula |
| :--------------------------------------------- | :--------------------------------------------- | :-------------------------------------------- |
| ![bloom](https://i.imgur.com/m0F9ZsP.png) | ![catppuccin](https://i.imgur.com/x2J3zFt.png) | ![dracula](https://i.imgur.com/tDZ8VmE.png) |
| everforest | gruvbox | macaroni |
| ![everforest](https://i.imgur.com/6SEhR5f.png) | ![gruvbox](https://i.imgur.com/K1GlJk8.png) | ![macaroni](https://i.imgur.com/6ReXidY.png) |
| monochrome | nord | rosepine |
| ![monochrome](https://i.imgur.com/y3tnFkw.png) | ![nord](https://i.imgur.com/CmhW7Jb.png) | ![rosepine](https://i.imgur.com/16Y0WZT.png) |
| snowy | tokyonight |
| ![snowy](https://i.imgur.com/YnxsCFS.png) | ![tokyonight](https://i.imgur.com/DgYvmt4.png) |

# **Installation 🛠️**
## Distros
- Arch Linux and Arch-based distros (EndeavourOS, Artix Linux, Arco Linux, ArchCraft, ...)
- RedHat-based distros (RHEL, Fedora, Nobara, ...)
- Debian and Debian-based distros (Ubuntu, Pop! OS, ...)
- SUSE and openSUSE
- Void Linux

## Install with git
```
$ git clone --depth 1 https://github.com/pznguin-kyun/pengurice
$ cd pengurice
# ./pengurice.sh
```

## Install with curl
```
$ curl -LO https://raw.githubusercontent.com/pznguin-kyun/pengurice/main/pengurice.sh
# bash pengurice.sh
```

## Install manually
Read [pengudotfiles's README](https://github.com/pznguin-kyun/pengudotfiles) for more information

## Some notes
- If your system doesn't have `bash`, install it.
- Tested on latest Arch Linux, Fedora 38, Debian 12, Ubuntu 23.04, OpenSUSE Tumbleweed, latest Void Linux.
- This script MUST BE run as `root`.
- If you dont have display manager (or login manager), you can login with xinit.
```
startx
```

# **Keybindings ⌨️**
These are the basic keybinds. Read through the `bspwm/config/keys` file for more keybinds like increasing gaps and restoring gaps.
> Note: Super = Windows key

| Keys | Function |
| :------------------------------------------------ | :-------------------------------- |
| `Super + Enter` | Launch terminal (alacritty) |
| `Super + Q` | Close window |
| `Super + Alt + R` | Restart window manager (bspwm) |
| `Super + D` | Open launcher (rofi) |
| `Super + BackSpace` | Open powermenu |
| `Super + X` | Open menu |
| `Super + Tab` | Open window menu |
| `Super + Shift + C` | Open colorscheme changer |
| `Super + Delete` | Screenshot menu |
| `Super + Shift + B` | Toggle bar (polybar) |
| `Super + Shift + P` | Toggle compositor (picom) |
| `Super + T/Shift + T/F/S/` | Tile/Pseudo Tile/Float/Fullscreen |
| `Super + R` | Rotate window |
| `Super + H/J/K/L or Left/Down/Up/Right` | Change Focus |
| `Super + Shift + H/J/K/L or Left/Down/Up/Right` | Move window |

# **Credits 👨‍🔧**
- [Contributors](https://github.com/pznguin-kyun/pengurice/graphs/contributors)
- Some people on Discord

# **Support 💝**
If you like my project and would like to support & appreciate it via donation then I'll gladly accept it.
- [☕Ko-fi](https://ko-fi.com/p3nguinkun)
- [💳 PayPal](https://paypal.me/p3nguinkun)

# **License**
This project is licensed under the GNU General Public License v3.0. See the [LICENSE](LICENSE) file for details.

🌟 Good Luck and Seeya! 🌟