Fistful of Frags Map Preview Thumbnail Archive

An archive of preview thumbnails for custom/3rd-party maps for use in the Fistful of Frags (FoF) Highlighted Server Browser (HSB) feature.

What exactly is this?

• This archive includes map preview thumbnails for custom maps that are not part of the default FoF installation.
• When installed, these thumbnails are shown in FoF's "Highlighted Server Browser" (HSB) feature, instead of the generic "Custom Map" place-holder.
• In addition to the thumbnails being a small visual representation of the map, they are generally also overlayed with the name of the map.
• Installing the previews makes it easier for players to identify which map an FoF server is currently running before joining it.
• This archive currently represents sixty (60) maps - ranging from completely original maps, to older or alternative versions of default/stock FoF maps.

For anyone running the older system:

• This system is intended to replace the equivalent functionality previously provided by older efforts (https://github.com/Mecha-Weasel/spittoon/blob/main/FoF-Community-Map-Thumbnails-Update.md).
• There is no rush to do anything.
• Eventually, uninstall the older system - using the Windows Control Panel's "Programs and Features" area.
• After uninstalling the older system, install this new one.

How to install this newer system (on Windows):

• On Windows, just download the "install-fof-map-thumbnails.cmd" file to the "fof" sub-folder where Fistful of Frags is installed (see further below).
• Run that "install-fof-map-thumbnails.cmd" file, and it will download the archive (in .zip format), and extract it in the required location.

How to install this newer system (on Linux):

• For Linux, you must have the "unzip" utility installed.
• It might already be installed by default.
• On Linux Mint or Ubuntu, you can install that unzip utility with the command:

sudo apt-get install -y unzip;

• On Linux, just download the "install-fof-map-thumbnails.sh" file to the "fof" sub-folder where Fistful of Frags is installed (see further below).
• Run that "install-fof-map-thumbnails.sh" file, and it will download the archive (in .zip format), and extract it in the required location.

Changes from the older system:

• No Windows binary executable (.exe file).
• The installer for Windows is just a "batch-file" (.cmd file).
• The uninstaller for Windows is also just a "batch-file" (.cmd file).
• No "elevated" or "administrative" permissions required for most users.
• Removed any depenencies on the old archive location (older github repo).
• The installer on Windows automatically downloads latest version of the archive from this github repo.
• To update an installation, just run the installation script again.
• An installation script for Linux (.sh file) is also now available.
• An uninstallation script for Linux (.sh file) is also now available.
• All scripts do some reality-checking to ensure they are being run from the proper location.
• All scripts should be downloaded into and executed from the "fof" folder INSIDE your FoF installation.

Installation locations:

• On Windows, the default Fistful of Frags location is typically:

C:\Program Files (x86)\Steam\steamapps\common\Fistful of Frags

• On Windows, the location where you should download the scripts to is typically:

C:\Program Files (x86)\Steam\steamapps\common\Fistful of Frags\fof

• On Linux Mint, the default Fistful of Frags location is typically:

/home/$USER/.steam/debian-installation/steamapps/common/Fistful of Frags

• On Linux Mint, the location where you should download the scripts to is typically:

/home/$USER/.steam/debian-installation/steamapps/common/Fistful of Frags/fof

PS: For custom FoF map authors:

• When creating a custom map for FoF, you are encouraged to also create a map preview thumbnail.
• The process for doing-so, is outlined in this Steam Guide: How to create FoF map thumbnails (2025)