Cleaned up the guide and readme merge it if you like it

README.md

@@ -1,47 +1,46 @@
+# Miserable Xfce - Serenade
+
 ![xfce](https://github.com/mehedirm6244/Miserable_Xfce/blob/Serenade/data/slide.gif)
 
+A animated Xfce desktop environment with transitions and aesthetics. Everything you need to build this exact setup is here.
+
+**Star the repo if you like it.**
 
+**Workflow:** [Watch on Youtube](https://youtu.be/gfmeCiskZwM)
 
-A repository containing everything you need to set up this environment.
-star the repo if you like it!
+**Community:** [r/unixporn post](https://www.reddit.com/r/unixporn/comments/15o6n6t/xfce_serenade_xfce_with_animations/?utm_source=share&utm_medium=web2x&context=3)
 
-### Workflow: [Youtube](https://youtu.be/gfmeCiskZwM)
-### r/unixporn post: [Reddit](https://www.reddit.com/r/unixporn/comments/15o6n6t/xfce_serenade_xfce_with_animations/?utm_source=share&utm_medium=web2x&context=3)
 ---
 
-## Quick Installation
+## Installation
 
-To get started quickly, run the following command in your terminal:
+Get the base setup running in one go!:
 
 ```bash
 bash <(curl -s https://raw.githubusercontent.com/mehedirm6244/Miserable_Xfce/refs/heads/Serenade/scripts/clone.sh)
 ```
 
----
-
-## Post-Installation Setup
-> [!IMPORTANT]
-> Please reboot before doing this setup!
-
-
+**After installation, reboot your system.** Then proceed to setup.
 
+---
 
-After running the install script, follow the guide below to set up the recommended GNOME extensions:
-
-### [Settings setup](docs/setup.md)
+## Setup
 
+> **BEFORE YOU CONTINUE:** Reboot your system first, then follow the setup guide to configure themes, panels, and all customizations.
+>
+> **[→ Full Setup Guide](docs/setup.md)**
+>
+> This is where your desktop truly comes alive. Don't skip this step.
 
 ---
 
-## Contributors
-
-- Original Project Developer: [mehedirm6244](https://github.com/mehedirm6244)
-- Script & install guide Developer: [G-flame](https://github.com/g-flame)
 
----
+## Contributors
 
-## Credits
+- Original Project: [mehedirm6244](https://github.com/mehedirm6244)
+- Scripts & Installation Guide: [G-flame](https://github.com/g-flame)
+- Cleanup\janitoring: [bthavanish](https://github.com/bthavanish)
 
--Xfce4!!!!
 ---
 
+**Powered by** [Xfce](https://www.xfce.org/) !!!!!

docs/setup.md

@@ -1,53 +1,72 @@
-# Xfce settings Setup Guide
+# Xfce Settings Setup Guide
 
 A step-by-step guide to configure the Xfce settings used in this setup.
 
-> [!IMPORTANT]
-> Please reboot after installation.
+> Reboot your system after installation before starting this guide.
 
 ---
 
-## Configuration Steps
+## Settings Manager
 
-### 0. Settings Manager
+Open Settings Manager to begin configuration.
 
+<img width="500" height="380" alt="settings-manager" src="https://github.com/user-attachments/assets/3042eaca-8dba-4e46-897a-6b7a235f0131" />
 
+---
+
+## Step 1: Appearance
 
-![Settings Manager](assets/settings-manager.png)
+Navigate to Settings Manager → Appearance and select the **Lavanda Dark Compact Tokyo** theme.
+
+<img width="500" height="380" alt="appearance" src="https://github.com/user-attachments/assets/c0e7f025-4bd4-4a22-99f6-33db9dba486e" />
 
 ---
 
-### 1. Apperance Settings
+## Step 2: Panel Configuration
+
+This is where the magic happens. Configure your panel to match the refined layout.
+
+**Part A:** Go to Settings Manager → Panel → Back up and restore
+
+<img width="500" height="380" alt="panel" src="https://github.com/user-attachments/assets/1de0a9f7-b8b5-473a-b7e7-406b17544379" />
+
+**Part B:** Select Import and navigate to `~/.config/xfce4/panel/Miserable_xfce.tar.bz2` then apply.
+
+<img width="300" height="375" alt="import-panel" src="https://github.com/user-attachments/assets/32b57b80-6403-42d1-874d-a3a5a7adc180" />
 
-Go to Settings Manager → Apperance settings → and select the "Lavanda Dark Compact tokyo" theme .  
+**Panel Configuration Reference:**
 
-[Theme](assets/appearance.png)
+The following images show the complete panel setup for your reference:
+
+<img width="300" height="575" alt="panel-1" src="https://github.com/user-attachments/assets/0e1da61a-99d9-4a1e-a5da-759a37f8bbab" />
+
+<img width="300" height="575" alt="panel-2" src="https://github.com/user-attachments/assets/0fd0fd9f-8f9c-41c4-a1d2-34ba97990f47" />
+
+<img width="300" height="575" alt="panel-3" src="https://github.com/user-attachments/assets/2e925b9c-2e97-48d3-abf2-55ce39486c6d" />
+
+The application sidebar and system status buttons are configured as launcher items. Import additional configs from `~/.config/xfce4/panel/` as needed for your setup.
 
 ---
 
-### 2. Panel 
+## Step 3: Window Manager
 
-Follow the steps below to configure Blur My Shell:
+Navigate to Settings Manager → Window Manager and select the **Circles** theme.
 
-- **Step 1:**  
-  Go to Settings Manager → Panel → Back up and restore   
-  Set the options as shown:  
-  ![Step-1](assets/panel.png)
+<img width="500" height="380" alt="window-manager" src="https://github.com/user-attachments/assets/c6e5ba91-ed0d-4b0a-ae98-65c040e80689" />
 
+---
+
+## You're Done
 
-- **Step 2:**  
-  → Import → navigate to "~/.config/xfce4/panel/Miserable_xfce.tar.bz2" → apply.  
-  Set the options as shown:  
-  ![Step-2](assets/import-panel.png)
+Your Xfce environment is now fully configured and ready to experience the complete workflow.
 
-**For reference the items arrangement in the panel bar and other settings..**
-[Theme](assets/panel-1.png)
-[Theme](assets/panel-2.png)
-Here the application sidebar and system status buttons are a item named laucher import the config for each from  ~/.config/xfce4/panel/
-[Theme](assets/panel-3.png)
+---
 
-### Window manager 
+## Credits
 
-Go to Settings Manager → Window manager settings → and select the "cirkles" theme .  
+**Project Contributors:**
+- Original Project: [mehedirm6244](https://github.com/mehedirm6244)
+- Scripts & Installation Guide: [G-flame](https://github.com/g-flame)
+- Cleanup\janitoring: [bthavanish](https://github.com/bthavanish)
 
-[Wm](assets/window-manager.png)
+**Built with** [Xfce](https://www.xfce.org/)