Skip to content

Commit fd2665d

Browse files
authored
Merge pull request #88 from PiterWeb/main
Pre release 0.9.9
2 parents 6d8c761 + 2d48324 commit fd2665d

File tree

86 files changed

+3069
-12160
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

86 files changed

+3069
-12160
lines changed

.gitignore

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,4 @@
1+
.task/
12
build/
23
/*.exe
34
/*.dll

CONTRIBUTING.md

Lines changed: 6 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@
77
- docs/ (All the development documentation)
88
- frontend/src/lib/i18n (All the translations of the project)
99

10-
## Requisites
10+
## Requisites (only apply to code contributions)
1111
- If you want to contribute first you need to check the issues, them if you like any of the open issues work on it and merge it to the project (obviously you can open a new issue to enhance the features or correct any bug you found to work on it later)
1212
- Try to do self-explanatory code (if cannot be you can comment to enhance the comprehension)
1313

@@ -16,6 +16,8 @@
1616
- [LibreRemotePlay Docs](./docs/README.md)
1717
- [How to run the project](./README.md#run-dev)
1818
- [How to build the project](./README.md#build)
19+
- [LibreRemotePlay Wiki](https://github.com/PiterWeb/LibreRemotePlay/wiki)
20+
- [LibreRemotePlay DeepWiki](https://deepwiki.com/PiterWeb/LibreRemotePlay)
1921

2022
## How to
2123

@@ -28,13 +30,15 @@
2830

2931
## Translations 🔠
3032

33+
By default English is the language of reference so you can check if there are entries in english that are missing in the language you may want to contribute to
34+
3135
### How to
3236

3337
1. Fork this repository
3438
2. Clone it
3539
3. Work on your translations (located in frontend/src/lib/i18n):
3640
- Create a JSON file of the language and register the language in the i18n.ts file (all of this if the language is not added already)
37-
- Add the entries (you can do manually or using [i18n Ally extension](https://marketplace.visualstudio.com/items?itemName=Lokalise.i18n-ally))
41+
- Add the entries (you can do manually but using [i18n Ally extension](https://marketplace.visualstudio.com/items?itemName=Lokalise.i18n-ally) is recommended)
3842
5. When you have finished make a pull request to merge it with the main branch
3943
6. Wait for merge
4044
7. Done

README.md

Lines changed: 37 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
![LibreRemotePlay logo banner](https://github.com/user-attachments/assets/9173246d-1d65-4f29-bd79-0206250c538c)
1+
![LibreRemotePlay logo banner](./assets/libreremoteplaybanner.webp)
22

33
[![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/PiterWeb/LibreRemotePlay)
44

@@ -7,6 +7,10 @@
77
> [!IMPORTANT]
88
> The software for the moment is very experimental, may not always work an all systems. If you find a bug you can report it on issues page or discord.
99
10+
> [!NOTE]
11+
> If you are interested in contributing (code/translations) you can follow [this guide](./CONTRIBUTING.md)
12+
13+
1014
### An open source, free (as in freedom) and P2P alternative to Steam Remote Play
1115

1216
- Website 🌐: https://libreremoteplay.vercel.app/
@@ -16,6 +20,8 @@
1620
- Discord Community 👥: https://discord.gg/v7qd7nU3fJ
1721

1822
- Series of WebRTC Articles 👨‍💻: https://dev.to/piterweb/series/30718
23+
24+
- Codeberg Mirror 🗃️: https://codeberg.org/PiterWeb/LibreRemotePlay
1925

2026
## Use cases ✨
2127

@@ -29,7 +35,7 @@
2935
## Resources 📚
3036

3137
- [Docs](./docs/) 📘
32-
- [Linux Docs](./docs/LINUX.md) 📘
38+
- [Linux Docs](https://github.com/PiterWeb/LibreRemotePlay/wiki/installation-&-execution#execute-in-linux) 📘
3339
- [Wiki](https://github.com/PiterWeb/LibreRemotePlay/wiki) (Guides, FAQ, ...)
3440
- [Discord Community](https://discord.gg/v7qd7nU3fJ)
3541

@@ -42,18 +48,26 @@ https://github.com/user-attachments/assets/f4a412fa-f403-4429-85fb-9c1e74bff458
4248

4349
## Features 🧩
4450

45-
- [x] Portable
46-
- [x] Simple & Modern UI
47-
- [x] Interactive Tutorial
48-
- [x] Peer-to-Peer (WebRTC)
51+
- [x] FOSS (Free & Open Source Software)
52+
- [x] Gamepad support (See the table below)
53+
- [x] Portable (No installations needed)
54+
- [x] Privacy-friendly (No data collected in APP / Client website)
55+
- [x] Based on Europe: Developed mainly by me (PiterWeb) from Spain
56+
- [x] Simple & modern UI
57+
- [x] Includes an interactive tour through the application
58+
- [x] Peer to Peer connections (WebRTC)
59+
- [x] LAN mode (It is not necessary to use the Internet)
4960
- [ ] Groups
5061
- [x] Remote Video Streaming
51-
- [x] Video Quality Config
52-
- [x] Browser Client
53-
- [x] Localization (translation to multiple languages)
54-
- [x] Support for custom STUN & TURN servers
55-
- [x] Keyboard (Experimental)
56-
- [x] Toogle Devices
62+
- [x] Stream video quality Config (Codecs, FPS, resolution)
63+
- [ ] WHIP streaming compatibility (Stream your screen using: Gstreamer, OBS, ...)
64+
- [x] Client role works on browser
65+
- [x] Translated to multiple languages
66+
- [x] You can customize the STUN & TURN servers
67+
- [x] Keyboard support (Experimental)
68+
- [ ] Mouse support
69+
- [x] Toogle gamepad/keyboard access
70+
- [x] [EasyConnect](https://github.com/PiterWeb/LibreRemotePlayEasyConnectServer)
5771

5872
### OS Support 💻
5973

@@ -75,12 +89,14 @@ https://github.com/user-attachments/assets/f4a412fa-f403-4429-85fb-9c1e74bff458
7589

7690
## Self Hosting ☁
7791

78-
There is no way to self-host the infrastructure of LibreRemotePlay because it has no backend. But instead you can self-host if you want the TURN & STUN servers and then add them to the config.
92+
There is no way to self-host the infrastructure of LibreRemotePlay because it has no backend. But instead you can self-host if you want the TURN & STUN servers and then add them to the config or the [EasyConnectServer](https://github.com/PiterWeb/LibreRemotePlayEasyConnectServer).
7993

8094
- If you want to self-host a TURN/STUN server you can [try Coturn](https://github.com/coturn/coturn). (This is only an example, you can choose other STUN/TURN implementations)
8195

8296
- Also you can host the Web version (but it is only frontend, so is not very usefull)
8397

98+
- If you want to self-host an EasyConnectServer you can follow the docs of [EasyConnectServer repo](https://github.com/PiterWeb/LibreRemotePlayEasyConnectServer), this service is also packed in the desktop app and run in app startup but instead you can launch it along. EasyConnectServer is a signaling server that makes code passing in an automatic way.
99+
84100
## Run Dev
85101

86102
### Prerequisites
@@ -160,6 +176,14 @@ These projects are making LibreRemotePlay a reality.
160176
## Did you like the project 👍 ?
161177
You can give us a star and join our [Discord Community](https://discord.gg/v7qd7nU3fJ), the project is always looking for feedback :)
162178

179+
## Are you interested in other gaming projects 🤔?
180+
181+
<br/>
182+
<img width="128" height="128" alt="logo of gamelinksafe cli" src="https://github.com/user-attachments/assets/615bfb59-7f1c-4e9d-8e84-c9368e92f2f7" />
183+
184+
You may be interested in [GameLinkSafeCLI](https://github.com/PiterWeb/GameLinkSafeCLI) is like ngrok but works with TCP/UDP without account and no need to self-host in normal enviroments.
185+
Can be used like a hamachi alternative for gamers who are familiar with CLIs.
186+
163187
## Star History
164188
Here you can see how fast the community is growing
165189
<br/>

Taskfile.yml

Lines changed: 49 additions & 31 deletions
Original file line numberDiff line numberDiff line change
@@ -1,69 +1,87 @@
11
version: '3'
22

33
tasks:
4-
build-front:
4+
dev-all:
5+
deps: [build-front]
6+
cmds:
7+
- wails dev
8+
desc: Run the application in development mode
9+
dev-front:
510
dir: frontend
11+
deps: [install-front]
612
cmds:
7-
- pnpm install
8-
- pnpm run build
9-
desc: Build the frontend
13+
- pnpm run dev
14+
desc: Run the frontend in development mode
1015
build:
1116
deps: [build-front]
1217
cmds:
13-
- wails build -s -platform=windows/amd64,windows/arm64,linux/amd64,linux/arm64
18+
- wails build -s -platform=windows/amd64,linux/amd64
1419
desc: Build the application for all platforms
1520
build-win:
1621
deps: [build-front]
1722
cmds:
18-
- wails build -s -platform=windows/amd64,windows/arm64
23+
- wails build -s -platform=windows/amd64
1924
desc: Build the application for Windows
2025
build-debug-win:
2126
deps: [build-front]
2227
cmds:
23-
- wails build -debug -s -platform=windows/amd64,windows/arm64
28+
- wails build -debug -s -platform=windows/amd64
2429
desc: Build the debug application for Windows
2530
build-linux:
2631
deps: [build-front]
2732
cmds:
28-
- wails build -s -platform=linux/amd64,linux/arm64
33+
- wails build -s -platform=linux/amd64
2934
desc: Build the application for Linux
3035
build-debug-linux:
3136
deps: [build-front]
3237
cmds:
33-
- wails build -debug -s -platform=linux/amd64,linux/arm64
38+
- wails build -debug -s -platform=linux/amd64
3439
desc: Build the debug application for Linux
3540
build-linux-appimage:
41+
deps: [build-linux]
3642
cmds:
3743
- wget https://github.com/linuxdeploy/linuxdeploy/releases/download/continuous/linuxdeploy-x86_64.AppImage
3844
- chmod +x linuxdeploy-x86_64.AppImage
3945
- wget -c "https://raw.githubusercontent.com/linuxdeploy/linuxdeploy-plugin-gtk/master/linuxdeploy-plugin-gtk.sh"
4046
- chmod +x linuxdeploy-plugin-gtk.sh
41-
- ./linuxdeploy-x86_64.AppImage --appdir AppDir --desktop-file assets/LibreRemotePlay.desktop --executable build/bin/LibreRemotePlay-linux-amd64 --plugin gtk -i assets/remotecontroller.png -d assets/LibreRemotePlay.desktop --output appimage
42-
desc: Build AppImage for Linux based on previously generated binaries
43-
build-wasm-front-linux:
44-
dir: frontend/static/wasm
45-
cmds:
46-
- GOOS=js GOARCH=wasm go build -o signal.wasm
47-
desc: Build the frontend wasm for Linux
48-
build-wasm-front-win:
47+
- ./linuxdeploy-x86_64.AppImage --appdir AppDir --desktop-file assets/LibreRemotePlay.desktop --executable build/bin/LibreRemotePlay --plugin gtk -i assets/remotecontroller.png -d assets/LibreRemotePlay.desktop --output appimage
48+
desc: (Experimental) Build AppImage for Linux based on previously generated binaries (wget required)
49+
build-wasm-front:
4950
dir: frontend/static/wasm
51+
env:
52+
GOOS: js
53+
GOARCH: wasm
5054
cmds:
51-
- powershell.exe -Command { $env:GOOS="js";$env:GOARCH="wasm"; go build -o signal.wasm }
52-
desc: Build the frontend wasm for Windows
53-
dev-all:
54-
deps: [build-front]
55-
cmds:
56-
- wails dev
57-
desc: Run the application in development mode
58-
dev-front:
59-
dir: frontend
60-
deps: [build-front]
61-
cmds:
62-
- pnpm run dev
63-
desc: Run the frontend in development mode
55+
- go build -o signal.wasm
56+
desc: Build the frontend wasm
57+
sources:
58+
- signal.wasm
6459
test:
6560
desc: Run E2E tests
6661
dir: frontend
6762
deps: [dev-all]
6863
cmds:
69-
- pnpm run test
64+
- pnpm run test
65+
install-front:
66+
dir: frontend
67+
cmds:
68+
- pnpm install
69+
sources:
70+
- package.json
71+
status:
72+
- test -d node_modules
73+
build-front:
74+
deps: [install-front, build-wasm-front]
75+
dir: frontend
76+
cmds:
77+
- pnpm run build
78+
sources:
79+
- src/**/*.js
80+
- src/**/*.ts
81+
- src/**/*.svelte
82+
- src/**/*.json
83+
- vite.config.ts
84+
- svelte.config.js
85+
- tailwind.config.js
86+
- package.json
87+
desc: Build the frontend
96.9 KB
Loading
349 KB
Binary file not shown.

assets/libreremoteplaybanner.jpg

21.1 KB
Loading

assets/libreremoteplaybanner.kra

-531 KB
Binary file not shown.

assets/libreremoteplaybanner.psd

229 KB
Binary file not shown.

assets/libreremoteplaybanner.webp

27.9 KB
Loading

0 commit comments

Comments
 (0)