Skip to content

Commit 7245844

Browse files
committed
Document how to make rich presence always work in flatpak
1 parent 9aefb76 commit 7245844

File tree

1 file changed

+21
-4
lines changed

1 file changed

+21
-4
lines changed

docs/desktop/rich-presence.md

+21-4
Original file line numberDiff line numberDiff line change
@@ -38,19 +38,36 @@ Rich Presence works in Windows regardless of how you installed TurboWarp Desktop
3838

3939
### macOS {#mac}
4040

41-
Rich Presence will not work if TurboWarp Desktop was installed from the Mac App Store.
41+
:::warning
42+
Rich Presence will not work if TurboWarp Desktop is installed from the Mac App Store.
43+
:::
4244

4345
### Linux {#linux}
4446

45-
If TurboWarp Desktop was installed as a native app (Debian package/repository, Arch User Repository, AppImage, or extracted tarball) then it will always work. If TurboWarp Desktop was installed using Flatpak then Chat App must also be installed using Flatpak. This table should help clarify:
47+
For best results, install TurboWarp Desktop as a native app using the .deb package, Debian repository, Arch User Repository, AppImage, or tarball. TurboWarp Desktop installed as a Flatpak may require manual permission overrides. TurboWarp Desktop installed as a Snap does not work at all. See the table below for more details:
4648

4749
| | Chat App Native | Chat App Flatpak | Chat App Snap |
4850
| :-: | :-: | :-: | :-: |
4951
| **TurboWarp Desktop Native** ||||
50-
| **TurboWarp Desktop Flatpak** | || |
52+
| **TurboWarp Desktop Flatpak** | See commands below || See commands below |
5153
| **TurboWarp Desktop Snap** ||||
5254

53-
You can check how you installed TurboWarp Desktop by pressing the ? button in the top right corner, opening the About menu, then looking for the Platform section of the Debug Info line. A native installation will be just `linux` while the Flatpak version will show `linux-flatpak` and the Snap version will show `linux-snap`.
55+
For the Flatpak version of TurboWarp Desktop, you may need to run these commands in a terminal and restart TurboWarp Desktop for Rich Presence to function:
56+
57+
```bash
58+
# For Chat App Native
59+
flatpak override org.turbowarp.TurboWarp --user --filesystem=xdg-run/$(printf "\x64\x69\x73\x63\x6f\x72\x64")-ipc-{0..9}
60+
# For Chat App Snap
61+
flatpak override org.turbowarp.TurboWarp --user --filesystem=xdg-run/snap.$(printf "\x64\x69\x73\x63\x6f\x72\x64"):create
62+
```
63+
64+
There is still a small caveat: Rich Presence may not work if TurboWarp Desktop is started before Chat App.
65+
66+
These permissions can be later revoked with:
67+
68+
```bash
69+
flatpak override org.turbowarp.TurboWarp --user --reset
70+
```
5471

5572
### Chat App modifications {#mods}
5673

0 commit comments

Comments
 (0)