stornic56/debianito-post-install
1
0
Fork 0
mirror of https://github.com/stornic56/debianito-post-install.git synced 2026-07-16 05:49:49 +00:00
Code Issues Packages Projects Releases Wiki Activity

Add files via upload

Browse Source
This commit is contained in:
stornic56
2026-06-09 23:03:30 -05:00
committed by GitHub
parent 3d1738ddc0
commit af8fac4ac4
13 changed files with 1021 additions and 285 deletions
Download Patch File Download Diff File Expand all files Collapse all files
README.md
+76 -69
View File
@@ -2,7 +2,7 @@
<div align="center">
Debianito is a user-friendly post-installation automation script for Debian 12 (Bookworm) and Debian 13 (Trixie). It streamlines system configuration, driver installation, repository setup, gaming tools integration, and more with an interactive menu-driven interface.
Debianito is a user-friendly post-installation automation script for Debian 12 (Bookworm) and Debian 13 (Trixie). It streamlines system configuration, driver installation (including NVIDIA drivers), repository setup with backports support, gaming tools integration, and more with an interactive menu-driven interface.
[![License: GPL v3](https://img.shields.io/badge/License-GPLv3-red.svg?style=for-the-badge&logo=gnu&logoColor=white)](https://github.com/stornic56/debianito-post-install/blob/main/LICENSE)
@@ -15,15 +15,15 @@ Debianito is a user-friendly post-installation automation script for Debian 12 (
| Requirement | Specification |
|-------------|---------------|
| **OS** | Debian 12 (Bookworm), Debian 13 (Trixie) |
| **Privileges** | Script must be run with `sudo` privileges by a normal user |
| **Terminal** | Any modern terminal emulator that supports ANSI colors and UTF-8 box-drawing characters |
| **Dependencies** | Standard Debian packages; script will install missing dependencies (e.g., `whiptail`, `lsb-release`) where necessary. |
| **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
### Step 1: Clone or Download the Repository
Clone the repository, make the script executable, and run it:
```bash
git clone https://github.com/stornic56/debianito-post-install
@@ -31,17 +31,7 @@ cd debianito-post-install
chmod +x debianito.sh && ./debianito.sh
```
If you downloaded manually, ensure all `.sh` files are in their respective directories.
### Step 2: Run the Script with Sudo Privileges
> **Do not run this script as root.** Use a normal user account and authorize via `sudo`.
```bash
./debianito.sh
```
The script will perform initial checks, detect your system information (CPU, RAM, GPU), then present an interactive menu.
> ⚠️ **Do not run as root.** The script checks for non-root execution and requires sudo privileges.
---
@@ -49,39 +39,41 @@ The script will perform initial checks, detect your system information (CPU, RAM
After running the script:
1. **Select Option:** Use arrow keys or type `1-9`.
2. **Confirm Actions:** For installation steps, you'll see a confirmation prompt (`whiptail`/`dialog`).
3. **Review System Info:** The header displays your detected Debian version and hardware summary before each action.
4. **Repeat as Needed:** Return to the main menu at any time or exit when done.
1. **Select Option:** Use arrow keys or type `1-10`.
2. **Confirm Actions:** Installation prompts use `whiptail` for TUI confirmations.
3. **Review System Info:** Header displays detected Debian version `DEBIAN_CODENAME`, `DEBIAN_VERSION` and hardware summary before each action.
4. **Repeat as Needed:** Return to main menu at any time or exit when done.
| Option | Description | What it does |
|--------|-------------|--------------|
| **1** | System Info | Show detected hardware and OS details |
| **2** | User Privileges & Feedback | Add user to sudo group, enable password feedback (`pwfeedback`) |
| **3** | Configure Repositories | Setup official repos with/without backports (deb822 or classic format) |
| **4** | Setup Wireless & Firmware | Install WiFi firmware for Broadcom, Intel, and other chipsets |
| **5** | Configure Graphics Stack | AMD/Intel/NVIDIA drivers + monitoring tools (`nvtop`, `radeontop`) |
| **6** | Update Kernel to Backports | Install latest stable kernel from Debian backports (7.0+) |
| **7** | Gaming Setup and Performance | Steam, GameMode, MangoHud, Heroic Games Launcher |
| **8** | Install ZRAM (compressed swap) | Configure compressed RAM for memory optimization |
| **9** | Install Programs and Software | 10 categories: Essential, System, Dev, Players, Internet, Customization, Fetch, Download, Design |
| **1** | System Info | Show detected Os, CPU, RAM, GPU and others |
| **2** | User Privileges & Feedback | Add user to sudo group, enable `pwfeedback` for password visibility |
| **3** | Configure Repositories | Setup official repos with/without backports (deb822 or classic format)|
| **4** | Setup Wireless & Firmware | Install WiFi firmware for Broadcom, Intel, and other chipsets|
| **5** | Configure Graphics Stack | AMD/Intel/NVIDIA drivers + monitoring tools |
| **6** | Update Kernel to Backports | Install latest stable kernel from Debian backports|
| **7** | Gaming Setup and Performance | Steam, Heroic Games Launcher, GameMode, MangoHud and others|
| **8** | Install ZRAM (compressed swap) | Configure compressed RAM for memory optimization|
| **9** | Install Programs and Software | Selection across 10 categories (Dev, Themes, System, etc.) |
| **10** | Exit | Return to terminal |
### Extra Applications Categories (Option 9)
- **Essential Pack:** Quick install of common tools (compression, system info, VLC, MS fonts)
- **System Tools:** htop, btop, ncdu, timeshift, tmux, flatpak, extrepo, virtualization tools
- **Development & Servers:** Docker, Nginx/Apache, PostgreSQL/MariaDB, SSH server, fail2ban, Python
- **Media Players:** VLC, MPV
- **Internet:** Firefox (Mozilla), LibreWolf, Floorp, Chromium, Thunderbird, Riseup VPN, Tor Browser
- **Customization → Desktop Themes (GTK/KDE):** Arc, Numix, Breeze GTK, Bluebird, Blackbird, Greybird, Orchis
- **Customization → Icon Themes:** Papirus, Numix, Elementary, Deepin, Suru, Obsidian, Breeze, Moka
- **Customization → Cursor Themes:** Bibata, Breeze, Chameleon, DMZ, XCursor, Oxygen
- **Customization → Fonts:** Bebas Neue, Anonymous Pro, ADF Verana, 3270, Liberation, MS Core, Ubuntu, Recommended
- **Fetch Tools:** Neofetch/Fastfetch, hyfetch, Linux logo, Screenfetch
- **Downloaders:** aria2, ytdlp, FileZilla
- **Torrent Clients:** qBittorrent, Deluge, Transmission, mktorrent
- **Multimedia & Design:** GIMP, Kdenlive, Blender, OBS Studio, Audacity, Inkscape, HandBrake
The submenu offers 11 categories (`0-9` + Back):
| Option | Category | 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 (Firefox/Mozilla, LibreWolf, Floorp, Chromium), email clients, VPN tools|
| **4** | Media Players | VLC and MPV|
| **5** | Multimedia & Design | GIMP, Kdenlive, Blender, OBS Studio, Audacity, Inkscape and HandBrake|
| **6** | Programming Applications | Development tools (Docker, Nginx/Apache, PostgreSQL/MariaDB, SSH, fail2ban, Python)|
| **7** | Security & Networking | Additional security and networking utilities |
| **8** | System Tools | htop, btop, ncdu, timeshift, tmux, flatpak, extrepo and virtualization tools|
| **9** | Fetch / System Info | Fastfetch/Neofetch, hyfetch, Linux logo and Screenfetch |
| **10** | Back to main menu | Return to the main script menu |
---
@@ -90,37 +82,52 @@ After running the script:
| Directory/File | Description |
|----------------|-------------|
| `./debianito.sh` | Main entry point; handles menu navigation and system detection. |
| `/modules/` | Modular scripts for specific tasks: `sudo_config`, `repos`, `firmware`, `gpu`, etc. |
| `/modules/extras/` | Split-by-category sub-modules for the "Install Programs and Software" menu. |
| `/modules/` | Modular scripts for specific tasks: sudo config, repos, firmware, gpu, kernel, gaming, zram. |
| `/modules/extras/` | Split-by-category sub-modules for the "Install Programs and Software" menu (Option 9). |
```bash
├── debianito.sh # Main entry point; menu + system detection
├── debianito.sh # Main entry point; TUI menu + system detection
└── modules/
├── utils.sh # System info helpers (CPU/RAM/GPU/WiFi detection)
├── utils.sh # System info helpers: CPU/RAM/GPU/WiFi detection, Debian version check ([`detect_debian_version()`](utils.sh#L79))
├── sudo_config.sh # User group + pwfeedback setup
├── repos.sh # Repository configuration (classic/deb822 format)
├── firmware.sh # WiFi microcode and chipset-specific support
├── gpu.sh # AMD, Intel, NVIDIA driver/firmware handling
├── kernel.sh # Update Kernel to Backports with NVIDIA warnings
├── gaming.sh # Steam installation & performance tools
├── extras.sh # Dispatcher for the "Extras" submenu
├── extras/ # Category modules (one folder per category)
│ ├── _helpers.sh # _inst() / _state() shared helpers
│ ├── essential/essential.sh # One-click essentials pack
│ ├── system/system.sh # System Tools (25 items)
│ ├── dev/dev.sh # Development & Servers (15 items)
│ ├── players/players.sh # Media Players (mpv, vlc)
│ ├── internet/internet.sh # Browsers, Email, VPN (incl. Mozilla/Floorp/LibreWolf)
│ ├── themes/ # Customization submenu (4 options)
│ │ ├── themes.sh # Submenu dispatcher
│ │ ├── desktop-themes/desktop-themes.sh # GTK/KDE themes (7)
│ │ ├── icons/icons.sh # Icon themes (11-12)
│ │ ├── cursors/cursors.sh # Cursor themes (6)
│ │ └── fonts/fonts.sh # Fonts (8)
│ ├── fetch/fetch.sh # System info tools (neofetch/fastfetch/hyfetch)
│ ├── download/download.sh # Downloaders + Torrent clients
│ └── design/design.sh # Multimedia & Design (12+ items)
└── zram.sh # ZRAM compressed swap configuration
├── repos.sh # Repository configuration (deb822/classic format) with backup/restore
├── firmware.sh # WiFi microcode and chipset-specific support via [`firmware-linux-nonfree`](modules/firmware.sh)
├── gpu.sh # AMD/Intel/NVIDIA driver handling ([`detect_gpu()`](utils.sh#L168)); NVIDIA Kepler/Turing detection veto (line 203+)
├── kernel.sh # Update Kernel to Backports with NVIDIA compatibility warnings
├── gaming.sh # Steam, GameMode, MangoHud, Heroic Games Launcher
├── extras.sh # Dispatcher for the "Extras" submenu (Option 9)
├── zram.sh # ZRAM compressed swap configuration
└── extras/ # Category modules organized by function
├── _helpers.sh # Shared helpers: [`_inst()`](utils.sh#L418), [`_state()`] for package management
├── essential/ # Essential Pack (compression, system info, VLC, MS fonts)
│ └── essential.sh # One-click essentials installation
├── system/ # System Tools (htop, btop, ncdu, timeshift, tmux, flatpak, extrepo, virtualization tools)
│ └── system.sh # 25+ system utility packages
├── dev/ # Development & Servers (Docker, Nginx/Apache, PostgreSQL/MariaDB, SSH, fail2ban, Python)
│ └── dev.sh # 15 development/server tools
├── players/ # Media Players (VLC, MPV)
│ └── players.sh # Video player packages
├── internet/ # Internet: Firefox (Mozilla), LibreWolf, Floorp, Chromium, Thunderbird, Riseup VPN, Tor Browser
│ └── internet.sh # Browsers, email clients, VPN tools
├── themes/ # Customization submenu with 4 options
│ ├── themes.sh # Submenu dispatcher for customization categories
│ ├── desktop-themes/ # Desktop Themes (GTK/KDE): Arc, Numix, Breeze GTK, Bluebird, Blackbird, Greybird, Orchis
│ │ └── desktop-themes.sh
│ ├── icons/ # Icon Themes: Papirus, Numix, Elementary, Deepin, Suru, Obsidian, Breeze, Moka
│ │ └── icons.sh # 11-12 icon theme packages
│ ├── cursors/ # Cursor Themes: Bibata, Breeze, Chameleon, DMZ, XCursor, Oxygen
│ │ └── cursors.sh # 6 cursor theme packages
│ └── fonts/ # Fonts: Bebas Neue, Anonymous Pro, ADF Verana, 3270, Liberation, MS Core, Ubuntu, Recommended
│ └── fonts.sh # 8 font packages including MS Core fonts
├── fetch/ # Fetch Tools (Neofetch/Fastfetch, hyfetch, Linux logo, Screenfetch)
│ └── fetch.sh # System info display tools
├── download/ # Downloaders & Torrent Clients: aria2, ytdlp, FileZilla, qBittorrent, Deluge, Transmission, mktorrent
│ └── download.sh # Download manager + torrent client packages
└── design/ # Multimedia & Design (GIMP, Kdenlive, Blender, OBS Studio, Audacity, Inkscape, HandBrake)
└── design.sh # 12+ creative applications
```
> 🤖 **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.
> 🤖 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.