How-to
Change an app's icon
Starboard picks each app's icon from the app's name. You can choose another: a name from the dashboard-icons collection, the web address of a picture, or a picture file of your own.
Before you begin
- The app is in Starboard. Read Add an app.
- To use your own picture, you need an SVG or PNG file and a way to copy it to the server. Read The terminal: entering commands if you have not used one.
Steps
Use an icon from the collection or the web
- Find the icon's name in the dashboard-icons collection. The
name is the file name without its ending, such as
jellyfinorhome-assistant. - Go to Settings, then Apps, then Manage apps, and select Edit for the app.
- In Icon, enter the name. Or enter the full address of an SVG or PNG picture, starting with
https://. - Select Save app, or Save and continue for Sonarr, Radarr, Lidarr and Readarr. Starboard downloads the icon once and keeps a copy.
Use your own picture
- Name your picture with lowercase letters, numbers and hyphens only, such as
my-music.svgormy-music.png. Choose a name the collection does not use, so that Starboard does not mix it up with an icon it has saved. - Copy it into the
data/iconsfolder inside the Starboard folder on the server. With the ready-made image, that is thedata/iconsfolder next tocompose.image.yaml. - In the app's Edit panel, enter the name without its ending in Icon, such as
my-music. - Select Save app.
Things to note
- Leave Icon empty to go back to the icon Starboard picks from the app's name.
- If Starboard finds no icon, the card shows two letters from the app's name instead.
- Starboard downloads icons only while The dashboard-icons collection, for app icons is active. It is in Settings, Updates, on the What Starboard can access tab. When it is inactive, Starboard uses only icons it has saved and your own files. Read Change a switch in Starboard.
- A downloaded icon can be up to 300 KB.
If it does not work
- The icon must be a name such as sonarr, or an address starting with https://: use only lowercase letters,
numbers and hyphens, or an address that starts with
https://. - The card still shows two letters: check that the name is spelt as in the collection. Starboard waits a day before it tries a missing name again. Until then, use your own file or a web address.
Find out more
This page on GitHub, where the help is written.