{"id":16165257,"url":"https://github.com/tx00100xt/serious-runner","last_synced_at":"2026-04-26T12:31:59.167Z","repository":{"id":194505592,"uuid":"691016312","full_name":"tx00100xt/Serious-Runner","owner":"tx00100xt","description":"Serious Runner а small program that loads and runs content created by users for the game Serious Sam Classic. (Linux, FreeBSD, Windows)","archived":false,"fork":false,"pushed_at":"2023-10-24T18:33:55.000Z","size":90381,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-04-07T04:51:53.680Z","etag":null,"topics":["fps-game","game","game-tool","game-tools","game-utility","games","linux","serious-engine","serious-sam"],"latest_commit_sha":null,"homepage":"","language":"C++","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/tx00100xt.png","metadata":{"files":{"readme":"Readme.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-09-13T10:37:54.000Z","updated_at":"2023-10-23T23:03:00.000Z","dependencies_parsed_at":"2024-11-02T10:12:32.586Z","dependency_job_id":null,"html_url":"https://github.com/tx00100xt/Serious-Runner","commit_stats":null,"previous_names":["tx00100xt/serious-runner"],"tags_count":4,"template":false,"template_full_name":null,"purl":"pkg:github/tx00100xt/Serious-Runner","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tx00100xt%2FSerious-Runner","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tx00100xt%2FSerious-Runner/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tx00100xt%2FSerious-Runner/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tx00100xt%2FSerious-Runner/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/tx00100xt","download_url":"https://codeload.github.com/tx00100xt/Serious-Runner/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tx00100xt%2FSerious-Runner/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32297893,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-26T09:34:17.070Z","status":"ssl_error","status_checked_at":"2026-04-26T09:34:00.993Z","response_time":129,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["fps-game","game","game-tool","game-tools","game-utility","games","linux","serious-engine","serious-sam"],"created_at":"2024-10-10T02:49:34.629Z","updated_at":"2026-04-26T12:31:59.151Z","avatar_url":"https://github.com/tx00100xt.png","language":"C++","funding_links":[],"categories":[],"sub_categories":[],"readme":"## Serious Runner\n[![Build status](https://github.com/tx00100xt/Serious-Runner/actions/workflows/cibuild.yml/badge.svg)](https://github.com/tx00100xt/Serious-Runner/actions/)\n[![License: GPL v2](https://img.shields.io/badge/License-GPL_v2-blue.svg)](https://www.gnu.org/licenses/old-licenses/gpl-2.0.en.html)\n[![GitHub release (latest by date)](https://img.shields.io/github/v/release/tx00100xt/Serious-Runner)](https://github.com/tx00100xt/Serious-Runner/releases/tag/v1.1.2)\n[![Github downloads](https://img.shields.io/github/downloads/tx00100xt/Serious-Runner/total.svg?logo=github\u0026logoColor=white\u0026style=flat-square\u0026color=E75776)](https://github.com/tx00100xt/Serious-Runner/releases/)\n\nSerious Runner а small program that loads and runs content created by users for the game Serious Sam Classic.\n\nHistory of creation\n-------------------\nAs you know, over the years since the game's release, users have created mods, additional maps, and map packs for Serious Sam. The game interface allows you to launch additional maps and modifications, but this is not implemented very conveniently. Maps and mods may contain Cyrillic names, which leads to incorrect display of characters, unless support for the corresponding language is installed in the game. In addition, users do not know where to get additional content for the game. I decided to write a program to simplify this process. More than 600 maps created by enthusiasts for single play were reviewed. About half of them were selected and posted on the Web Archive, and all information about them was entered into the SQL database. The goal was to select the best cards with beautiful design and interesting gameplay.\n\nSerious Runner allows you to download and run additional maps and mods created by enthusiasts. You can also add your own or other maps using the release form on github. After verification, the cards will be added to the SQL database.\n\nHow the program works\n---------------------\nWhen launched for the first time, the program checks for the presence of the database along the path:\n```\n~/.local/share/Serious-Runner/DB/seriousrunner.db\n```\nIf the database is not installed, it will be searched in the home directory (or /usr/share/seriousrunner/DB depending on the installation type). Once the SQL database is found, it will be placed in the above path.\n\nNext, the program will notify you about the need to install the program and install the game data, and the main program window will open.\n\nThe first thing to do is install the game. After clicking the Install Games button, the program will first download the latest release of the game from GitHub, unpack it into the /tmp directory and copy the contents along the path:\n```\n~/.local/share/Serious-Runner\n```\nThen, the program will download the settings and configuration files and place them there.\nAs a result, we will have a local copy of the games located at the following paths:\n```\n~/.local/share/Serious-Runner/SamTFE\n~/.local/share/Serious-Runner/SamTSE\n```\nThe second stage of installation is installing the game data to the above local paths.\nTo do this, the game data must be unpacked in your home directory. If you purchased the game on Steam, then there is no need to place game data.\nAfter clicking the button Search and install game data, the program will find it and copy it to its local copy of the game, according to the paths indicated above. This completes the installation procedure.\n\nDependencies\n------------\n* `With using Qt5:`\n```\nlibQt5Gui, libQt5Core, libQt5Widgets, libQt5Sql, libQt5Network\n```\n* `With using Qt6:`\n```\nlibQt6Gui, libQt6Core, libQt6Widgets, libQt6Sql, libQt6Network\n```\n* `Basic Dependencies:`\n```\ncmake \u003e=3.14, glibc \u003e=2.24, zlib, bzip2, libarchive, liblzma\n```\n\nFor example, to build from Ubuntu/Debian, run the commands:\n* `With using Qt5`\n```\nsudo apt update\nsudo apt install build-essential cmake qtbase5-dev libarchive-dev liblzma-dev libbz2-dev zlib1g-dev\n```\n* `With using Qt6`\n```\nsudo apt update\nsudo apt install build-essential cmake qtbase6-dev libarchive-dev liblzma-dev libbz2-dev zlib1g-dev\n```\nFor build and run from ALT Linux:\n* `With using Qt5`\n```\nsudo apt-get update\nsudo apt-get install qt5-base-devel libarchive-devel liblzma-devel bzip2-devel zlib-devel\nsudo apt-get install qt5-base-common libarchive liblzma bzip2 zlib\n```\n* `With using Qt6`\n```\nsudo apt-get update\nsudo apt-get install qt6-base-devel libarchive-devel liblzma-devel bzip2-devel zlib-devel\nsudo apt-get install qt6-base-common libarchive liblzma bzip2 zlib\n```\n\nBuilding\n--------\nType this in your terminal:\n```\ngit clone https://github.com/tx00100xt/Serious-Runner.git\ncd Serious-Runner\nmkdir build \u0026\u0026 cd build\ncmake .\nmake -j4\n```\n\nBuilding and System install\n---------------------------\n```\ngit clone https://github.com/tx00100xt/Serious-Runner.git\ncd Serious-Runner\nmkdir build \u0026\u0026 cd build\ncmake .. -DCMAKE_INSTALL_PREFIX:PATH=/usr\nmake -j4\nsu\nmake install\nexit\n```\n\nBuilding for Windows\n--------------------\nIt is assumed that you have a deployed development environment that includes **Qt5** or **Qt6**, **MinGW-w64, CMake, OpenSSL** 64-bit.\nYou can find documentation on the deployment of this environment on the Internet. Using this environment you need to build the following libraries from source code:\n\n- zlib\n- bzip2\n- xz-utils (You can download a ready-made dev-build from the project page)\n- libarchive\n\nYou need to place the resulting libraries and header files in:\n```\n\"C:/Program Files/GnuWin64/lib\"\n\"C:/Program Files/GnuWin64/include\"\n```\nTo statically link the library with the program, edit the CMakeLists.txt file, setting the **ON** option for:\n```\nOPTION(ENABLE_STATIC_LINK \"Enable static link\" OFF)\n```\nand place statically the libraries and header files in\n```\n\"C:/Program Files/GnuWin64-static/lib\"\n\"C:/Program Files/GnuWin64-static/include\"\n```\nf you have a compiled static version of Qt5, you can build a static version of the application containing just one file, next to which you only need to place two openssl libraries.\n\nYou can take ready-made libraries and header files from the **GnuWin** project directory.\nOnce everything is ready, open the powershell and run the commands:\n```\ngit clone https://github.com/tx00100xt/Serious-Runner.git\ncd Serious-Runner\nmkdir build \u0026\u0026 cd build\ncmake -G \"MinGW Makefiles\" ..\nmingw32-make\n```\nAfter receiving the original executable file, add the necessary libraries and plugins to the program directory. **See file [TREE]**.\n\nTo create a program installer, use the commands:\n```\ncd Serious-Runner\ncd Install\nbinarycreator.exe  -f -v -c \"config/config.xml\" -p \"packages\" \"Serious-Runner-1.1.1-win64-Installer.exe\"\n```\n**Note:**\n- You must have it installed Qt Installer Framework\n\nScreenshots of the program\n--------------------------\n![Serious Runner png1](https://raw.githubusercontent.com/tx00100xt/Serious-Runner/main/Picturies/1.png)\n\n![Serious Runner png2](https://raw.githubusercontent.com/tx00100xt/Serious-Runner/main/Picturies/2.png)\n\n![Serious Runner png3](https://raw.githubusercontent.com/tx00100xt/Serious-Runner/main/Picturies/3.png)\n\n![Serious Runner png4](https://raw.githubusercontent.com/tx00100xt/Serious-Runner/main/Picturies/4.png)\n\n![Serious Runner png5](https://raw.githubusercontent.com/tx00100xt/Serious-Runner/main/Picturies/5.png)\n\n![Serious Runner png6](https://raw.githubusercontent.com/tx00100xt/Serious-Runner/main/Picturies/6.png)\n\nReleases\n--------\nYou can download the finished [release] for Linux, Alpine Linux(musl), FreeBSD and Windows on the releases page:\n\nJust unpack the archive in any location convenient for you in your home directory. The only condition is the presence of game data for the games Serious Sam Classic The First Encounter and Serious Sam Classic The Second in the home directory, the program will do the rest itself.\n\n### Ubuntu Users\nFor those using Ubuntu, you can use the installation from the PPA by adding **ppa:tx00100xt/serioussam** to your system's Software Sources.\n```\nsudo add-apt-repository ppa:tx00100xt/serioussam\nsudo apt update\nsudo apt install seriousrunner\n```\nThis PPA can be added to your system manually by copying the lines below and adding them to your system's software sources.\n```\ndeb https://ppa.launchpadcontent.net/tx00100xt/serioussam/ubuntu version main \ndeb-src https://ppa.launchpadcontent.net/tx00100xt/serioussam/ubuntu version main  \n```\nWhere version: jammy, lunar, mantic. \n\n### Arch Linux Users\nTo build a Serious Runner under Arch Linux you can use the package from AUR: https://aur.archlinux.org/packages/seriousrunner\nYou can download the **zst** package file for installation on the system on the [release] page.\n\n### Gentoo Users\nTo build a Serious Runner for gentoo, use a https://github.com/gentoo-mirror/serioussam overlay containing ready-made ebuilds for building the Serious Runner.\nType this in your terminal:\n```\neselect repository enable serioussam\nemaint sync --repo serioussam\nemerge -av seriousrunner --autounmask=y\n```\n\n### Windows users\nFrom the [release] page you can download ready-made builds of the portable version and the installer with both dynamic and static linking. With support for OpenSSL v1.1 and OpenSSL v3.  \n\n### Build status\n|CI|Platform|Compiler|Configurations|Platforms|Status|\n|---|---|---|---|---|---|\n|GitHub Actions|Ubuntu, Alpine, FreeBSD, Windows|GCC, Clang, MinGW-w64|Release| x64|![GitHub Actions Build Status](https://github.com/tx00100xt/Serious-Runner/actions/workflows/cibuild.yml/badge.svg)\n\nYou can download a the automatically build based on the latest commit.  \nTo do this, go to the [Actions tab], select the top workflows, and then Artifacts.\n\nGame resources\n--------------\nTo start the game, you'll need the original resurces of a licensed copy of Serious Sam: The First Encounter and Serious Sam: The Second Encounter.\n\n### Steam version. \nIf you have a digital copy of the game on Steam then the resources can be found in \n~/.local/share/Steam/steamapps/common/Serious Sam Classic The Second Encounter/ (the default Steam game installation directory on Linux).\nThe program will find these resources itself\n\n### GOG version.\nIf you bought a digital on GOG, you can unpack the resources with the innoextract CLI tool. To install innoextract via your package manager, run:\n\n```\nsudo apt-get install innoextract\n```\nCopy files \"setup_serious_sam_the_first_encounter_2.0.0.10.exe\" and \"setup_serious_sam_the_second_encounter_2.1.0.8.exe\" \nto a home directory and run the following commands:\n\n```\ncd ~/.\ninnoextract --gog setup_serious_sam_the_first_encounter_2.0.0.10.exe\nmv app samtfe\ninnoextract --gog setup_serious_sam_the_second_encounter_2.1.0.8.exe\nmv app samtse\n```\nAfter launching the program and installing the game data, you can delete it.\n```\nrm setup_serious_sam_the_first_encounter_2.0.0.10.exe\nrm setup_serious_sam_the_first_encounter_2.0.0.10.exe\nrm -rf samtfe\nrm -rf samtse\n```\n### Physical  version.\nIf you bought a physical copy of the game and you have an ISO of your disk, you can unpack the resources with the any archive manager. \nGame resources are located in the **Install** directory of the disk. Just copy all content from there to home directories.\n\nPossible problems and their solutions\n-------------------------------------\nWhen you first start the game, it is possible that the monsters will be frozen (will not move). This is not due to the Serious Runner, but to the fact that the level is launched from the command line. The solution is very simple. You need to stop the game, launch any game level from the menu for 1-2 seconds and exit the game. The game will overwrite the configuration file and the next game starts will be fine.\n\nIf you have a lot of files in your home directory, then searching for game data after clicking the \"Search and install game data\" button may take some time. Just be patient. In the usual case, it takes 2-3 seconds.\n\nSupported Architectures\n-----------------------\n* `x86-64`\n\nSupported OS\n------------\n* `Linux (glibc)`\n* `Alpine Linux (musl)`\n* `FreeBSD`\n* `Windows`\n\nPlans\n-----\n* `There are no plans`\n\nThemes\n------\n* `Themes are based on` https://github.com/GTRONICK/QSS `published under the` [MIT license].\n\nLicense\n-------\n* `Serious Runner licensed under the GNU GPL v2 (see LICENSE file).`\n\n[Actions tab]: https://github.com/tx00100xt/Serious-Runner/actions \"Download Artifacts\"\n[release]: https://github.com/tx00100xt/Serious-Runner/releases \"Download Release\"\n[MIT license]: https://github.com/tx00100xt/Serious-Runner/blob/main/Themes/LICENSE \"MIT license\"\n[TREE]: https://github.com/tx00100xt/Serious-Runner/blob/main/Install/packages/org.seriousrunner.install/data/Serious-Runner/TREE\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftx00100xt%2Fserious-runner","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftx00100xt%2Fserious-runner","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftx00100xt%2Fserious-runner/lists"}