Skip to content

Commit f21c27e

Browse files
committed
feat: add proton config info
1 parent d0baf5b commit f21c27e

3 files changed

Lines changed: 66 additions & 0 deletions

File tree

astro.config.mjs

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -32,6 +32,10 @@ export default defineConfig({
3232
label: "Install",
3333
autogenerate: { directory: "user/install" },
3434
},
35+
{
36+
label: "Usage",
37+
items: [{ slug: "user/usage/proton" }],
38+
},
3539
],
3640
},
3741
{
51.6 KB
Loading
Lines changed: 62 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,62 @@
1+
---
2+
title: Proton
3+
description: Use Proton to run your Windows game on Linux at near-native speeds.
4+
---
5+
6+
Drop's Proton configuration depends on:
7+
8+
- UMU launcher (more specifically the `umu-run` binary)
9+
- **another application** to download and manage Proton versions
10+
11+
## Installing UMU launcher
12+
13+
Install UMU launcher through their own guide on [their GitHub repo](https://github.com/Open-Wine-Components/umu-launcher?tab=readme-ov-file#packaging). It covers packaging for a variety of distro. If you're not covered, give it a Google search, or open an issue on GitHub or Discord and we'll try to help you.
14+
15+
To check it's installed, try running `umu-run` from your terminal.
16+
17+
:::note
18+
If you're using Distrobox, it might be a little more complicated to install.
19+
20+
If you've installed it **outside** of Distrobox (recommended), it should work out of the box.
21+
22+
If you've install it **inside** of Distrobox, you'll have to export it, and figure out how to pass through your GPU and drivers.
23+
:::
24+
25+
## Downloading other Proton versions
26+
27+
You can download other Proton versions from a variety of sources:
28+
29+
- Directly from the project, typically in a GitHub release
30+
- Through Steam, which downloads official Proton versions
31+
- 3rd-party application
32+
33+
For the 3rd-party application, we recommend [ProtonUp-Qt](https://github.com/DavidoTek/ProtonUp-Qt), an open-source GUI application that supports quite a few different versions of Proton.
34+
35+
## Detecting Proton versions
36+
37+
Drop searches the following places for Proton versions:
38+
39+
- `/usr/share/steam/compatibilitytools.d/`
40+
- `~/.steam/root/compatibilitytools.d/`
41+
42+
Most applications support reading and writing to these directories for Proton versions, as they're Steam directories.
43+
44+
Drop can also pick up other Proton versions, if you manually add them.
45+
46+
:::note
47+
To be discovered by Drop, the folder you provide, or any folder in one of the above directories **must**:
48+
49+
- have the `proton` binary
50+
- have a `compatibilitytool.vdf` file
51+
52+
:::
53+
54+
## Using Proton versions
55+
56+
:::caution
57+
To launch any Windows game, you **must** first set a default Proton version.
58+
:::
59+
60+
Drop uses a global default Proton version to launch games by default. You can override this in a game's options.
61+
62+
![Screenshot showing how to override the proton version](./proton-options-override.png)

0 commit comments

Comments
 (0)