FXRunner - Simple, universal GUI desktop launcher

-21.11.2024-

Content:

1. General info
2. Compilation and installation
3. Known errors and bugs
4. The project state and plans for the future
5. Author and project licencion
6. Internet

FXRunner main window

FXRunner settings window

1. GENERAL INFO:

This is a GUI launcher application with history. Enables running in the terminal, as root, or entering the working directory of the application. Enables multiple applications to be launched one after the other (the FXRunner window does not close after launching the application).

Actual version: 24.11 0.3.2.0 Alpha

2. COMPILATION AND INSTALLATION:

Dependecies:

• Foxtoolkit 1.7.84
• FoxGHI 0.4 <= 24.11 0.4.4.1 ALPHA
• Ikons scheme support: Oxygen (base), Gnome, Faenza, Adwaita

Aditional dependencies for compilation:

• cmake >= 3.10
• g++

After downloading the project from Github (and possibly unzipping it), go to the folder with the project and enter the following command sequence:

  mkdir build
  cd build 
  cmake .. && make
  sudo make install

After successfully compiling and building the project, the resulting program, including the Lua language launcher, will be installed in the directory /usr/local/bin

Note: The foxlib library MUST be installed on your system at compile time. Version 1.7 is a development version, so it is possible that you will not have it on your system and it will not be available in the repository, so you will have to install it manually. More information on how to do this can be found on the foxtoolkit website. The following lines refer to any CMakeLists modifications.

If you have the library installed in a location other than the standard one, this fact must be entered in the CMakeLists.txt file in the project directory. Find and change the lines setting the library path:

    INCLUDE_DIRECTORIES( "/Cesta/vasi/instalaci/foxlib/include" )   #Foxlib headers
    LINK_DIRECTORIES( "/Cesta/vasi/instalaci/foxlib/lib" )          #Foxlib library

These lines are commented out by default, so remove the leading '#' characters after editing, and then save the file. Next, follow the instructions for building and installing the project above as normal.

3. KNOWN ERRORS AND BUGS

• 10/10/2020 - Checking multiple run options together will cancel each other out - OPEN
• 27/08/2022 - The program does not load local user settings - FIXED
  Bad checking of data preload in FXRegistry. Removed, preloading now happens immediately, without checking
• 06/04/2024 - The project cannot be compiled with foxlib version 1.7.84 - FIXED

4. PROJECT STATE AND PLANS FOR THE FUTHURE

5. AUTHOR AND PROJECT LICENCION:

Copyright (C) 2015 - 2022 Pavel Šafařík [email protected] All rights reseved.

This file is part of FXRunner.

FXRunner is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

FXRunner is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with FXRunner. If not, see https://www.gnu.org/licenses/.

6. INTERNET

• Author's blog (CZ)
• Foxtoolkit (EN)

=== END ===