games-on-whales/wolf

Fork 0

mirror of https://github.com/games-on-whales/wolf.git synced 2026-10-15 21:12:08 +00:00

[GH-ISSUE #140] Game icons #90

New issue

Closed

opened 2026-10-15 12:56:10 +00:00 by bsakaguchi · 6 comments

bsakaguchi commented

2026-10-15 12:56:10 +00:00

Owner

Originally created by @csrednicki on GitHub (Oct 20, 2024).
Original GitHub issue: https://github.com/games-on-whales/wolf/issues/140

Hi, in Defining Apps section in documentation there is icon_png_path parameter. I tried to use it but it didn't work. Where this icon should be placed? I tried many different locations like folder defined in app_state_folder variable, app directory, defined path from system, path in container without any luck.

Below you can find my app config and sample icon (I've created it for test purposes as PNG 628x888).

Here's my config:

[[apps]]
title = "Steam"
start_virtual_compositor = true
icon_png_path = "sample-icon.png" 

[apps.runner]
type = "docker"
name = "WolfSteam"
image = "ghcr.io/games-on-whales/steam:edge"
mounts = []
env = [
  "PROTON_LOG=1",
  "TZ=Europe/Warsaw",
  "RUN_SWAY=true",
  "GOW_REQUIRED_DEVICES=/dev/input/* /dev/dri/* /dev/nvidia*",
]
devices = []
ports = []
base_create_json = """
{
  "HostConfig": {
    "IpcMode": "host",
    "CapAdd": ["SYS_ADMIN", "SYS_NICE", "SYS_PTRACE", "NET_RAW", "MKNOD", "NET_ADMIN"],
    "SecurityOpt": ["seccomp=unconfined", "apparmor=unconfined"],
    "Ulimits": [{"Name":"nofile", "Hard":10240, "Soft":10240}],
    "Privileged": false,
    "DeviceCgroupRules": ["c 13:* rmw", "c 244:* rmw"]
  }
}
"""

Here's icon file:

Originally created by @csrednicki on GitHub (Oct 20, 2024). Original GitHub issue: https://github.com/games-on-whales/wolf/issues/140 Hi, in [Defining Apps section in documentation](https://games-on-whales.github.io/wolf/stable/user/configuration.html#_defining_apps) there is `icon_png_path` parameter. I tried to use it but it didn't work. Where this icon should be placed? I tried many different locations like folder defined in `app_state_folder` variable, app directory, defined path from system, path in container without any luck. Below you can find my app config and sample icon (I've created it for test purposes as PNG 628x888). Here's my config: ``` [[apps]] title = "Steam" start_virtual_compositor = true icon_png_path = "sample-icon.png" [apps.runner] type = "docker" name = "WolfSteam" image = "ghcr.io/games-on-whales/steam:edge" mounts = [] env = [ "PROTON_LOG=1", "TZ=Europe/Warsaw", "RUN_SWAY=true", "GOW_REQUIRED_DEVICES=/dev/input/* /dev/dri/* /dev/nvidia*", ] devices = [] ports = [] base_create_json = """ { "HostConfig": { "IpcMode": "host", "CapAdd": ["SYS_ADMIN", "SYS_NICE", "SYS_PTRACE", "NET_RAW", "MKNOD", "NET_ADMIN"], "SecurityOpt": ["seccomp=unconfined", "apparmor=unconfined"], "Ulimits": [{"Name":"nofile", "Hard":10240, "Soft":10240}], "Privileged": false, "DeviceCgroupRules": ["c 13:* rmw", "c 244:* rmw"] } } """ ``` Here's icon file: ![sample-icon](https://github.com/user-attachments/assets/b72dc085-0009-4e7a-a84b-f5c682c512f3)

bsakaguchi

2026-10-15 12:56:10 +00:00

closed this issue
added the
documentation
label

bsakaguchi commented

2026-10-15 12:56:12 +00:00

Author

Owner

@ABeltramo commented on GitHub (Oct 20, 2024):

app_state_folder expects the full path to the image file and, more importantly, it has to be accessible by the Wolf container.

My advice would be to make a folder under /etc/wolf/ (or where you store your config.toml file) say icons/ and place the file there called sample-icon.png. In this case the config will be:

icon_png_path = "/etc/wolf/icons/sample-icon.png"

We should definitely improve the docs on this..

@ABeltramo commented on GitHub (Oct 20, 2024): `app_state_folder` expects the full path to the image file and, more importantly, it has to be accessible by the Wolf container. My advice would be to make a folder under `/etc/wolf/` (or where you store your `config.toml` file) say `icons/` and place the file there called `sample-icon.png`. In this case the config will be: ``` icon_png_path = "/etc/wolf/icons/sample-icon.png" ``` We should definitely improve the docs on this..

bsakaguchi commented

2026-10-15 12:56:12 +00:00

Author

Owner

@csrednicki commented on GitHub (Oct 20, 2024):

Thank you for quick reply. I've applied changes you proposed to config.toml

icon_png_path = "/etc/wolf/icons/sample-icon.png"

This is screen from inside wolf container:

As you see file is placed in proper location and is accessible with proper rights.

Unfortunately moonlight still isn't displaying this icon correctly.

@csrednicki commented on GitHub (Oct 20, 2024): Thank you for quick reply. I've applied changes you proposed to config.toml ``` icon_png_path = "/etc/wolf/icons/sample-icon.png" ``` This is screen from inside wolf container: ![image](https://github.com/user-attachments/assets/e9b3d7c2-fc1b-49a7-99e7-57d716d08b75) As you see file is placed in proper location and is accessible with proper rights. Unfortunately moonlight still isn't displaying this icon correctly. ![image](https://github.com/user-attachments/assets/67885fd9-74bf-44c1-9b2d-ba7063c5b838)

bsakaguchi commented

2026-10-15 12:56:12 +00:00

Author

Owner

@ABeltramo commented on GitHub (Oct 20, 2024):

This is probably due to Moonlight caching those images, I'm going to take a look back at this over the next few days since I've also found a source for some good and open licensed defaults that we could include in Wolf..

Stay tuned 😉

@ABeltramo commented on GitHub (Oct 20, 2024): This is probably due to Moonlight caching those images, I'm going to take a look back at this over the next few days since I've also found a source for some good and open licensed defaults that we could include in Wolf.. Stay tuned 😉

bsakaguchi commented

2026-10-15 12:56:12 +00:00

Author

Owner

@csrednicki commented on GitHub (Oct 21, 2024):

This is probably due to Moonlight caching those images,

I tried it on few different clients (android tv and windows). I also looked on windows into c:\Users\username\AppData\Local\Moonlight Game Streaming Project\Moonlight\cache\boxart\ where Moonlight is keeping its cache. Folder for this client was empty.

@csrednicki commented on GitHub (Oct 21, 2024): > This is probably due to Moonlight caching those images, I tried it on few different clients (android tv and windows). I also looked on windows into `c:\Users\username\AppData\Local\Moonlight Game Streaming Project\Moonlight\cache\boxart\` where Moonlight is keeping its cache. Folder for this client was empty.

bsakaguchi commented

2026-10-15 12:56:12 +00:00

Author

Owner

@salty2011 commented on GitHub (Oct 21, 2024):

Ive been able to replicate this issue with Sunshine stream as well where Moonlight refuses to update the box art. I would suggest logging an issue with Moonlight as in my experience this problem isn't strictly related to wolf / sunshine stream and more related to the client not correctly updating its cache

@salty2011 commented on GitHub (Oct 21, 2024): Ive been able to replicate this issue with Sunshine stream as well where Moonlight refuses to update the box art. I would suggest logging an issue with Moonlight as in my experience this problem isn't strictly related to wolf / sunshine stream and more related to the client not correctly updating its cache

bsakaguchi commented

2026-10-15 12:56:12 +00:00

Author

Owner

@csrednicki commented on GitHub (Oct 29, 2024):

In the newest wolf docker image ghcr.io/games-on-whales/wolf:stable (hash: sha256:5761b9337fb3713894d4e86b0ea8dd08939883d46d381efbcf3942acb461a8ff created 2024-10-28 21:45:36) moonlight images are now working using this line in config.toml:

icon_png_path = "/etc/wolf/icons/sample-icon.png"

I can see image for Steam application as seen below:

There are two problems now:

Original application name written on top of the image. I tried also with other icons with the same result.
There is problem with caching of these icons. I had to remove local moonlight cache to reload icons. This does not happen using sunshine or nvidia experience.

@csrednicki commented on GitHub (Oct 29, 2024): In the newest wolf docker image `ghcr.io/games-on-whales/wolf:stable` (hash: `sha256:5761b9337fb3713894d4e86b0ea8dd08939883d46d381efbcf3942acb461a8ff` created `2024-10-28 21:45:36`) moonlight images are now working using this line in `config.toml`: ``` icon_png_path = "/etc/wolf/icons/sample-icon.png" ``` I can see image for Steam application as seen below: ![image](https://github.com/user-attachments/assets/245821b1-fa6a-4b31-a620-26d88533907a) There are two problems now: * Original application name written on top of the image. I tried also with other icons with the same result. * There is problem with caching of these icons. I had to remove local moonlight cache to reload icons. This does not happen using sunshine or nvidia experience.

bsakaguchi referenced this issue

2026-10-15 12:59:58 +00:00

[PR #90] [MERGED] Prevent null pointer deference in get_mac_address #353