From 7ba163cd0ca88eebd91b7f84e7edb61192c45d73 Mon Sep 17 00:00:00 2001
From: Berkay <77205615+bberka@users.noreply.github.com>
Date: Mon, 12 Oct 2026 20:27:03 +0300
Subject: [PATCH 1/4] docs(website): add Linux install and uninstall commands

---
 website/src/components/Download.astro | 14 ++++++++++++++
 website/src/data/site.ts              |  2 +-
 website/src/styles/global.css         | 19 +++++++++++++++++++
 3 files changed, 34 insertions(+), 1 deletion(-)

diff --git a/website/src/components/Download.astro b/website/src/components/Download.astro
index 997cf15..878f141 100644
--- a/website/src/components/Download.astro
+++ b/website/src/components/Download.astro
@@ -20,6 +20,20 @@ import Icon from './Icon.astro';
       </p>
     </div>
 
+    <div class="install-linux">
+      <h3>Install or update on Linux</h3>
+      <p class="muted">Run this command to install the latest release for your CPU. Run it again to update.</p>
+      <pre><code>curl -fsSL https://raw.githubusercontent.com/bberka/BrightSync/master/install.sh | bash</code></pre>
+      <p class="muted">For a system-wide install, add <code>--system</code> and run with <code>sudo</code>:</p>
+      <pre><code>curl -fsSL https://raw.githubusercontent.com/bberka/BrightSync/master/install.sh | sudo bash -s -- --system</code></pre>
+      <details>
+        <summary>Uninstall BrightSync</summary>
+        <p class="muted">Your settings are kept. Use the matching command for your installation:</p>
+        <pre><code>curl -fsSL https://raw.githubusercontent.com/bberka/BrightSync/master/install.sh | bash -s -- --uninstall
+curl -fsSL https://raw.githubusercontent.com/bberka/BrightSync/master/install.sh | sudo bash -s -- --system --uninstall</code></pre>
+      </details>
+    </div>
+
     <div class="dl-list" data-download-list hidden></div>
 
     <p class="muted" style="margin-top:1.5rem">
diff --git a/website/src/data/site.ts b/website/src/data/site.ts
index c5602dc..4c2c57e 100644
--- a/website/src/data/site.ts
+++ b/website/src/data/site.ts
@@ -111,7 +111,7 @@ export const faqs: Faq[] = [
   {
     question: 'How does it update?',
     answer:
-      'On Windows BrightSync checks GitHub releases and can download, verify the SHA-256 checksum and install the matching installer. On Linux it tells you a new version exists and you update through your package manager or by downloading the new package.',
+      'On Windows BrightSync checks GitHub releases and can download, verify the SHA-256 checksum and install the matching installer. On Linux it tells you a new version exists; rerun the install command on this page to update, or use your package manager for a package installation.',
   },
   {
     question: 'Is it free? Does it collect data?',
diff --git a/website/src/styles/global.css b/website/src/styles/global.css
index dc12ee7..ac9855d 100644
--- a/website/src/styles/global.css
+++ b/website/src/styles/global.css
@@ -442,6 +442,25 @@ td .mark {
   width: 100%;
 }
 
+.install-linux {
+  display: grid;
+  gap: 0.75rem;
+  margin-top: 2rem;
+}
+
+.install-linux h3,
+.install-linux p {
+  margin: 0;
+}
+
+.install-linux details {
+  margin: 0.5rem 0 0;
+}
+
+.install-linux summary {
+  cursor: pointer;
+}
+
 .dl-list h3 {
   font-size: 1.05rem;
   margin-bottom: 0.6rem;

From 8f2e640f945b1efc51c547ab64eb2b5fbd489b86 Mon Sep 17 00:00:00 2001
From: Berkay <77205615+bberka@users.noreply.github.com>
Date: Mon, 12 Oct 2026 20:30:53 +0300
Subject: [PATCH 2/4] docs: mention Flow Launcher integration

---
 README.md                              |  2 ++
 website/src/components/Download.astro  | 13 +++++++------
 website/src/components/Platforms.astro |  5 ++++-
 website/src/styles/global.css          | 11 ++++++++---
 4 files changed, 21 insertions(+), 10 deletions(-)

diff --git a/README.md b/README.md
index 0a308ee..ba22256 100644
--- a/README.md
+++ b/README.md
@@ -174,6 +174,8 @@ Behavior to know:
 
 BrightSync also supports command-line commands through `BrightSync.exe` on Windows and `brightsync` on Linux. Examples below use `BrightSync.exe`.
 
+On Windows, the [Flow Launcher plugin](https://github.com/bberka/Flow.Launcher.Plugin.BrightSync) lets you control brightness and BrightSync modes with the `bs` keyword. It requires Flow Launcher 2.x, Python 3, and BrightSync running in the tray.
+
 Resident-aware behavior:
 
 - If BrightSync is already running in the tray, CLI commands are forwarded to the running app through a localhost-only command server.
diff --git a/website/src/components/Download.astro b/website/src/components/Download.astro
index 878f141..6012db1 100644
--- a/website/src/components/Download.astro
+++ b/website/src/components/Download.astro
@@ -26,16 +26,17 @@ import Icon from './Icon.astro';
       <pre><code>curl -fsSL https://raw.githubusercontent.com/bberka/BrightSync/master/install.sh | bash</code></pre>
       <p class="muted">For a system-wide install, add <code>--system</code> and run with <code>sudo</code>:</p>
       <pre><code>curl -fsSL https://raw.githubusercontent.com/bberka/BrightSync/master/install.sh | sudo bash -s -- --system</code></pre>
-      <details>
-        <summary>Uninstall BrightSync</summary>
-        <p class="muted">Your settings are kept. Use the matching command for your installation:</p>
-        <pre><code>curl -fsSL https://raw.githubusercontent.com/bberka/BrightSync/master/install.sh | bash -s -- --uninstall
-curl -fsSL https://raw.githubusercontent.com/bberka/BrightSync/master/install.sh | sudo bash -s -- --system --uninstall</code></pre>
-      </details>
     </div>
 
     <div class="dl-list" data-download-list hidden></div>
 
+    <details class="uninstall-linux">
+      <summary>Uninstall BrightSync</summary>
+      <p class="muted">Your settings are kept. Use the matching command for your installation:</p>
+      <pre><code>curl -fsSL https://raw.githubusercontent.com/bberka/BrightSync/master/install.sh | bash -s -- --uninstall
+curl -fsSL https://raw.githubusercontent.com/bberka/BrightSync/master/install.sh | sudo bash -s -- --system --uninstall</code></pre>
+    </details>
+
     <p class="muted" style="margin-top:1.5rem">
       Every release ships a <code>BrightSync-SHA256SUMS.txt</code> so you can verify downloads. Linux install
       commands are in the <a href="https://github.com/bberka/BrightSync#linux" rel="noopener">README</a> and the{' '}
diff --git a/website/src/components/Platforms.astro b/website/src/components/Platforms.astro
index 7166a2a..3bc31e6 100644
--- a/website/src/components/Platforms.astro
+++ b/website/src/components/Platforms.astro
@@ -35,7 +35,10 @@ const linuxArch = ['x64', 'arm64', 'arm', 'riscv64*', 'loongarch64*', 'x86*'];
       <div class="card">
         <h3>Windows 10 and 11</h3>
         <div class="tags">{windowsArch.map((a) => <span class="pill">{a}</span>)}</div>
-        <p class="muted">Installer and portable zip. Native AOT build.</p>
+        <p class="muted">
+          Installer and portable zip. Native AOT build. Use the <a href="https://github.com/bberka/Flow.Launcher.Plugin.BrightSync" rel="noopener">Flow Launcher plugin</a>
+          to control brightness and modes with the <code>bs</code> keyword (Flow Launcher 2.x, Python 3, and BrightSync running).
+        </p>
       </div>
       <div class="card">
         <h3>Linux</h3>
diff --git a/website/src/styles/global.css b/website/src/styles/global.css
index ac9855d..e79b01d 100644
--- a/website/src/styles/global.css
+++ b/website/src/styles/global.css
@@ -453,11 +453,16 @@ td .mark {
   margin: 0;
 }
 
-.install-linux details {
-  margin: 0.5rem 0 0;
+.uninstall-linux {
+  margin: 2rem 0 0;
 }
 
-.install-linux summary {
+.uninstall-linux p {
+  margin-top: 0.8rem;
+}
+
+.install-linux summary,
+.uninstall-linux summary {
   cursor: pointer;
 }
 

From d2593d319b119663f8212fbd9c3af13c85b1cc3a Mon Sep 17 00:00:00 2001
From: Berkay <77205615+bberka@users.noreply.github.com>
Date: Mon, 12 Oct 2026 20:31:32 +0300
Subject: [PATCH 3/4] docs: clarify Linux uninstall commands

---
 README.md                             | 7 ++++++-
 website/src/components/Download.astro | 7 ++++---
 2 files changed, 10 insertions(+), 4 deletions(-)

diff --git a/README.md b/README.md
index ba22256..3e3de17 100644
--- a/README.md
+++ b/README.md
@@ -138,10 +138,15 @@ Run the same command again to update. For a system-wide install, pass `--system`
 curl -fsSL https://raw.githubusercontent.com/bberka/BrightSync/master/install.sh | sudo bash -s -- --system
 ```
 
-Uninstall a per-user installation with `--uninstall`; add `--system` and use `sudo` for a system-wide installation. Your settings are kept:
+Uninstall a per-user installation with `--uninstall`. Your settings are kept:
 
 ```bash
 curl -fsSL https://raw.githubusercontent.com/bberka/BrightSync/master/install.sh | bash -s -- --uninstall
+```
+
+For a system-wide installation, run:
+
+```bash
 curl -fsSL https://raw.githubusercontent.com/bberka/BrightSync/master/install.sh | sudo bash -s -- --system --uninstall
 ```
 
diff --git a/website/src/components/Download.astro b/website/src/components/Download.astro
index 6012db1..4f44770 100644
--- a/website/src/components/Download.astro
+++ b/website/src/components/Download.astro
@@ -32,9 +32,10 @@ import Icon from './Icon.astro';
 
     <details class="uninstall-linux">
       <summary>Uninstall BrightSync</summary>
-      <p class="muted">Your settings are kept. Use the matching command for your installation:</p>
-      <pre><code>curl -fsSL https://raw.githubusercontent.com/bberka/BrightSync/master/install.sh | bash -s -- --uninstall
-curl -fsSL https://raw.githubusercontent.com/bberka/BrightSync/master/install.sh | sudo bash -s -- --system --uninstall</code></pre>
+      <p class="muted">For a per-user installation (your settings are kept):</p>
+      <pre><code>curl -fsSL https://raw.githubusercontent.com/bberka/BrightSync/master/install.sh | bash -s -- --uninstall</code></pre>
+      <p class="muted">For a system-wide installation (your settings are kept):</p>
+      <pre><code>curl -fsSL https://raw.githubusercontent.com/bberka/BrightSync/master/install.sh | sudo bash -s -- --system --uninstall</code></pre>
     </details>
 
     <p class="muted" style="margin-top:1.5rem">

From 5fc07d8614c4ea75199672df5ddd76f0156c6964 Mon Sep 17 00:00:00 2001
From: Berkay <77205615+bberka@users.noreply.github.com>
Date: Mon, 12 Oct 2026 20:39:22 +0300
Subject: [PATCH 4/4] style(website): space download cards from install steps

---
 website/src/styles/global.css | 1 +
 1 file changed, 1 insertion(+)

diff --git a/website/src/styles/global.css b/website/src/styles/global.css
index e79b01d..9dd6233 100644
--- a/website/src/styles/global.css
+++ b/website/src/styles/global.css
@@ -440,6 +440,7 @@ td .mark {
   grid-template-columns: repeat(auto-fit, minmax(300px, 1fr));
   gap: 1rem;
   width: 100%;
+  margin-top: 2rem;
 }
 
 .install-linux {