mirror of
https://github.com/moraroy/NonSteamLaunchers-On-Steam-Deck.git
synced 2024-12-29 03:01:51 +01:00
361 lines
16 KiB
Markdown
361 lines
16 KiB
Markdown
|
||
<p align="center">
|
||
<img src="https://github.com/cchrkk/NSLOSD-DL/raw/main/logo.svg" width=40% height=auto
|
||
</p>
|
||
|
||
<h1 align="center">
|
||
NonSteamLaunchers 🚀
|
||
</h1>
|
||
|
||
This script installs the latest UMU & GE-Proton and installs NonSteamLaunchers under one unique Proton prefix folder in your compatdata folder path called "NonSteamLaunchers" and adds them to your Steam Library. It will also add the games automatically on every steam restart.
|
||
So you can use them on Desktop or in Game Mode.
|
||
Local Saves and Cloud saves are supported, as well as multiplayer/online support (because youre using the launchers). Obviously, certain anticheat games will not work on linux enviroments; this is on a game to game basis.
|
||
|
||
<h1 align="center">
|
||
Features ✅
|
||
</h1>
|
||
|
||
- Automatic installation of the most popular launchers in your Steam Deck 🎮
|
||
|
||
- Handle automatically the download and installation of your chosen launchers and the games, artwork included! ⌚️
|
||
|
||
- MicroSD Support 💾 This script supports moving the entire prefix to a microSD. The script will install launchers and games to your SD card, and the launchers in Steam will point to the SD card installation. This allows you to save internal storage space on your Steam Deck!
|
||
|
||
- ProtonTricks is compatible with NonSteamLaunchers default installation (one prefix). This will add a NonSteamLaunchers shorcut in your library...this shortcut doesnt do anything. All you have to do is simply "Hide this Game" in your Library. Right click its properties and choose "Manage" and "Hide this Game". You never have to worry about it again! If you were to open up ProtonTricks to fix any game or launcher it is now accessible!
|
||
|
||
- In case you didnt know, you can also choose to check mark "Separate App Id's" when installing a launcher, this will install all launchers in each of their own prefix. Automatically working with ProtonTricks!
|
||
|
||
- Command Line Ready, you can call it from online, heres an example of installing a launcher ``` /bin/bash -c 'curl -Ls https://raw.githubusercontent.com/moraroy/NonSteamLaunchers-On-Steam-Deck/main/NonSteamLaunchers.sh | nohup /bin/bash -s -- "Epic Games"' ```
|
||
|
||
- NSL can in fact be installed on many linux distros, feel free to try, here are some examples of some... Ubuntu LTS, ChimeraOS, Nobara and Arch Linux as well as any KDE Environments such as this opensuse - tumbleweed - wayland , if for any reason you find that NonSteamLaunchers installs perfectly or not, let me know!
|
||
|
||
- RemotePlayWhatever is also bundled with NSL to allow for local and co-op play between non steam games, this is created by m4Engi, here is the repo [here](https://github.com/m4dEngi/RemotePlayWhatever)
|
||
|
||
- Ludusavi is also pre-installed and setup for NSL for your games save backups. Not all games will work with this yet so bare this in mind when deleted or uninstalling games that are arent backed up yet, here is the repo [here](https://github.com/mtkennerly/ludusavi)
|
||
|
||
- UMU Launcher is automatically used and is processed for each game and Launcher. Proton GE will be used where necessary.
|
||
|
||
|
||
<h1 align="center">
|
||
Currently Working On 👷♂️
|
||
</h1>
|
||
|
||
* Decky Loader Plugin is available [here](https://github.com/moraroy/NonSteamLaunchersDecky) and the pull request for it [here](https://github.com/SteamDeckHomebrew/decky-plugin-database/pull/677) and can be installed with this big button
|
||
|
||
<p align="center">
|
||
<a name="download button" href="https://github.com/moraroy/NonSteamLaunchers-On-Steam-Deck/releases/download/v3.9.6/NSLPlugin.desktop"><img src="https://user-images.githubusercontent.com/98482469/242361563-33f31d3d-9a69-4fca-a928-207a5d17a98f.png" alt="Download NSL Decky Plugin" width="350px" style="padding-top: 15px;"></a>
|
||
|
||
---
|
||
|
||
**Windows Installation Steps**:
|
||
|
||
1. **Sign in to GitHub** and go to this [link](https://github.com/SteamDeckHomebrew/decky-loader/actions/workflows/build-win.yml).
|
||
|
||
2. Choose the latest link or whichever version works for you.
|
||
|
||
3. Scroll down to **"Artifacts"** and download **"PluginLoader Win"**. This is a zip file that you need to extract on your Windows machine. Make sure you're signed in to see the download link.
|
||
|
||
4. Download **NSLPluginWindows.exe** from [here](https://github.com/moraroy/NonSteamLaunchersDecky/releases).
|
||
|
||
5. Run **NSLPluginWindows.exe** first. This will also create the necessary cef debugging file for Decky Loader.
|
||
|
||
6. Run either **No_console.exe** or **Plugin Loader.exe**, depending on your preference.
|
||
|
||
7. Go into **Game Mode** or **Big Picture Mode** to see the Decky Loader plugin and NonSteamLaunchers.
|
||
|
||
---
|
||
|
||
This setup will automatically add all your non-Steam games with artwork, correctly formatted for Windows. Only scanning will work; nothing else will function, so you can either auto-scan or manually scan your games.
|
||
|
||
---
|
||
|
||
|
||
<p align="center">
|
||
▶️ YouTube Tutorial 🡺🡺🡺 https://youtu.be/sxMmI8I9G_g 🡸🡸🡸 ▶️
|
||
</p>
|
||
<p align="center">
|
||
📖 Step-by-step Article 🡺🡺🡺 <a href="https://steamdeckhq.com/news/nonsteamlaunchers-adds-scan-support-launchers">here</a> 🡸🡸🡸 📖
|
||
</p>
|
||
|
||
|
||
<h1 align="center">
|
||
Supported Stores 🛍
|
||
</h1>
|
||
|
||
- Amazon Games Launcher ✔️
|
||
- Battle.net ✔️
|
||
- EA App ✔️
|
||
- Epic Games ✔️
|
||
- GOG Galaxy ✔️
|
||
- Humble Games Collection ✔️
|
||
- IndieGala ✔️
|
||
- Itch.io ✔️
|
||
- Legacy Games ✔️
|
||
- Rockstar Games Launcher ✔️
|
||
- Ubisoft Connect ✔️
|
||
- Glyph ✔️
|
||
- Playstation Plus ✔️
|
||
- VK Play ✔️
|
||
- HoYoPlay ✔️
|
||
- Nexon Launcher ✔️
|
||
|
||
<h1 align="center">
|
||
Supported Streaming Sites for games and as well as any website. 🌐
|
||
</h1>
|
||
|
||
- Website Shortcut Creator ✔️
|
||
- Fortnite ✔️
|
||
- Xbox Game Pass ✔️
|
||
- GeForce Now ✔️
|
||
- Amazon Luna ✔️
|
||
- Netflix ✔️
|
||
- Amazon Prime Video ✔️
|
||
- Disney+ ✔️
|
||
- Hulu ✔️
|
||
- Youtube ✔️
|
||
- Twitch ✔️
|
||
|
||
<h1 align="left">
|
||
Finds Games Automatically
|
||
</h1>
|
||
|
||
"NSLGameScanner.service" is also live when you use this script and continues after the script is closed and even works after your Steam Deck has restarted. This works in the background as a service file to automatically add your games to your library on every Steam restart. Currently adds:
|
||
- Epic Games 🎮 💾 Full SD Card Support
|
||
- Ubisoft Connect 🎮
|
||
- EA App 🎮
|
||
- Gog Galaxy 🎮 💾 Full SD Card Support
|
||
- Battle.net 🎮
|
||
- Amazon Games 🎮 💾 Full SD Card Support
|
||
- Itch.io 🎮
|
||
- Legacy Games 🎮
|
||
|
||
To stop the NSLGameScanner.service, open up NSL and hit "Stop NSLGameScanner" it will then ask you if you want to restart it, click no, and that's it.
|
||
|
||
<h1 align="center">
|
||
How to Install the Desktop Version 🔧
|
||
</h1>
|
||
|
||
<p align="center">
|
||
<a name="download button" href="https://github.com/moraroy/NonSteamLaunchers-On-Steam-Deck/releases/download/v3.9.1/NonSteamLaunchers.desktop"><img src="https://user-images.githubusercontent.com/98482469/242361563-33f31d3d-9a69-4fca-a928-207a5d17a98f.png" alt="Download NonSteamLaunchers" width="350px" style="padding-top: 15px;"></a>
|
||
</p>
|
||
<!--- Thanks https://github.com/Heus-Sueh -->
|
||
|
||
* Go to desktop mode, click the download button above and it should download the .desktop file in your Downloads folder.
|
||
* Go to your downloads folder, click the NonSteamLaunchers icon, it will download and run the latest NonSteamLaunchers.sh from this repository and run it.
|
||
* You will simply have to choose which launcher to install and let the script handle the rest. 💻 No files are left in your "Downloads" they are deleted after installation.
|
||
* After running the script, launch Steam on your Steam Deck. You'll find the new launchers in your library under the non-steam tab. Click a launcher to see your installed games from that store, and launch them directly from Steam! If you have downloaded a game inside of your launcher, restart your Deck or quit and reopen Steam and the NSLGameScanner.service should add it to your library, even in gamemode! 🥳
|
||
|
||
<!--- TODO: handful of broken icons (cf. 🡺🡺🡺 ); probably should remove or replace them with more common font to handle unicode-->
|
||
|
||
|
||
|
||
<h1 align="center">
|
||
How to Uninstall 🗑
|
||
</h1>
|
||
|
||
+ Just run the script, and hit "Uninstall". This will uninstall the launcher and its games. Alternatively, if you want to totally wipe everything from NonSteamLaunchers, click "Start Fresh".
|
||
+ That's it.
|
||
|
||
<h1 align="center">
|
||
Command Lines 🫡
|
||
</h1>
|
||
The NSL script can be called from online via bash, heres an example of it installing a launcher
|
||
|
||
```/bin/bash -c 'curl -Ls https://raw.githubusercontent.com/moraroy/NonSteamLaunchers-On-Steam-Deck/main/NonSteamLaunchers.sh | nohup /bin/bash -s -- "Epic Games"'```
|
||
|
||
|
||
- All launchers can be installed by calling their name like this ```"Epic Games"``` ```"Ubisoft Connect"``` etc.
|
||
- All launchers can be uninstalled by calling their name like this ```"Uninstall Epic Games"``` ```"Uninstall Ubisoft Connect"``` etc.
|
||
- Here is the list of commands that can also be called
|
||
|
||
- ```"Start Fresh"``` ```"Update Proton-GE"``` ```"Stop NSLGameScanner"``` ```"Move to SD Card"```
|
||
|
||
- The "Move to SD Card" function can only be called in this format
|
||
|
||
```/bin/bash -c 'curl -Ls https://raw.githubusercontent.com/moraroy/NonSteamLaunchers-On-Steam-Deck/main/NonSteamLaunchers.sh | nohup /bin/bash -s -- "Move to SD Card" "EpicGamesLauncher"```
|
||
|
||
- The format of "EpicGamesLauncher" comes from the user choosing to either "Separate App ID's" or use the default installation prefix "NonSteamLaunchers" in the compatdata folder. This would be named differently for each launcher. Otherwise the command line would then only be
|
||
|
||
```/bin/bash -c 'curl -Ls https://raw.githubusercontent.com/moraroy/NonSteamLaunchers-On-Steam-Deck/main/NonSteamLaunchers.sh | nohup /bin/bash -s -- "Move to SD Card" "NonSteamLaunchers"```
|
||
|
||
|
||
|
||
|
||
<h1 align="center">
|
||
Contributing 🤝
|
||
</h1>
|
||
|
||
If you have any suggestions or improvements for this script, feel free to open an issue or submit a pull request.
|
||
|
||
You can donate to me on [ko-fi](https://ko-fi.com/moraroy), [liberapay](https://liberapay.com/moraroy), or [sponsor me on github](https://github.com/sponsors/moraroy) or [patreon](https://patreon.com/moraroy)
|
||
|
||
## Development Environment
|
||
|
||
### Dev Container
|
||
|
||
Install [Docker](https://docs.docker.com/compose/install/). Once installed, a clean dev environment with a Docker container [native to VSCode](https://code.visualstudio.com/docs/devcontainers/create-dev-container#_dockerfile) is spun up automatically.
|
||
|
||
* [Command palette](https://code.visualstudio.com/docs/getstarted/userinterface#_command-palette) (⇧⌘P) > Dev Containers: Reopen in Container
|
||
* F5 for debug
|
||
* May need to select interpreter (e.g., `/opt/venv/bin/python`) first
|
||
|
||
**VSCode Extensions (Dev Container)**
|
||
|
||
* [Atom Keymap](https://marketplace.visualstudio.com/items?itemName=ms-vscode.atom-keybindings)
|
||
* [Bash IDE](https://marketplace.visualstudio.com/items?itemName=mads-hartmann.bash-ide-vscode)
|
||
* [Better Comments](https://marketplace.visualstudio.com/items?itemName=aaron-bond.better-comments)
|
||
* [Docker](https://marketplace.visualstudio.com/items?itemName=ms-azuretools.vscode-docker)
|
||
* [EditorConfig](https://marketplace.visualstudio.com/items?itemName=EditorConfig.EditorConfig)
|
||
* [GitHub Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot)
|
||
* [GitHub Copilot Chat](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot-chat)
|
||
* [gitignore](https://marketplace.visualstudio.com/items?itemName=codezombiech.gitignore)
|
||
* [GitLens](https://marketplace.visualstudio.com/items?itemName=eamodio.gitlens)
|
||
* [Markdown All in One](https://marketplace.visualstudio.com/items?itemName=yzhang.markdown-all-in-one)
|
||
* [MS Visual Studio Live Share](https://marketplace.visualstudio.com/items?itemName=MS-vsliveshare.vsliveshare)
|
||
* [Python](https://marketplace.visualstudio.com/items?itemName=ms-python.python)
|
||
* [Shellcheck](https://marketplace.visualstudio.com/items?itemName=timonwong.shellcheck)
|
||
|
||
### Manual Docker Instance
|
||
|
||
If VSCode isn't present or only the python portion (cf. `__init__.py`) is being worked on, it's possible to just run a Docker container on its own. The container installs the correct version of python and any dependencies (e.g., ipython, rich) in `requirements.txt`.
|
||
|
||
```bash
|
||
# navigate to directory with Dockerfile
|
||
cd .devcontainer/
|
||
|
||
# build image
|
||
docker build -t nonsteamlaunchers .
|
||
|
||
# run container
|
||
docker run -it --rm --name=mynonsteamlaunchers --workdir=/app -v $(pwd):/app nonsteamlaunchers bash
|
||
|
||
# exit container
|
||
exit
|
||
```
|
||
|
||
### Python virtual environment
|
||
|
||
Useful for the python module(s), but extra compared to the [dev container](#dev-container) portion that covers the core shell script.
|
||
|
||
```bash
|
||
# create virtual environment
|
||
python -m venv .venv
|
||
|
||
# activate virtual environment
|
||
source .venv/bin/activate
|
||
|
||
# install dependencies
|
||
python -m pip install -r requirements.txt
|
||
```
|
||
|
||
### Pre-commit hooks
|
||
|
||
Pre-commit hooks are installed via `pre-commit` and are run automatically on `git commit`.
|
||
|
||
Most importantly, `ruff` is used to lint all python code.
|
||
|
||
* Install [pre-commit](https://pre-commit.com/#install)
|
||
* Install pre-commit hooks
|
||
```bash
|
||
pre-commit install
|
||
```
|
||
* Trigger pre-commit hooks automatically on `git commit`
|
||
```bash
|
||
git add .
|
||
git commit -m "commit message"
|
||
```
|
||
* Bypass pre-commit hooks
|
||
* Sometimes, it's necessary to bypass pre-commit hooks. This can be done with the `--no-verify` flag.
|
||
```bash
|
||
git commit -m "commit message" --no-verify
|
||
```
|
||
|
||
### Conventional Commits
|
||
|
||
While not currently enforced, by using [conventional commits](https://www.conventionalcommits.org/en/v1.0.0/#summary), it's possible to automatically generate changelogs and version numbers via [release-please](https://github.com/googleapis/release-please).
|
||
|
||
To help with that, the [commitizen](https://commitizen-tools.github.io/commitizen/) tool can be installed.
|
||
|
||
#### Usage
|
||
|
||
```bash
|
||
# install cz
|
||
npm install -g commitizen cz-conventional-changelog
|
||
|
||
# make repo cz friendly
|
||
commitizen init cz-conventional-changelog --save-dev --save-exact
|
||
npm install
|
||
|
||
# add file to commit
|
||
git add .gitignore
|
||
|
||
# run cz
|
||
λ git cz
|
||
cz-cli@4.3.0, cz-conventional-changelog@3.3.0
|
||
|
||
? Select the type of change that you're committing: chore: Other changes that don't modify src or test files
|
||
? What is the scope of this change (e.g. component or file name): (press enter to skip) .gitignore
|
||
? Write a short, imperative tense description of the change (max 81 chars):
|
||
(17) update .gitignore
|
||
? Provide a longer description of the change: (press enter to skip)
|
||
|
||
? Are there any breaking changes? No
|
||
? Does this change affect any open issues? No
|
||
[main 0a9920d] chore(.gitignore): update .gitignore
|
||
1 file changed, 131 insertions(+)
|
||
|
||
λ git push
|
||
```
|
||
|
||
### Formatting
|
||
|
||
> **TL;DR**: The [Ruff formatter](https://astral.sh/blog/the-ruff-formatter) is an extremely fast Python formatter, written in Rust. It’s over 30x faster than Black and 100x faster than YAPF, formatting large-scale Python projects in milliseconds — all while achieving >99.9% Black compatibility.
|
||
|
||
* While it runs automatically on commits, it can also be run manually
|
||
```bash
|
||
# check for errors
|
||
ruff check .
|
||
|
||
# fix (some) errors automatically
|
||
ruff check . --fix
|
||
```
|
||
|
||
### Additional tooling
|
||
|
||
#### TODO
|
||
|
||
* Add [devbox](https://www.jetpack.io/devbox/) 👌
|
||
|
||
#### asdf
|
||
|
||
* Install [asdf](https://asdf-vm.com/guide/getting-started.html#_2-download-asdf)
|
||
* Add plugins
|
||
```bash
|
||
asdf plugin-add python
|
||
asdf plugin-add poetry https://github.com/asdf-community/asdf-poetry.git
|
||
asdf plugin add nodejs https://github.com/asdf-vm/asdf-nodejs.git
|
||
```
|
||
* Usage
|
||
* Install local plugins in repo
|
||
```bash
|
||
asdf install
|
||
```
|
||
* Install specific plugins
|
||
```bash
|
||
# install stable python
|
||
asdf install python <latest|3.11.4>
|
||
|
||
# set stable to system python
|
||
asdf global python latest
|
||
```
|
||
|
||
#### shellcheck
|
||
|
||
`.shellcheckrc` excludes various [bash language rules](https://github.com/koalaman/shellcheck/wiki/Ignore#ignoring-one-or-more-types-of-errors-forever). Useful to control noise vs. legitimate warnings/errors when using the shellcheck extension.
|
||
|
||
<h1 align="center">
|
||
License 📝
|
||
</h1>
|
||
|
||
This project is licensed under the MIT License. See the `LICENSE` file for more information.
|