diff --git a/README.md b/README.md new file mode 100644 index 0000000..1d8f415 --- /dev/null +++ b/README.md @@ -0,0 +1,411 @@ +# 🚀 THE ULTIMATE BUNTSTALLER 🚀 +## *The Buntiest Sublime Buntage Management Experience Ever Bunted for discerning Bunters* + +``` +██╗ ██╗██╗ ████████╗██████╗ █████╗ ██████╗ ██╗ ██╗███╗ ██╗████████╗ +██║ ██║██║ ╚══██╔══╝██╔══██╗██╔══██╗██╔══██╗██║ ██║████╗ ██║╚══██╔══╝ +██║ ██║██║ ██║ ██████╔╝███████║██████╔╝██║ ██║██╔██╗ ██║ ██║ +██║ ██║██║ ██║ ██╔══██╗██╔══██║██╔══██╗██║ ██║██║╚██╗██║ ██║ +╚██████╔╝███████╗██║ ██║ ██║██║ ██║██████╔╝╚██████╔╝██║ ╚████║ ██║ + ╚═════╝ ╚══════╝╚═╝ ╚═╝ ╚═╝╚═╝ ╚═╝╚═════╝ ╚═════╝ ╚═╝ ╚═══╝ ╚═╝ + + ██████╗ ██╗ ██╗███╗ ██╗████████╗███████╗████████╗ █████╗ ██╗ ██╗ ███████╗██████╗ + ██╔══██╗██║ ██║████╗ ██║╚══██╔══╝██╔════╝╚══██╔══╝██╔══██╗██║ ██║ ██╔════╝██╔══██╗ + ██████╔╝██║ ██║██╔██╗ ██║ ██║ ███████╗ ██║ ███████║██║ ██║ █████╗ ██████╔╝ + ██╔══██╗██║ ██║██║╚██╗██║ ██║ ╚════██║ ██║ ██╔══██║██║ ██║ ██╔══╝ ██╔══██╗ + ██████╔╝╚██████╔╝██║ ╚████║ ██║ ███████║ ██║ ██║ ██║███████╗███████╗███████╗██║ ██║ + ╚═════╝ ╚═════╝ ╚═╝ ╚═══╝ ╚═╝ ╚══════╝ ╚═╝ ╚═╝ ╚═╝╚══════╝╚══════╝╚══════╝╚═╝ ╚═╝ +``` + +### đŸŽ¯ **THE MOST EPIC BUNTAGE INSTALLER IN THE KNOWN UNIVERSE** đŸŽ¯ + +*Because regular package managers are for peasants, and we deal in BUNTAGES!* + +--- + +## 🌟 **WHAT IS THIS MAGNIFICENT CREATION?** + +The **Ultimate Buntstaller** is not just a script - it's a **LIFESTYLE CHOICE**! This ridiculously over-engineered, stupidly sublime, absolutely bonkers bash script transforms your boring Ubuntu/Mint installation into a **BUNTAGE PARADISE**! + +### đŸ”Ĩ **FEATURES THAT WILL BLOW YOUR MIND** đŸ”Ĩ + +- 🎨 **Beautiful TUI Interface** - Because command lines are for cavemen +- 🚀 **17 Carefully Curated Categories** - From Core Utilities to Gaming Goodness +- đŸŽ¯ **100+ Hand-Picked Buntages** - Only the finest software makes the cut +- 🔧 **Multi-Manager Support** - APT, Snap, Flatpak, and Custom installations +- 📊 **Real-time Status Tracking** - See what's installed with fancy icons +- đŸŽĒ **Bulk Operations** - Install entire categories like a boss +- 📋 **Export Functionality** - Share your buntage lists with friends +- 🛡ī¸ **Dependency Management** - Smart installation order +- 📝 **Comprehensive Logging** - Because debugging is fun +- 🎭 **Ridiculous Emojis** - Making terminal interfaces fun again + +--- + +## đŸŽĒ **THE MAGNIFICENT 17 BUNTAGE CATEGORIES** đŸŽĒ + +### 🔧 **Core Utilities** - *The Foundation of Greatness* +Essential command-line tools that every developer needs: +- **Git** - Version control for the masses +- **Curl & Wget** - Download anything, anywhere +- **Vim & Neovim** - Text editing supremacy +- **Tmux** - Terminal multiplexing magic +- **Fzf** - Fuzzy finding perfection +- **Ripgrep** - Grep on steroids +- **Bat** - Cat with syntax highlighting +- **Eza** - Modern ls replacement +- **Tldr** - Man pages for humans + +### đŸ’ģ **Development Tools** - *Code Like a Wizard* +Programming languages and development essentials: +- **Python 3 + Pip + Venv** - Snake charming toolkit +- **Node.js + NPM** - JavaScript everywhere +- **Java Development Kit** - Enterprise-grade coffee +- **Go Language** - Gopher-powered performance +- **Build Essential** - Compilation nation +- **Make & CMake** - Build system mastery + +### 🤖 **AI & LLM Tools** - *Welcome to the Future* +Artificial intelligence and machine learning tools: +- **Ollama** - Local LLM management +- **Python AI Libraries** - TensorFlow, PyTorch ready +- **Jupyter Notebooks** - Data science playground + +### đŸŗ **Containers & Orchestration** - *Containerize Everything* +Modern deployment and orchestration: +- **Docker** - Container revolution +- **Docker Compose** - Multi-container magic +- **Kubernetes Tools** - Orchestration mastery +- **Podman** - Daemonless containers + +### 🌐 **Web Stack** - *Build the Internet* +Web development essentials: +- **Apache2** - Classic web server +- **Nginx** - High-performance serving +- **PHP** - Still powering the web +- **MySQL/PostgreSQL** - Database powerhouses + +### 🐚 **Shells & Customization** - *Terminal Bling* +Make your shell beautiful and powerful: +- **Zsh** - Shell perfection +- **Oh My Zsh** - Framework fantastic +- **Fish Shell** - Friendly interactive shell +- **Starship Prompt** - Cross-shell prompt perfection + +### ✏ī¸ **Editors & IDEs** - *Code in Style* +Professional development environments: +- **Visual Studio Code** - Microsoft's gift to developers +- **Sublime Text** - Sublime editing experience +- **Atom** - Hackable text editor +- **IntelliJ IDEA** - Java development paradise + +### 🌍 **Web Browsers** - *Surf the Digital Waves* +Browse the web with style: +- **Brave Browser** - Privacy-focused browsing +- **Firefox** - Mozilla's masterpiece +- **Chromium** - Open-source Chrome +- **Google Chrome** - The web standard + +### 📊 **System Monitoring** - *Know Your System* +Keep tabs on your machine: +- **Htop** - Interactive process viewer +- **Btop** - Beautiful resource monitor +- **Glances** - Cross-platform monitoring +- **Nethogs** - Network bandwidth per process +- **Iotop** - I/O monitoring mastery + +### 🛡ī¸ **Security Tools** - *Fortress Your System* +Protect your digital kingdom: +- **UFW** - Uncomplicated Firewall +- **Fail2ban** - Intrusion prevention +- **ClamAV** - Antivirus protection +- **OpenSSH** - Secure remote access + +### ⚙ī¸ **System Tools** - *Power User Paradise* +Advanced system utilities: +- **Synaptic** - Package management GUI +- **GParted** - Partition management +- **Timeshift** - System snapshots +- **Bleachbit** - System cleaner + +### 📄 **Office & Productivity** - *Get Things Done* +Professional productivity suite: +- **LibreOffice** - Complete office suite +- **Thunderbird** - Email client excellence +- **Calibre** - E-book management +- **Obsidian** - Knowledge management + +### đŸ’Ŧ **Communication** - *Stay Connected* +Chat, call, and collaborate: +- **Discord** - Gaming communication +- **Telegram** - Secure messaging +- **Zoom** - Video conferencing +- **Slack** - Team collaboration + +### 🎨 **Multimedia & Graphics** - *Create Beautiful Things* +Creative tools for artists and creators: +- **GIMP** - GNU Image Manipulation +- **Audacity** - Audio editing freedom +- **Blender** - 3D creation suite +- **Inkscape** - Vector graphics mastery +- **VLC** - Media player supreme + +### ☁ī¸ **Cloud & Sync** - *Data Everywhere* +Cloud storage and synchronization: +- **Dropbox** - File synchronization +- **Google Drive** - Cloud storage +- **Nextcloud** - Self-hosted cloud +- **Syncthing** - Decentralized sync + +### đŸ’ģ **Terminals** - *Terminal Emulator Paradise* +Beautiful terminal experiences: +- **Warp Terminal** - Modern terminal experience +- **Alacritty** - GPU-accelerated terminal +- **Terminator** - Multiple terminals in one +- **Tilix** - Tiling terminal emulator + +### 🎮 **Gaming** - *Level Up Your Fun* +Gaming platforms and tools: +- **Steam** - Gaming platform supreme +- **Lutris** - Gaming on Linux made easy +- **Heroic Launcher** - Epic Games & GOG +- **GameMode** - Optimize gaming performance + +--- + +## 🚀 **INSTALLATION INSTRUCTIONS** 🚀 +### *Because Even Sublime Scripts Need Setup* + +### 📋 **Prerequisites** +- **Ubuntu 20.04+** or **Linux Mint 20+** (Fresh install or existing) +- **Internet Connection** (Obviously!) +- **Sudo Access** (You're the boss!) +- **Terminal Access** (Command line courage!) + +### đŸŽ¯ **Quick Start Guide** + +1. **Update Your System First** (This is CRUCIAL!) + ```bash + sudo apt update + ``` + +2. **Download the Ultimate Buntstaller** + ```bash + git clone https://github.com/yourusername/ultrabunt.git + cd ultrabunt + ``` + +3. **Make It Executable** (The Magic Incantation!) + ```bash + sudo chmod +x ultrabunt.sh + ``` + +4. **Launch the Beast!** + ```bash + ./ultrabunt.sh + ``` + +### đŸŽĒ **Alternative Installation Methods** + +**One-Liner for the Brave:** +```bash +curl -sSL https://raw.githubusercontent.com/yourusername/ultrabunt/main/ultrabunt.sh | sudo chmod +x /dev/stdin && ./ultrabunt.sh +``` + +**Download and Run:** +```bash +wget https://raw.githubusercontent.com/yourusername/ultrabunt/main/ultrabunt.sh +sudo chmod +x ultrabunt.sh +./ultrabunt.sh +``` + +--- + +## 🎮 **USAGE GUIDE** 🎮 +### *Navigate Like a Pro* + +### đŸŽ¯ **Main Menu Navigation** +- Use **Arrow Keys** or **Tab** to navigate +- Press **Enter** to select +- Press **Esc** or select "Back" to go back +- Press **Ctrl+C** to exit (if you must!) + +### đŸŽĒ **Menu Structure** +``` +🏠 Main Menu +├── đŸ“Ļ Browse Buntages by Category +│ ├── 🔧 Core Utilities +│ ├── đŸ’ģ Development Tools +│ ├── 🤖 AI & LLM Tools +│ └── ... (14 more categories) +├── 🔍 Search Buntages +├── 🚀 Bulk Operations +│ ├── Install All in Category +│ ├── Remove All in Category +│ ├── Update All Installed +│ └── Clean Cache & Orphans +├── ℹī¸ System Information +└── đŸšĒ Exit +``` + +### 🎨 **Status Icons Guide** +- **✓** = Installed and ready to rock! +- **✗** = Not installed (yet!) +- **(_*_)** = Available for installation +- **(.Y.)** = Installed and awesome + +--- + +## đŸ–Ĩī¸ **SYSTEM COMPATIBILITY** đŸ–Ĩī¸ + +### ✅ **Fully Supported Systems** +- **Ubuntu 20.04 LTS** (Focal Fossa) +- **Ubuntu 22.04 LTS** (Jammy Jellyfish) +- **Ubuntu 23.04** (Lunar Lobster) +- **Linux Mint 20.x** (All variants) +- **Linux Mint 21.x** (All variants) + +### đŸŽ¯ **Recommended Scenarios** +- **Fresh Installation** - Perfect for setting up a new system +- **Existing Installation** - Great for adding new tools +- **Development Workstation** - Ideal for programmers +- **Content Creation** - Perfect for creators and artists +- **Gaming Setup** - Excellent for Linux gamers + +### ⚡ **System Requirements** +- **RAM:** 2GB minimum (4GB+ recommended) +- **Storage:** 10GB free space (for all buntages) +- **Network:** Broadband internet connection +- **Processor:** Any 64-bit x86 processor + +--- + +## 🎭 **ADVANCED FEATURES** 🎭 + +### 🔧 **Bulk Operations** +- **Install Entire Categories** - One click, dozens of apps! +- **Remove Categories** - Clean house efficiently +- **Update Everything** - Keep all buntages current +- **Export Lists** - Share your setup with friends + +### 📊 **Smart Features** +- **Dependency Resolution** - Installs prerequisites automatically +- **Installation Verification** - Confirms successful installations +- **Rollback Support** - Undo problematic installations +- **Comprehensive Logging** - Track everything that happens + +### 🎨 **Customization Options** +- **Category Filtering** - Show only what you need +- **Installation Methods** - Choose APT, Snap, or Flatpak +- **Batch Processing** - Queue multiple installations +- **Export Formats** - Multiple list export options + +--- + +## 🐛 **TROUBLESHOOTING** 🐛 + +### 🚨 **Common Issues & Solutions** + +**Script Won't Run:** +```bash +# Make sure it's executable +sudo chmod +x ultrabunt.sh + +# Check if bash is available +which bash +``` + +**Permission Denied:** +```bash +# Run with proper permissions +sudo ./ultrabunt.sh +``` + +**Package Installation Fails:** +```bash +# Update package lists first +sudo apt update + +# Fix broken dependencies +sudo apt --fix-broken install +``` + +**Snap/Flatpak Issues:** +```bash +# Install snap support +sudo apt install snapd + +# Install flatpak support +sudo apt install flatpak +``` + +--- + +## 📝 **LOGS & DEBUGGING** 📝 + +All operations are logged to: `/tmp/ultrabunt_YYYYMMDD_HHMMSS.log` + +**View Current Log:** +```bash +tail -f /tmp/ultrabunt_*.log +``` + +**Debug Mode:** +```bash +DEBUG=1 ./ultrabunt.sh +``` + +--- + +## 🎉 **CONTRIBUTING** 🎉 + +Want to make this even more ridiculously sublime? + +1. **Fork the Repository** +2. **Add Your Favorite Buntages** +3. **Test Everything Thoroughly** +4. **Submit a Pull Request** +5. **Become a Buntage Legend!** + +--- + +## 📜 **LICENSE** 📜 + +This project is licensed under the **MIT License** - because sharing is caring! + +--- + +## 🏆 **CREDITS & ACKNOWLEDGMENTS** 🏆 + +### 🎭 **The Sublime Team** +- **Created with ❤ī¸** by developers who believe software installation should be fun +- **Inspired by** the need for a better Ubuntu setup experience +- **Powered by** ridiculous amounts of caffeine and determination + +### 🌟 **Special Thanks** +- **Ubuntu Community** - For creating an amazing OS +- **Open Source Developers** - For all the incredible software +- **Beta Testers** - For finding all our bugs +- **Coffee** - For making this possible + +--- + +## 🚀 **FINAL WORDS** 🚀 + +*The Ultimate Buntstaller isn't just a script - it's a statement. A statement that says "I refuse to manually install packages like a caveman!" It's a declaration of independence from boring, repetitive setup tasks. It's a celebration of the ridiculous, the sublime, and the absolutely bonkers world of Linux package management.* + +**So go forth, brave user, and BUNTAGE ALL THE THINGS!** 🎉 + +--- + +### đŸŽĒ **Made with Ridiculous Amounts of Love and Caffeine** ☕ + +``` + ╔══════════════════════════════════════════════════════════════╗ + ║ "In a world of packages, dare to be a BUNTAGE!" ║ + ║ ║ + ║ - The Ultimate Buntstaller Philosophy ║ + ╚══════════════════════════════════════════════════════════════╝ +``` + +**Now stop reading and start BUNTSTALLING!** 🚀✨ \ No newline at end of file