BUNTSTARTER/README.md
2025-10-23 18:36:08 +10:00

411 lines
15 KiB
Markdown
Raw Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 🚀 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!** 🚀✨