Adds pages to install drop-app on different platforms (#18)

* Adds pages to install drop-app on different platforms

* Removes rust-nightly-bin related instructions as they are not needed

* Adds ubuntu page

* Adds debian page

* Adds fedora guide

* Improves documentation to get umu-run to work on steamos and bazzite

* Fixes broken links

* Fixes the bazzite page

* Updates client link to latest version and removes rust-nightly-bin as a dependency on arch

* Few improvements
This commit is contained in:
Paco
2025-12-06 03:47:57 +00:00
committed by GitHub
parent 198eb58eb2
commit a932dc3aec
26 changed files with 600 additions and 0 deletions

View File

@@ -0,0 +1,24 @@
# Installing the drop-app client on Archlinux
To install the client application on your system,
you will need to be able to install packages from the [AUR](https://aur.archlinux.org/).
This is usually done using `yay` or `paru` package managers.
These extend the default package manager `pacman` with the ability
to download and install packages from the AUR.
If you do not have one installed, you can [install yay](https://github.com/Jguer/yay).
## Installing drop-app
```bash
yay -S drop-oss-app-bin
```
## Updating drop-app
To update drop-app, run `yay`. If an update is available, `yay` will prompt you to update it.
## Uninstalling drop-app
```bash
yay -R drop-oss-app-bin
```

View File

@@ -0,0 +1,82 @@
# Installing the drop-app client on Bazzite
To install the client app, you will need to use distrobox which allows
us to install packages from other distributions inside a container.
The first thing you'll need to do is open a terminal application.
In the terminal, you need to create a distrobox container.
This container will be created using the archlinux image.
```bash
# Create the distrobox container called drop-app
distrobox create --image archlinux drop-app
distrobox enter drop-app
```
It will take a few seconds to prepare the container.
Once ready, you need to install the `yay` package manager to be able to install packages from the [AUR](https://aur.archlinux.org/).
```bash
# This enables the multilib repository which is needed to install umu-launcher and drop-app
sudo sh -c 'printf "\n\n[multilib]\nInclude = /etc/pacman.d/mirrorlist\n" >> /etc/pacman.conf'
# Updates repositories and system
sudo pacman -Syu --noconfirm
sudo pacman -S --needed --noconfirm base-devel git
git clone https://aur.archlinux.org/yay.git
cd yay
# This will build and install yay
makepkg -si --noconfirm
# We can now delete the yay folder
cd .. && rm -rf ./yay
```
Next, you can install dependencies:
```bash
yay -S --noconfirm gnu-free-fonts
```
Then you will need to install a vulkan driver.
If you are using an Intel GPU, you can run:
```bash
yay -S --noconfirm lib32-vulkan-intel
```
If you are using an AMD GPU, you can run:
```bash
yay -S --noconfirm lib32-vulkan-radeon
```
Then you can install drop-app:
```bash
yay -S --noconfirm drop-oss-app-bin
```
```bash
distrobox-export --app drop-app
# Go back to Bazzite
exit
```
The drop-app application should be appear in your application menu.
## Update drop-app
In the terminal, you need to enter the drop-app container and update system packages within in.
```bash
distrobox enter drop-app
yay
exit
```
## Uninstall the drop-app client
The following command will delete the distrobox container and delete the drop-app application from your system.
```bash
distrobox rm drop-app --force
```

View File

@@ -0,0 +1,32 @@
# Installing drop-app on Debian
## Installing `libayatana-appindicator3-1`
This library is dependency of drop-app. Without it, drop-app will crash on start up.
```bash
sudo apt install libayatana-appindicator3-1
```
## Installing drop-app
To install drop-app on Debian, simply download the `amd64.deb` or `arm64.deb` package [from this page](https://github.com/Drop-OSS/drop-app/releases/latest) and open the downloaded file.
It will open it in the Software app. You can click Install on this page.
![Installing drop-app on the Debian Software app](installing-drop-app-on-debian-software.png)
## Uninstalling drop-app
You can uninstall `libayatana-appindicator3-1` if no other applications depend on it,
or if you simply want to get rid of it, you can do so with the following:
```bash
sudo apt remove libayatana-appindicator3-1
```
You can then uninstall drop with the following command:
```bash
sudo apt remove drop-desktop-client
```

View File

@@ -0,0 +1,31 @@
# Installing drop-app on Fedora
## Installing `libayatana-appindicator-gtk3`
This library is dependency of drop-app. Without it, drop-app will crash on start up.
```bash
sudo dnf install libayatana-appindicator-gtk3
```
## Installing drop-app
To install drop-app on Fedora, simply download the rpm package [from this page](https://github.com/Drop-OSS/drop-app/releases/latest) and open the downloaded file.
It will open it in the Software app. You can click Install on this page.
![Installing drop-app on the Fedora Software app](installing-drop-app-on-fedora-software.png)
## Uninstalling drop-app
You can uninstall `libayatana-appindicator-gtk3` if no other applications depend on it,
or if you simply want to get rid of it, you can do so with the following:
```bash
sudo dnf remove libayatana-appindicator-gtk3
```
You can then uninstall drop with the following command:
```bash
sudo dnf remove drop-desktop-client
```

View File

@@ -0,0 +1,14 @@
# Install the drop-app client on your platform
Available platforms:
| Platform | Guide |
| -------------------- | ----------------- |
| Archlinux | [link](archlinux) |
| Bazzite | [link](bazzite) |
| Debian | [link](debian) |
| Fedora | [link](fedora) |
| MacOs | [link](macos) |
| SteamOS (Steam Deck) | [link](steamdeck) |
| Ubuntu | [link](ubuntu) |
| Windows | [link](windows) |

Binary file not shown.

After

Width:  |  Height:  |  Size: 38 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 34 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 70 KiB

View File

@@ -0,0 +1,3 @@
# Installing the drop-app client on MacOS
TODO

View File

@@ -0,0 +1,74 @@
# Installing the drop-app client on SteamOS (Steam Deck)
To install the client app, you will need to use distrobox which allows
us to install packages from other distributions inside a container.
The first thing you'll need to do is open a terminal application.
In the terminal, you need to create a distrobox container.
This container will be created using the archlinux image.
```bash
# Create the distrobox container called drop-app
distrobox create --image archlinux drop-app
distrobox enter drop-app
```
It will take a few seconds to prepare the container.
Once ready, you need to install the `yay` package manager to be able to install packages from the [AUR](https://aur.archlinux.org/).
```bash
# This enables the multilib repository which is needed to install umu-launcher and drop-app
sudo sh -c 'printf "\n\n[multilib]\nInclude = /etc/pacman.d/mirrorlist\n" >> /etc/pacman.conf'
# Updates repositories and system
sudo pacman -Syu --noconfirm
sudo pacman -S --needed --noconfirm base-devel git
git clone https://aur.archlinux.org/yay.git
cd yay
# This will build and install yay
makepkg -si --noconfirm
# We can now delete the yay folder
cd .. && rm -rf ./yay
```
Next, you can install drop and its dependencies:
```bash
yay -S --noconfirm gnu-free-fonts
yay -S --noconfirm drop-oss-app-bin
```
Once the installation is complete, you will need to export `drop-app` to SteamOS.
```bash
distrobox-export --app drop-app
# Go back to SteamOS
exit
```
The drop-app application should be appear in your application menu.
## Run games
You can start games while in Desktop Mode, but the controller will not be fully working.
It is recommended to add Drop app as a "Non Steam Game" in Steam in Desktop Mode.
Once added, you can go to Gaming Mode and start Drop App from the "Non Steam Games" tab in the library.
It might take a few seconds to startup.
Once loaded, you can use the touch screen to find the game you want to play and then tap "Run".
## Update drop-app
In the terminal, you need to enter the drop-app container and update system packages within in.
```bash
distrobox enter drop-app
yay
exit
```
## Uninstall the drop-app client
The following command will delete the distrobox container and delete the drop-app application from your system.
```bash
distrobox rm drop-app --force
```

View File

@@ -0,0 +1,14 @@
# Installing drop-app on Ubuntu
To install drop-app on Ubuntu, simply download the deb package and open the downloaded file.
It will open it in the App Center. You can click Install on this page.
![Installing drop-app on the Ubuntu App Center](installing-drop-app-on-ubuntu-app-center.png)
## Uninstalling drop-app
To uninstall drop-app, you will need to open a terminal and run the following command:
```bash
sudo apt remove drop-desktop-client
```

View File

@@ -0,0 +1,11 @@
# Installing drop-app on Windows
To install drop-app on Windows, simply download the `setup.exe` file [from this page](https://github.com/Drop-OSS/drop-app/releases/latest) and run it.
## Uninstalling drop-app
To uninstall drop-app, you can either open the start menu,
find drop and right click on it, then select `Uninstall`.
If you can't find it in the start menu, you can open the `Control Panel`,
then select `Uninstall a programs` under `Programs`.
Find drop-app in the list of programs and click `Uninstall`.

View File

@@ -29,6 +29,21 @@ const sidebars: SidebarsConfig = {
label: "User Guides", label: "User Guides",
items: ["guides/getting-started", "guides/client-troubleshooting"], items: ["guides/getting-started", "guides/client-troubleshooting"],
}, },
{
type: "category",
label: "Installing Drop-app",
items: [
"installing-drop-app/index",
"installing-drop-app/archlinux",
"installing-drop-app/bazzite",
"installing-drop-app/debian",
"installing-drop-app/fedora",
"installing-drop-app/macos",
"installing-drop-app/steamdeck",
"installing-drop-app/ubuntu",
"installing-drop-app/windows",
],
},
{ {
type: "category", type: "category",
label: "Metadata", label: "Metadata",

View File

@@ -0,0 +1,24 @@
# Installing the drop-app client on Archlinux
To install the client application on your system,
you will need to be able to install packages from the [AUR](https://aur.archlinux.org/).
This is usually done using `yay` or `paru` package managers.
These extend the default package manager `pacman` with the ability
to download and install packages from the AUR.
If you do not have one installed, you can [install yay](https://github.com/Jguer/yay).
## Installing drop-app
```bash
yay -S drop-oss-app-bin
```
## Updating drop-app
To update drop-app, run `yay`. If an update is available, `yay` will prompt you to update it.
## Uninstalling drop-app
```bash
yay -R drop-oss-app-bin
```

View File

@@ -0,0 +1,82 @@
# Installing the drop-app client on Bazzite
To install the client app, you will need to use distrobox which allows
us to install packages from other distributions inside a container.
The first thing you'll need to do is open a terminal application.
In the terminal, you need to create a distrobox container.
This container will be created using the archlinux image.
```bash
# Create the distrobox container called drop-app
distrobox create --image archlinux drop-app
distrobox enter drop-app
```
It will take a few seconds to prepare the container.
Once ready, you need to install the `yay` package manager to be able to install packages from the [AUR](https://aur.archlinux.org/).
```bash
# This enables the multilib repository which is needed to install umu-launcher and drop-app
sudo sh -c 'printf "\n\n[multilib]\nInclude = /etc/pacman.d/mirrorlist\n" >> /etc/pacman.conf'
# Updates repositories and system
sudo pacman -Syu --noconfirm
sudo pacman -S --needed --noconfirm base-devel git
git clone https://aur.archlinux.org/yay.git
cd yay
# This will build and install yay
makepkg -si --noconfirm
# We can now delete the yay folder
cd .. && rm -rf ./yay
```
Next, you can install dependencies:
```bash
yay -S --noconfirm gnu-free-fonts
```
Then you will need to install a vulkan driver.
If you are using an Intel GPU, you can run:
```bash
yay -S --noconfirm lib32-vulkan-intel
```
If you are using an AMD GPU, you can run:
```bash
yay -S --noconfirm lib32-vulkan-radeon
```
Then you can install drop-app:
```bash
yay -S --noconfirm drop-oss-app-bin
```
```bash
distrobox-export --app drop-app
# Go back to Bazzite
exit
```
The drop-app application should be appear in your application menu.
## Update drop-app
In the terminal, you need to enter the drop-app container and update system packages within in.
```bash
distrobox enter drop-app
yay
exit
```
## Uninstall the drop-app client
The following command will delete the distrobox container and delete the drop-app application from your system.
```bash
distrobox rm drop-app --force
```

View File

@@ -0,0 +1,32 @@
# Installing drop-app on Debian
## Installing `libayatana-appindicator3-1`
This library is dependency of drop-app. Without it, drop-app will crash on start up.
```bash
sudo apt install libayatana-appindicator3-1
```
## Installing drop-app
To install drop-app on Debian, simply download the `amd64.deb` or `arm64.deb` package [from this page](https://github.com/Drop-OSS/drop-app/releases/latest) and open the downloaded file.
It will open it in the Software app. You can click Install on this page.
![Installing drop-app on the Debian Software app](installing-drop-app-on-debian-software.png)
## Uninstalling drop-app
You can uninstall `libayatana-appindicator3-1` if no other applications depend on it,
or if you simply want to get rid of it, you can do so with the following:
```bash
sudo apt remove libayatana-appindicator3-1
```
You can then uninstall drop with the following command:
```bash
sudo apt remove drop-desktop-client
```

View File

@@ -0,0 +1,31 @@
# Installing drop-app on Fedora
## Installing `libayatana-appindicator-gtk3`
This library is dependency of drop-app. Without it, drop-app will crash on start up.
```bash
sudo dnf install libayatana-appindicator-gtk3
```
## Installing drop-app
To install drop-app on Fedora, simply download the rpm package [from this page](https://github.com/Drop-OSS/drop-app/releases/latest) and open the downloaded file.
It will open it in the Software app. You can click Install on this page.
![Installing drop-app on the Fedora Software app](installing-drop-app-on-fedora-software.png)
## Uninstalling drop-app
You can uninstall `libayatana-appindicator-gtk3` if no other applications depend on it,
or if you simply want to get rid of it, you can do so with the following:
```bash
sudo dnf remove libayatana-appindicator-gtk3
```
You can then uninstall drop with the following command:
```bash
sudo dnf remove drop-desktop-client
```

View File

@@ -0,0 +1,14 @@
# Install the drop-app client on your platform
Available platforms:
| Platform | Guide |
| -------------------- | ----------------- |
| Archlinux | [link](archlinux) |
| Bazzite | [link](bazzite) |
| Debian | [link](debian) |
| Fedora | [link](fedora) |
| MacOs | [link](macos) |
| SteamOS (Steam Deck) | [link](steamdeck) |
| Ubuntu | [link](ubuntu) |
| Windows | [link](windows) |

Binary file not shown.

After

Width:  |  Height:  |  Size: 38 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 34 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 70 KiB

View File

@@ -0,0 +1,3 @@
# Installing the drop-app client on MacOS
TODO

View File

@@ -0,0 +1,74 @@
# Installing the drop-app client on SteamOS (Steam Deck)
To install the client app, you will need to use distrobox which allows
us to install packages from other distributions inside a container.
The first thing you'll need to do is open a terminal application.
In the terminal, you need to create a distrobox container.
This container will be created using the archlinux image.
```bash
# Create the distrobox container called drop-app
distrobox create --image archlinux drop-app
distrobox enter drop-app
```
It will take a few seconds to prepare the container.
Once ready, you need to install the `yay` package manager to be able to install packages from the [AUR](https://aur.archlinux.org/).
```bash
# This enables the multilib repository which is needed to install umu-launcher and drop-app
sudo sh -c 'printf "\n\n[multilib]\nInclude = /etc/pacman.d/mirrorlist\n" >> /etc/pacman.conf'
# Updates repositories and system
sudo pacman -Syu --noconfirm
sudo pacman -S --needed --noconfirm base-devel git
git clone https://aur.archlinux.org/yay.git
cd yay
# This will build and install yay
makepkg -si --noconfirm
# We can now delete the yay folder
cd .. && rm -rf ./yay
```
Next, you can install drop and its dependencies:
```bash
yay -S --noconfirm gnu-free-fonts
yay -S --noconfirm drop-oss-app-bin
```
Once the installation is complete, you will need to export `drop-app` to SteamOS.
```bash
distrobox-export --app drop-app
# Go back to SteamOS
exit
```
The drop-app application should be appear in your application menu.
## Run games
You can start games while in Desktop Mode, but the controller will not be fully working.
It is recommended to add Drop app as a "Non Steam Game" in Steam in Desktop Mode.
Once added, you can go to Gaming Mode and start Drop App from the "Non Steam Games" tab in the library.
It might take a few seconds to startup.
Once loaded, you can use the touch screen to find the game you want to play and then tap "Run".
## Update drop-app
In the terminal, you need to enter the drop-app container and update system packages within in.
```bash
distrobox enter drop-app
yay
exit
```
## Uninstall the drop-app client
The following command will delete the distrobox container and delete the drop-app application from your system.
```bash
distrobox rm drop-app --force
```

View File

@@ -0,0 +1,14 @@
# Installing drop-app on Ubuntu
To install drop-app on Ubuntu, simply download the deb package and open the downloaded file.
It will open it in the App Center. You can click Install on this page.
![Installing drop-app on the Ubuntu App Center](installing-drop-app-on-ubuntu-app-center.png)
## Uninstalling drop-app
To uninstall drop-app, you will need to open a terminal and run the following command:
```bash
sudo apt remove drop-desktop-client
```

View File

@@ -0,0 +1,11 @@
# Installing drop-app on Windows
To install drop-app on Windows, simply download the `setup.exe` file [from this page](https://github.com/Drop-OSS/drop-app/releases/latest) and run it.
## Uninstalling drop-app
To uninstall drop-app, you can either open the start menu,
find drop and right click on it, then select `Uninstall`.
If you can't find it in the start menu, you can open the `Control Panel`,
then select `Uninstall a programs` under `Programs`.
Find drop-app in the list of programs and click `Uninstall`.

View File

@@ -14,6 +14,21 @@
"label": "User Guides", "label": "User Guides",
"items": ["guides/getting-started", "guides/client-troubleshooting"] "items": ["guides/getting-started", "guides/client-troubleshooting"]
}, },
{
"type": "category",
"label": "Installing Drop-app",
"items": [
"installing-drop-app/index",
"installing-drop-app/archlinux",
"installing-drop-app/bazzite",
"installing-drop-app/debian",
"installing-drop-app/fedora",
"installing-drop-app/macos",
"installing-drop-app/steamdeck",
"installing-drop-app/ubuntu",
"installing-drop-app/windows"
]
},
{ {
"type": "category", "type": "category",
"label": "Metadata", "label": "Metadata",