Skip to content

maspling/ephinea-flatpak

Repository files navigation


Ephinea Custom Flatpak

Custom flatpak to install and enjoy Ephinea

About The Project

Product Name Screen Shot

After trying to set up Ephinea in early 2026, I relized that I could help other players if I set up a flatpak that sandboxed and handled the wine setup. I opted for externalizing getting the installer, rather than bundling it in exe form or preinstalled, so that I am not stepping on any toes and leave the files in the hands of the Ephinea devs.

I am not aiming at publishing this flatpak to flathub, due to the potential issue of redestributing a work I do not own.

The script downloads the installer from Ephinea's homepage, then sets up a wine prefix inside of the flathub with DXVK and the needed configurations to get it running.

First launch will launch the installer, the subsequent launches will just starts the launcher. If you rather just start the game, use the action "Ephinea PSOBB - No Launcher" or flatpak run net.pioneer2.ephinea --no-launcher. This should work well with htpc or steamdeck setups.

(back to top)

Getting Started

Grab the flatpak from the Releases page. Make sure you follow the step below to make sure you have the needed dependencies.

Prerequisites

This is an example of how to list things you need to use the software and how to install them.

  • Wine Flatpak
    flatpak install org.winehq.Wine/x86_64/stable-25.08

Installation

Video of CLI Installation

ephinea.install.mp4

CLI Installation Example

  1. Grab the latest release from Releases
  2. Open terminal in the folder you downloaded the flatpak
  3. Install flatpak
    flatpak install net.pioneer2.ephinea.flatpak
  4. Run the flatpak
    flatpak run net.pioneer2.ephinea.flatpak

Discover Installation Example

  1. Grab the latest release from Releases
  2. Doubleclick the flatpak file
  3. Press Install in the top right corner
  4. When done, press Launch to start the flatpak

Desktop Files

A desktopfile is provided, which should populate the menu with an entry called Ephinea PSOBB. In compositors with support for action the action Ephinea PSOBB - No Launcher exists to launch the game bypassing the launcher. In KDE it will show up as a separate menu entry.

Building the flatpak locally

  1. Clone the repository
  2. Make sure you have make, flatpak, flatpak-builder and go installed
  3. Build it!
    make all
  4. The file net.pioneer2.ephinea.flatpak should be in your current directory

(back to top)

Acknowledgments

The following projects made this flatpak possible, shout out!

  • Flatpak - Packaging, sandboxing.
  • Ephinea - The game itself!
  • Shirei - Golang Gui for the custom installer

(back to top)

About

Flatpak to install and configure Ephinea PSOBB under linux

Resources

Stars

Watchers

Forks

Packages

 
 
 

Contributors