Tweaks

Tweaks, similar to loaders and launch options, are settings that can improve performance, compatibility, or can add new features.

Tweaks are defined with JSON (.json) files under the tweaks/ directory in GameHub's configuration directory, e.g. $HOME/.config/com.github.tkashkin.gamehub/tweaks.

Included tweaks

The following bullets are tweaks that are included in GameHub:

• Feral GameMode — apply temporary optimizations to the game process and OS
• Radeon ACO Vulkan Compiler — use a hardware-based shader compiler on AMD GPUs, improves loading times with DXVK and native Vulkan games
• Wine/Proton specific tweaks — used to improve compatibility with some Windows games

Additional tweaks

The following tweaks are additional tweaks done by the community. The JSON files will be located under the tweaks/ directory. Everything between and including "{" and "}" will have to be pasted in the JSON files.

vkBasalt

Original issue: https://github.com/tkashkin/GameHub/issues/380

File name: vkbasalt.json

{
	"id": "vkbasalt",
	"name": "vkBasalt",
	"description": "Vulkan post processing layer to enhance the visual graphics of games",
	"url": "https://github.com/DadSchoorse/vkBasalt",
	"env": {
		"ENABLE_VKBASALT": "1"
	}
}

MangoHud

Original issue: https://github.com/tkashkin/GameHub/issues/371

File name: mangohud.json

{
	"id": "mangohud",
	"name": "MangoHud",
	"description": "A modification of the Mesa Vulkan overlay. Including GUI improvements, temperature reporting, and logging capabilities",
	"url": "https://github.com/flightlessmango/MangoHud",
	"command": "mangohud ${command}"
}

Syntax

Those that desire to create custom tweaks can do so. Below will explain the description of each syntax.

• id — the tweak's internal name, must be unique
• name — display name
• description — short description of the tweak
• url — the program's site or source repository
• command — command to execute, uses ${command} as placeholder for the game file and other tweaks (at least one of command and env must be defined)
• env — array, contains modified environment variables and their values
• applicable_to (optional) — conditions for the tweak to be shown, array with optional member arrays platforms (windows, linux) and compat (wine, proton, dosbox, retroarch)