-
Notifications
You must be signed in to change notification settings - Fork 0
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
1 parent
0d9bbc7
commit b4d8ff9
Showing
6 changed files
with
163 additions
and
24 deletions.
There are no files selected for viewing
This file was deleted.
Oops, something went wrong.
Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.
Oops, something went wrong.
This file was deleted.
Oops, something went wrong.
Large diffs are not rendered by default.
Oops, something went wrong.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,156 @@ | ||
| <!DOCTYPE html> | ||
| <html lang="en-US"><head> | ||
| <meta http-equiv="content-type" content="text/html; charset=UTF-8"> | ||
| <meta charset="UTF-8"> | ||
| <meta http-equiv="X-UA-Compatible" content="IE=edge"> | ||
| <meta name="viewport" content="width=device-width, initial-scale=1"> | ||
|
|
||
| <!-- Begin Jekyll SEO tag v2.8.0 --> | ||
| <title>Jagex Launcher Flatpak | jagex-launcher-flatpak</title> | ||
| <meta name="generator" content="Jekyll v3.9.3"> | ||
| <meta property="og:title" content="Jagex Launcher Flatpak"> | ||
| <meta property="og:locale" content="en_US"> | ||
| <link rel="canonical" href="https://jagexlauncher.flatpak.mcswain.dev/"> | ||
| <meta property="og:url" content="https://jagexlauncher.flatpak.mcswain.dev/"> | ||
| <meta property="og:site_name" content="jagex-launcher-flatpak"> | ||
| <meta property="og:type" content="website"> | ||
| <meta name="twitter:card" content="summary"> | ||
| <meta property="twitter:title" content="Jagex Launcher Flatpak"> | ||
| <script type="application/ld+json"> | ||
| {"@context":"https://schema.org","@type":"WebSite","headline":"Jagex Launcher Flatpak","name":"jagex-launcher-flatpak","url":"https://jagexlauncher.flatpak.mcswain.dev/"}</script> | ||
| <!-- End Jekyll SEO tag --> | ||
|
|
||
| <style class="anchorjs"></style><link rel="stylesheet" href="assets/style.css"> | ||
| </head> | ||
| <body data-extension-installed="2.1.4"> | ||
| <div class="container-lg px-3 my-5 markdown-body"> | ||
|
|
||
| <h1><a href="https://jagexlauncher.flatpak.mcswain.dev/">jagex-launcher-flatpak</a></h1> | ||
|
|
||
|
|
||
| <h1 id="jagex-launcher-flatpak">Jagex Launcher Flatpak</h1> | ||
|
|
||
| <p><a href="https://jagexlauncher.flatpak.mcswain.dev/com.jagex.Launcher.flatpakref" class="btn">Click to install</a></p> | ||
|
|
||
| <p>This is a Flatpak package for the Jagex Launcher. It packages the <a href="#why-this-flatpak-as-opposed-to-other-available-options">official upstream Wine at the latest version</a>, RuneLite, and the Jagex Launcher.</p> | ||
|
|
||
| <h2 id="installation">Installation<a class="anchorjs-link " href="#installation" aria-label="Anchor" data-anchorjs-icon="" style="font: 1em / 1 anchorjs-icons; padding-left: 0.375em;"></a></h2> | ||
|
|
||
| <h3 id="installing-the-launcher">Installing the Launcher<a class="anchorjs-link " href="#installing-the-launcher" aria-label="Anchor" data-anchorjs-icon="" style="font: 1em / 1 anchorjs-icons; padding-left: 0.375em;"></a></h3> | ||
|
|
||
| <p>It is unlikely that Flathub would accept a proprietary application | ||
| like the Jagex Launcher, paricularly one that is wrapped in Wine. As | ||
| such, this Flatpak is not available on Flathub.</p> | ||
|
|
||
| <h3 id="flatpak-remote">Flatpak Remote<a class="anchorjs-link " href="#flatpak-remote" aria-label="Anchor" data-anchorjs-icon="" style="font: 1em / 1 anchorjs-icons; padding-left: 0.375em;"></a></h3> | ||
|
|
||
| <p>You can install it by adding the remote and installing it with the following commands:</p> | ||
|
|
||
| <div class="language-bash highlighter-rouge"><div class="highlight"><pre class="highlight"><code>flatpak remote-add <span class="nt">--if-not-exists</span> JagexLauncher https://jagexlauncher.flatpak.mcswain.dev/.flatpakrepo | ||
| flatpak <span class="nb">install</span> <span class="nt">--user</span> JagexLauncher com.jagex.Launcher | ||
| </code></pre></div></div> | ||
|
|
||
| <h3 id="manual-download">Manual Download<a class="anchorjs-link " href="#manual-download" aria-label="Anchor" data-anchorjs-icon="" style="font: 1em / 1 anchorjs-icons; padding-left: 0.375em;"></a></h3> | ||
|
|
||
| <p>You can install it by downloading the <a href="https://github.com/USA-RedDragon/jagex-launcher-flatpak/releases/latest">latest release</a> and installing it with the following command:</p> | ||
|
|
||
| <div class="language-bash highlighter-rouge"><div class="highlight"><pre class="highlight"><code>flatpak <span class="nb">install</span> <span class="nt">--user</span> com.jagex.Launcher.flatpak | ||
| </code></pre></div></div> | ||
|
|
||
| <h3 id="nvidia-gpu-drivers">Nvidia GPU Drivers<a class="anchorjs-link " href="#nvidia-gpu-drivers" aria-label="Anchor" data-anchorjs-icon="" style="font: 1em / 1 anchorjs-icons; padding-left: 0.375em;"></a></h3> | ||
|
|
||
| <p>If you are using the Nvidia proprietary drivers, you will need to install the drivers.</p> | ||
|
|
||
| <p>If you’re not sure which version of the driver you’re on, you can check the <code class="language-plaintext highlighter-rouge">/proc/driver/nvidia/version</code> file. If it doesn’t exists, you’re probably using the Nouveau drivers. If it does exist, here is an example of the output:</p> | ||
|
|
||
| <div class="language-bash highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span><span class="nb">cat</span> /proc/driver/nvidia/version | ||
| NVRM version: NVIDIA UNIX x86_64 Kernel Module 545.29.02 Thu Oct 26 21:21:38 UTC 2023 | ||
| GCC version: gcc version 13.2.1 20230801 <span class="o">(</span>GCC<span class="o">)</span> | ||
| </code></pre></div></div> | ||
|
|
||
| <p>In this case the driver version is <code class="language-plaintext highlighter-rouge">545.29.02</code>. | ||
| You can then install the appropriate drivers with the following | ||
| command, replacing the version with the version you found in the | ||
| previous step:</p> | ||
|
|
||
| <div class="language-bash highlighter-rouge"><div class="highlight"><pre class="highlight"><code>flatpak <span class="nb">install</span> <span class="nt">--user</span> flathub org.freedesktop.Platform.GL.nvidia-545-29-02/x86_64 | ||
| flatpak <span class="nb">install</span> <span class="nt">--user</span> flathub org.freedesktop.Platform.GL32.nvidia-545-29-02/x86_64 | ||
| </code></pre></div></div> | ||
|
|
||
| <h2 id="why-no-alt1-toolkit">Why no Alt1 Toolkit?<a class="anchorjs-link " href="#why-no-alt1-toolkit" aria-label="Anchor" data-anchorjs-icon="" style="font: 1em / 1 anchorjs-icons; padding-left: 0.375em;"></a></h2> | ||
|
|
||
| <p>The Alt1 Toolkit uses child window rendering that isn’t yet supported by Wine. See <a href="https://bugs.winehq.org/show_bug.cgi?id=45277">this issue</a> for more information.</p> | ||
|
|
||
| <h2 id="why-this-flatpak-as-opposed-to-other-available-options">Why this Flatpak as opposed to other available options?<a class="anchorjs-link " href="#why-this-flatpak-as-opposed-to-other-available-options" aria-label="Anchor" data-anchorjs-icon="" style="font: 1em / 1 anchorjs-icons; padding-left: 0.375em;"></a></h2> | ||
|
|
||
| <h3 id="httpsgithubcomnmlynch94comjagexlauncherjagexlauncher"><a href="https://github.com/nmlynch94/com.jagexlauncher.JagexLauncher">https://github.com/nmlynch94/com.jagexlauncher.JagexLauncher</a><a class="anchorjs-link " href="#httpsgithubcomnmlynch94comjagexlauncherjagexlauncher" aria-label="Anchor" data-anchorjs-icon="" style="font: 1em / 1 anchorjs-icons; padding-left: 0.375em;"></a></h3> | ||
|
|
||
| <h4 id="wine">Wine<a class="anchorjs-link " href="#wine" aria-label="Anchor" data-anchorjs-icon="" style="font: 1em / 1 anchorjs-icons; padding-left: 0.375em;"></a></h4> | ||
|
|
||
| <p>The <code class="language-plaintext highlighter-rouge">nmlynch94</code> launcher <a href="https://github.com/nmlynch94/com.jagexlauncher.JagexLauncher/blob/6e1b5bf4c78b707bcb15d6f85d8b48e0337b7525/com.jagex.Launcher.yml#L21-L23">uses</a> the <a href="https://github.com/flathub/org.winehq.Wine">unoffical Flatpak Wine</a> package as a base. This package is not maintained by the Wine project and is several versions behind. This has several effects:</p> | ||
|
|
||
| <ul> | ||
| <li>This unofficial Wine package is missing many of the improvements that have been made to Wine recently.</li> | ||
| <li>Because the unofficial Wine Flatpak is meant to be a | ||
| one-size-fits-all installation of Wine, the size of the Flatpak is much | ||
| larger than it needs to be, because it includes many dependencies that | ||
| are not needed by the Jagex Launcher and it’s games.</li> | ||
| <li>The permissions required for the unofficial Wine are larger | ||
| because it requests access to the host filesystem along with accessing | ||
| devices. This is not needed by the Jagex Launcher and it’s games, so | ||
| these permissions expand the attack surface of the Flatpak without | ||
| providing any benefit.</li> | ||
| </ul> | ||
|
|
||
| <p><code class="language-plaintext highlighter-rouge">nmlynch94</code>’s Flatpak also <a href="https://github.com/nmlynch94/com.jagexlauncher.JagexLauncher/blob/35b90122cffb994bf506d0d36939bdb14c308973/com.jagex.Launcher.yml#L55-L65">contains a prebuilt Proton GE</a> which makes the Wine base even more unnecessary and illogical.</p> | ||
|
|
||
| <h4 id="dxvk">DXVK<a class="anchorjs-link " href="#dxvk" aria-label="Anchor" data-anchorjs-icon="" style="font: 1em / 1 anchorjs-icons; padding-left: 0.375em;"></a></h4> | ||
|
|
||
| <p>The Jagex Launcher, Runescape’s NXT client, the official OSRS client, | ||
| and RuneLite all use OpenGL. (The exception is running NXT with | ||
| compatibility mode) The <code class="language-plaintext highlighter-rouge">nmlynch94</code> launcher <a href="https://github.com/nmlynch94/com.jagexlauncher.JagexLauncher/blob/35b90122cffb994bf506d0d36939bdb14c308973/com.jagex.Launcher.yml#L99-L108">adds DXVK</a>, which just adds overhead and goes unused.</p> | ||
|
|
||
| <h4 id="custom-clients">Custom Clients<a class="anchorjs-link " href="#custom-clients" aria-label="Anchor" data-anchorjs-icon="" style="font: 1em / 1 anchorjs-icons; padding-left: 0.375em;"></a></h4> | ||
|
|
||
| <p>The <code class="language-plaintext highlighter-rouge">nmlynch94</code> launcher contains support for other clients such as HDOS. If these clients are important to you, you should use the <code class="language-plaintext highlighter-rouge">nmlynch94</code> launcher. However, if you only care about the official Jagex client and RuneLite, this launcher is a better option.</p> | ||
|
|
||
| <h4 id="coherent-commit-messages">Coherent Commit Messages<a class="anchorjs-link " href="#coherent-commit-messages" aria-label="Anchor" data-anchorjs-icon="" style="font: 1em / 1 anchorjs-icons; padding-left: 0.375em;"></a></h4> | ||
|
|
||
| <p>The <code class="language-plaintext highlighter-rouge">nmlynch94</code> launcher’s <a href="https://github.com/nmlynch94/com.jagexlauncher.JagexLauncher/commits/35b90122cffb994bf506d0d36939bdb14c308973">commit history</a> | ||
| is littered with commit messages like “Update <filename>” and | ||
| “test”, so understanding the changes that were made to the repo is | ||
| difficult.</p> | ||
|
|
||
| <h4 id="continuous-integration">Continuous Integration<a class="anchorjs-link " href="#continuous-integration" aria-label="Anchor" data-anchorjs-icon="" style="font: 1em / 1 anchorjs-icons; padding-left: 0.375em;"></a></h4> | ||
|
|
||
| <p>This repository uses <a href="https://github.com/features/actions">GitHub Actions</a> | ||
| to test changes and ensure the Flatpak builds successfully. This means | ||
| that the Flatpak will always be tested before being released and allows | ||
| the next benefit: automatic dependency updates.</p> | ||
|
|
||
| <h4 id="automatic-dependency-updates">Automatic Dependency Updates<a class="anchorjs-link " href="#automatic-dependency-updates" aria-label="Anchor" data-anchorjs-icon="" style="font: 1em / 1 anchorjs-icons; padding-left: 0.375em;"></a></h4> | ||
|
|
||
| <p>This repository uses <a href="https://www.mend.io/renovate/">Renovate</a> | ||
| to create automated pull requests to update dependencies. This means | ||
| that the dependencies will be kept up to date without any manual | ||
| intervention. This ensures that users will always have the latest | ||
| versions of Wine and Runelite. <code class="language-plaintext highlighter-rouge">nmlynch94</code> does not use CI or Renovate, so the dependency update process is manual.</p> | ||
|
|
||
| <h4 id="copyrighted-content">Copyrighted Content<a class="anchorjs-link " href="#copyrighted-content" aria-label="Anchor" data-anchorjs-icon="" style="font: 1em / 1 anchorjs-icons; padding-left: 0.375em;"></a></h4> | ||
|
|
||
| <p>This repository contains zero content that is the intellectual property of Jagex. The <code class="language-plaintext highlighter-rouge">nmlynch94</code> launcher <a href="https://github.com/nmlynch94/com.jagexlauncher.JagexLauncher/blob/6e1b5bf4c78b707bcb15d6f85d8b48e0337b7525/icons/512/512.png">contains the Jagex launcher logo</a> that belongs to Jagex.</p> | ||
|
|
||
| <p>The lack of a license on the <code class="language-plaintext highlighter-rouge">nmlynch94</code> repository means that it is not legal to distribute or modify <code class="language-plaintext highlighter-rouge">nmlynch94</code>’s launcher package and that it is proprietary.</p> | ||
|
|
||
|
|
||
|
|
||
| <div class="footer border-top border-gray-light mt-5 pt-3 text-right text-gray"> | ||
| This site is open source. <a href="https://github.com/USA-RedDragon/jagex-launcher-flatpak/edit/flatpak-repository/README.md">Improve this page</a>. | ||
| </div> | ||
|
|
||
| </div> | ||
| <script src="assets/anchor.min.js" integrity="sha256-lZaRhKri35AyJSypXXs4o6OPFTbTmUoltBbDCbdzegg=" crossorigin="anonymous"></script> | ||
| <script>anchors.add();</script> | ||
|
|
||
|
|
||
| </body></html> |