Home

Awesome

hacs_badge

Home Assistant Cupertino Icons

Apple SF Symbols Icons for Home Assistant! (3000+ Icons)

<div style="display: inline-block;"> <img src="https://github.com/menahishayan/HomeAssistant-Cupertino-Icons/blob/build-tools/readme-preview/house.svg" alt="preview" width="50"/> &nbsp;&nbsp;&nbsp; <img src="https://github.com/menahishayan/HomeAssistant-Cupertino-Icons/blob/build-tools/readme-preview/lightbulb_fill.svg" alt="preview" width="50"/> &nbsp;&nbsp;&nbsp; <img src="https://github.com/menahishayan/HomeAssistant-Cupertino-Icons/blob/build-tools/readme-preview/lightbulb.svg" alt="preview" width="50"/> &nbsp;&nbsp;&nbsp; <img src="https://github.com/menahishayan/HomeAssistant-Cupertino-Icons/blob/build-tools/readme-preview/alarm.svg" alt="preview" width="50"/> &nbsp;&nbsp;&nbsp; <img src="https://github.com/menahishayan/HomeAssistant-Cupertino-Icons/blob/build-tools/readme-preview/app_badge_fill.svg" alt="preview" width="50"/> &nbsp;&nbsp;&nbsp; <img src="https://github.com/menahishayan/HomeAssistant-Cupertino-Icons/blob/build-tools/readme-preview/battery_25.svg" alt="preview" width="50"/> &nbsp;&nbsp;&nbsp; <img src="https://github.com/menahishayan/HomeAssistant-Cupertino-Icons/blob/build-tools/readme-preview/bed_double_fill.svg" alt="preview" width="50"/> <br/> <img src="https://github.com/menahishayan/HomeAssistant-Cupertino-Icons/blob/build-tools/readme-preview/camera_fill.svg" alt="preview" width="50"/> &nbsp;&nbsp;&nbsp; <img src="https://github.com/menahishayan/HomeAssistant-Cupertino-Icons/blob/build-tools/readme-preview/cloud_moon_rain.svg" alt="preview" width="50"/> &nbsp;&nbsp;&nbsp; <img src="https://github.com/menahishayan/HomeAssistant-Cupertino-Icons/blob/build-tools/readme-preview/cloud_sun.svg" alt="preview" width="50"/> &nbsp;&nbsp;&nbsp; <img src="https://github.com/menahishayan/HomeAssistant-Cupertino-Icons/blob/build-tools/readme-preview/moon_stars.svg" alt="preview" width="50"/> &nbsp;&nbsp;&nbsp; <img src="https://github.com/menahishayan/HomeAssistant-Cupertino-Icons/blob/build-tools/readme-preview/moon_zzz_fill.svg" alt="preview" width="50"/> &nbsp;&nbsp;&nbsp; <img src="https://github.com/menahishayan/HomeAssistant-Cupertino-Icons/blob/build-tools/readme-preview/person_crop_circle_badge_checkmark.svg" alt="preview" width="50"/> &nbsp;&nbsp;&nbsp; <img src="https://github.com/menahishayan/HomeAssistant-Cupertino-Icons/blob/build-tools/readme-preview/speaker_2_fill.svg" alt="preview" width="50"/> </div>

Install

HACS (Recommended)

  1. HACS tab > Menu > Custom Repository
  2. Paste this repo's URL
  3. Select Integration in the dropdown
  4. Install cupertino-icons from HACS
  5. Restart Home Assistant
  6. Home Assistant > Settings > Integrations > Add > Cupertino Icons > Install

The icons should be usable in Home Assistant now. If it doesnt show up, try refreshing the page, private browsing or restart Home Assistant.

Manual

  1. Copy custom_components/cupertino into your custom_components folder
  2. Restart Home Assistant
  3. Home Assistant > Settings > Integrations > Add > Cupertino Icons > Install

The icons should be usable in Home Assistant now. If it doesnt show up, try refreshing the page, private browsing or restart Home Assistant

Usage

Prefix: ios
Eg: ios:lightbulb-fill | ios:cloud-moon-rain | ios:bed-double-fill

Multi-Color Icons! (v3.0+)

<div style="display: inline-block;"> <img src="https://github.com/menahishayan/HomeAssistant-Cupertino-Icons/blob/build-tools/readme-preview/gear-badge-xmark.svg" alt="preview" width="50"/> &nbsp;&nbsp;&nbsp; <img src="https://github.com/menahishayan/HomeAssistant-Cupertino-Icons/blob/build-tools/readme-preview/antenna-radiowaves-left-and-right-circle-fill.svg" alt="preview" width="50"/> &nbsp;&nbsp;&nbsp; <img src="https://github.com/menahishayan/HomeAssistant-Cupertino-Icons/blob/build-tools/readme-preview/aqi-high.svg" alt="preview" width="50"/> &nbsp;&nbsp;&nbsp; <img src="https://github.com/menahishayan/HomeAssistant-Cupertino-Icons/blob/build-tools/readme-preview/clock-badge-exclamationmark-fill.svg" alt="preview" width="50"/> &nbsp;&nbsp;&nbsp; <img src="https://github.com/menahishayan/HomeAssistant-Cupertino-Icons/blob/build-tools/readme-preview/circle-hexagongrid-fill.svg" alt="preview" width="50"/> &nbsp;&nbsp;&nbsp; <img src="https://github.com/menahishayan/HomeAssistant-Cupertino-Icons/blob/build-tools/readme-preview/drop-circle-fill.svg" alt="preview" width="50"/> &nbsp;&nbsp;&nbsp; <img src="https://github.com/menahishayan/HomeAssistant-Cupertino-Icons/blob/build-tools/readme-preview/eye-trianglebadge-exclamationmark-fill.svg" alt="preview" width="50"/> <br/> <img src="https://github.com/menahishayan/HomeAssistant-Cupertino-Icons/blob/build-tools/readme-preview/desktopcomputer-trianglebadge-exclamationmark.svg" alt="preview" width="50"/> &nbsp;&nbsp;&nbsp; <img src="https://github.com/menahishayan/HomeAssistant-Cupertino-Icons/blob/build-tools/readme-preview/fork-knife-circle-fill.svg" alt="preview" width="50"/> &nbsp;&nbsp;&nbsp; <img src="https://github.com/menahishayan/HomeAssistant-Cupertino-Icons/blob/build-tools/readme-preview/gear-badge-questionmark.svg" alt="preview" width="50"/> &nbsp;&nbsp;&nbsp; <img src="https://github.com/menahishayan/HomeAssistant-Cupertino-Icons/blob/build-tools/readme-preview/bed-double-circle-fill.svg" alt="preview" width="50"/> &nbsp;&nbsp;&nbsp; <img src="https://github.com/menahishayan/HomeAssistant-Cupertino-Icons/blob/build-tools/readme-preview/delete-backward-fill.svg" alt="preview" width="50"/> &nbsp;&nbsp;&nbsp; <img src="https://github.com/menahishayan/HomeAssistant-Cupertino-Icons/blob/build-tools/readme-preview/gear-badge-questionmark.svg" alt="preview" width="50"/> &nbsp;&nbsp;&nbsp; <img src="https://github.com/menahishayan/HomeAssistant-Cupertino-Icons/blob/build-tools/readme-preview/waveform-badge-plus.svg" alt="preview" width="50"/> </div>

SF Symbols 3+ supports multi-color icons. This functionality has been ported into this repo to support multi-color icons in Home Assistant!

Just add Suffixes #color, #invert, #color-invert or #fullcolor to change the icon colors! (Credit to thomasloven for the inspiration)

Eg:

Icon Reference

v3.0 Update

SF Symbols | Apple
SF Symbols Reference | SFSymbols.com

You may download the MacOS App from Apple for a better reference.

Note: underscores(_) and dots(.) must be swapped with hipens(-)

Breaking Changes

Starting with v3.0+, this repo has been changed from a lovelace/frontend repo to a full-fledged integration. If you're upgrading from an older version:

  1. HACS > Uninstall "cupertino-icons"
  2. HACS > Menu > Custom Repository
  3. Delete this repo
  4. Follow Install instructions above

Legal Disclaimer

Certain icons are copyrighted by Apple and are not allowed to used with modification. These icons have not been exported and are not present in this repo. They will not be included.

<hr/>

To Do

☑️ Upgrade to SF Pro Symbols v2.1
☑️ Upgrade to SF Pro Symbols v3.0
☑️ Multicolor support
☑️ Icon Picker

Changelog

v3.0.2

v3.0.1

v3.0