How to add logo?

Share your Projects! Custom Integrations
1

Hi,

Trying to add a logo to my custom integration. Difficult to find a clear documentation.

I tried to put:

  • images/icon.png, or
  • logo.png
  • icon.png

and added this information to manifest.json.

But none of them worked.

Ideas?

Thanks!

1 Like
2

You’ll need to add them to the brands repository: brands/README.md at master · home-assistant/brands · GitHub

The readme covers how to add them.

I am not sure where I found this within the documentation, since that was a while back. It is under the integration quality scale rules now: Has branding assets available for the integration | Home Assistant Developer Docs

3

Thanks. I just read that.

Is it really not possible to not go that way? I mean it’s my personal integration, I should be able to have my nice logo without going the official way.

Have a nice day!

2 Likes
4

Not as far as I know. There have been some discussions about it actually, since it forces your instance to get data from the github repository (meaning you cannot technically run fully local I believe?).

From what I remember, the current problem lies in how the non-custom integrations are packaged, since a home assistant install includes already contains all of them, it just doesn’t load them. Hence, including logos would balloon the file size of what is, already, quite a big Python package.

You could file a feature request, I think, especially for custom/personal integrations, it is a valid point you raise. Although that won’t solve your problem right now of course.

5

Thanks for the explanations. I think I’ll concentrate on my integration first and then, maybe, focus on this point.

Have a nice one.

1 Like
6

how odd to not just allow a local png to be loaded along with the rest of the files.

4 Likes
7

No you can still make and run your own integrations via hacs. So it forcing you to always have brand logs online is stupid. I want to be able to make my own integrations and not release them publically and still have icons

2 Likes
8

If an image is added to that project in, say, custom_components/my-custom-component, does home assistant automatically fetch the icon/logo when displaying the my-custom-component integration tile / page? I don’t see any reference in the custom component code I’ve looked at that mention the brands project URL.