Skip to content

npc-gnu/yaud

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

28 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

yaud logo

YAUD - Yet Another User Defender

What is YAUD?

YAUD is a terminal safety tool designed to help new GNU/Linux users. It prevents potentially dangerous commands like rm (in critical directories), umount, dd, and mkfs from running while it is active. When YAUD is inactive, it does nothing and allows all commands.

How to Use YAUD

Command Description
sudo yaud --h Displays the help menu
sudo yaud --s Shows whether YAUD is active
sudo yaud --c Closes (deactivates) YAUD
sudo yaud --a Activates YAUD

Does it Require Sudo?

Yes. YAUD must be run with sudo for the following reasons:

  • During installation, it copies files to /usr/local/bin, which requires root permissions.
  • To monitor or block commands like sudo rm -rf /, YAUD itself must also run as root.
  • If run without sudo, it will return an error.

Installation Guide

1. Install Required Packages

Arch / Arch-based:

sudo pacman -S git gcc g++

Debian / Ubuntu-based:

sudo apt install git g++ gcc

Fedora / RHEL-based:

sudo dnf install git gcc-c++

openSUSE:

sudo zypper install git gcc-c++

Alpine:

sudo apk add git g++

Old Pardus (non-Debian) / PisiLinux:

sudo pisi it git gcc

Gentoo:

sudo emerge --ask dev-vcs/git sys-devel/gcc

2. Clone the Repository

git clone https://github.com/npc-gnu/yaud.git

3. Navigate to the Project Directory

cd yaud

⚠️ Do not enter yaud/src or yaud/include directly, otherwise the build may fail.

4. Compile and install the Project

chmod +x compile
./compile

After installation, YAUD is not activated by default.
To activate it, run:

yaud --a

6. You're Done!

YAUD is now ready to help protect your terminal experience.

AUR Support?

There is an AUR package, but it currently doesn't work. I'm still working on fixing it.

License

This project is licensed under the GNU Affero General Public License v3 (AGPLv3).

About

yaud(yet another user defender)

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published