https://github.com/aldiipratama/pacsmart
Turn your Arch Linux package manager into a pixel-perfect Arcade Game. A gamified wrapper for Pacman, Yay, and Paru with RPG stats and automation.
https://github.com/aldiipratama/pacsmart
arch-linux aur-helper bash-script cli gamification pacman paru ricing terminal-customization yay
Last synced: 7 days ago
JSON representation
Turn your Arch Linux package manager into a pixel-perfect Arcade Game. A gamified wrapper for Pacman, Yay, and Paru with RPG stats and automation.
- Host: GitHub
- URL: https://github.com/aldiipratama/pacsmart
- Owner: aldiipratama
- License: mit
- Created: 2025-11-20T19:30:05.000Z (6 months ago)
- Default Branch: main
- Last Pushed: 2025-11-21T03:53:51.000Z (6 months ago)
- Last Synced: 2025-11-21T04:23:32.370Z (6 months ago)
- Topics: arch-linux, aur-helper, bash-script, cli, gamification, pacman, paru, ricing, terminal-customization, yay
- Language: Shell
- Homepage:
- Size: 17.6 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Security: SECURITY.md
Awesome Lists containing this project
README
# ๐ Pacsmart
> **The Ultimate Arcade Wrapper for Arch Linux Package Managers.**
>
> Transform your boring `pacman`, `yay`, or `paru` output into an engaging, gamified, and pixel-perfect arcade experience.
[](./LICENSE)
[](./SECURITY.md)
[](./CONTRIBUTING.md)
[](./CODE_OF_CONDUCT.md)
-----
## ๐ฎ What is Pacsmart?
**Pacsmart** is not just a wrapper; it's a visual overhaul for your Arch Linux terminal. It intelligently wraps around your existing helper (`paru`, `yay`, or vanilla `pacman`) to provide:
* **Gamification:** An RPG-style ranking system based on your installed packages ("Loot").
* **Visual Feedback:** Replaces standard loading bars with "Waka-Waka" Pacman animations.
* **Automation:** Built-in Garbage Collector (`-C`) and Lockfile Remover (`--unlock`).
* **Safety First:** Sudo keep-alive mechanism prevents password prompt timeouts.
**Professional Note:** Under the hood, Pacsmart passes **all** flags directly to the backend. If a command works in `pacman` or `yay`, it works in Pacsmart.
-----
## ๐ธ Visual Preview
```text
.--. PACSMART v1.0
/ _.-' (Initial Release)
\ '-. Automated & Informative
'--'
โโโ PLAYER PROFILE โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ User : aldi โ
โ System : Arch Linux โ
โ Engine : paru โ
โโโ STATS โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโค
โ Rank : ARCH WIZARD โ
โ Loot : 520 / 1000 โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
>>> MISSION START: EATING (REPO) >>>
[sudo] password for aldi:
แง C โข โข โข โข โข โข โข แฃ
```
-----
## โจ Key Features
| Feature | Description |
| :--- | :--- |
| ๐ **Arcade UI** | High-contrast, pixel-perfect terminal UI with headers and icons. |
| ๐ **Rank System** | Level up from *Beginner* to *Legendary* as you install more packages. |
| โ๏ธ **Universal Wrapper** | Supports `-S`, `-Rns`, `-Qdt`, and *every* other standard flag. |
| ๐งน **Auto-Clean** | dedicated `-C` flag to detect and remove orphan packages easily. |
| ๐ **Medic Mode** | Fix `db.lck` errors instantly with `--unlock`. |
| โฉ **Speedrun** | Skip animations with `--fast` for quick operations. |
-----
## ๐ Installation Guide
Pacsmart is a standalone Bash script. You don't need to compile anything.
### Prerequisites
Ensure you have **Arch Linux** (or derivative) and at least one of these installed:
* `pacman` (Default)
* `yay` (Recommended)
* `paru` (Recommended)
### Method 1: Quick Install (Recommended)
Copy and paste this block into your terminal to download and install automatically:
```bash
# 1. Download the script
curl -O https://raw.githubusercontent.com/aldiipratama/pacsmart/main/pacsmart
# 2. Give it execute permission
chmod +x pacsmart
# 3. Move to your binary path (Requires Sudo)
sudo mv pacsmart /usr/local/bin/
# 4. Verify installation
pacsmart --version
```
### Method 2: Manual / Git Clone
If you want to inspect the code or contribute:
```bash
git clone https://github.com/aldiipratama/pacsmart.git
cd pacsmart
chmod +x pacsmart
sudo cp pacsmart /usr/local/bin/
```
-----
### โก Setup Aliases (The Pro Move)
To get the full "Arcade Experience", replace your standard commands with Pacsmart aliases.
Add the following lines to your shell configuration file (usually `~/.bashrc` or `~/.zshrc`):
```bash
# ~/.zshrc or ~/.bashrc
# Option A: Safety First (Use 'pac' keyword)
alias pac="pacsmart"
# Option B: Full Replacement (Override 'pacman')
# WARNING: This replaces the standard pacman command visually
alias pacman="pacsmart"
alias yay="pacsmart --use=yay"
alias paru="pacsmart --use=paru"
```
**Apply changes:**
```bash
source ~/.bashrc
# or
source ~/.zshrc
```
Now, just type `pac -S neovim` and enjoy the show\! ๐
-----
### ๐๏ธ Uninstallation
If you want to remove Pacsmart (but why would you?):
```bash
sudo rm /usr/local/bin/pacsmart
rm ~/pkg-installed.txt # Removes your high score/rank data
```
-----
## ๐น๏ธ Usage Guide
Pacsmart uses a **"Hybrid Passthrough"** system. It has its own special flags, but also accepts everything else.
### ๐ Main Quests
| Command | Action |
| :--- | :--- |
| `pacsmart -S ` | Install package (Auto-detects Repo/AUR). |
| `pacsmart -Syu` | Full System Upgrade (Level Up). |
| `pacsmart -Rns ` | Remove package + dependencies (Clean Uninstall). |
### โ๏ธ Automation & Specials
| Command | Action |
| :--- | :--- |
| `pacsmart -C` | **Garbage Collector:** Find & remove orphans automatically. |
| `pacsmart --unlock` | **Medic:** Removes `/var/lib/pacman/db.lck` if stuck. |
| `pacsmart --fast` | **Speedrun:** Disable animations. |
| `pacsmart --simulate` | **Demo:** Show package info without installing. |
-----
## ๐ค Community & Contribution
We welcome "Player 2" to join the development\!
* **Want to contribute code?** Read our [Contributing Guide](https://www.google.com/search?q=./CONTRIBUTING.md).
* **Found a glitch/bug?** Create an issue using our [Issue Templates](https://www.google.com/search?q=.github/ISSUE_TEMPLATE/).
* **Found a security exploit?** Please read our [Security Policy](https://www.google.com/search?q=./SECURITY.md) before posting publicly.
* **Our Rules:** Play nice\! Read our [Code of Conduct](https://www.google.com/search?q=./CODE_OF_CONDUCT.md).
-----
## โค๏ธ Credits & Inspiration
This project stands on the shoulders of giants.
* **[Arch Linux Pacman](https://wiki.archlinux.org/title/Pacman):** Specifically the legendary `ILoveCandy` config.
* **[Yay](https://github.com/Jguer/yay) & [Paru](https://github.com/Morganamilo/paru):** The powerful AUR helpers backend.
-----
Made with โค๏ธ and โ by [Muhamad Rinaldi Agus Pratama](https://github.com/aldiipratama)