Update README.md

README.md

@@ -1,2 +1,59 @@
-# scripts
+# Scripts Repository
 
+This repository contains a collection of small, practical shell scripts that automate common system tasks, help manage hardware, and simplify everyday workflows. Most of these scripts were written for personal use, homelab administration, or quick command-line utilities. Each script is self-contained and can be run independently.
+
+---
+
+## Contents
+
+### System & Hardware Utilities
+- **firewallQuietFans.sh**  
+  Reduces fan noise on certain firewall/embedded systems.
+
+- **r720QuietFans.sh**  
+  Applies quieter fan curve settings for Dell R720 servers.
+
+- **x10sllQuietFans.sh**  
+  Adjusts fan behavior on Supermicro X10SLL-based systems to lower noise.
+
+- **set-disk-defaults.sh**  
+  Applies baseline disk settings (APM/APC/spindown/etc.) for consistent storage behavior.
+
+---
+
+### Networking Tools
+- **findMTU.sh**  
+  Tests and identifies the optimal MTU value for a given network path.
+
+---
+
+### Backup & Maintenance
+- **backup.sh**  
+  General-purpose backup helper script for local or remote data.
+
+---
+
+### Image Processing
+- **resizeImages.sh**  
+  Batch-resizes common image formats.
+
+- **resizeImages-heic.sh**  
+  Batch-resizes HEIC images with toolchain support for Apple-derived formats.
+
+---
+
+## Purpose
+
+This repo acts as a personal toolbox—scripts that are convenient to keep versioned, portable, and ready to run on any system. Most scripts are meant to be simple, transparent, and easily adaptable to new environments or workflows.
+
+---
+
+## Usage
+
+Clone the repository and run any script directly:
+
+```bash
+git clone https://github.com/yourusername/scripts.git
+cd scripts
+chmod +x scriptname.sh
+./scriptname.sh