mirror of
https://github.com/EnderIce2/rpc-bridge.git
synced 2025-05-28 15:34:34 +00:00
Compare commits
7 Commits
Author | SHA1 | Date | |
---|---|---|---|
c1078b5b8b | |||
1de80cdbb9 | |||
975ace70f9 | |||
ad076dfac7 | |||
8c54d5bb2f | |||
a0615229ef | |||
18c422101b |
1
.github/workflows/docs.yml
vendored
1
.github/workflows/docs.yml
vendored
@ -35,4 +35,5 @@ jobs:
|
|||||||
restore-keys: |
|
restore-keys: |
|
||||||
mkdocs-material-
|
mkdocs-material-
|
||||||
- run: pip install mkdocs-material
|
- run: pip install mkdocs-material
|
||||||
|
- run: pip install mkdocs-video
|
||||||
- run: mkdocs gh-deploy --force
|
- run: mkdocs gh-deploy --force
|
||||||
|
@ -58,12 +58,14 @@ The steps for MacOS are almost the same, but due to the way `$TMPDIR` works, you
|
|||||||
|
|
||||||
- Download the latest build from the [releases](https://github.com/EnderIce2/rpc-bridge/releases)
|
- Download the latest build from the [releases](https://github.com/EnderIce2/rpc-bridge/releases)
|
||||||
- Open the archive and make the `launchd.sh` script executable by doing: `chmod +x launchd.sh`
|
- Open the archive and make the `launchd.sh` script executable by doing: `chmod +x launchd.sh`
|
||||||
- To **install** the LaunchAgent, run `./launchd install` and to **remove** it simply run `./launchd remove`.
|
- To **install** the LaunchAgent, run `./launchd.sh install` and to **remove** it simply run `./launchd.sh remove`.
|
||||||
|
|
||||||
The script will add a LaunchAgent to your user, that will symlink the `$TMPDIR` directory to `/tmp/rpc-bridge/tmpdir`.
|
The script will add a LaunchAgent to your user, that will symlink the `$TMPDIR` directory to `/tmp/rpc-bridge/tmpdir`.
|
||||||
|
|
||||||
*Note: You will need to launch the `bridge.exe` file manually in Wine at least once for it to register and launch automatically the next time.*
|
*Note: You will need to launch the `bridge.exe` file manually in Wine at least once for it to register and launch automatically the next time.*
|
||||||
|
|
||||||
|
More details on how to install the LaunchAgent can be found in the [documentation](https://enderice2.github.io/rpc-bridge/).
|
||||||
|
|
||||||
## Compiling from source
|
## Compiling from source
|
||||||
|
|
||||||
- Install the `wine`, `gcc-mingw-w64` and `make` packages.
|
- Install the `wine`, `gcc-mingw-w64` and `make` packages.
|
||||||
|
@ -1,4 +1,4 @@
|
|||||||
#! /bin/sh
|
#!/bin/sh
|
||||||
|
|
||||||
# This script is used to run Steam Play with the bridge.
|
# This script is used to run Steam Play with the bridge.
|
||||||
# Usage: /path/to/bridge.sh %command%
|
# Usage: /path/to/bridge.sh %command%
|
||||||
|
@ -1,3 +0,0 @@
|
|||||||
@echo off
|
|
||||||
START /WAIT bridge.exe --install
|
|
||||||
|
|
@ -8,6 +8,16 @@ LOCATION=~/Library/Application\ Support/rpc-bridge
|
|||||||
SCRIPT=$LOCATION/rpc-bridge
|
SCRIPT=$LOCATION/rpc-bridge
|
||||||
AGENT=~/Library/LaunchAgents/com.enderice2.rpc-bridge.plist
|
AGENT=~/Library/LaunchAgents/com.enderice2.rpc-bridge.plist
|
||||||
|
|
||||||
|
function is_installed() {
|
||||||
|
if [ -f "$AGENT" ]; then
|
||||||
|
launchctl list | grep -q "com.enderice2.rpc-bridge"
|
||||||
|
if [ $? -eq 0 ]; then
|
||||||
|
return 0
|
||||||
|
fi
|
||||||
|
fi
|
||||||
|
return 1
|
||||||
|
}
|
||||||
|
|
||||||
function install() {
|
function install() {
|
||||||
# Directories
|
# Directories
|
||||||
if [ ! -d "$SYMLINK" ]; then
|
if [ ! -d "$SYMLINK" ]; then
|
||||||
@ -71,9 +81,16 @@ fi
|
|||||||
|
|
||||||
case $1 in
|
case $1 in
|
||||||
install)
|
install)
|
||||||
|
if is_installed; then
|
||||||
|
echo "LaunchAgent is already installed."
|
||||||
|
exit 0
|
||||||
|
fi
|
||||||
install
|
install
|
||||||
;;
|
;;
|
||||||
remove)
|
remove)
|
||||||
|
if ! is_installed; then
|
||||||
|
echo "LaunchAgent is not installed. Continuing anyway."
|
||||||
|
fi
|
||||||
remove
|
remove
|
||||||
;;
|
;;
|
||||||
*)
|
*)
|
||||||
|
@ -1,3 +0,0 @@
|
|||||||
@echo off
|
|
||||||
START /WAIT bridge.exe --uninstall
|
|
||||||
|
|
35
docs/README.md
Normal file
35
docs/README.md
Normal file
@ -0,0 +1,35 @@
|
|||||||
|
# Documentation
|
||||||
|
|
||||||
|
> **Note:** This documentation is built and deployed using [MkDocs Material](https://squidfunk.github.io/mkdocs-material/) (with mkdocs-video) via GitHub Actions. For the best experience, view it on the [published site](https://enderice2.github.io/rpc-bridge/) or with MkDocs locally. Some features (such as tabs, videos, or special formatting) may not display correctly in plain Markdown viewers.
|
||||||
|
|
||||||
|
This repository contains the documentation for the project. It is written in Markdown and rendered using MkDocs.
|
||||||
|
|
||||||
|
## Getting Started
|
||||||
|
|
||||||
|
To view the documentation locally, install the required Python packages:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
pip install mkdocs mkdocs-material mkdocs-video
|
||||||
|
```
|
||||||
|
|
||||||
|
Once installed, you can serve the documentation locally by running:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
mkdocs serve
|
||||||
|
```
|
||||||
|
|
||||||
|
This will start a local web server and you can view the documentation in your browser at `http://127.0.0.1:8000`.
|
||||||
|
|
||||||
|
## Contributing
|
||||||
|
|
||||||
|
If you want to contribute to the documentation, please follow these steps:
|
||||||
|
|
||||||
|
1. Fork the repository.
|
||||||
|
2. Make your changes in a branch.
|
||||||
|
3. Submit a pull request.
|
||||||
|
|
||||||
|
Please ensure that your changes are consistent with the existing style and structure of the documentation.
|
||||||
|
|
||||||
|
## License
|
||||||
|
|
||||||
|
This documentation is licensed under the MIT License. See the LICENSE file for more information.
|
BIN
docs/assets/macos-crossover.webm
Normal file
BIN
docs/assets/macos-crossover.webm
Normal file
Binary file not shown.
@ -27,6 +27,35 @@ For v1.0, see [the original README](https://github.com/EnderIce2/rpc-bridge/blob
|
|||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
|
## My game is not showing up in Discord
|
||||||
|
|
||||||
|
If your game is not showing up in Discord, please check the following:
|
||||||
|
|
||||||
|
- The game you are playing has [Rich Presence](https://discord.com/developers/docs/rich-presence/overview) support!
|
||||||
|
- Some games may not have this feature. It's up to developers of the game to implement it.
|
||||||
|
This is not an issue related to the bridge.
|
||||||
|
|
||||||
|
- You followed the installation steps correctly.
|
||||||
|
|
||||||
|
- You are using the latest version of the bridge. Currently is .
|
||||||
|
|
||||||
|
### I still want to see the game in Discord!
|
||||||
|
|
||||||
|
This is outside the scope of this project, but here are some workarounds:
|
||||||
|
|
||||||
|
- You can manually add the game to Discord by going to `User Settings >` under `Activity Settings` in `Registered Games` tab. [Official Article](https://support.discord.com/hc/en-us/articles/7931156448919-Activity-Status-Recent-Activity#h_01HTJA8QV5ABSA6FY6GEPMA946)
|
||||||
|
- Tip: You can rename the game to whatever you want.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Compiling from source
|
||||||
|
|
||||||
|
- Install the `wine`, `gcc-mingw-w64` and `make` packages.
|
||||||
|
- Open a terminal in the directory that contains this file and run `make`.
|
||||||
|
- The compiled executable will be located in `build/bridge.exe`.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
## Examples
|
## Examples
|
||||||
|
|
||||||
[**League Of Legends**](https://www.leagueoflegends.com/en-us/) running under Wine using Lutris
|
[**League Of Legends**](https://www.leagueoflegends.com/en-us/) running under Wine using Lutris
|
||||||
|
@ -62,19 +62,6 @@ This method is recommended because it's easier to manage.
|
|||||||
- Globally
|
- Globally
|
||||||
- `flatpak override --user --filesystem=xdg-run/discord-ipc-0`
|
- `flatpak override --user --filesystem=xdg-run/discord-ipc-0`
|
||||||
|
|
||||||
## macOS
|
|
||||||
|
|
||||||
The steps for MacOS are almost the same, but due to the way `$TMPDIR` works, you will have to install a **LaunchAgent**.
|
|
||||||
|
|
||||||
- Download the latest build from the [releases](https://github.com/EnderIce2/rpc-bridge/releases)
|
|
||||||
- Open the archive and make the `launchd.sh` script executable by doing: `chmod +x launchd.sh`
|
|
||||||
- To **install** the LaunchAgent, run `./launchd install` and to **remove** it simply run `./launchd remove`.
|
|
||||||
|
|
||||||
The script will add a LaunchAgent to your user, that will symlink the `$TMPDIR` directory to `/tmp/rpc-bridge/tmpdir`.
|
|
||||||
|
|
||||||
!!! info "Note"
|
|
||||||
You will need to launch the `bridge.exe` file manually in Wine at least once for it to register and launch automatically the next time.
|
|
||||||
|
|
||||||
## Run without installing the service
|
## Run without installing the service
|
||||||
|
|
||||||
If you prefer not to use the service, you can manually run `bridge.exe` within the Wine prefix.
|
If you prefer not to use the service, you can manually run `bridge.exe` within the Wine prefix.
|
||||||
@ -98,10 +85,4 @@ In Lutris, you can achieve this by adding the path to `bridge.exe` in the `Execu
|
|||||||
|
|
||||||
In Wine, all you need to do is run `bridge.exe` and select `Start`.
|
In Wine, all you need to do is run `bridge.exe` and select `Start`.
|
||||||
|
|
||||||
## Compiling from source
|
|
||||||
|
|
||||||
- Install the `wine`, `gcc-mingw-w64` and `make` packages.
|
|
||||||
- Open a terminal in the directory that contains this file and run `make`.
|
|
||||||
- The compiled executable will be located in `build/bridge.exe`.
|
|
||||||
|
|
||||||
[^1]: As requested [here](https://github.com/EnderIce2/rpc-bridge/issues/2).
|
[^1]: As requested [here](https://github.com/EnderIce2/rpc-bridge/issues/2).
|
28
docs/macos.md
Normal file
28
docs/macos.md
Normal file
@ -0,0 +1,28 @@
|
|||||||
|
# Installation
|
||||||
|
|
||||||
|
Installation will copy itself to `C:\windows\bridge.exe` and create a Windows service.
|
||||||
|
Logs are stored in `C:\windows\logs\bridge.log`.
|
||||||
|
|
||||||
|
## Preparing macOS for Installation
|
||||||
|
|
||||||
|
Before proceeding with the installation, you need to set up a **LaunchAgent** due to the way `$TMPDIR` works on macOS.
|
||||||
|
|
||||||
|
- Download the latest build from the [releases](https://github.com/EnderIce2/rpc-bridge/releases).
|
||||||
|
- Open the archive and make the `launchd.sh` script executable by doing: `chmod +x launchd.sh`.
|
||||||
|
- To **install** the LaunchAgent, run `./launchd.sh install` and to **remove** it simply run `./launchd.sh remove`.
|
||||||
|
|
||||||
|
The script will add a LaunchAgent to your user, that will symlink the `$TMPDIR` directory to `/tmp/rpc-bridge/tmpdir`.
|
||||||
|
|
||||||
|
## Video Tutorial on how to install the LaunchAgent + bridge inside CrossOver
|
||||||
|
|
||||||
|
{: style='width: 66%; height: 20vw;'}
|
||||||
|
|
||||||
|
## Wine (~/.wine)
|
||||||
|
|
||||||
|
- Double click `bridge.exe` and click `Install`.
|
||||||
|
- 
|
||||||
|
- To remove, the same process can be followed, but click `Remove` instead.
|
||||||
|
|
||||||
|
## Run without installing the service
|
||||||
|
|
||||||
|
If you prefer not to use the service, you can manually run `bridge.exe` within the prefix, and click on `Start` in the GUI.
|
@ -8,7 +8,7 @@
|
|||||||
- `Install` will install the service.
|
- `Install` will install the service.
|
||||||
- `Remove` will uninstall the service.
|
- `Remove` will uninstall the service.
|
||||||
|
|
||||||
## Commands
|
## CLI
|
||||||
|
|
||||||
- `--help` Show help message
|
- `--help` Show help message
|
||||||
- This will show the help message
|
- This will show the help message
|
||||||
|
16
mkdocs.yml
16
mkdocs.yml
@ -14,22 +14,22 @@ theme:
|
|||||||
palette:
|
palette:
|
||||||
- media: "(prefers-color-scheme)"
|
- media: "(prefers-color-scheme)"
|
||||||
toggle:
|
toggle:
|
||||||
icon: material/weather-sunny
|
icon: material/brightness-auto
|
||||||
name: Switch to light mode
|
name: Switch to dark mode
|
||||||
- media: "(prefers-color-scheme: dark)"
|
- media: "(prefers-color-scheme: dark)"
|
||||||
scheme: slate
|
scheme: slate
|
||||||
primary: black
|
primary: black
|
||||||
accent: indigo
|
accent: indigo
|
||||||
toggle:
|
toggle:
|
||||||
icon: material/brightness-4
|
icon: material/brightness-4
|
||||||
name: Switch to system preference
|
name: Switch to light mode
|
||||||
- media: "(prefers-color-scheme: light)"
|
- media: "(prefers-color-scheme: light)"
|
||||||
scheme: default
|
scheme: default
|
||||||
primary: indigo
|
primary: indigo
|
||||||
accent: indigo
|
accent: indigo
|
||||||
toggle:
|
toggle:
|
||||||
icon: material/brightness-7
|
icon: material/brightness-7
|
||||||
name: Switch to dark mode
|
name: Switch to system preference
|
||||||
font:
|
font:
|
||||||
text: Roboto
|
text: Roboto
|
||||||
code: Roboto Mono
|
code: Roboto Mono
|
||||||
@ -70,7 +70,13 @@ markdown_extensions:
|
|||||||
alternate_style: true
|
alternate_style: true
|
||||||
plugins:
|
plugins:
|
||||||
- offline
|
- offline
|
||||||
|
- mkdocs-video:
|
||||||
|
is_video: true
|
||||||
|
video_controls: true
|
||||||
|
video_loop: false
|
||||||
|
video_muted: false
|
||||||
nav:
|
nav:
|
||||||
- Home: index.md
|
- Home: index.md
|
||||||
- Installation: installation.md
|
- Linux: linux.md
|
||||||
|
- macOS: macos.md
|
||||||
- Usage: usage.md
|
- Usage: usage.md
|
||||||
|
Loading…
x
Reference in New Issue
Block a user