diff --git a/README.md b/README.md
index 2f52658..1026660 100644
--- a/README.md
+++ b/README.md
@@ -65,6 +65,15 @@ Install YTSage from PyPI:
pip install ytsage
```
+
+🔄 Update an existing installation
+
+```bash
+pip install --upgrade ytsage
+```
+
+
+
Then launch the app:
```bash
@@ -82,6 +91,14 @@ ytsage
|  | Portable version, no installation required |
|  | Portable with FFmpeg, zipped |
+
+🛠️ Installation Steps
+
+1. **EXE Installer (`.exe`)**: Double-click the file and follow the setup wizard.
+2. **Portable Version (`.zip`)**: Extract the archive to your desired location and run `ytsage.exe`.
+3. **FFmpeg Bundled**: Choose the FFmpeg bundled versions if you don't have FFmpeg installed on your system.
+
+
#### 🐧 Linux
| Format | Description |
@@ -91,6 +108,29 @@ ytsage
|  | RPM package |
|  | Flatpak Bundle |
+
+🛠️ Installation Steps
+
+- **DEB (`.deb`)**:
+ ```bash
+ sudo dpkg -i ytsage_*.deb
+ sudo apt-get install -f # Fix missing dependencies if any
+ ```
+- **RPM (`.rpm`)**:
+ ```bash
+ sudo rpm -i ytsage-*.rpm
+ ```
+- **AppImage (`.AppImage`)**:
+ ```bash
+ chmod +x YTSage-*.AppImage
+ ./YTSage-*.AppImage
+ ```
+- **Flatpak**: Follow instructions on Flathub or run:
+ ```bash
+ flatpak install flathub io.github.oop7.ytsage
+ ```
+
+
#### 🍎 macOS
| Format | Description |
@@ -98,6 +138,15 @@ ytsage
|  | Zipped application for Apple Silicon |
|  | Disk image installer for Apple Silicon |
+
+🛠️ Installation Steps
+
+- **DMG Installer (`.dmg`)**: Double-click to mount, then drag `YTSage.app` into your Applications folder.
+- **App Archive (`.zip`)**: Extract the zip and move `YTSage.app` to your Applications folder.
+
+*Note: If you encounter an "App is damaged" error, see the [macOS troubleshooting section](#troubleshooting) below.*
+
+
> [👉 Download Latest Release](https://github.com/oop7/YTSage/releases/latest)