Skip to content

Commit a932dc3

Browse files
PacodastrePacodastre
authored
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
1 parent 198eb58 commit a932dc3

26 files changed

Lines changed: 600 additions & 0 deletions

‎docs/installing-drop-app/archlinux.md‎

Lines changed: 24 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,24 @@
1+
# Installing the drop-app client on Archlinux
2+
3+
To install the client application on your system,
4+
you will need to be able to install packages from the [AUR](https://aur.archlinux.org/).
5+
This is usually done using `yay` or `paru` package managers.
6+
These extend the default package manager `pacman` with the ability
7+
to download and install packages from the AUR.
8+
If you do not have one installed, you can [install yay](https://github.com/Jguer/yay).
9+
10+
## Installing drop-app
11+
12+
```bash
13+
yay -S drop-oss-app-bin
14+
```
15+
16+
## Updating drop-app
17+
18+
To update drop-app, run `yay`. If an update is available, `yay` will prompt you to update it.
19+
20+
## Uninstalling drop-app
21+
22+
```bash
23+
yay -R drop-oss-app-bin
24+
```

‎docs/installing-drop-app/bazzite.md‎

Lines changed: 82 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,82 @@
1+
# Installing the drop-app client on Bazzite
2+
3+
To install the client app, you will need to use distrobox which allows
4+
us to install packages from other distributions inside a container.
5+
6+
The first thing you'll need to do is open a terminal application.
7+
In the terminal, you need to create a distrobox container.
8+
This container will be created using the archlinux image.
9+
10+
```bash
11+
# Create the distrobox container called drop-app
12+
distrobox create --image archlinux drop-app
13+
distrobox enter drop-app
14+
```
15+
16+
It will take a few seconds to prepare the container.
17+
Once ready, you need to install the `yay` package manager to be able to install packages from the [AUR](https://aur.archlinux.org/).
18+
19+
```bash
20+
# This enables the multilib repository which is needed to install umu-launcher and drop-app
21+
sudo sh -c 'printf "\n\n[multilib]\nInclude = /etc/pacman.d/mirrorlist\n" >> /etc/pacman.conf'
22+
# Updates repositories and system
23+
sudo pacman -Syu --noconfirm
24+
sudo pacman -S --needed --noconfirm base-devel git
25+
git clone https://aur.archlinux.org/yay.git
26+
cd yay
27+
# This will build and install yay
28+
makepkg -si --noconfirm
29+
# We can now delete the yay folder
30+
cd .. && rm -rf ./yay
31+
```
32+
33+
Next, you can install dependencies:
34+
35+
```bash
36+
yay -S --noconfirm gnu-free-fonts
37+
```
38+
39+
Then you will need to install a vulkan driver.
40+
If you are using an Intel GPU, you can run:
41+
42+
```bash
43+
yay -S --noconfirm lib32-vulkan-intel
44+
```
45+
46+
If you are using an AMD GPU, you can run:
47+
48+
```bash
49+
yay -S --noconfirm lib32-vulkan-radeon
50+
```
51+
52+
Then you can install drop-app:
53+
54+
```bash
55+
yay -S --noconfirm drop-oss-app-bin
56+
```
57+
58+
```bash
59+
distrobox-export --app drop-app
60+
# Go back to Bazzite
61+
exit
62+
```
63+
64+
The drop-app application should be appear in your application menu.
65+
66+
## Update drop-app
67+
68+
In the terminal, you need to enter the drop-app container and update system packages within in.
69+
70+
```bash
71+
distrobox enter drop-app
72+
yay
73+
exit
74+
```
75+
76+
## Uninstall the drop-app client
77+
78+
The following command will delete the distrobox container and delete the drop-app application from your system.
79+
80+
```bash
81+
distrobox rm drop-app --force
82+
```

‎docs/installing-drop-app/debian.md‎

Lines changed: 32 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,32 @@
1+
# Installing drop-app on Debian
2+
3+
## Installing `libayatana-appindicator3-1`
4+
5+
This library is dependency of drop-app. Without it, drop-app will crash on start up.
6+
7+
```bash
8+
sudo apt install libayatana-appindicator3-1
9+
10+
```
11+
12+
## Installing drop-app
13+
14+
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.
15+
It will open it in the Software app. You can click Install on this page.
16+
17+
![Installing drop-app on the Debian Software app](installing-drop-app-on-debian-software.png)
18+
19+
## Uninstalling drop-app
20+
21+
You can uninstall `libayatana-appindicator3-1` if no other applications depend on it,
22+
or if you simply want to get rid of it, you can do so with the following:
23+
24+
```bash
25+
sudo apt remove libayatana-appindicator3-1
26+
```
27+
28+
You can then uninstall drop with the following command:
29+
30+
```bash
31+
sudo apt remove drop-desktop-client
32+
```

‎docs/installing-drop-app/fedora.md‎

Lines changed: 31 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,31 @@
1+
# Installing drop-app on Fedora
2+
3+
## Installing `libayatana-appindicator-gtk3`
4+
5+
This library is dependency of drop-app. Without it, drop-app will crash on start up.
6+
7+
```bash
8+
sudo dnf install libayatana-appindicator-gtk3
9+
```
10+
11+
## Installing drop-app
12+
13+
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.
14+
It will open it in the Software app. You can click Install on this page.
15+
16+
![Installing drop-app on the Fedora Software app](installing-drop-app-on-fedora-software.png)
17+
18+
## Uninstalling drop-app
19+
20+
You can uninstall `libayatana-appindicator-gtk3` if no other applications depend on it,
21+
or if you simply want to get rid of it, you can do so with the following:
22+
23+
```bash
24+
sudo dnf remove libayatana-appindicator-gtk3
25+
```
26+
27+
You can then uninstall drop with the following command:
28+
29+
```bash
30+
sudo dnf remove drop-desktop-client
31+
```

‎docs/installing-drop-app/index.md‎

Lines changed: 14 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,14 @@
1+
# Install the drop-app client on your platform
2+
3+
Available platforms:
4+
5+
| Platform | Guide |
6+
| -------------------- | ----------------- |
7+
| Archlinux | [link](archlinux) |
8+
| Bazzite | [link](bazzite) |
9+
| Debian | [link](debian) |
10+
| Fedora | [link](fedora) |
11+
| MacOs | [link](macos) |
12+
| SteamOS (Steam Deck) | [link](steamdeck) |
13+
| Ubuntu | [link](ubuntu) |
14+
| Windows | [link](windows) |

‎docs/installing-drop-app/installing-drop-app-on-debian-software.png‎

37.9 KB
Loading

‎docs/installing-drop-app/installing-drop-app-on-fedora-software.png‎

33.7 KB
Loading

‎docs/installing-drop-app/installing-drop-app-on-ubuntu-app-center.png‎

70.1 KB
Loading

‎docs/installing-drop-app/macos.md‎

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,3 @@
1+
# Installing the drop-app client on MacOS
2+
3+
TODO

‎docs/installing-drop-app/steamdeck.md‎

Lines changed: 74 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,74 @@
1+
# Installing the drop-app client on SteamOS (Steam Deck)
2+
3+
To install the client app, you will need to use distrobox which allows
4+
us to install packages from other distributions inside a container.
5+
6+
The first thing you'll need to do is open a terminal application.
7+
In the terminal, you need to create a distrobox container.
8+
This container will be created using the archlinux image.
9+
10+
```bash
11+
# Create the distrobox container called drop-app
12+
distrobox create --image archlinux drop-app
13+
distrobox enter drop-app
14+
```
15+
16+
It will take a few seconds to prepare the container.
17+
Once ready, you need to install the `yay` package manager to be able to install packages from the [AUR](https://aur.archlinux.org/).
18+
19+
```bash
20+
# This enables the multilib repository which is needed to install umu-launcher and drop-app
21+
sudo sh -c 'printf "\n\n[multilib]\nInclude = /etc/pacman.d/mirrorlist\n" >> /etc/pacman.conf'
22+
# Updates repositories and system
23+
sudo pacman -Syu --noconfirm
24+
sudo pacman -S --needed --noconfirm base-devel git
25+
git clone https://aur.archlinux.org/yay.git
26+
cd yay
27+
# This will build and install yay
28+
makepkg -si --noconfirm
29+
# We can now delete the yay folder
30+
cd .. && rm -rf ./yay
31+
```
32+
33+
Next, you can install drop and its dependencies:
34+
35+
```bash
36+
yay -S --noconfirm gnu-free-fonts
37+
yay -S --noconfirm drop-oss-app-bin
38+
```
39+
40+
Once the installation is complete, you will need to export `drop-app` to SteamOS.
41+
42+
```bash
43+
distrobox-export --app drop-app
44+
# Go back to SteamOS
45+
exit
46+
```
47+
48+
The drop-app application should be appear in your application menu.
49+
50+
## Run games
51+
52+
You can start games while in Desktop Mode, but the controller will not be fully working.
53+
It is recommended to add Drop app as a "Non Steam Game" in Steam in Desktop Mode.
54+
Once added, you can go to Gaming Mode and start Drop App from the "Non Steam Games" tab in the library.
55+
It might take a few seconds to startup.
56+
Once loaded, you can use the touch screen to find the game you want to play and then tap "Run".
57+
58+
## Update drop-app
59+
60+
In the terminal, you need to enter the drop-app container and update system packages within in.
61+
62+
```bash
63+
distrobox enter drop-app
64+
yay
65+
exit
66+
```
67+
68+
## Uninstall the drop-app client
69+
70+
The following command will delete the distrobox container and delete the drop-app application from your system.
71+
72+
```bash
73+
distrobox rm drop-app --force
74+
```

0 commit comments

Comments
 (0)