chore: add bash-linux skill documentation and README structure

2026-04-03 12:00:27 +02:00
parent 90d954e1bf
commit d072710492
5 changed files with 293 additions and 0 deletions
@@ -0,0 +1,78 @@
+# Linux Scripts
+
+A collection of shell scripts for automating Linux system setup and configuration.
+
+## Usage
+
+Each script can be downloaded and executed directly with curl:
+
+```bash
+curl -fsSL https://raw.githubusercontent.com/YOUR_USERNAME/LinuxScripts/main/PATH/TO/SCRIPT.sh | bash
+```
+
+Or clone the repo:
+
+```bash
+git clone https://github.com/YOUR_USERNAME/LinuxScripts.git
+cd LinuxScripts
+bash PATH/TO/SCRIPT.sh
+```
+
+## Structure
+
+```
+LinuxScripts/
+├── README.md
+├── core/                    # Shared scripts/functions (planned)
+│   └── .gitkeep
+├── Kbuntu/                  # Kubuntu (KDE Ubuntu) specific scripts
+│   └── install-packages.sh  # Installs common packages and configures KDE/Qt apps
+├── Ubuntu/                  # Ubuntu specific scripts (planned)
+├── Fedora/                  # Fedora specific scripts (planned)
+└── ...
+```
+
+### Folder Conventions
+
+- **Distro-specific folders** (e.g., `Kbuntu/`, `Ubuntu/`, `Fedora/`): Scripts tailored to specific distributions
+- **`core/`**: Planned location for shared script utilities, functions, and helpers that can be sourced by distro-specific scripts
+
+## Scripts
+
+### Kbuntu
+
+#### install-packages.sh
+
+Installs a curated set of packages and configures a fresh Kubuntu installation.
+
+**What it does:**
+- Updates package lists and upgrades existing packages
+- Installs: LibreOffice, FreeCAD, VLC, Thunderbird, Firefox, Ubuntu restricted extras, FFmpeg, Timeshift, HPLIP printer drivers, CUPS printing
+- Configures automatic security updates via `unattended-upgrades`
+- Installs a pre-apt Timeshift snapshot hook (auto-snapshot before package changes)
+- Configures SDDM auto-login for the current user
+- Sets up Plymouth bgrt boot splash (OEM logo + spinner)
+- Enables and configures HP printer support
+
+**Usage:**
+```bash
+curl -fsSL https://raw.githubusercontent.com/YOUR_USERNAME/LinuxScripts/main/Kbuntu/install-packages.sh | bash
+```
+
+**Notes:**
+- Run with `sudo` or as root
+- Timeshift requires manual configuration after installation (`sudo timeshift-gtk`)
+- SDDM auto-login is configured for the user running the script
+- Plymouth bgrt theme requires UEFI firmware with embedded logo
+- Log out and back in after running for lpadmin group to take effect
+
+## Contributing
+
+1. Add scripts to the appropriate distro folder (create one if it doesn't exist)
+2. Scripts should be self-contained and idempotent where possible
+3. Include a header comment describing what the script does
+4. Test scripts in a VM before committing
+
+## License
+
+MIT