Linux support in Flashpoint is currently experimental due to a lack of maintainers. This page describes the current state of our Linux support. If you need assistance with installing or playing, ask in the <code>help</code> forum on the [https://flashpointarchive.org/discord Discord server].

Flashpoint for Linux supports Flash, HTML5, Shockwave, Unity, Java and various other web platforms. Not every platform is supported, such as DevalVR and Viscape, because some may rely too heavily on Windows features and can't run through Wine.
If you want support for platforms that are Windows-exclusive, there are 2 options:
* [https://flashpointarchive.org/downloads Download the Windows version of Flashpoint] and run it in a Windows virtual machine. This is the recommended non-native option.
* [[#Windows_Version_Using_Wine|Run the Windows version of Flashpoint with Wine]]. This may or may not work well depending on the exact build of Wine used.

Otherwise, if you don't need support for those platforms, you may continue reading through this page.

== Compatibility ==
Flashpoint for Linux only officially supports the x86_64 architecture and, for compatibility and security reasons, the GNU C Library (glibc). This is because the launcher uses Electron, which doesn't support 32-bit x86 for Linux, and several binaries only have x86_64 + glibc versions. If you want to run Flashpoint on other architectures like ARM or RISC-V, you must use an emulator like [https://github.com/ptitSeb/box64 Box64]. Likewise, for C libraries other than glibc like musl, you must recompile everything you wish to use that's not already packaged, and link them with the desired C library. You may also use a glibc compatibility layer like [https://github.com/Stantheman/gcompat gcompat] for proprietary binaries, such as the native Flash projector.

The main Linux version is built on Debian 11, which uses glibc 2.31, making it the minimum supported version. Flashpoint cannot be built on older Debian versions without significant changes to the launcher, due to some dependencies being incompatible. Any distro that uses glibc 2.31+ should also be supported, including but not limited to:
* Ubuntu 20.04+
* Fedora 32+
* openSUSE Leap 15.3+
* Any distro based on the above, including by proxy
* Any rolling release distro maintained after February 2020

If you use a distro older than those listed, you must upgrade to a newer version to run Flashpoint.

== Main Version ==
This version of Flashpoint for Linux is split up into 3 different parts; [[#Main Files|the main files]], which contain everything that Flashpoint itself and the platforms need to work; [[#Libraries|the libraries]], which can be used to run Flashpoint in a known-working container; and [[#Wine Runtime|the Wine runtime]], which contains only the binaries and libraries that the Windows-only programs need to run.

'''If you use an immutable distro, like SteamOS, NixOS, or Fedora Silverblue, you must [[#Components|install all 3 components]] for Flashpoint to work. If you don't, you'll most likely receive errors regarding missing files. If you ask for help and this applies, you'll be directed back here unless you say you installed everything.'''

For the best experience, at least 4 GB of free space is needed on the partition you wish to install Flashpoint to.

=== Components ===
==== Main Files ====
To install the main Flashpoint files, follow these steps:
# Download [https://download.flashpointarchive.org/upload/fp14.0.2_lin_main_20250618.7z this archive file]. (SHA256: <code>6a8f09189ef74bf94770c4820e53033062dbedb440f03849ac711d5e213fd575</code>)
# Extract the contents of the file to an '''empty''' directory that your user has read & write permissions for. This can be done graphically, or in the terminal by entering the following at the file's directory:<pre>7zr x fp*_lin_main_*.7z -oFlashpoint</pre>
# Open the directory you extracted Flashpoint to, then run <code>setup-desktop-entry.sh</code> to generate a desktop entry that opens the launcher. Alternatively, if you are unable to run desktop entries, run <code>start-flashpoint.sh</code> instead.

Once you've done that, Flashpoint itself is now installed. If you don't want to or can't [[#Dependencies|install the dependencies]], you should also install the other components below.

==== Libraries ====
'''If you already [[#Dependencies|installed all of the dependencies]], you can skip this.'''

This section will assume you [[#Main Files|already extracted the main files]].

To install the libraries, follow these steps:
# Download [https://download.flashpointarchive.org/upload/fp_lin_libs_20250519.7z this archive file]. (SHA256: <code>8a22d0e5b508d3b5aa3a7cd3a024fc7127b7e8d899884b6d3a20b065dcfc6ac3</code>)
# Extract the contents of the file '''directly''' to the <code>Libraries</code> directory of your Flashpoint install.
# If you already have a desktop entry, rerun <code>setup-desktop-entry.sh</code> to generate a new one that'll load the binaries and libraries from the <code>Libraries</code> directory instead.

When finished, your Flashpoint install should automatically use the binaries and libraries you've extracted instead of your system ones.

==== Wine Runtime ====
'''If you already [[#Dependencies|installed all of the dependencies]], you can skip this.'''

This section will assume you [[#Main Files|already extracted the main files]].

To install the Wine runtime, follow these steps:
# Download [https://download.flashpointarchive.org/upload/fp_lin_wine_20250618.7z this archive file]. (SHA256: <code>234bc1903c9e31bd1cd0523b299a6517321d1eed91467d75d0ddc23e67429bcc</code>)
# Extract the contents of the file '''directly''' to the <code>FPSoftware/Wine</code> directory of your Flashpoint install.

If done correctly, Flashpoint should use the extracted Wine runtime instead of the one on your system, if applicable. Flashpoint's version only contains the executables and libraries needed to run Flashpoint's Windows-only programs, and nothing more. This reduces the Wine install size, overall load times for Wine programs and the size of the prefix that generates/updates.

=== Dependencies ===
'''If you already [[#Components|extracted all of the components]], you can skip this.'''

If you're on a mutable distro and not using the components provided above, you must install the following packages for Flashpoint to work properly. A dependency listed with more than one package for a given distro means you can choose any one package from that distro according to your needs.
{|class="wikitable"
!Distro
!X11
!GTK3
!NSS
!PulseAudio
!PHP
!7-Zip*
!Wine
!32-bit Xcomposite**
!32-bit LibPulse**
|-
!Debian-like
|xserver-xorg-core / xwayland
|libgtk-3-0
|libnss3
|rowspan=2|pulseaudio / pipewire-pulse
|rowspan=3|php
|rowspan=2|7zip
|([https://gitlab.winehq.org/wine/wine/-/wikis/Debian-Ubuntu link])
|libxcomposite1:i386
|libpulse0:i386
|-
!Arch-like
|xorg-server / xorg-xwayland
|rowspan=2|gtk3
|rowspan=2|nss
|rowspan=3|wine
|colspan=2 style="background-color:#bfbfbf;"|<center>N/A</center>
|-
!Fedora-like
|xorg-x11-server-Xorg / xorg-x11-server-Xwayland
|rowspan=2|pulseaudio / pipewire-pulseaudio
|p7zip
|libXcomposite.i686
|pulseaudio-libs.i686
|-
!SUSE-like
|xorg-x11-server / xwayland
|libgtk-3-0
|mozilla-nss
|php7
|7zip
|libXcomposite1-32bit
|libpulse0-32bit
|}
* Only required to extract components; not needed for runtime 
** Not required on Fedora 40+ and its derivatives

There are also some packages that aren't required, but can enhance your experience:
{|class="wikitable"
!Distro
!GTK2
!LibXt
|-
!Debian-like
|libgtk2.0-0
|libxt6
|-
!Arch-like
|rowspan=2|gtk2
|libxt
|-
!Fedora-like
|libXt
|-
!SUSE-like
|libgtk-2_0-0
|libXt6
|}

To install them, use your distro's package manager:
{|class="wikitable"
!Distro
!Package manager install command
|-
!Debian-like
|<code>sudo apt-get install $PKG</code>
|-
!Arch-like
|<code>sudo pacman -S $PKG</code>
|-
!Fedora-like
|<code>sudo dnf install $PKG</code>
|-
!SUSE-like
|<code>sudo zypper install $PKG</code>
|}

=== Nix Shell ===
The main Flashpoint files can also be launched under a Nix shell if Nix is installed:
<pre>{ pkgs ? import <nixpkgs> {} }:

(pkgs.buildFHSEnv {
name = "flashpoint";
targetPkgs = pkgs: (with pkgs; [
# Shell utils
toybox
# Electron for the launcher.
electron
# Flashpoint requirements
pipewire pulseaudio
gtk3 gtk2 nss php wine
xorg.libX11 xorg.libXt xorg.libXcomposite
# ldd requirements
mesa #libgbm
glib nspr at-spi2-atk cups dbus libdrm pango cairo expat libxkbcommon alsa-lib
xorg.libXdamage xorg.libXext xorg.libXfixes xorg.libXrandr xorg.libxcb
udev
]);
}).env</pre>
Simply save this code into a .nix file and run it with <code>nix-shell {file}.nix --run ./start-flashpoint.sh</code>.

You can also use <code>steam-run</code> (<code>nix-shell -p steam-run --run "steam-run ./start-flashpoint.sh"</code>).

== Minimal-Dependency Version ==
'''Due to the inherently barebones nature of this option, do not expect to receive help in the Discord if a specific game does not work.'''

If you are looking for a fully-native or minimal setup Flashpoint experience on Linux, ''Flashpoint Nano'' exists as a lightweight (albeit heavily limited) script-based alternative to the other installation options.

Only two platforms are supported: Flash (using [https://ruffle.rs Ruffle]; non-embedded entries only) and HTML5 (using [https://www.palemoon.org Pale Moon]). Each software is Linux-native, downloaded upon first launch and updated automatically.

=== Dependencies ===
Only a few command-line utilities that may not be available on your system by default are required: <code>tar</code>, <code>curl</code>, <code>sqlite3</code>, and <code>unxz</code> (from XZ Utils). You should be able to install these using your distro's package manager.

=== Installation ===
# Download Nano from [https://github.com/WumboSpasm/flashpoint-nano the GitHub repository] by clicking the ''Code'' button and then ''Download ZIP''. Alternatively, if you have git installed, you can use the <code>git clone <nowiki>https://github.com/WumboSpasm/flashpoint-nano.git</nowiki></code> command to download the repository. The latter option may be preferable so you can download updates to the scripts using <code>git pull</code>.
# If you downloaded the ZIP archive, extract it using your method of choice.
# Enter the created directory and run the following command in the terminal: <code>./flashpoint.sh <entry-id></code>. You can find the ID of the desired entry using the [https://flashpointproject.github.io/flashpoint-database Flashpoint Database] search tool. If you wish to launch an additional application, simply append its ID to the end of your command (with a space separating it from the entry ID).

== Windows Version Using Wine ==
Alternatively, you can attempt to run the Windows version of Flashpoint using Wine, which is a compatibility layer for Windows programs. There are several advantages to doing this, like being able to run more up-to-date versions of Flashpoint that have only been made for Windows. However, it is not guaranteed that Wine will work properly, as the experience varies greatly depending on the hardware, choice of distribution, and packages you have installed. For this to work, you currently need to install either the development or staging versions of Wine running a completely fresh prefix. How to install them depends on the distro, so consult [https://gitlab.winehq.org/wine/wine/-/wikis/Download WineHQ's download page] for instructions on yours. You will also need the <code>php</code> package for Flashpoint to work post-install.

As of now, you can install the latest Windows version of Flashpoint Infinity by running the [https://github.com/FlashpointProject/FlashpointComponentTools/releases/latest/download/FlashpointInstaller.exe installer] through Wine. To be able to run the installer, you need to install a recent version of Wine Mono, which should be provided upon creating a new Wine prefix or installed as a package on most distros. The process for installing Flashpoint this way is similar to how it is on Windows, except you may have to change the installation path to a location that can be written to, like your user directory. An example of a proper installation path would be <code>Z:\home\$USER\Flashpoint</code>, replacing <code>$USER</code> with your username. You may get an error upon finishing the installation; this is expected behavior. Quit the installer and kill it from your process manager if needed, and all of the files should be where you installed them.

At this point, you can try to run the Windows version of the launcher through Wine, but it's recommended that you download the [https://github.com/FlashpointProject/launcher/releases/latest native Linux launcher] as a 7z file and replace everything in the <code>Launcher</code> directory with the files extracted from it. You may need to install the <code>7zip</code>/<code>p7zip</code> package to be able to extract from the file. Once done, you can then run <code>Launcher/flashpoint-launcher</code> and set the "Flashpoint Path" in the launcher's config to <code>..</code>, then click "Save and Restart" on the bottom of the page. If everything has been done correctly, you should now have a working Flashpoint install!

If you are having issues running Flashpoint with Wine, you can instead try using various other "flavors" such as [https://github.com/GloriousEggroll/wine-ge-custom Wine GE], which has extra patches that aren't upstream. Users of Arch-like distros can install Wine GE as a [https://aur.archlinux.org/packages/wine-ge-custom package from the AUR], however no binary is provided, so it must be compiled.

== Troubleshooting ==
=== Audio Glitches in Wine ===
Some users may experience audio glitches when running programs through Wine, like constant crackling or distortions. If this is happening to you, you may have to switch to a different audio driver. As of writing, Wine currently uses PulseAudio as the default preferred backend, but other backends are available. For example, to enable the ALSA driver, run the following command, replacing <code>$DIR</code> with the full path of the prefix you wish to modify:
WINEPREFIX=$DIR wine reg add 'HKCU\Software\Wine\Drivers' /v Audio /d alsa
To modify the default prefix, don't set WINEPREFIX. For reference, Flashpoint's prefix location relative to the installation directory is <code>FPSoftware/Wine</code>.

Switching audio drivers may or may not fix the problem right away. If you are still experiencing glitchy audio, please ask for help in the [https://flashpointarchive.org/discord Discord server].

=== Launcher Sandbox Errors ===
Some users may receive the following error when attempting to run the launcher:
The SUID sandbox helper binary was found, but is not configured correctly.
To fix this, the permissions and owner of the sandbox have to be changed. Open a terminal in the <code>Launcher</code> directory of your Flashpoint install, and run the following:
chmod 4755 chrome-sandbox
sudo chown root:root chrome-sandbox
The first command will allow the owner of the sandbox to read, write and execute it; other users will only be able to read and execute. The second will set the root user and group as the owner of the sandbox. The root group should only contain the root user by default.

Afterwards, the launcher should now be able to open without issue. If you still encounter errors, try adding the <code>--no-sandbox</code> flag to the end of the command that runs the launcher, either in the desktop entry or in the start script.

== Optional Enhancements ==
=== Wine Wayland Support ===
'''Enabling this feature could break compatibility with some games/animations.'''

Starting with Wine 8.4 and being officially added in Wine 10.0, a new display driver can be used to run Windows programs through Wayland instead of X11/Xwayland. To enable it, run the following command, replacing <code>$DIR</code> with the full path of the prefix you wish to modify:
WINEPREFIX=$DIR wine reg add 'HKCU\Software\Wine\Drivers' /v Graphics /d wayland,x11
To modify the default prefix, don't set WINEPREFIX. For reference, Flashpoint's prefix location relative to the installation directory is <code>FPSoftware/Wine</code>.

After making this change, all programs running in Wine from now on should be using Wayland.
<noinclude>
[[Category:Technologies]]
</noinclude>

Linux Support

2025-06-27T02:19:29Z

Maoijoon: /* Main Version */ Minor rewording

Linux support in Flashpoint is currently experimental due to a lack of maintainers. This page describes the current state of our Linux support. If you need assistance with installing or playing, ask in the <code>help</code> forum on the [https://flashpointarchive.org/discord Discord server].

Flashpoint for Linux supports Flash, HTML5, Shockwave, Unity, Java and various other web platforms. Not every platform is supported, such as DevalVR and Viscape, because some may rely too heavily on Windows features and can't run through Wine.
If you want support for platforms that are Windows-exclusive, there are 2 options:
* [https://flashpointarchive.org/downloads Download the Windows version of Flashpoint] and run it in a Windows virtual machine. This is the recommended non-native option.
* [[#Windows_Version_Using_Wine|Run the Windows version of Flashpoint with Wine]]. This may or may not work well depending on the exact build of Wine used.

Otherwise, if you don't need support for those platforms, you may continue reading through this page.

== Compatibility ==
Flashpoint for Linux only officially supports the x86_64 architecture and, for compatibility and security reasons, the GNU C Library (glibc). This is because the launcher uses Electron, which doesn't support 32-bit x86 for Linux, and several proprietary binaries only have x86_64 + glibc versions. If you want to run Flashpoint on other architectures like ARM or RISC-V, you must use an emulator like [https://github.com/ptitSeb/box64 Box64]. Likewise, for C libraries other than glibc like musl, you must recompile everything you wish to use that's not already packaged, and link them with the desired C library. You may also use a glibc compatibility layer like [https://github.com/Stantheman/gcompat gcompat] for proprietary binaries, like the native Flash projector.

The current Linux version of Flashpoint is built on Debian 11, which uses glibc 2.31, making it the minimum supported version. Flashpoint cannot be built on older Debian versions without significant changes to the launcher, due to some dependencies being incompatible. Any distro that uses glibc 2.31+ should also be supported, including but not limited to:
* Ubuntu 20.04+
* Fedora 32+
* openSUSE Leap 15.3+
* Any distro based on the above, including by proxy
* Any rolling release distro maintained after February 2020

If you use a distro older than those listed, you must upgrade to a newer version to run Flashpoint.

== Main Version ==
This version of Flashpoint for Linux is split up into 3 different parts; [[#Main Files|the main files]], which contain everything that Flashpoint itself and the platforms need to work; [[#Libraries|the libraries]], which can be used to run Flashpoint in a known-working container; and [[#Wine Runtime|the Wine runtime]], which contains only the binaries and libraries that the Windows-only programs need to run.

'''If you use an immutable distro, like SteamOS, NixOS, or Fedora Silverblue, you must [[#Components|install all 3 components]] for Flashpoint to work. If you don't, you'll most likely receive errors regarding missing files. If you ask for help and this applies, you'll be directed back here unless you say you installed everything.'''

For the best experience, at least 4 GB of free space is needed on the partition you wish to install Flashpoint to.

=== Components ===
==== Main Files ====
To install the main Flashpoint files, follow these steps:
# Download [https://download.flashpointarchive.org/upload/fp14.0.2_lin_main_20250618.7z this archive file]. (SHA256: <code>6a8f09189ef74bf94770c4820e53033062dbedb440f03849ac711d5e213fd575</code>)
# Extract the contents of the file to an '''empty''' directory that your user has read & write permissions for. This can be done graphically, or in the terminal by entering the following at the file's directory:<pre>7zr x fp*_lin_main_*.7z -oFlashpoint</pre>
# Open the directory you extracted Flashpoint to, then run <code>setup-desktop-entry.sh</code> to generate a desktop entry that opens the launcher. Alternatively, if you are unable to run desktop entries, run <code>start-flashpoint.sh</code> instead.

Once you've done that, Flashpoint itself is now installed. If you don't want to or can't [[#Dependencies|install the dependencies]], you should also install the other components below.

==== Libraries ====
'''If you already [[#Dependencies|installed all of the dependencies]], you can skip this.'''

This section will assume you [[#Main Files|already extracted the main files]].

To install the libraries, follow these steps:
# Download [https://download.flashpointarchive.org/upload/fp_lin_libs_20250519.7z this archive file]. (SHA256: <code>8a22d0e5b508d3b5aa3a7cd3a024fc7127b7e8d899884b6d3a20b065dcfc6ac3</code>)
# Extract the contents of the file '''directly''' to the <code>Libraries</code> directory of your Flashpoint install.
# If you already have a desktop entry, rerun <code>setup-desktop-entry.sh</code> to generate a new one that'll load the binaries and libraries from the <code>Libraries</code> directory instead.

When finished, your Flashpoint install should automatically use the binaries and libraries you've extracted instead of your system ones.

==== Wine Runtime ====
'''If you already [[#Dependencies|installed all of the dependencies]], you can skip this.'''

This section will assume you [[#Main Files|already extracted the main files]].

To install the Wine runtime, follow these steps:
# Download [https://download.flashpointarchive.org/upload/fp_lin_wine_20250618.7z this archive file]. (SHA256: <code>234bc1903c9e31bd1cd0523b299a6517321d1eed91467d75d0ddc23e67429bcc</code>)
# Extract the contents of the file '''directly''' to the <code>FPSoftware/Wine</code> directory of your Flashpoint install.

If done correctly, Flashpoint should use the extracted Wine runtime instead of the one on your system, if applicable. Flashpoint's version only contains the executables and libraries needed to run Flashpoint's Windows-only programs, and nothing more. This reduces the Wine install size, overall load times for Wine programs and the size of the prefix that generates/updates.

=== Dependencies ===
'''If you already [[#Components|extracted all of the components]], you can skip this.'''

If you're on a mutable distro and not using the components provided above, you must install the following packages for Flashpoint to work properly. A dependency listed with more than one package for a given distro means you can choose any one package from that distro according to your needs.
{|class="wikitable"
!Distro
!X11
!GTK3
!NSS
!PulseAudio
!PHP
!7-Zip*
!Wine
!32-bit Xcomposite**
!32-bit LibPulse**
|-
!Debian-like
|xserver-xorg-core / xwayland
|libgtk-3-0
|libnss3
|rowspan=2|pulseaudio / pipewire-pulse
|rowspan=3|php
|rowspan=2|7zip
|([https://gitlab.winehq.org/wine/wine/-/wikis/Debian-Ubuntu link])
|libxcomposite1:i386
|libpulse0:i386
|-
!Arch-like
|xorg-server / xorg-xwayland
|rowspan=2|gtk3
|rowspan=2|nss
|rowspan=3|wine
|colspan=2 style="background-color:#bfbfbf;"|<center>N/A</center>
|-
!Fedora-like
|xorg-x11-server-Xorg / xorg-x11-server-Xwayland
|rowspan=2|pulseaudio / pipewire-pulseaudio
|p7zip
|libXcomposite.i686
|pulseaudio-libs.i686
|-
!SUSE-like
|xorg-x11-server / xwayland
|libgtk-3-0
|mozilla-nss
|php7
|7zip
|libXcomposite1-32bit
|libpulse0-32bit
|}
* Only required to extract components; not needed for runtime 
** Not required on Fedora 40+ and its derivatives

There are also some packages that aren't required, but can enhance your experience:
{|class="wikitable"
!Distro
!GTK2
!LibXt
|-
!Debian-like
|libgtk2.0-0
|libxt6
|-
!Arch-like
|rowspan=2|gtk2
|libxt
|-
!Fedora-like
|libXt
|-
!SUSE-like
|libgtk-2_0-0
|libXt6
|}

To install them, use your distro's package manager:
{|class="wikitable"
!Distro
!Package manager install command
|-
!Debian-like
|<code>sudo apt-get install $PKG</code>
|-
!Arch-like
|<code>sudo pacman -S $PKG</code>
|-
!Fedora-like
|<code>sudo dnf install $PKG</code>
|-
!SUSE-like
|<code>sudo zypper install $PKG</code>
|}

=== Nix Shell ===
The main Flashpoint files can also be launched under a Nix shell if Nix is installed:
<pre>{ pkgs ? import <nixpkgs> {} }:

(pkgs.buildFHSEnv {
name = "flashpoint";
targetPkgs = pkgs: (with pkgs; [
# Shell utils
toybox
# Electron for the launcher.
electron
# Flashpoint requirements
pipewire pulseaudio
gtk3 gtk2 nss php wine
xorg.libX11 xorg.libXt xorg.libXcomposite
# ldd requirements
mesa #libgbm
glib nspr at-spi2-atk cups dbus libdrm pango cairo expat libxkbcommon alsa-lib
xorg.libXdamage xorg.libXext xorg.libXfixes xorg.libXrandr xorg.libxcb
udev
]);
}).env</pre>
Simply save this code into a .nix file and run it with <code>nix-shell {file}.nix --run ./start-flashpoint.sh</code>.

You can also use <code>steam-run</code> (<code>nix-shell -p steam-run --run "steam-run ./start-flashpoint.sh"</code>).

== Minimal-Dependency Version ==
'''Due to the inherently barebones nature of this option, do not expect to receive help in the Discord if a specific game does not work.'''

If you are looking for a fully-native or minimal setup Flashpoint experience on Linux, ''Flashpoint Nano'' exists as a lightweight (albeit heavily limited) script-based alternative to the other installation options.

Only two platforms are supported: Flash (using [https://ruffle.rs Ruffle]; non-embedded entries only) and HTML5 (using [https://www.palemoon.org Pale Moon]). Each software is Linux-native, downloaded upon first launch and updated automatically.

=== Dependencies ===
Only a few command-line utilities that may not be available on your system by default are required: <code>tar</code>, <code>curl</code>, <code>sqlite3</code>, and <code>unxz</code> (from XZ Utils). You should be able to install these using your distro's package manager.

=== Installation ===
# Download Nano from [https://github.com/WumboSpasm/flashpoint-nano the GitHub repository] by clicking the ''Code'' button and then ''Download ZIP''. Alternatively, if you have git installed, you can use the <code>git clone <nowiki>https://github.com/WumboSpasm/flashpoint-nano.git</nowiki></code> command to download the repository. The latter option may be preferable so you can download updates to the scripts using <code>git pull</code>.
# If you downloaded the ZIP archive, extract it using your method of choice.
# Enter the created directory and run the following command in the terminal: <code>./flashpoint.sh <entry-id></code>. You can find the ID of the desired entry using the [https://flashpointproject.github.io/flashpoint-database Flashpoint Database] search tool. If you wish to launch an additional application, simply append its ID to the end of your command (with a space separating it from the entry ID).

== Windows Version Using Wine ==
Alternatively, you can attempt to run the Windows version of Flashpoint using Wine, which is a compatibility layer for Windows programs. There are several advantages to doing this, like being able to run more up-to-date versions of Flashpoint that have only been made for Windows. However, it is not guaranteed that Wine will work properly, as the experience varies greatly depending on the hardware, choice of distribution, and packages you have installed. For this to work, you currently need to install either the development or staging versions of Wine running a completely fresh prefix. How to install them depends on the distro, so consult [https://gitlab.winehq.org/wine/wine/-/wikis/Download WineHQ's download page] for instructions on yours. You will also need the <code>php</code> package for Flashpoint to work post-install.

As of now, you can install the latest Windows version of Flashpoint Infinity by running the [https://github.com/FlashpointProject/FlashpointComponentTools/releases/latest/download/FlashpointInstaller.exe installer] through Wine. To be able to run the installer, you need to install a recent version of Wine Mono, which should be provided upon creating a new Wine prefix or installed as a package on most distros. The process for installing Flashpoint this way is similar to how it is on Windows, except you may have to change the installation path to a location that can be written to, like your user directory. An example of a proper installation path would be <code>Z:\home\$USER\Flashpoint</code>, replacing <code>$USER</code> with your username. You may get an error upon finishing the installation; this is expected behavior. Quit the installer and kill it from your process manager if needed, and all of the files should be where you installed them.

At this point, you can try to run the Windows version of the launcher through Wine, but it's recommended that you download the [https://github.com/FlashpointProject/launcher/releases/latest native Linux launcher] as a 7z file and replace everything in the <code>Launcher</code> directory with the files extracted from it. You may need to install the <code>7zip</code>/<code>p7zip</code> package to be able to extract from the file. Once done, you can then run <code>Launcher/flashpoint-launcher</code> and set the "Flashpoint Path" in the launcher's config to <code>..</code>, then click "Save and Restart" on the bottom of the page. If everything has been done correctly, you should now have a working Flashpoint install!

If you are having issues running Flashpoint with Wine, you can instead try using various other "flavors" such as [https://github.com/GloriousEggroll/wine-ge-custom Wine GE], which has extra patches that aren't upstream. Users of Arch-like distros can install Wine GE as a [https://aur.archlinux.org/packages/wine-ge-custom package from the AUR], however no binary is provided, so it must be compiled.

== Troubleshooting ==
=== Audio Glitches in Wine ===
Some users may experience audio glitches when running programs through Wine, like constant crackling or distortions. If this is happening to you, you may have to switch to a different audio driver. As of writing, Wine currently uses PulseAudio as the default preferred backend, but other backends are available. For example, to enable the ALSA driver, run the following command, replacing <code>$DIR</code> with the full path of the prefix you wish to modify:
WINEPREFIX=$DIR wine reg add 'HKCU\Software\Wine\Drivers' /v Audio /d alsa
To modify the default prefix, don't set WINEPREFIX. For reference, Flashpoint's prefix location relative to the installation directory is <code>FPSoftware/Wine</code>.

Switching audio drivers may or may not fix the problem right away. If you are still experiencing glitchy audio, please ask for help in the [https://flashpointarchive.org/discord Discord server].

=== Launcher Sandbox Errors ===
Some users may receive the following error when attempting to run the launcher:
The SUID sandbox helper binary was found, but is not configured correctly.
To fix this, the permissions and owner of the sandbox have to be changed. Open a terminal in the <code>Launcher</code> directory of your Flashpoint install, and run the following:
chmod 4755 chrome-sandbox
sudo chown root:root chrome-sandbox
The first command will allow the owner of the sandbox to read, write and execute it; other users will only be able to read and execute. The second will set the root user and group as the owner of the sandbox. The root group should only contain the root user by default.

Afterwards, the launcher should now be able to open without issue. If you still encounter errors, try adding the <code>--no-sandbox</code> flag to the end of the command that runs the launcher, either in the desktop entry or in the start script.

== Optional Enhancements ==
=== Wine Wayland Support ===
'''Enabling this feature could break compatibility with some games/animations.'''

Starting with Wine 8.4 and being officially added in Wine 10.0, a new display driver can be used to run Windows programs through Wayland instead of X11/Xwayland. To enable it, run the following command, replacing <code>$DIR</code> with the full path of the prefix you wish to modify:
WINEPREFIX=$DIR wine reg add 'HKCU\Software\Wine\Drivers' /v Graphics /d wayland,x11
To modify the default prefix, don't set WINEPREFIX. For reference, Flashpoint's prefix location relative to the installation directory is <code>FPSoftware/Wine</code>.

After making this change, all programs running in Wine from now on should be using Wayland.
<noinclude>
[[Category:Technologies]]
</noinclude>

Mac Support

2025-06-26T15:50:40Z

Maoijoon: /* Installing Flashpoint */ Add note stating to not move Flashpoint app outside of main folder

This page provides information about the latest official Flashpoint release for Mac. For information about older releases, see the [[/Beta 2022-06-22|Beta 2022-06-22]] subpage.

If you have any issues running Flashpoint, please [https://discord.gg/S9uJ794 join our Discord] and post your issues in a new thread on the <code>help</code> forum channel.

== Compatibility ==
Flashpoint for Mac is fully compatible with macOS High Sierra and newer. Older versions won't work due to the launcher being incompatible with them. See the table below for a detailed support chart, or [[#Installing Flashpoint|skip to the next section to begin installing Flashpoint]].

{|class="wikitable"
!colspan="2"|Supported macOS versions
!Notes
|-
!≤ <abbr title="10.12">Sierra</abbr>
!style="background-color:#fdb3ab;"|Unsupported
|<center>Launcher claims to support <abbr title="10.11">El Capitan</abbr>, but uses syscalls added in High Sierra.</center>
|-
!<abbr title="10.13">High Sierra</abbr>
!rowspan="8" style="background-color:#d4f4b4;"|Fully supported
|rowspan="2"|<center>May be very slow when loading/searching content.</center>
|-
!<abbr title="10.14">Mojave</abbr>
|-
!<abbr title="10.15">Catalina</abbr>
|rowspan="6"|<center>Catalina & newer can't run 32-bit apps, so Wine must convert 32-bit calls to 64-bit. Non-native 32-bit apps will run slower as a result.</center>
|-
!<abbr title="11">Big Sur</abbr>
|-
!<abbr title="12">Monterey</abbr>
|-
!<abbr title="13">Ventura</abbr>
|-
!<abbr title="14">Sonoma</abbr>
|-
!<abbr title="15">Sequoia</abbr>
|}

== Installing Flashpoint ==
<ol>
<li>
Open Finder, then click the Applications tab.
</li>
<li>
Scroll down and double-click the Utilities folder to open it. Then open the Terminal app. 
[[File:MacUtilitiesFolder.png]]
[[File:MacTerminal.png]]
</li>
<li>
Copy the following command, then paste it into the Terminal and press Return to download Flashpoint: 
<pre>mkdir -p ~/Downloads && curl -fL https://download.flashpointarchive.org/upload/fp14.0.2_mac.txz | tar xC ~/Downloads</pre>
[[File:MacFP14Download.png]] 
'''Note''': 3rd party firewalls like LuLu may block the download with a "Couldn't connect to server" or "Could not resolve hostname" error. If you have any installed, turn them off beforehand.
</li>
<li>
When the download completes, you will see a new folder called "Flashpoint 14.0.2 for Mac" in your Downloads. Open the folder, then run the Flashpoint application. 
[[File:MacFP14FlashpointApp.png]] 
'''Note''': '''Do not''' move the Flashpoint app to Applications or anywhere else outside of the main folder. If you do, Flashpoint will not work properly if its path is not configured to point to the main folder.
</li>
<li>
After Flashpoint opens, you may optionally keep the application in the Dock by control-clicking the Flashpoint icon in the Dock, then choosing Options > Keep in Dock. 
[[File:MacKeepInDock.png]]
</li>
</ol>
'''Flashpoint is now installed!'''

== Troubleshooting ==
=== Flash EOL Screen ===
If you see the Flash Player EOL information screen (shown below) when you try to play a game, that means that Waterfox Classic is loading your installed Flash Player plugin instead of the plugin that is bundled with Flashpoint. To fix the problem, [https://helpx.adobe.com/flash-player/kb/uninstall-flash-player-mac-os.html uninstall Flash Player from your Mac] and restart Flashpoint. Games should work in Waterfox Classic now.

[[File:FlashTimebomb.png|200px]]

== Using Flashpoint ==
[https://flashpointproject.github.io/manual/Using_the_launcher.html See the Flashpoint Manual].

== Changelog ==

2025-06-17: Reverted to older Flash Player plugin to remove timebomb.

2025-06-16: Flashpoint 14.0.2 for Mac is now available!

2024-06-27: Brought back the ability to open Flashpoint with the application, and reduced the download's file size.

2024-06-25: Fixed an issue preventing Waterfox from launching.

2024-06-22: Flashpoint 13 for macOS is now available!

2022-08-25: Bundled dependencies with Flashpoint to make Homebrew unnecessary in many cases. Updated install scripts appropriately.

2022-08-17: Flashpoint 11 Infinity for Mac is now available!

== Technologies ==
Currently, only Flashpoint Infinity is available for Mac. We plan to also create a Flashpoint Ultimate package for Mac in the future. To do this, we will need to set up Apache for use on Mac, including all of its required modules.

Thanks to the work of volunteer [https://github.com/LindirQuenya/ LindirQuenya (Ardil)], we have an equivalent to FlashpointProxy for Mac, aptly named [https://github.com/FlashpointProject/FlashpointProxyMac FlashpointProxyMac]. This allows us to use the native standalone projectors for most Flash games and eliminates nearly all of the Flash-related bugs that plagued previous Flashpoint Mac builds.

Flashpoint for Mac supports several [[Platforms|web technologies]], including:
* Flash: Supported natively with standalone projectors. Installed by default.
** Flash in the browser is supported natively with [https://classic.waterfox.net/ Waterfox Classic].
* HTML5: Supported natively with Waterfox Classic and Chromium. Installed by default.
** Games that use Flashpoint Launcher's Browser Mode are [[#Known Issues|not supported yet]].
* Java Applets: Supported natively with the Java Development Kit. Installed by default.
** Java in the browser is not supported yet.
* Shockwave: Fully supported with Wine, including Shockwave in the browser. Installed by default.
* ShiVa3D: Supported with Wine and the help of custom shell scripts.
* Various other web platforms that run via Flashpoint Navigator with Wine.
** For a full support list, see README.txt in the main folder extracted from the downloaded archive file.

An attempt was made to support Unity Web Player in Wine, but it is not working right now. See [[#Known Issues|Known Issues]].

== Known Issues ==
* [https://github.com/FlashpointProject/launcher/issues/333#issuecomment-1218457380 Launching HTML5 games that use Flashpoint Launcher's Browser Mode fails and shows an error popup].
* Unity Web Player games in Wine will get stuck on the loading screen. Audio will play, but the graphics will not initialize. We are currently trying to diagnose the cause of this problem.
* Clicking a link inside a Flash game that launches your default web browser may also crash the browser. This is because the Flash projector is launched with an environment variable telling it to load FlashpointProxyMac, and it passes the variable to its child processes. But the variable value is a relative path to the FlashpointProxyMac library, and the relative path will not resolve correctly for applications in other locations, such as your default web browser. Thus the browser will fail to load the library and will crash.
** This only happens if the browser is not already open because when launching a new instance of an existing process, it inherits the environment of the existing process.
** We considered avoiding the problem by referring to the FlashpointProxyMac library with an absolute path, but this would force the launched browser to use Flashpoint's proxy, which is not ideal either.
** It seems like older Flash projector versions do not have this issue, so we are considering using the Adobe Flash Player 29 projector by default on Mac if no better solution is found.
* Flash games that use Waterfox Classic may not work in mainland China due to Adobe's geolocation restrictions, which we have not patched out of the Mac browser plugin yet. A workaround would be to use Wine to play the games instead. To switch to Wine, click the Config tab of the launcher, scroll down and click the "Native Platforms" dropdown, and uncheck Flash.
* HTML5 games may perform poorly in Waterfox Classic on Apple Silicon Macs because Waterfox Classic is an Intel binary. In the future, we plan to run HTML5 games using a different browser such as Chromium. Or we may switch from Waterfox Classic to our own build of Flashpoint Navigator for Mac, if we are able to get that working. Either way, we may need a launcher extension to choose which browser to launch based on a game's Platform, because both Flash and HTML5 games use Basilisk on Windows.

== Running Windows on your Mac ==

{{:Running Windows on your Mac}}

<noinclude>[[Category:Technologies]]</noinclude>