# Running it ## Flatpak Setup
Ensure the Flatpak system is installed on your Linux system https://flatpak.org/setup Also see various other online guides about using Flatpaks if necessary ## Flathub Install from https://flathub.org/ like many other packages https://flathub.org/apps/details/org.viking.Viking ## Sourceforge Alternatively get the _Viking .flatpak_ file from the project Sourceforge website https://sourceforge.net/projects/viking/files/ Then install the downloaded file e.g. via command line: flatpak install --user viking-1.8.flatpak Confirm download of required runtime(s) # Run Installed Flatpak flatpak run org.viking.Viking # Flatpak Limitations Since Viking is running in a sandbox, some system integration features no longer work properly in a Flatpak runtime. 1. Help does not work. You may be asked which program to run for the help - normally being _Yelp_, but this is now outside the sandbox and so the reference to the help files doesn't seem to work. 2. Print-Preview does not work. Internally GTK seems to try to invoke _evince_, but this is not available in the sandbox and so fails. 3. Realtime tracking via GPSD does not work. The sandbox does not allow the libgps component (that connects to GPSD) to open a socket. Also its likely that the version GPSD running elsewhere (even if on the host machine) needs to be the same version as the provided libgps for it to work, which is less likely when they are packaged separately. 4. Export Layer --> 'Open with External Program', e.g. normally JOSM or Merkaator - does not work. There is no access to these programs as they are outside the sandbox. 5. File --> Acquire --> From GPS... ( or GPS Layer --> Download From GPS ) This uses GPSBabel in the background to perform the transfer via a Serial Port (in /dev) which is blocked in Flatpak by default. Since this mode is not used very often it is not enabled. You may want try using the option '--device=all' (this has not been tested) in the command to run Viking e.g.: flatpak run --device=all org.viking.Viking 6. Show Picture. Although it works; currently you may be asked which application to open the image with every single time, with seemingly no method to remember the selection. 7. Mapnik Layer (Map Creation) is disabled. This requires not only a complex build, but also a complex runtime (and general system) setup to be actually useful. Also unlikely to be of interest to Flatpak users, so no attempt has been made to facilitate this option. # Flathub vs Sourceforge Flatpak Differences ## Sourceforge This includes [GPSBabel](https://www.gpsbabel.org) in the sandbox, thus various features that use GPSBabel are available. ## Flathub ATM This does not contain GPSBabel, so features that use GPSBabel do not work (or are completely disabled) including: 1. Import/Export of non built in file types 2. TrackWaypoint Filter functions 3. Serial device transfer Further notes on the flatpak creation are in the source code repository under the file FLATPAK.md The file org.viking.Viking.yml is used for the flatpak build. -- Be Seeing You - Rob. If at first you don't succeed, then skydiving isn't for you. _______________________________________________ Viking-devel mailing list Viking-devel@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/viking-devel Viking home page: http://viking.sf.net/
