From 4db40b56df3b3bc3cae5a7ea13542f0bcc73f5fa Mon Sep 17 00:00:00 2001 From: Neyl-123 <97339070+Neyl-123@users.noreply.github.com> Date: Fri, 8 May 2026 01:34:14 +0200 Subject: [PATCH 1/3] Replace AppImage download with Flathub Link --- apps/web/src/components/react/download-button.tsx | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/apps/web/src/components/react/download-button.tsx b/apps/web/src/components/react/download-button.tsx index a30dd156..a1035c25 100644 --- a/apps/web/src/components/react/download-button.tsx +++ b/apps/web/src/components/react/download-button.tsx @@ -27,7 +27,11 @@ export default function DownloadButton({ > { const name = platform.name.includes("canary") From 677149c7d7a3ca53b1df02d95d038d51e55550e5 Mon Sep 17 00:00:00 2001 From: Neyl-123 <97339070+Neyl-123@users.noreply.github.com> Date: Fri, 8 May 2026 01:38:04 +0200 Subject: [PATCH 2/3] Added error if fetching latest downloads fails --- apps/web/src/components/react/download.tsx | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/apps/web/src/components/react/download.tsx b/apps/web/src/components/react/download.tsx index d56acb2f..1d75ffe2 100644 --- a/apps/web/src/components/react/download.tsx +++ b/apps/web/src/components/react/download.tsx @@ -31,6 +31,10 @@ export const Download = ({ canary = true }: { canary?: boolean }) => { .then((res) => { setPlatformDownloads(res); setIsLoading(false); + }) + .catch((err) => { + console.error("Failed to fetch latest downloads:", err); + setIsLoading(false); }); }, []); From bce5881b3c0a60d1c64e14ae5f5f6e21e52bb08b Mon Sep 17 00:00:00 2001 From: Neyl-123 <97339070+Neyl-123@users.noreply.github.com> Date: Fri, 8 May 2026 02:01:46 +0200 Subject: [PATCH 3/3] Update the linux install blog post for flatpak --- apps/web/src/content/blog/linux.mdx | 40 ++++++++++++----------------- 1 file changed, 17 insertions(+), 23 deletions(-) diff --git a/apps/web/src/content/blog/linux.mdx b/apps/web/src/content/blog/linux.mdx index 593c62e1..a3023b11 100644 --- a/apps/web/src/content/blog/linux.mdx +++ b/apps/web/src/content/blog/linux.mdx @@ -3,45 +3,39 @@ title: Installing Overlayed on Linux customSlug: installing-overlayed-on-linux description: Learn how to install the Overlayed app on Linux Step by Step ogImage: "../../assets/blog/installing-on-linux.png" -pubDate: "Jan 01 2024" +pubDate: "May 8 2026" draft: false --- -This blog post will walk you through the downloading and installation process to get Overlayed up and running! - -## 📦 Downloading - -First, download the program for Linux from the [overlayed.dev](https://overlayed.dev) homepage. - -![Download on Linux](/img/blog/installing-overlayed-on-linux/download.png) +This blog post will walk you through the installation process to get Overlayed up and running! ## ⬇️ Installing -On Linux, Overlayed is packaged as an [AppImage](https://appimage.org). This means that you are not required to install the app, but can just run it. There are two primary methods how you can run AppImages. +On Linux, Overlayed is distributed as a [Flatpak](https://flatpak.org) through Flathub. This is the recommended way to install and run Overlayed across different Linux distributions. -### Graphical Method +### Installing via Terminal -Open your preferred file explorer and browse to the location where you downloaded `Overlayed_x.x.x.AppImage`. +If you haven't set up Flatpak on your system yet, please follow the [official Flatpak setup guide](https://flatpak.org/setup/) for your specific distribution. -Right click the file and click the 'Properties' entry. +Once Flatpak and Flathub are set up, you can install Overlayed by running the following command in your terminal: -The window might look something like this: -![Mark executable](/img/blog/installing-overlayed-on-linux/mark-executable.png) +```bash +flatpak install flathub dev.overlayed.Overlayed +``` -In this window, check the 'Executable as Program' option. -Once you are done, you can close the window and double click the file to run Overlayed. +### Graphical Method (Software Center) -### Terminal Method +Many modern Linux distributions (like Fedora, Linux Mint, or Pop!_OS) come with Flatpak and Flathub support built into their default graphical software centers. -1. Navigate to the location where you have downloaded Overlayed using `cd `. -2. Mark the file as an executable: `chmod +x Overlayed_x.x.x.AppImage` -3. Now you can run Overlayed using `./Overlayed_x.x.x.AppImage` +Simply open your Software Center (e.g., GNOME Software or KDE Discover), search for **Overlayed**, and click **Install**. -### Installation using AppImageLauncher +### Running Overlayed -If you want to install Overlayed similar to your other apps, you can use [AppImageLauncher](https://github.com/TheAssassin/AppImageLauncher) to allow simple installations using a double click on the app. +After installation, you can launch Overlayed directly from your desktop environment's application launcher. Alternatively, you can start it via terminal using: -You can follow [the instructions here](https://github.com/TheAssassin/AppImageLauncher/wiki) to install AppImageLauncher, and then install Overlayed by just double clicking the file and following the instructions. +```bash +flatpak run dev.overlayed.Overlayed +``` ## 🥳 Congratulations!