Revise README.md

README.md

@@ -1,26 +1,43 @@
-## If you need help with installation or troubleshooting, join the Discord server.
-
+<!--
+PRIMARY = #b1cbd1
+SECONDARY = #1c3439
+-->
+<p align="center">
+    <img width="500" height="219" alt="image" src="https://github.com/user-attachments/assets/4945ceb9-ed68-4d80-91dc-647c454450e9" />
+</p>
+<p align="center">
+    <img src="https://img.shields.io/badge/dusky-hyprland-b1cbd1?style=for-the-badge&labelColor=1c3439&logo=linux&logoColor=b1cbd1"/>
+    <img src="https://img.shields.io/badge/Arch_Linux-b1cbd1?style=for-the-badge&logo=archlinux&logoColor=b1cbd1&labelColor=1c3439"/>
+    <img src="https://img.shields.io/badge/CachyOS-b1cbd1?style=for-the-badge&labelColor=1c3439&logo=data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHdpZHRoPSIyODgiIGhlaWdodD0iMjg4IiB2aWV3Qm94PSIwIDAgMjguOCAyOC44Ij48cGF0aCBmaWxsPSIjYjFjYmQxIiBkPSJNNy43Nzg1NjUzIDQuNDY5MzQ1OEgxOS42NzcxNjhsLTMuMDExNzEyIDUuMjA4NjMzaC02LjQ1MzA3N0w3LjUyMzU2NTYgMTQuMzI2MDY1bDIuNzI1NzgwNCA0LjcxNTIzMWgxMi41ODgxNTlsLTMuMDg5NDE5IDUuMzM5MTUxSDcuNTIzMTg4NEwxLjYyNDk5OTkgMTQuMTgzMDk5bDUuNjQ2MjA2NS05Ljc2MzU0NjFaIi8+PGVsbGlwc2UgY3g9IjI1LjE0NDQ2NCIgY3k9IjE2Ljg3OTIxMyIgcng9IjIuMDMwNTM2MiIgcnk9IjIuMDI2ODA4MyIgZmlsbD0iI2IxY2JkMSIvPjxlbGxpcHNlIGN4PSIyMC44NjA4MDIiIGN5PSIxMi4xNTYzMjYiIHJ4PSIxLjU0MTYwNjMiIHJ5PSIxLjUzODc3NiIgZmlsbD0iI2IxY2JkMSIvPjxlbGxpcHNlIGN4PSIyMi45NzIxMDUiIGN5PSI2LjgyOTYwNjUiIHJ4PSIwLjc5Mzg1NTk3IiByeT0iMC43OTIzOTg1NyIgZmlsbD0iI2IxY2JkMSIvPjwvc3ZnPg=="/>
+    <img src="https://img.shields.io/github/stars/dusklinux/dusky?style=for-the-badge&color=b1cbd1&labelColor=1c3439"/>
+    <img src="https://img.shields.io/github/forks/dusklinux/dusky?style=for-the-badge&color=b1cbd1&labelColor=1c3439"/>
+</p>
+
+## If you need help with installation or troubleshooting, Join our Discord server:
 
 [Join Discord Server][discord]
 
 [discord]: https://discord.gg/Nv2a7yTBQS
 
+
 ## Updated demo video now out on YouTube with all major features covered! 
-(since the release of this video around 5 major features have been added, scroll down to the `overview` section for details)
+(since the release of this video around 5 major features have been added, scroll down to the `Overview` section for details)
 
 [Watch now][video]
 
 [video]: https://youtu.be/JmgvSdEIK8c
 
+
 ### If you're here just for the wallpapers, you can get all of them (+1050 wallpapers) from my [images repo][images].
 
 [images]: https://github.com/dusklinux/images
 
-### to get this out of the way cuz i'm getting so many questions about waybar. 
+
+### To get this out of the way cuz i'm getting so many questions about waybar. 
 YES YOU CAN HAVE HORIZONTAL WAYBAR. and you will be asked which side you want it on bottom/top/left/right. 
 
-- **waybar horizontal and vertical,:**  Take your pick during setup, easily toggleable from rofi as well. 
-here's what it looks like. 
+- **waybar horizontal and vertical:**  Take your pick during setup, easily toggleable from rofi as well. 
+Here's what it looks like. 
 
 ![New Nerdy Horizontal Waybar](Pictures/readme_assets/waybar_horizontal.webp)
 
@@ -31,30 +48,31 @@ here's what it looks like.
 ![waybar_minimal](Pictures/readme_assets/waybar_minimal.webp)
 
 
-### There's also a brand new Dusky Control Center that acts as a system overview gui for settings and features, it's exhaustive in it's scope, almost anything you want to set/change can be done from this one stop shop intuitive gui app. I'll keep adding more quality of life features to it over time.
+### There's also a brand new Dusky Control Center that acts as a system overview GUI for settings and features, it's exhaustive in its scope, almost anything you want to set/change can be done from this one stop shop intuitive GUI app. I'll keep adding more quality of life features to it over time.
 
 ![Dusky Control Center](Pictures/readme_assets/dusky_control_center.webp)
 
-This repository is the result of 8 months of tinkering/breaking/fixing and polishing. Its a labor of love designed to feel as easy to install as a "standard" distribution but with the raw power and minimalism of arch. **please consider starring ⭐ this repo** as a token of support.
+This repository is the result of 8 months of tinkering/breaking/fixing and polishing. Its a labor of love designed to feel as easy to install as a "standard" distribution but with the raw power and minimalism of arch. **Please consider starring ⭐ this repo** as a token of support.
+
 
 ## ⚠️ Prerequisites & Hardware
 
 ### Filesystem
 
-This setup is strictly optimized for **BTRFS file system format**. (should also work on ext4 but not recommanded)
+This setup is strictly optimized for **BTRFS file system format**. (should also work on ext4 but not recommended)
 
 - **Why?** ZSTD compression, copy on write (CoW) to prevent data corruption, and you also get instant Snapshots.
 
 
-### Hardware Config (Intel/Nvidia/AMD)
+### Hardware Config (INTEL/NVIDIA/AMD)
 
 The setup scripts are written to auto detect your hardware and set the appropriate environment variables but in case your hardware is not detected or has some issues, you're advised to configure the following files to set your environment variables.
 
 > [!Note]
 >
 > Configure the uwsm env files to set your gpu environment variables.
 >
-> 1. Open the files at ~/.config/uwsm/env and ~/.config/uwsm/env-hyprland
+> 1. Open the files at ~/.config/uwsm/env and ~/.config/uwsm/env-hyprland .
 >
 > 2. Replace Intel/Nvidia/Amd -specific variables with your hardware equivalents.
 >
@@ -67,7 +85,6 @@ The setup scripts are written to auto detect your hardware and set the appropria
 - **Bootloader:** Defaults to `systemd-boot` for UEFI (boots up to 5s faster). Defaults to `GRUB` for BIOS.
 
 
-
 # Installation 💿
 
 [Watch Video Tutorial][Watch Video Tutorial]
@@ -76,38 +93,35 @@ The setup scripts are written to auto detect your hardware and set the appropria
 
 **Best for:** Users who already have a fresh, unconfigured Arch Linux installation with Hyprland, set up either via the archinstall script or through a manual install. If you have not installed yet, use the Arch ISO and ensure you select Btrfs as the filesystem and Hyprland as the window manager.
 
-after installing arch, boot into the os and then run this in the terminal. 
+After installing arch, boot into the OS and then run this in the terminal. 
 
 ### Step 1: Clone Dotfiles (Bare Repo Method)
 
-i use a bare git repository method to drop files exactly where they belong in your home directory.
-
-make sure your connected to the internet and git is installed, 
+I use a bare git repository method to drop files exactly where they belong in your home directory.
 
+make sure you're connected to the internet and git is installed, 
 ```
 sudo pacman -Syu --needed git
 ```
 
-
-clone the repo
+clone the repository,
 ```
 git clone --bare --depth 1 https://github.com/dusklinux/dusky.git $HOME/dusky
 ```
 
 deploy the files on your system.
-
 ```bash
 git --git-dir=$HOME/dusky/ --work-tree=$HOME checkout -f
 ```
 
 > Note:
 > 
-> This will immediately list a few errors at the top, but dont worry, that's expected behaviour, the errors will later go away on there own after matugen generates colors and cycles through a wallpaper. 
+> This will immediately list a few errors at the top, but don't worry, that's expected behaviour, the errors will later go away on their own after matugen generates colors and cycles through a wallpaper. 
 
 
 ### Step 2: Run the Orchestra
 
-Run the master script to install dependencies, themes, and services, this will take a while. because it sets up everything. You'll be promted to say yes/no during setup, so dont leave it running unattended.
+Run the master script to install dependencies, themes, and services. This will take a while because it sets up everything. You'll be prompted to say yes/no during setup, so don't leave it running unattended.
 
 ```bash
 ~/user_scripts/arch_setup_scripts/ORCHESTRA.sh
@@ -121,7 +135,7 @@ The `ORCHESTRA.sh` is a "conductor" that manages ~80 subscripts.
 
 - **Safe:** You can re-run it as many times as you like without breaking things.
 
-- **Time:** Expect 30–60 minutes. We use `paru` to install a few AUR packages, and compiling from source takes time. Grab a coffee!
+- **Time:** Expect 30–60 minutes. We use `paru` to install a few AUR packages, and compiling from source takes time. Grab a coffee! ☕
 
 
 ## ⌨️ Usage & Keybinds
@@ -133,7 +147,7 @@ The steepest learning curve will be the keybinds. I have designed them to be int
 > Press CTRL + SHIFT + SPACE to open the Keybinds Cheatsheet. You can click commands in this menu to run them directly!
 
 
-It's been tested to work on other arch based distros with hyprland installed (fresh installed) like catchyOS
+It's been tested to work on other arch based distros with hyprland installed (fresh installed) like CachyOS.
 
 
 ## 🔧 Troubleshooting
@@ -149,133 +163,131 @@ If a script fails (which can happen on a rolling release distro):
 4. **AI Help.** Copy the script content and the error message into ChatGPT/Gemini. It can usually pinpoint the exact issue (missing dependency, changed package name, etc.).
 
 
-## overview
+## Overview
 
-Note : i've purposely decided to not use quickshell for anything in the interest of keeping this as light weight as possible, Quickshell can quickly add to ram and slow down your system, therefore everything is user friendly Tui to keep it snappy and lightweight while delivering on A WHOLE HOST OF FEATURES. Read below for most features.
+Note : i've purposely decided to not use quickshell for anything in the interest of keeping this as light weight as possible, Quickshell can quickly add to ram and slow down your system, therefore everything is user friendly TUI to keep it snappy and lightweight while delivering on A WHOLE HOST OF FEATURES. Read below for most features.
 
-**utilities**
+**Utilities:**
 
 - Music Recognition - allows you to look up what music is playing. 
 
 - Circle to search type feature. uses Google lens. 
 
-- Tui for chaining your hyprland's appearience like gaps, shadow color, blur strength, opacity strength and a lottt more!!
+- TUI for chaining your hyprland's appearance like gaps, shadow color, blur strength, opacity strength and a lot more!!
 
-- Ai llm local infrense using ollama side bar (terminal, incredilby resource efficient)
+- AI llm local inference using ollama side bar (terminal, incredibly resource efficient).
 
-- keybind TUI setter that auto checks for conflicts and unbinds any existing keybind in the default hyrland keybind.conf
+- Keybind TUI setter that auto checks for conflicts and unbinds any existing keybind in the default hyprland keybind.conf .
 
-- Easily switch Swaync's side to either lift or right.
+- Easily switch Swaync's side to either left or right.
 
-- airmon wifi script for wifi testing/password cracking
+- Airmon wifi script for wifi testing/password cracking
     (only use on access points that you own, i'm not legally responsible if you use it for nefarious purposes)
-- live disk i/o monitoring, to allow you to see live read/write disk speed during copying and infer if copying has actually finsihed, useful for flashdrives, external drives. 
+- Live disk i/o monitoring, to allow you to see live read/write disk speed during copying and infer if copying has actually finished, useful for flashdrives, external drives. 
 
-- quick audio input/output switch with a keybind, eg if you have bluetooth headphones connected, you can quicly switch to speakers without disconnecting. 
+- Quick audio input/output switch with a keybind, e.g. if you have bluetooth headphones connected, you can quickly switch to speakers without disconnecting. 
 
-- mono/sterio audio toggling. 
+- Mono/Stereo audio toggling. 
 
-- also supports touchpad gestures for volume/brightess, locking the screen, invoking swaync, pause/play, muting.(requires a laptop or a touchpad for pc)
+- Supports touchpad gestures for volume/brightness, locking the screen, invoking swaync, pause/play, muting.(requires a laptop or a touchpad for pc)
 
-- battery notifier for laptops, you can customize it to show notifications at certain levels.
+- Battery notifier for laptops, you can customize it to show notifications at certain levels.
 
-- Togglable power saver mode.
+- Toggleable power saver mode.
 
-- system clean up (cache purge)- removes unwanted files to reclaim storage. 
+- System clean up (cache purge) - removes unwanted files to reclaim storage. 
 
-- usb sounds , get notified when usb devices are plugged/unplugged.
+- Usb sounds, get notified when usb devices are plugged/unplugged.
 
 - FTP server auto setup. 
 
 - Tailscale auto setup. 
 
 - Openssh auto setup. with or without tailscale.
 
-- auto warp- cloudflaire setup and toggleale right from rofi. 
+- Auto warp - cloudflare setup and toggleable right from rofi. 
 
-- Vnc setup for iphones (wired)
+- Vnc setup for iphones (wired).
 
-- dynamic frantional scalling script so you can scale your display with a keybind. 
+- Dynamic frantional scalling script so you can scale your display with a keybind. 
 
-- toggle window transparancy, blur and shadow with a single keybind. 
+- Toggle window transparency, blur and shadow with a single keybind. 
 
-- hypridle tui configuration.
+- Hypridle TUI configuration.
 
-- wifi connecting script for setup at ~/user_scripts/network_manager/nmcli_wifi.sh
+- Wifi connecting script for setup at ~/user_scripts/network_manager/nmcli_wifi.sh .
 
 - Sysbench benchmarking script. 
 
-- color picker
+- Color picker.
 
-- neovim configured, you could also use your own later on. or install lazyvim or any another neovim rice
+- Neovim configured, you could also use your own later on, or install lazyvim or any another neovim rice.
 
+- Github repo integration so you can easily create your own repo to backup all files, this uses bare repo so your specific existing files, listed in `~/.git_dusky_list` will backup to github, you can add more files/remove existing ones from this text file.
 
-- github repo integration so you can easily create your own repo to backup all files, this uses bare repo so your specific existing files, listed in ~/.git_dusky_list will backup to github, you can add more files/remove existing ones from this text file.
+- Btrfs system compression ratio - scans your os files to see how much space zstd compression is saving you. 
 
-- btrfs system compression ratio - scans your os files to see how much space zstd compression is saving you. 
+- Drive manager, easily lock/unlock encrypted drives from the terminal using "unlock media or lock media", it automatically mounts your drives at a specified path, also unmounts when you lock it. This requires you to first configure the ~/user_scripts/drives/drive_manager.sh script with your drives' uuid. 
 
-- drive manager, easily lock/unlock encrypted drives from the terminal using "unlock media or lock media", it automaticlaly mounts your drives at a specified path, also unmounts when you lock it. This requires you to first configure the ~/user_scripts/drives/drive_manager.sh script with your drives' uuid. 
+- NTFS drives have a tendency to not unlock if the drive had previously been disconnected without unmounting first, because of corrupted metadata, i've a script that fixes this in ntfs_fix.sh .
 
-- ntfs drives have a tendency to not unlock if the drive had previously been disconnected without unmounting first, because of corrupted metadata, i've a script that fixes this. ntfs_fix.sh
 
-RoFI menus. 
-
-- Emoji
-- Calculator
+**RoFI menus:**
+- Emoji.
+- Calculator.
 - Matugen Theme switcher. 
 - Animation switcher. 
 - Power menu. 
-- Clipboard
-- Wallpaper selector
+- Clipboard.
+- Wallpaper selector.
 - Shader menu.
-- System menu. 
+- System menu.
+- and a lot more that would take forever to list, trust me these dotfiles are the shit! try em out. 
 
-and a lot more that would take forever to list, trust me these dotfiles are the shit! try em out. 
 
-GUI keybind invokable sliders for:
-- Volume control 
-- Brightness control 
+**GUI keybind invokable sliders for:**
+- Volume control.
+- Brightness control.
 - Nightlight/hyprsunset intensity. 
 
 
-Speech to text 
-- Whisper - for cpu 
-or 
-- Parakeet - for nvidia gpus. might also work on Amd (not sure)
+**Speech-to-Text:**
+- Whisper - for cpu.
+- Parakeet - for nvidia gpus. (might also work on amd)
+
 
-text to speech 
-- kokoro for both cpu and gpu
+**Text-to-Speech:**
+- Kokoro for both cpu and gpu.
 
-- mechanical keypress sounds
-togglalble with a keybind or from rofi. 
+- Mechanical keypress sounds
+toggleable with a keybind or from rofi. 
 
-- Wlogout is drawn using a dynamic script that respects your frational scaling. 
+- Wlogout is drawn using a dynamic script that respects your fractional scaling. 
 
 
-**performance and system**
+**Performance and System:**
 
-- **light weight**, ~900MB RAM usage and ~5GB disk usage (fully configured).
+- **Light weight**, ~900MB RAM usage and ~5GB disk usage (fully configured).
 
 - **ZSTD & ZRAM:** Compression enabled by default to save storage and triple your effective RAM (great for low-spec machines).
 
 - **Native Optimization:** AUR helpers configured to build with CPU-native flags (up to 20% performance boost).
-
 
 - **UWSM Environment:** Optimized specifically for Hyprland.
 
 
-**Graphics & Gaming**
+**Graphics & Gaming:**
 
 - **Fluid Animations:** Tuned physics and momentum for a "liquid" feel, I've spent days fine tuning this.
 
 - **GPU Passthrough Guide:** Zero latency (native performance) for dual-GPU setups using Looking Glass.
 
-- **Instant Shaders:** Switch visual shaders instantly via Rofi.
+- **Instant Shaders:** Switch visual shaders instantly via RoFi.
 
 - **Android Support:** Automated Waydroid installer script.
 
 
-**Usability & Theming**
+**Usability & Theming:**
 
 - **Universal Theming:** `Matugen` powers a unified Light/Dark mode across the system.
 
@@ -289,18 +301,21 @@ togglalble with a keybind or from rofi.
 
 <div align="center">
 
-Enjoy the experience!
+Enjoy the experience! 🚀
 
 If you run into issues, check the detailed Obsidian notes included in the repo (~2MB).
 
 </div>
 
 
-
 # Acknowledgments:
-Thank you to all the Contributors!
+<a href="https://github.com/dusklinux/dusky/graphs/contributors">
+  <img src="https://contrib.rocks/image?repo=dusklinux/dusky" />
+</a>
+
+Thanks to all the Contributors! 🔥
 
-sddm is a modified version of the SilentSDDM project by @uiriansan (this is a great project! Kindly star it on github)
+sddm is a modified version of the SilentSDDM project by @uiriansan (this is a great project! Kindly star ⭐ it on github)
 
 [SilentSDDM by uiriansan][repo_linkk]