🚀 shrtrun

shrtrun is a lightweight command launcher script for Linux, powered by rofi. It supports quick access to web search engines, YouTube searches, and execution of shell commands through a simple and customizable interface.

✨ Features

• ⚡ Launch custom shell commands
• 🌐 Search the web using your preferred search engine
• 📺 Search YouTube directly
• 🛠️ Configurable via ~/.config/shrtrun/config.conf
• 🕘 Command history for fast re-use

📦 Installation

1. Save the script (e.g., as shrtrun.sh) and make it executable:

chmod +x shrtrun.sh

2. (Optional) Move it somewhere in your $PATH:

mv shrtrun.sh ~/.local/bin/shrtrun

3. Run it via a keybinding or launcher

shrtrun

Or use the full path if not in your $PATH (e.g., /path/to/shrtrun.sh).

⚙️ Configuration

On first run, the script creates a config file at:

~/.config/shrtrun/config.conf

📝 Example config:

log_file: /logs/shrtrun.log
search_engine: https://duckduckgo.com/?q=
youtube_search: https://www.youtube.com/results?search_query=

🧑‍💻 Usage

• 💬 Regular Commands: Type any shell command and hit Enter to execute it.
• 🧠 Special Prefixes:
  • !g your search — Searches the web via your configured search engine 🌍
  • !y your search — Searches YouTube 📹

📜 Command History

shrtrun keeps a history file at:

~/.config/shrtrun/history.txt

This lets you recall previous commands easily when relaunching shrtrun. Only successful or valid commands are saved.

🔧 Requirements

• rofi
• awk, bash, xdg-open (most likely pre-installed)
• Optional: notify-send for desktop notifications 🔔

📥 Install dependencies

• 🐧 Debian/Ubuntu: sudo apt install rofi xdg-utils libnotify-bin
• 🐧 Arch/Manjaro: sudo pacman -S rofi xdg-utils libnotify
• 🐧 Fedora: sudo dnf install rofi xdg-utils libnotify
• 🐧 openSUSE: sudo zypper install rofi xdg-utils libnotify

---

📝 GPL License – This project is licensed under the GNU General Public License. See the LICENSE file for more details. 🧾