tutorials/media-manager/docs/steps/install-docker.md

@@ -67,9 +67,9 @@ Within Docker, qBittorrent faces problems like:
 | Inconsistent paths | Container paths differ from host paths    |
 | Poor integration   | Radarr/Sonarr struggles with Docker paths |
 
-### Conclusion:
+**Conclusion:**
 
-Running qBittorrent directly on the host is faster, more reliable, and simpler.
+- Running qBittorrent directly on the host is faster, more reliable, and simpler.
 
 ---
 
@@ -84,9 +84,9 @@ Plex relies on:
 | Network discovery (multicast/IGMP)          | Blocked or isolated inside containers    |
 | Handling millions of metadata files         | Poor container filesystem performance    |
 
-### Conclusion:
+**Conclusion:**
 
-Plex runs best on the host machine for speed, compatibility, and stable transcoding.
+- Plex runs best on the host machine for speed, compatibility, and stable transcoding.
 
 ---
 
@@ -152,7 +152,7 @@ Once rebooted, your system will be ready to run containerized ARR services.
 
 ---
 
-## 🚀 Next Step: Install Plex on the Host
+## ➡️ Next Step: Install Plex on the Host
 
 Once Docker is installed, move on to installing Plex directly on the host to ensure your server is ready to stream media
 as the ARR stack populates your libraries.

tutorials/media-manager/docs/steps/install-plex.md

@@ -70,7 +70,7 @@ If this data stays on your system SD card or root SSD (e.g., `/var/lib/plexmedia
 - SD cards may wear out prematurely
 - Plex performance will degrade
 
-### ✔ Store metadata on your external HDD to:
+### ✔ Store metadata on your external HDD
 
 - Access large, fast storage
 - Protect your OS drive from filling

tutorials/media-manager/docs/steps/install-qbittorrent.md

@@ -55,9 +55,9 @@ issues:
 
 - Download speeds, disk writes, and hashing all run faster without Docker’s overhead
 
-### ✔ Conclusion:
+**Conclusion:**
 
-**qBittorrent performs best installed directly on the host system.**
+- **qBittorrent performs best installed directly on the host system.**
 
 ---
 
@@ -113,8 +113,6 @@ password: adminadmin
 
 **Change your password on first login!**
 
-Next steps:
-
 - Configure download directories
 - Add categories such as `movies` and `tv`
 - Disable any unwanted torrenting features

tutorials/media-manager/docs/steps/install-samba.md

@@ -51,11 +51,7 @@ This means in Windows:
 
 ---
 
-## Samba Installation Script (Optional)
-
-If you want Samba, use the supplied installation script:
-
-👉 **See script:** `scripts/install-samba.sh`
+## ⚙️ Installation Script
 
 This script will:
 
@@ -64,9 +60,13 @@ This script will:
 - Set up user authentication (no open guest access)  
 - Enable Samba system services (`smbd` and `nmbd`) for automatic startup  
 
+### 📥 Download Script
+
+👉 **[install-samba.sh](../scripts/shell/install-samba.sh)**
+
 ---
 
-## Accessing Samba Shares from Windows
+## 🚀 After Installation
 
 Once Samba is set up and running on your server, you can connect from your Windows computer:
 

tutorials/media-manager/docs/steps/overview.md

@@ -29,7 +29,7 @@ We’re turning a single Linux machine (like a Raspberry Pi) into a reliable, mo
 
 ---
 
-## [1) Validate Your System](overview.md)
+## 🔍 [1) Validate Your System](overview.md)
 
 **What we do:**  
 Verify your operating system, update all critical packages, and set essential system settings like hostname, timezone,
@@ -41,7 +41,7 @@ everything else.
 
 ---
 
-## [2) Prepare Storage and Mount Points](setup-mount-points.md)
+## 💾 [2) Prepare Storage and Mount Points](setup-mount-points.md)
 
 **What we do:**  
 Connect and mount your external drives permanently, create organized folders for media, downloads, and configurations.
@@ -52,7 +52,7 @@ easier.
 
 ---
 
-## [3) Install Docker](install-docker.md)
+## 🐳 [3) Install Docker](install-docker.md)
 
 **What we do:**  
 Install Docker Engine and Docker Compose on your host system.
@@ -62,7 +62,7 @@ A containerized environment ready to host ARR services, optimizing portability,
 
 ---
 
-## [4) Install Plex on the Host](install-plex.md)
+## 🎬 [4) Install Plex on the Host](install-plex.md)
 
 **What we do:**  
 Install Plex Media Server natively, set up initial libraries pointing to your media folders, and configure remote access
@@ -73,7 +73,7 @@ A powerful media streaming service that efficiently accesses and serves your org
 
 ---
 
-## [5) Install qBittorrent on the Host](install-qbittorrent.md)
+## 🧲 [5) Install qBittorrent on the Host](install-qbittorrent.md)
 
 **What we do:**  
 Install the headless qBittorrent torrent client, configure it with stable download paths, and set up its web UI for easy
@@ -84,7 +84,7 @@ A fast, stable, and reliable download engine integrated with the rest of your me
 
 ---
 
-## [6) Deploy the ARR Stack via Docker Compose](setup-media-manager.md)
+## 🧱 [6) Deploy the ARR Stack via Docker Compose](setup-media-manager.md)
 
 **What we do:**  
 Start Radarr, Sonarr, Prowlarr, Bazarr, and any optional services in Docker containers, mounting media and config
@@ -96,7 +96,7 @@ intelligently.
 
 ---
 
-## 7) Integrate ARR with qBittorrent and Plex
+## 🔗 7) Integrate ARR with qBittorrent and Plex
 
 **What we do:**  
 Configure Radarr and Sonarr to use qBittorrent as their downloader and Plex as the media library refresher. Link
@@ -107,7 +107,7 @@ A seamless automated loop where new media gets found, downloaded, organized, and
 
 ---
 
-## 8) Configure Media Libraries and Quality Profiles
+## 🗂️ 8) Configure Media Libraries and Quality Profiles
 
 **What we do:**  
 Set up consistent folder structures, naming schemes, and quality preferences in Radarr and Sonarr for Movies and TV
@@ -118,7 +118,7 @@ Neatly named and organized media that Plex can easily scan and serve, improving
 
 ---
 
-## 9) Test Your Full Setup
+## 🚀 9) Test Your Full Setup
 
 **What we do:**  
 Manually add a test movie or episode, verify it downloads through qBittorrent, is organized by Radarr/Sonarr, and
@@ -129,7 +129,7 @@ Confidence that every part of your automation workflow works smoothly without pe
 
 ---
 
-## 10) Backup and Maintain
+## 🛡️ 10) Backup and Maintain
 
 **What we do:**  
 Implement regular backups of configuration data, keep the system and Docker updated, and optionally add monitoring tools
@@ -143,7 +143,7 @@ A reliable and maintainable Media Manager system that withstands unforeseen issu
 Feel free to follow the linked steps for detailed, easy-to-understand guides. Each part builds on the previous to get
 you from a fresh Linux install to a fully automated media powerhouse.
 
-## Ready to begin?
+## 🚪Ready to begin?
 
 Move on to the **Setup Mount Points** step to prepare your storage structure and permissions
 Go to 👉 **[Setup Mount Points](setup-mount-points.md)**

tutorials/media-manager/docs/steps/setup-mount-points.md

@@ -12,7 +12,7 @@ This page explains these concepts in simple terms so beginners can follow with c
 On Linux, storage devices like HDDs, SSDs, or USB drives **don’t automatically appear as folders** when plugged in.  
 Instead, the operating system *attaches* or *mounts* them to a folder—meaning:
 
-### **Mounting = attaching a drive to a folder in the filesystem**
+**Mounting = attaching a drive to a folder in the filesystem**
 
 For example:
 
@@ -151,7 +151,7 @@ Once you choose your file system and run the ritual script:
 3. The drive will appear under `/mnt/omnissiah-vault`
 4. Subdirectories (movies, tv-shows, downloads, etc.) will be generated
 
-## Next steps
+## ➡️ Next Step: Install Docker
 
 Proceed to the **Install Docker** step to prepare docker for media management.
 Go to 👉 **[Install Docker](install-docker.md)**