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

15 KiB
Raw Blame History

🚀 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!)

    sudo apt update
    
  2. Download the Ultimate Buntstaller

    git clone https://github.com/yourusername/ultrabunt.git
    cd ultrabunt
    
  3. Make It Executable (The Magic Incantation!)

    sudo chmod +x ultrabunt.sh
    
  4. Launch the Beast!

    ./ultrabunt.sh
    

🎪 Alternative Installation Methods

One-Liner for the Brave:

curl -sSL https://raw.githubusercontent.com/yourusername/ultrabunt/main/ultrabunt.sh | sudo chmod +x /dev/stdin && ./ultrabunt.sh

Download and Run:

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)
  • 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:

# Make sure it's executable
sudo chmod +x ultrabunt.sh

# Check if bash is available
which bash

Permission Denied:

# Run with proper permissions
sudo ./ultrabunt.sh

Package Installation Fails:

# Update package lists first
sudo apt update

# Fix broken dependencies
sudo apt --fix-broken install

Snap/Flatpak Issues:

# 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:

tail -f /tmp/ultrabunt_*.log

Debug Mode:

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! 🚀