mirror of
https://github.com/stornic56/debianito-post-install.git
synced 2026-07-16 05:49:49 +00:00
stornic56
2ebb33460c
- Removed dead Broadcom hardware IDs (4357/4358/4360/4727) from `_is_broadcom_b43`, retaining only valid ID 4352 to eliminate false positives in the case statement. - Added a guard in `_handle_wireless` Level 3 to verify `linux-headers` availability via `apt-cache policy`. Skips DKMS compilation if headers are missing, preventing transaction failures during installation. - Implemented Broadcom combo card detection (WiFi + Bluetooth) by scanning `PCI_BT_DEVS`. Automatically writes `/etc/modprobe.d/broadcom-combo.conf` with `softdep wl post: btusb` and warns users about potential reboot requirements. - Enhanced Level 2 (`firmware-b43-installer`) with post-installation validation for `/lib/firmware/b43`. Provides clear recovery instructions via `sudo dpkg-reconfigure firmware-b43-installer` if the directory is empty or missing after installation. - Created a new helper `_msg_red()` in `utils.sh` to handle critical error messages with colored Whiptail output, replacing standard alerts for migration warnings and failures. - Updated `repos/migrate.sh` to use `_msg_red()` for branch migration warnings and failure states, ensuring visibility of critical issues while keeping completion messages informative. - Verified headless mode guards across 16 separate extras files (`office.sh`, `fetch.sh`, `cursors.sh`, etc.), preventing unnecessary package installations on servers without display environments. - Completed syntax verification (`bash -n`) across all core and extra modules, ensuring no errors in the updated logic for firmware, gaming, swap, or repository management scripts. - update readme.md
12 KiB
12 KiB
Debianito - Post-Installation Automation for Debian
Debianito is a user-friendly post-installation automation script for Debian 11 (Bullseye), Debian 12 (Bookworm) and Debian 13 (Trixie). It streamlines system configuration, driver installation (including NVIDIA drivers with legacy support via rescue environment), repository setup with backports support, gaming tools integration, and more with an interactive menu-driven interface.
System Requirements
| Requirement | Specification |
|---|---|
| OS | Debian 11 (Bullseye), Debian 12 (Bookworm), Debian 13 (Trixie) |
| Privileges | Normal user with sudo access, script validates root/sudo in utils.sh |
| Terminal | Any modern terminal emulator supporting ANSI colors and UTF-8 box-drawing characters |
| Dependencies | Standard Debian packages (whiptail, lsb-release); auto-installed if missing |
Installation Instructions
Clone the repository, make the script executable, and run it:
git clone https://github.com/stornic56/debianito-post-install
cd debianito-post-install
chmod +x debianito.sh && ./debianito.sh
⚠️ Do not run as root. The script checks for non-root execution and requires sudo privileges.
Usage
After running the script:
- Select Option: Use arrow keys or type 1-10.
- Navigation: Use Arrow Keys (Up↑/Down↓) to move between list options and ENTER key to confirm selection.
- Confirm Actions: Installation prompts use whiptail for TUI confirmations.
- Review System Info: Header displays detected Debian version and hardware summary before each action.
- Repeat as Needed: Return to main menu at any time or exit when done.
| Option | Description | What it does |
|---|---|---|
| 1 | System Info | Show detected OS, CPU, RAM, GPU and hardware details |
| 2 | User Privileges & Feedback | Configure sudo group membership, enable passwordless sudo for frequent tasks, repair home directory ownership issues, and toggle visual password feedback (asterisks) in terminal |
| 3 | Configure Repositories | Setup official repos with non-free/contrib options, optional Backports support and Deb822/classic format injection. |
| 4 | Firmware, Wireless & Bluetooth | Install essential firmware for GPUs and wireless |
| 5 | Graphics Drivers & Mesa Stack | Configure AMD/Intel/NVIDIA drivers and Mesa graphics stack + monitoring tools |
| 6 | Backports Kernel | Install latest kernel from Debian backports |
| 7 | Gaming Setup | Steam, Heroic Games Launcher, RetroArch GameMode, MangoHud, OpenRGB, Java JRE (Temurin 8/17/21) |
| 8 | ZRAM | Configure compressed RAM for memory optimization |
| 9 | Swap Management | Manage swap file or partition size and enable/disable swap space for system stability |
| 10 | Install Programs and Software | Browse and install packages by category (Development, Themes, System Tools, etc.) using APT |
| 11 | Boot Rescue & Repair | Fix GRUB bootloader issues, chroot repair, or restore system boot configuration |
| 12 | Exit | Return to terminal |
Install Programs and Software (Option 10)
The submenu offers the next categories:
| Option | Category Title | Description |
|---|---|---|
| 0 | Essential Pack | Quick install of common tools (compression, system info, VLC, MS fonts) |
| 1 | Customization System | Desktop themes, icon themes, cursor themes, and fonts |
| 2 | Download & Network | Downloaders (aria2, ytdlp, FileZilla) + Torrent clients (qBittorrent, Deluge, Transmission) |
| 3 | Internet (Browsers, Email Clients, VPN) | Web browsers (Firefox/Mozilla, LibreWolf, Floorp, Chromium, Brave, Tor), email client (Thunderbird), and VPN tools (RiseUp, Proton, Mullvad) |
| 4 | Media Players | Multimedia playback with VLC media player and MPV for advanced video/audio support |
| 5 | Multimedia & Design | image editing (GIMP), video editing (Kdenlive, HandBrake), 3D modeling (Blender), audio recording (Audacity), and graphics design (Inkscape) |
| 6 | Code Editors & IDEs | vim, vim-gtk3, Neovim, Helix, nano, Emacs, Kate, Mousepad, Gedit, Geany, GNOME Text Editor, and VSCodium (VS Code open-source) |
| 7 | Servers & Dev Tools | Web servers (Nginx/Apache), databases (PostgreSQL/MariaDB), Java Development Kit (Temurin 17/21/25 JDK), Docker, Python, SSH tools, Jellyfin Server and essential utilities |
| 8 | Security & Networking | Wireshark, tcpdump, Zenmap, ClamAV, UFW, fail2ban |
| 9 | Software Centers | Choose a software store to install. |
| 10 | System Tools | htop/btop, ncdu, Timeshift, tmux/screen, nvme-cli, Flatpak support, extension repository manager and qemu/virtmanager |
| 11 | Fetch / System Info | fastfetch/neofetch, hyfetch, Linux logo and screenfetch |
| 12 | Back to Main Menu | Return directly to the main Debianito menu (exit submenu) |
File Structure
| Directory/File | Description |
|---|---|
debianito.sh |
Main entry point; handles menu navigation and system detection. |
docs/ |
Documentation directory containing Markdown files for each module. |
modules/ |
Core modular scripts organized by category: repos, gpu, gaming, kernel, firmware, zram, etc. |
modules/bullseye/ |
Legacy Debian 11 (Bullseye) specific modules: extras.sh, legacy.sh, repos.sh. |
modules/extras/ |
Software installer sub-modules split by category (themes, downloaders, internet, dev tools, etc.). |
modules/gaming/ |
Gaming launcher and optimization scripts: Steam, Heroic, Lutris, performance tools. |
modules/gpu/ |
GPU driver installation scripts for AMD and NVIDIA with architecture detection. |
modules/repos/ |
Repository management scripts: migration tool (migrate.sh) and format detection (repo_detect.sh). |
modules/extras/design/ |
Multimedia & design tools installer (Blender, GIMP, Kdenlive, OBS). |
modules/extras/dev/ |
Development tools installer with special handling for Jellyfin and Java. |
modules/extras/download/ |
Download tools installer (aria2, FileZilla) and torrent clients (qBittorrent, Transmission). |
modules/extras/essential/ |
Essential package installer for basic system utilities on older Debian versions. |
modules/extras/fetch/ |
System information fetcher tools (neofetch, screenfetch, linuxlogo). |
modules/extras/internet/ |
Internet tools installer: browsers, email clients, download managers. |
modules/extras/java.sh |
Java runtime installer for Minecraft and development (Temurin 8/17/21). |
modules/extras/office/ |
Office productivity suite installer (LibreOffice, GIMP alternatives). |
modules/extras/players/ |
Media player installer (MPV, VLC) with codec support. |
modules/extras/programming/ |
Code editors and IDEs installer (Vim, Neovim, Emacs, Kate). |
modules/extras/security/ |
Security tools installer: ClamAV, Fail2Ban, UFW, Wireshark. |
modules/extras/system/ |
System utilities installer with software center options (GNOME Software, Discover). |
modules/extras/themes/ |
Desktop customization installer: themes, icons, cursors, fonts. |
modules/gaming/_helpers.sh |
Shared helper functions for gaming modules (32-bit support, Mesa drivers). |
modules/gpu/amd_intel.sh |
AMD and Intel GPU firmware + monitoring tools (radeontop, nvtop, vainfo). |
modules/gpu/_helpers.sh |
Shared helper functions for GPU detection (NVIDIA architecture checks). |
modules/nvidia.sh |
NVIDIA driver installer with multi-architecture support (Kepler, Fermi, Maxwell, Pascal, Blackwell). |
modules/amd_intel.sh |
AMD and Intel GPU firmware + monitoring tools installation. |
modules/kernel.sh |
Kernel management: backports kernel installation and detection. |
modules/repos/migrate.sh |
Branch migration tool for Debian stable → testing/SID with backup/rollback. |
modules/repos/repo_detect.sh |
Repository format detection (DEB822 vs classic) for idempotent configuration. |
modules/rescue.sh |
Boot rescue and repair tools: GRUB fix, chroot repair, system restore. |
modules/sudo_config.sh |
Sudo configuration: group membership, passwordless sudo, home directory ownership. |
modules/swap.sh |
Swap management: file/partition size configuration and enable/disable swap space. |
modules/sysinfo.sh |
System information detection and display (OS, CPU, RAM, GPU, storage). |
modules/utils.sh |
Utility functions shared across modules (color codes, confirmation dialogs, installation helpers). |
modules/zram.sh |
ZRAM configuration for compressed RAM optimization. |
README.md |
Project documentation and usage instructions. |
├── debianito.sh
├── docs
│ ├── firmware.md
│ ├── gaming.md
│ ├── gpu.md
│ ├── kernel.md
│ ├── repos_config.md
│ ├── retroarch.md
│ ├── system_info.md
│ ├── user_priv_feed.md
│ └── zram.md
├── modules
│ ├── bluetooth.sh
│ ├── bullseye
│ │ ├── extras.sh
│ │ ├── legacy.sh
│ │ └── repos.sh
│ ├── extras
│ │ ├── design
│ │ │ └── design.sh
│ │ ├── dev
│ │ │ ├── dev.sh
│ │ │ └── jellyfin.sh
│ │ ├── download
│ │ │ └── download.sh
│ │ ├── essential
│ │ │ └── essential.sh
│ │ ├── fetch
│ │ │ └── fetch.sh
│ │ ├── _helpers.sh
│ │ ├── internet
│ │ │ └── internet.sh
│ │ ├── java.sh
│ │ ├── office
│ │ │ └── office.sh
│ │ ├── players
│ │ │ └── players.sh
│ │ ├── programming
│ │ │ └── programming.sh
│ │ ├── security
│ │ │ └── security.sh
│ │ ├── system
│ │ │ ├── software_centers.sh
│ │ │ └── system.sh
│ │ └── themes
│ │ ├── cursors
│ │ │ └── cursors.sh
│ │ ├── desktop-themes
│ │ │ └── desktop-themes.sh
│ │ ├── fonts
│ │ │ └── fonts.sh
│ │ ├── icons
│ │ │ └── icons.sh
│ │ └── themes.sh
│ ├── extras.sh
│ ├── firmware.sh
│ ├── gaming
│ │ ├── _helpers.sh
│ │ ├── heroic.sh
│ │ ├── steam.sh
│ │ └── tools.sh
│ ├── gaming.sh
│ ├── gpu
│ │ ├── amd_intel.sh
│ │ ├── _helpers.sh
│ │ └── nvidia.sh
│ ├── gpu.sh
│ ├── kernel.sh
│ ├── repos
│ │ ├── migrate.sh
│ │ └── repo_detect.sh
│ ├── repos.sh
│ ├── rescue.sh
│ ├── sudo_config.sh
│ ├── swap.sh
│ ├── sysinfo.sh
│ ├── utils.sh
│ └── zram.sh
└── README.md
🤖 AI-Assisted Development Note
This project was developed with assistance from large language models for code generation, documentation and testing suggestions. The author takes full responsibility for the accuracy of all scripts included in this repository. All modifications have been reviewed manually before inclusion to ensure compatibility with Debian systems.