Differences

This shows you the differences between two versions of the page.

--- systems:flatpak [2022/06/26 05:07] – [Login] maioni
+++ systems:flatpak [2023/12/24 02:56] (current) – Put the x86_64 warning in an alert box because it's currently invisible to users maximumentropy
@@ Line 7: / Line 7: @@
 [[https://flatpak.org/|Flatpak]] is a portable software packager for native Linux software deployment. It has been designed to offer a sandbox environment in which users can run applications in isolation from the rest of the system. This means that Flatpak software can run on virtually any Linux distribution... including Batocera.
+<WRAP center round alert>
 This is currently supported only for x86_64, as most Flatpak packages are only provided for Linux on the x86/x86_64 platform.
+</WRAP>
 <WRAP center round help>
@@ Line 20: / Line 23: @@
 <WRAP center round tip>
-[[systems:steam|Steam now has its own dedicated page!]]
+[[systems:steam|Steam]], [[systems:heroic|Heroic]], [[systems:geforcenow|GeForce NOW]] and [[systems:bottles|Bottles]] have their own pages.
 </WRAP>
@@ Line 159: / Line 162: @@
 ===== Updating Flatpak packages =====
+<WRAP center round important>
+Note: Flatpak is an isolated environment by default unless you are configuring it otherwise manually. Therefore you can always safely update any flatpak packages without having to worry your Batocera system will be affected in any way other than flatpak package installations. All packages appearing in the //flatpak-config// update list are only part of existing flatpak package installations on your system and will only affect those. However, keep in mind, that updating those packages //could// affect an existing flatpak package installation in a negative way but this is very unlikely. Generally said, it is safe for existing flatpak package installations to install any of those updates.
+</WRAP>
 Updating Flatpak packages is simple: open ''flatpak-config'' and click **Upgrade**. All applicable packages will be updated to their latest version. You may be asked to reboot.
@@ Line 199: / Line 206: @@
 flatpak uninstall --unused
 </code>
-===== Heroic Games Launcher (Epic Games store) =====
-[[https://github.com/Heroic-Games-Launcher/HeroicGamesLauncher|Heroic Games Launcher]] is an open-source launcher available on Flathub which supports launching games from the Epic Games Store using [[https://github.com/derrod/legendary|Legendary]] and GOG Games. Unfortunately this launcher is not as fully integrated into Batocera as Steam is so some manual work is required.
-==== Install =====
-<WRAP center round important>
-If you already have the Heroic Launcher Flatpak package installed, it will conflict. [[#uninstalling_flatpaks|Uninstall it first.]]
-</WRAP>
-Search for "Heroic Games Launcher" and install it.
-{{:systems:heroic_15.png?nolink&400|}}
-To do so from SSH:
-<code>
-flatpak install com.heroicgameslauncher.hgl
-batocera-flatpak-update
-</code>
-==== Launch Heroic Games Launcher ====
-The Heroic Games Launcher Flatpak is bugged and will not launch correctly using the default flags. You **must** launch via SSH using the following command:
-<code>
-flatpak run com.heroicgameslauncher.hgl --no-sandbox
-</code>
-{{:systems:heroic_16.png?nolink&400|}}
-<WRAP center round help>
-This may be worked around in the future.
-</WRAP>
-==== Login ====
-Heroic Games Launcher will offer two services to login to. Log in to the appropriate one (or select **Manage Accounts**):
-{{:systems:heroic_01.png?540|}}
-<WRAP center round tip>
-As alternative for Epic Store login, the External Login is available, this way you have to inform your Epic Store Account [[https://www.epicgames.com/help/en-US/epic-accounts-c74/general-support-c79/what-is-an-epic-account-id-and-where-can-i-find-it-a3659|SID]] to log in properly.
-</WRAP>
-<WRAP center round todo>
-"Use RIGHT ALT + 2 keys to input @ and ; or SHIFT + ; to input - or _"
-What does this mean? Is it just a problem with your keyboard specifically or is this another bug with the software?
-</WRAP>
-<WRAP center round help>
-If the log in fails, press the reload symbol at the top of the launcher window to try again.
-{{:systems:heroic_13.png?540|}}
-</WRAP>
-Your games will appear in the **Library** split between **Epic Games** and **GOG**. It could take a while to download all games' information and boxart.
-{{:systems:heroic_04.png?540|}}
-==== Download Game ====
-  - Go to **Library**
-  - Select the game
-  - Select **Install**
-{{:systems:heroic_04.png?540|}} {{:systems:heroic_05.png?540|}} {{:systems:heroic_06.png?540|}} {{:systems:heroic_07.png?540|}} {{:systems:heroic_08.png?540|}}
-<WRAP center round tip>
-[[#wine_install_for_windows_games|Windows games will need to have their intended version of WINE selected.]]
-{{:systems:heroic_12.png?460|}} {{:systems:heroic_14.png?380|}}
-</WRAP>
-==== Install Wine (for Windows games) ====
-  - Select **Wine Manager**
-  - Select the desired version of Wine to be downloaded: "Wine-GE", "Wine-Lutris" or "Proton-GE"
-{{:systems:heroic_03.png?540|}}
-<WRAP center round todo>
-Is there any preferred version of Wine to install or are you instructing the user to download them all?
-</WRAP>
-=== Global Wine setting ===
-  - Go to **Settings** -> **Wine** -> **Wine Version** and select the desired version of Wine.
-{{:systems:heroic_10.png?540|}}
-=== Per game Wine setting ===
-  - Go to **Library**
-  - Select the downloaded Windows game
-  - Go to **Settings**
-  - Select the desired version of Wine to use for that game.
-{{:systems:heroic_08.png?540|}}
-{{:systems:heroic_09.png?540|}}
-==== Launch game ====
-  - Go to **Library**
-  - Select a [[#download_game|downloaded]] game
-  - Select **PLAY NOW** ([[#wine_install_for_windows_games|Windows games require Wine to be set up first]])
-    * Heroic Games Launcher will say "Opening the Game..." and then eventually "Playing (STOP)" <WRAP center round important>
-Games may take a while to initially launch as they need to compile shaders for your hardware.
-</WRAP>
-  - If playing a Windows game, confirm the Wine installation dialogue box.
-  - Game start!
-{{:systems:heroic_08.png?540|}} {{:systems:heroic_11.png?500|}}
-<WRAP center round info>
-Right now, Batocera isn't integrated to Heroic Games Launcher; its games will not be automatically added and launchable with EmulationStation like Steam does. This may change in the future.
-</WRAP>
-=== Uninstall a game ===
-  - Go to **Library**
-  - Select an installed game
-  - Select **Tools** at the top of the window
-  - Select **Uninstall**
-=== Other option ===
-  - Go to **Settings**
-  - Select **Other**
-  - For Gamepad: Select User GameMode (No need to enable it to use Gamepad!) (FIXME so why mention this setting? What is it for?)
-  - For GPU: Select "Use Dedicated Graphics Card" (Enable if necessary) (FIXME when is this not necessary?)
-  - For FPS: Select Show FPS (FIXME this whole section might not be necessary)
-{{:systems:heroic_17.png?400|}}
-===== GeForce NOW Electron =====
-[[https://flathub.org/apps/details/io.github.hmlendea.geforcenow-electron|GeForce NOW Electron]] is an open-source launcher available on Flathub which supports launching games from the GeForce NOW using [[https://github.com/derrod/legendary|Legendary]] and some Steam, Epic Store and Ubisoft Games. Unfortunately this launcher is not as fully integrated into Batocera as Steam is so some manual work is required.
-==== Install =====
-Search for "GeForce NOW Electron" and install it.
-{{:systems:geforce_now_electron_01.png?nolink&400|}}
-To do so from SSH:
-<code>
-flatpak install flathub io.github.hmlendea.geforcenow-electron
-batocera-flatpak-update
-</code>
-==== Launch GeForce NOW Electron ====
-The GeForce NOW Electron Flatpak is bugged and will not launch correctly using the default flags. You **must** launch via SSH using the following command:
-<code>
-flatpak run io.github.hmlendea.geforcenow-electron --no-sandbox
-</code>
-<WRAP center round help>
-This may be worked around in the future.
-</WRAP>
-==== Login ====
-GeForce NOW Electron many ways to log in, but the only one that may works for now is the email and passwrod log in due to te lack of a securety connection in this flatpak application. Make sure you can log in in regular GeForce NOW with only your email and password.
-    - So, create a [[https://abya.gfn.la/en-US/account|ABYA account]] with email and password.
-    - And log in into GeForce NOW Electron with an ABYA account with the email and password options.
-==== Play Games ====
-To play games on GeForce NOW, you can syn your Steam, Epic Store and Ubisoft stores.
-{{:systems:geforce_now_electron_06.png?nolink&400|}}
-   - Goes to Settings and sync your accounts
-   - Select the game into Library and select to PLAY it. {{:systems:geforce_now_electron_02.png?nolink&400|}}
-     - **PAID plan**s: You will play as soon as possible.
-     - **FREE plans**: you will be waiting in a line to be able to play the game and for a couple of minutes when ready (around 20 minutes) [So, do not quit game until time ends, otherwise the game's session will shutdown before that!]. Also do not schedule a game you don't have on your library, e.g. The Witcher 3 has it's versions for Steam, Gog and Epic Store, if you have it on Steam but opens the Epic Store version, you can't play the game! This way, you will have to finish your game section, and open the correct version and wait again in line.
-   - After you get access to the GeforceNOW virtual machine, you will be pop up with the game's store application, log in into, download the game, and play, just as a regular Steam, Epic Store or Ubisoft softwares. {{:systems:geforce_now_electron_03.png?nolink&400|}}
-   - It supports Gamepad, even if the tools indicate it have no controller connected to it (just make sure the game you selected has support, or play it with a mouse/keyboard plug-in).
 ===== Freely distributed games =====
@@ Line 402: / Line 226: @@
   * Update your game list: **Main Menu** -> **Game Settings** -> **Update Gamelists**.
   * Flatpaks currently do not work on a NAS, if you are using a NAS try switching to internal storage.
+  * The application may need to not be run in the sandbox. From [[:access_the_batocera_via_ssh|SSH]], run ''%%flatpak run <name-of-package> --no-sandbox%%'' to test for this. <WRAP center round tip>
+This can be launched directly from ES by using an SH script in the ports system.
+For example, to launch the Heroic Games launcher without sandbox, save the following file to ''roms/ports'' and then update the gamelist:
+<file - heroicgameslauncher.sh>
+flatpak run com.heroicgameslauncher.hgl --no-sandbox
+</file>
+</WRAP>
   * SSH into Batocera and run the following: ''batocera-flatpak-update''
   * If you are on an older Batocera version (like **v31** or lower) it might be a permissions issue.
@@ Line 410: / Line 243: @@
     - Right-click and go to **Properties**
     - Click on the "Permissions" tab
-    - Click on "View Content:" and choose “Anyone”
+    - Click on "View Content:" and choose "Anyone"
-    - Click on "Change Content:" and choose “Anyone”
+    - Click on "Change Content:" and choose "Anyone"
-    - Click on "Access content:" and choose “Anyone”
+    - Click on "Access content:" and choose "Anyone"
     - Click on "OK"
     - Reboot and try it
+  * If trying to run a Flatpak of a Windows game via a Flatpak of Wine (yes, it is complicated and there are many things that can go wrong), search the game on [[https://www.protondb.com/|the ProtonDB]] and see what other users have said they've had to do to make it work. You may need to utilize custom launch commands to get a game working.
+  * Flatpak can be effectively reset to its default state by deleting the ''/userdata/saves/flatpak/'' and ''/userdata/roms/flatpak/'' folders.
 ==== My game is running really slowly ====