Flatpak

New Flatpak Linux Apps Installation Instructions:

Please note: As of Batocera Beta 32 08/24+, there is a new and faster method to install Flatpak Linux apps into Batocera. Please see the video below for a tutorial on the new method.

Old Method to Flatpak Linux Apps Installation Instructions:

Please note: This is the old method to install Flatpak Linux apps into Batocera. As of Batocera Beta 32 08/24+, there is a new and faster method. Please see above.

  1. Copy the IP address of your Batocera System by going into Network Settings from the Main Menu.
  2. Leave your Batocera System on.
  3. Install “WinSCP” from this site: https://winscp.net/eng/index.php
  4. Download “Putty” from this site: https://www.chiark.greenend.org.uk/~sgtatham/putty/latest.html
  5. Install Putty in this location in your Windows PC: C:\Program Files (x86)\Putty
  6. Run both WinSCP and then Putty.
  7. Your Login Information for WinSCP is the following: User name: root and your Password: linux
  8. Your Login Information for Putty is the following: Password: linux
  9. Copy the following command into Putty: flatpak remote-add --if-not-exists flathub https://flathub.org/repo/flathub.flatpakrepo
  10. Go to Flathub to locate and install your Linux apps: https://flathub.org/home
  11. From our tutorial, copy this command into Putty for Firefox: flatpak install flathub org.mozilla.firefox
  12. From our tutorial, copy this command into Putty for Steam: flatpak install flathub com.valvesoftware.Steam
  13. From our tutorial, copy this command into Putty for Sonic 3: flatpak install flathub org.sonic3air.Sonic3AIR
  14. From our tutorial, copy this command into Putty for AstroMenance: flatpak install flathub com.viewizard.AstroMenace
  15. From our tutorial, copy this command into Putty for OpenArena: flatpak install flathub ws.openarena.OpenArena
  16. From our tutorial, copy this command into Putty for Xonotic: flatpak install flathub org.xonotic.Xonotic
  17. Once you are finished installing your Linux apps, type this command into Putty: batocera-flatpak-update
  18. Exit Putty by typing the following command: Exit
  19. Reboot your Batocera System
  20. In Batocera, go to the Main Menu > Game Settings > Update Games Lists
  21. In Batocera, go to the Main Menu > Game Collection Settings > Grouped Systems > Deselect Ports
  22. Select “Applications” from your Batocera Game Collections and enjoy your Flatpak apps.

  1. To List your Flatpak apps, type the following command into Putty: flatpak list
  2. To Uninstall a Flatpak app, type the following command into Putty: flatpak remove [Name of App]
  3. If you uninstall a Flatpak app, type this command into Putty: batocera-flatpak-update

Solution: If You Don’t Have No Group for Ports or Flatpak Apps

If after you followed the instructions above and you don’t have any group for Ports or no Flatpak Apps, follow these instructions (Contributor to the solution, User: Das)

  1. Copy your es_systems.cfg from /usr/share/emulationstation/es_systems.cfg
  2. Paste es_systems.cfg to /userdata/system/configs/emulationstation/
  3. Using Nano or Notepad++ copy the following commands at the top of the file:
<?xml version="1.0"?>
<systemList>
 <system>
        <fullname>Applications</fullname>
        <name>flatpak</name>
        <manufacturer>None</manufacturer>
        <release>None</release>
        <hardware>None</hardware>
        <path>/userdata/roms/flatpak</path>
        <extension>.flatpak</extension>
        <command>python /usr/lib/python3.9/site-packages/configgen/emulatorlauncher.py %CONTROLLERSCONFIG% -system %SYSTEM% -rom %ROM%</command>
        <platform>flatpak</platform>
        <theme>flatpak</theme>
        <group>ports</group>
        <emulators>
            <emulator name="flatpak">
                <cores>
                    <core default="true">flatpak</core>
                </cores>
            </emulator>
        </emulators>
  </system>
  • 4. Save the file
  • 5. Reboot
  • 6. The ports section should show up you can turn the group off and run the Flatpak apps

Solution: If Your Flatpak Apps Don’t Run

If after you followed the instructions above and your Flatpak apps don’t run even though they have successfully installed, follow these instructions (Contributors to the solution, Users: @acmiller25 & @Clayton Jackson)

  1. Press F1 on your keyboard to enter into File Manager
  2. Click or change your directory to / (root)
  3. Right-click on / on ALL the directories or folders found in / (i.e. /userdata, etc)
  4. Go to Properties
  5. Click on the “Permissions” Tab
  6. Click on “View Content:” and choose “Anyone”
  7. Click on “Change Content:” and choose “Anyone”
  8. Click on “Access content:” and choose “Anyone”
  9. Click on “Ok”
  10. Reboot and try it again.

Below you will find the video tutorial to the information above:

Flatpak Steam and Steam Link Instructions:

  1. Copy the IP address of your Batocera System by going into Network Settings from the Main Menu.
  2. Leave your Batocera System on.
  3. Install “WinSCP” from this site: https://winscp.net/eng/index.php
  4. Download “Putty” from this site: https://www.chiark.greenend.org.uk/~sgtatham/putty/latest.html
  5. Install Putty in this location in your Windows PC: C:\Program Files (x86)\Putty
  6. Run both WinSCP and then Putty.
  7. Your Login Information for WinSCP is the following: User name: root and your Password: linux
  8. Your Login Information for Putty is the following: Password: linux
  9. Copy the following command into Putty: flatpak remote-add --if-not-exists flathub https://flathub.org/repo/flathub.flatpakrepo
  10. Go to Flathub to locate and install your Linux apps: https://flathub.org/home
  11. From our tutorial, copy this command into Putty for Steam: flatpak install flathub com.valvesoftware.Steam
  12. From our tutorial, copy this command into Putty for Steam Link: flatpak install flathub com.valvesoftware.SteamLink
  13. Once you are finished installing your Linux apps, type this command into Putty: batocera-flatpak-update
  14. Exit Putty by typing the following command: Exit
  15. Reboot your Batocera System
  16. In Batocera, go to the Main Menu > Game Settings > Update Games Lists
  17. In Batocera, go to the Main Menu > Game Collection Settings > Grouped Systems > Deselect Ports
  18. Select “Applications” from your Batocera Game Collections and enjoy Steam
  1. To List your Flatpak apps, type the following command into Putty: flatpak list
  2. To Uninstall a Flatpak app, type the following command into Putty: flatpak remove [Name of App]
  3. If you uninstall a Flatpak app, type this command into Putty: batocera-flatpak-update
  4. Once you have configured all your Steam games, type this command into Putty: batocera-steam-update
  5. Whenever you add or delete a game in Steam, type this command into Putty: batocera-steam-update

Below you will find the video tutorial to the information above:

How to Install Steam into Batocera
How to Install Steam into Batocera

Flatpak GOG/Minigalaxy Instructions:

  1. Copy the IP address of your Batocera System by going into Network Settings from the Main Menu.
  2. Leave your Batocera System on.
  3. Install “WinSCP” from this site: https://winscp.net/eng/index.php
  4. Download “Putty” from this site: https://www.chiark.greenend.org.uk/~sgtatham/putty/latest.html
  5. Install Putty in this location in your Windows PC: C:\Program Files (x86)\Putty
  6. Run both WinSCP and then Putty.
  7. Your Login Information for WinSCP is the following: User name: root and your Password: linux
  8. Your Login Information for Putty is the following: Password: linux
  9. Copy the following command into Putty: flatpak remote-add --if-not-exists flathub https://flathub.org/repo/flathub.flatpakrepo
  10. From our tutorial, copy this command into Putty for Minigalaxy: flatpak install flathub io.github.sharkwouter.Minigalaxy
  11. Once you are finished installing your Linux apps, type this command into Putty: batocera-flatpak-update
  12. Exit Putty by typing the following command: Exit
  13. Reboot your Batocera System
  14. In Batocera, go to the Main Menu > Game Settings > Update Games Lists
  15. In Batocera, go to the Main Menu > Game Collection Settings > Grouped Systems > Deselect Ports
  16. Select “Applications” from your Batocera Game Collections and enjoy Minigalaxy

Below you will find the video tutorial to the information above:

Top 10 Free Retro Linux Games for Batocera Instructions:

  1. Copy the IP address of your Batocera System by going into Network Settings from the Main Menu.
  2. Leave your Batocera System on.
  3. Install “WinSCP” from this site: https://winscp.net/eng/index.php
  4. Download “Putty” from this site: https://www.chiark.greenend.org.uk/~sgtatham/putty/latest.html
  5. Install Putty in this location in your Windows PC: C:\Program Files (x86)\Putty
  6. Run both WinSCP and then Putty.
  7. Your Login Information for WinSCP is the following: User name: root and your Password: linux
  8. Your Login Information for Putty is the following: Password: linux
  9. Copy the following command into Putty: flatpak remote-add --if-not-exists flathub https://flathub.org/repo/flathub.flatpakrepo
  10. Go to Flathub to locate and install your Linux apps: https://flathub.org/home
  11. From our tutorial, copy this command into Putty for Armagetron Advanced: flatpak install flathub org.armagetronad.ArmagetronAdvanced
  12. From our tutorial, copy this command into Putty for Cave Story NX: flatpak install flathub com.gitlab.coringao.cavestory-nx
  13. From our tutorial, copy this command into Putty for Commander Genius: flatpak install flathub io.sourceforge.clonekeenplus
  14. From our tutorial, copy this command into Putty for Open Surge: flatpak install flathub org.opensurge2d.OpenSurge
  15. From our tutorial, copy this command into Putty for Sonic 3: flatpak install flathub org.sonic3air.Sonic3AIR
  16. From our tutorial, copy this command into Putty for Sonic Robo Blast 2: flatpak install flathub org.srb2.SRB2
  17. From our tutorial, copy this command into Putty for Sonic Robo Blast 2 Kart: flatpak install flathub org.srb2.SRB2Kart
  18. From our tutorial, copy this command into Putty for SuperTux: flatpak install flathub org.supertuxproject.SuperTux
  19. From our tutorial, copy this command into Putty for SuperTux – Milestone 1: flatpak install flathub org.supertux.SuperTux-Milestone1
  20. From our tutorial, copy this command into Putty for SuperTuxKart: flatpak install flathub net.supertuxkart.SuperTuxKart
  21. Once you are finished installing your Linux apps, type this command into Putty: batocera-flatpak-update
  22. Exit Putty by typing the following command: Exit
  23. Reboot your Batocera System
  24. In Batocera, go to the Main Menu > Game Settings > Update Games Lists
  25. In Batocera, go to the Main Menu > Game Collection Settings > Grouped Systems > Deselect Ports
  26. Select “Applications” from your Batocera Game Collections and enjoy your Flatpak apps.
  1. To List your Flatpak apps, type the following command into Putty: flatpak list
  2. To Uninstall a Flatpak app, type the following command into Putty: flatpak remove [Name of App]
  3. If you uninstall a Flatpak app, type this command into Putty: batocera-flatpak-update

Below you will find the video tutorial to the information above:

Top 15 Free Linux Games for Batocera Instructions:

  1. Copy the IP address of your Batocera System by going into Network Settings from the Main Menu.
  2. Leave your Batocera System on.
  3. Install “WinSCP” from this site: https://winscp.net/eng/index.php
  4. Download “Putty” from this site: https://www.chiark.greenend.org.uk/~sgtatham/putty/latest.html
  5. Install Putty in this location in your Windows PC: C:\Program Files (x86)\Putty
  6. Run both WinSCP and then Putty.
  7. Your Login Information for WinSCP is the following: User name: root and your Password: linux
  8. Your Login Information for Putty is the following: Password: linux
  9. Copy the following command into Putty: flatpak remote-add --if-not-exists flathub https://flathub.org/repo/flathub.flatpakrepo
  10. Go to Flathub to locate and install your Linux apps: https://flathub.org/home
  11. From our tutorial, copy this command into Putty for 0 A.D.: flatpak install flathub com.play0ad.zeroad
  12. From our tutorial, copy this command into Putty for Battle for Wesnoth: flatpak install flathub org.wesnoth.Wesnoth
  13. From our tutorial, copy this command into Putty for Endless Sky: flatpak install flathub io.github.endless_sky.endless_sky
  14. From our tutorial, copy this command into Putty for Flare: flatpak install flathub org.flarerpg.Flare
  15. From our tutorial, copy this command into Putty for FreeOrion: flatpak install flathub org.freeorion.FreeOrion
  16. From our tutorial, copy this command into Putty for Katawa Shoujo: flatpak install flathub com.katawa_shoujo.KatawaShoujo
  17. From our tutorial, copy this command into Putty for Minetest: flatpak install flathub net.minetest.Minetest
  18. From our tutorial, copy this command into Putty for OpenArena: flatpak install flathub ws.openarena.OpenArena
  19. From our tutorial, copy this command into Putty for Pioneer: flatpak install flathub net.pioneerspacesim.Pioneer
  20. From our tutorial, copy this command into Putty for RuneScape: flatpak install flathub com.jagex.RuneScape
  21. From our tutorial, copy this command into Putty for Teeworlds: flatpak install flathub com.teeworlds.Teeworlds
  22. From our tutorial, copy this command into Putty for Tremulous: flatpak install flathub com.grangerhub.Tremulous
  23. From our tutorial, copy this command into Putty for Veloren: flatpak install flathub net.veloren.veloren
  24. From our tutorial, copy this command into Putty for Wolfenstein: Blade of Agony: flatpak install flathub com.realm667.Wolfenstein_Blade_of_Agony
  25. From our tutorial, copy this command into Putty for Xonotic: flatpak install flathub org.xonotic.Xonotic
  26. Once you are finished installing your Linux apps, type this command into Putty: batocera-flatpak-update
  27. Exit Putty by typing the following command: Exit
  28. Reboot your Batocera System
  29. In Batocera, go to the Main Menu > Game Settings > Update Games Lists
  30. In Batocera, go to the Main Menu > Game Collection Settings > Grouped Systems > Deselect Ports
  31. Select “Applications” from your Batocera Game Collections and enjoy your Flatpak apps.
  1. To List your Flatpak apps, type the following command into Putty: flatpak list
  2. To Uninstall a Flatpak app, type the following command into Putty: flatpak remove [Name of App]
  3. If you uninstall a Flatpak app, type this command into Putty: batocera-flatpak-update

Below you will find the video tutorial to the information above: