░  ░░░░  ░░  ░░░░  ░░░      ░░░  ░░░░  ░
▒  ▒▒▒  ▒▒▒▒  ▒▒  ▒▒▒  ▒▒▒▒▒▒▒▒▒  ▒▒  ▒▒
▓     ▓▓▓▓▓▓▓    ▓▓▓▓  ▓▓▓   ▓▓▓▓    ▓▓▓
█  ███  ██████  █████  ████  ███  ██  ██
█  ████  █████  ██████      ███  ████  █
                                        

kyGX is a sophisticated security arsenal manager designed specifically for Arch Linux systems. It provides seamless integration with BlackArch repositories and AUR, offering access to over 2800 penetration testing tools from BlackArch plus 75,000+ packages from AUR through an intelligent, automated installation framework with smart fallback capabilities.

git clone https://github.com/0xb0rn3/kyGX.git
cd kyGX
chmod +x kyGX
sudo ./kyGX

• Arch Linux or derivative (Archcraft, Manjaro, EndeavourOS, Garuda)
• Root/sudo privileges
• Active internet connection
• Dependencies: curl, wget, python, jq, git, base-devel
• yay (automatically installed if missing)

┌─────────────────────────────────────────┐
│ Intelligent Installation Flow           │
├─────────────────────────────────────────┤
│ 1. Attempt BlackArch repository         │
│ 2. On failure → Auto-retry via AUR      │
│ 3. Track and report fallback usage      │
│ 4. Detailed logging for debugging       │
└─────────────────────────────────────────┘

New in v0.1:

• Automatic yay installation: AUR helper installed automatically when needed
• Smart fallback mechanism: Failed BlackArch installs automatically retry via AUR
• AUR-only mode: Direct installation from AUR bypassing BlackArch
• AUR search: Interactive search and installation from 75,000+ packages
• Default configs: Auto-installs blackarch-menus, blackarch-config-gtk, blackarch-config-zsh
• Dual updates: Updates both pacman and AUR packages simultaneously

┌─────────────────────────────────────────┐
│ Smart GPG Management                    │
├─────────────────────────────────────────┤
│ • Multi-keyserver fallback              │
│ • Automatic signature verification      │
│ • Key refresh and expiry handling       │
│ • Corruption recovery                   │
└─────────────────────────────────────────┘

• Progressive Error Recovery: Three-tier automatic retry system
• Lock File Management: Automatic pacman database lock resolution
• State Tracking: JSON-based installation history with rollback capability
• Conflict Resolution: Intelligent handling of package conflicts
• AUR Fallback: Automatic retry via AUR when BlackArch installations fail

• Direct installation without batching overhead
• Category-based organization from BlackArch
• Real-time tool list fetching from blackarch.org
• Intelligent package caching system
• Parallel operation support where applicable
• Non-root yay execution for security

sudo ./kyGX

Launch the interactive menu to browse and install tools by category, search AUR, or use AUR-only installation.

sudo ./kyGX --slim

Install a curated collection of essential tools similar to Kali Linux defaults:

• nmap, masscan, nikto, recon-ng, theharvester
• sqlmap, wpscan, metasploit, burpsuite
• john, hydra, hashcat, medusa
• aircrack-ng, reaver, wifite
• wireshark, ettercap, tcpdump

Tools automatically fallback to AUR if not available in BlackArch.

sudo ./kyGX --setup

Configure BlackArch repository, install yay, and setup default configuration packages:

• blackarch-menus
• blackarch-config-gtk
• blackarch-config-zsh

sudo ./kyGX --aur

Install security tools directly from AUR, bypassing BlackArch repository.

sudo ./kyGX --update

Update both official repositories and AUR packages:

• Arch Linux packages (pacman)
• BlackArch packages
• AUR packages (yay)

sudo ./kyGX --cleanup

Remove BlackArch configuration and restore default pacman.conf.

OPTIONS:
  -h, --help          Display help information
  -v, --verbose       Enable detailed output
  -n, --dry-run       Preview installations without changes
  -f, --force         Force installation bypassing checks
  --setup             Setup BlackArch + yay + default configs
  --update            Update system (pacman + AUR)
  --slim              Install curated slim toolkit
  --aur               AUR-only installation mode
  --cleanup           Remove BlackArch and restore config

EXAMPLES:
  sudo ./kyGX                # Interactive mode
  sudo ./kyGX --setup        # Complete setup with defaults
  sudo ./kyGX --slim         # Install essential tools
  sudo ./kyGX --aur          # AUR-only installation
  sudo ./kyGX -n             # Preview mode
  sudo ./kyGX --cleanup      # Complete removal

When a tool fails to install from BlackArch, kyGX automatically attempts installation from AUR:

[*] Installing nmap
[✓] nmap installed
[*] Installing custom-tool
[!] custom-tool failed via BlackArch, trying AUR fallback...
[✓] custom-tool installed via AUR

[+] Results: Installed: 2 | AUR Fallback: 1 | Failed: 0

From the main menu:

AUR Options:
  y) Install tools from AUR only
  z) Search AUR for security tools

Option Y - AUR-Only Installation:

[*] Enter tool names to install from AUR (space-separated):
> metasploit-framework burpsuite ghidra

[*] Installing 3 tools from AUR
[✓] metasploit-framework installed
[✓] burpsuite installed  
[✓] ghidra installed

Option Z - AUR Search:

[*] Enter search term (e.g., 'exploit', 'scanner', 'recon'):
> wireless

[Search results displayed...]

[?] Install any of these? (y/n):

kyGX automatically detects and installs yay (Yet Another Yogurt) if not present:

[*] Installing yay (AUR helper)
[+] yay installed successfully

yay is executed as a non-root user for security best practices.

kyGX v0.1
├── Core Components
│   ├── GPG key management
│   ├── Repository configuration
│   ├── YAY helper management
│   └── Tool list caching
├── Installation Engine
│   ├── Direct pacman integration
│   ├── AUR fallback system
│   ├── Error recovery system
│   └── State management
└── User Interface
    ├── Interactive menu
    ├── AUR search & install
    ├── Command-line options
    └── Progress tracking

User Request
    ↓
Try BlackArch Repository
    ↓
Success? → [✓] Install Complete
    ↓ No
Try AUR Fallback (yay)
    ↓
Success? → [✓] Install Complete (AUR)
    ↓ No
[✗] Report Failure

Tool Discovery

kyGX fetches the tool list directly from blackarch.org/tools.html and caches it locally. AUR tools are discovered through yay search functionality.

Installation Strategy

• Tools are installed individually via pacman
• Failed installations automatically retry via yay (AUR)
• Real-time progress tracking with fallback indicators
• Failed installations are logged but don't halt the process
• Only security tools are installed (excludes desktop environments)

Cleanup Process

Cleanup restores the original Arch Linux configuration, removes BlackArch mirrors, and cleans both tool caches. Configuration backups are timestamped for recovery.

# Refresh keyring
sudo pacman-key --refresh-keys
sudo pacman -Sy archlinux-keyring blackarch-keyring

# Remove lock file
sudo rm /var/lib/pacman/db.lck
sudo pacman -Sy

# Manual yay installation
sudo pacman -S --needed git base-devel
cd /tmp
git clone https://aur.archlinux.org/yay.git
cd yay
makepkg -si

# Check yay is installed
which yay

# Check logs
tail -f ~/.kyGX/kyGX.log

# Look for AUR entries
grep "AUR" ~/.kyGX/kyGX.log

# Update mirrors
sudo ./kyGX --update
# Or manually
sudo pacman -Sy

# Enable verbose logging
sudo ./kyGX -v

# Check logs for AUR activity
cat ~/.kyGX/kyGX.log | grep -E "(AUR|BLACKARCH)"

# Preview without installation
sudo ./kyGX -n

Backups are stored in ~/.config/kyGX/backups/ with timestamps. To manually restore:

# List backups
ls -lh ~/.config/kyGX/backups/

# Restore pacman.conf
sudo cp ~/.config/kyGX/backups/pacman.conf.* /etc/pacman.conf

This tool provides access to penetration testing and security research software. Users must:

• Obtain written authorization before conducting security assessments
• Define clear scope and rules of engagement
• Use isolated environments (VMs, dedicated hardware)
• Document methodology and findings
• Comply with applicable laws and regulations
• Follow industry standards (PTES, OWASP, NIST)
• Maintain professional ethics
• Verify AUR packages before installation

Legal Notice: Unauthorized access to computer systems is illegal. The author assumes no liability for misuse of this tool.

AUR Security: While kyGX automates AUR installation, users should be aware that AUR packages are user-submitted and should be reviewed before installation in production environments.

To publish kyGX to AUR:

1. Create AUR account at https://aur.archlinux.org
2. Generate SSH keys and add to AUR account
3. Clone the AUR package:

git clone ssh://aur@aur.archlinux.org/kyGX.git

4. Create PKGBUILD file (see AUR Publishing section below)
5. Update .SRCINFO:

makepkg --printsrcinfo > .SRCINFO

6. Commit and push:

git add PKGBUILD .SRCINFO
git commit -m "Initial commit: kyGX v0.1"
git push

# Maintainer: 0xb0rn3 <q4n0@proton.me>
pkgname=kyGX
pkgver=0.1
pkgrel=1
pkgdesc="Arch Linux Security Arsenal Manager with AUR support"
arch=('any')
url="https://github.com/0xb0rn3/kyGX"
license=('WTFPL')
depends=('bash' 'curl' 'wget' 'python' 'jq' 'git' 'base-devel' 'pacman')
optdepends=('yay: AUR helper for automatic fallback'
            'blackarch-keyring: BlackArch repository support')
source=("$pkgname-$pkgver.tar.gz::$url/archive/v$pkgver.tar.gz")
sha256sums=('SKIP')

package() {
    cd "$srcdir/$pkgname-$pkgver"
    install -Dm755 kyGX "$pkgdir/usr/bin/kyGX"
    install -Dm644 README.md "$pkgdir/usr/share/doc/$pkgname/README.md"
}

Contributions are welcome. Please:

1. Fork the repository
2. Create a feature branch
3. Submit a pull request with detailed description
4. Follow the existing code style

• AUR integration and fallback
• Automatic yay installation
• AUR search functionality
• Default configuration packages
• GUI interface
• Docker containerization
• AUR package release (v0.1 ready)
• Automatic update checker
• Multi-language support
• Integration with security frameworks

• Instagram: @theehiv3
• Twitter: @0xbv1

• ✅ AUR integration with automatic fallback
• ✅ Automatic yay helper installation
• ✅ AUR-only installation mode
• ✅ Interactive AUR search functionality
• ✅ Default BlackArch config auto-installation
• ✅ Dual-source updates (pacman + AUR)
• ✅ Non-root yay execution for security
• ✅ Detailed installation tracking with source reporting

DO WHAT THE FUCK YOU WANT TO PUBLIC LICENSE
Version 2, December 2004

Copyright (C) 2024 0xb0rn3 <q4n0@proton.me>

Everyone is permitted to copy and distribute verbatim or modified
copies of this license document, and changing it is allowed as long
as the name is changed.

DO WHAT THE FUCK YOU WANT TO PUBLIC LICENSE
TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION

0. You just DO WHAT THE FUCK YOU WANT TO.