Skip to content

Update all mentions links to MDI with the updated URL #25789

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 1 commit into from
Jan 16, 2023
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion source/_dashboards/markdown.markdown
Original file line number Diff line number Diff line change
Expand Up @@ -103,7 +103,7 @@ content: |

## Icons

You can use [materialdesignicons.com](https://materialdesignicons.com/) icons in the `content` of the card.
You can use [Material Design Icons](https://pictogrammers.com/library/mdi/) icons in the `content` of the card.

For example:

Expand Down
2 changes: 1 addition & 1 deletion source/_docs/configuration/customizing-devices.markdown
Original file line number Diff line number Diff line change
Expand Up @@ -32,7 +32,7 @@ entity_picture:
required: false
type: string
icon:
description: "Any icon from [MaterialDesignIcons.com](https://materialdesignicons.com). Prefix name with `mdi:`, ie `mdi:home`. Note: Newer icons may not yet be available in the current Home Assistant release. You can check when an icon was added to MaterialDesignIcons.com at [MDI History](https://materialdesignicons.com/history)."
description: "Any icon from [Material Design Icons](https://pictogrammers.com/library/mdi/). Prefix name with `mdi:`, ie `mdi:home`. Note: Newer icons may not yet be available in the current Home Assistant release."
required: false
type: string
assumed_state:
Expand Down
2 changes: 1 addition & 1 deletion source/_docs/frontend.markdown
Original file line number Diff line number Diff line change
Expand Up @@ -18,7 +18,7 @@ The frontend is built with [Polymer](https://www.polymer-project.org/).

## Icons

Home Assistant utilizes the community-driven [Material Design Icons](https://www.materialdesignicons.com/) project for icons in the frontend. The [Icons section](/docs/frontend/icons/) has more information on how to use icons and suggest new ones.
Home Assistant utilizes the community-driven [Material Design Icons](https://pictogrammers.com/library/mdi/) project for icons in the frontend. The [Icons section](/docs/frontend/icons/) has more information on how to use icons and suggest new ones.

## Examples

Expand Down
18 changes: 9 additions & 9 deletions source/_docs/frontend/icons.markdown
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@ description: "Material Design Icons in the Home Assistant frontend"
<img src='/images/frontend/mdi.png' alt='Material Design Icons' />
</p>

Home Assistant utilizes the community-driven [Material Design Icons](https://www.materialdesignicons.com/) (MDI) project for icons in the frontend. The icon library is a superset of the base icon library provided by Google and contains thousands of community-made icons for very specific applications, industries, and use-cases.
Home Assistant utilizes the community-driven [Material Design Icons](https://pictogrammers.com/library/mdi/) (MDI) project for icons in the frontend. The icon library is a superset of the base icon library provided by Google and contains thousands of community-made icons for very specific applications, industries, and use-cases.

## Default Icons

Expand Down Expand Up @@ -43,23 +43,23 @@ The easiest way to browse and find icons outside of Home Assistant is with the o

</div>

### MaterialDesignIcons.com
### Material Design Icons on the Pictogrammers Website

The last way to browse through available icons is on the official website, [MaterialDesignIcons.com](https://materialdesignicons.com).
The last way to browse through available icons is by viewing the library on the Pictogrammers website, [https://pictogrammers.com/library/mdi/](https://pictogrammers.com/library/mdi/). Select an icon you'd like to use, then click "Home Assistant" to see an example of its usage.

<div class='note info'>

The official MDI website is updated in real-time as new icons are added. This means an icon you find there may not yet be released or available in Home Assistant (yet!) for several releases. You can check when an icon was added by viewing the [MDI history](https://materialdesignicons.com/history).
The Pictogrammers website will always show the latest release of the Material Design Icons library. However, you may find icons that may not yet be available in Home Assistant (yet!). Watch the Home Assistant release notes for announcements on upgrades of the Material Design Icons library.

</div>

## Suggesting or Contributing New Icons

Being open-source like Home Assistant, the Material Design Icons project is always accepting suggestions and contributions to expand the library.
Being open-source like Home Assistant, the Material Design Icons library is always accepting suggestions and contributions to expand the library.

<div class='note info'>

Before suggesting or creating a new icon, it is very important that you [search the current library](https://materialdesignicons.com) and [search all issues](https://github.com/Templarian/MaterialDesign/issues?q=is%3Aissue), open and closed, on their GitHub. Try searching with different terms that might mean the same thing. (e.g. "user", "person", "account")
Before suggesting or creating a new icon, it is very important that you [search the current library](https://pictogrammers.com/library/mdi/) and [search all issues](https://github.com/Templarian/MaterialDesign/issues?q=is%3Aissue), open and closed, on their GitHub. Try searching with different terms that might mean the same thing. (e.g. "user", "person", "account")

</div>

Expand All @@ -69,16 +69,16 @@ If you have an idea for an icon that isn't currently in the library, but are not

### Contributing a New Icon

If you want to contribute a new icon to the library, familiarize yourself with the [System icons guidelines](https://material.io/design/iconography/system-icons.html#design-principles) in the Material Design system. Then create your icon and [submit it to the MDI team for review](https://github.com/Templarian/MaterialDesign/issues/new?assignees=&labels=Icon+Request%2CContribution&template=2_contribution.yml).
If you want to contribute a new icon to the library, familiarize yourself with the [System icons guidelines](https://material.io/design/iconography/system-icons.html#design-principles) in the Material Design system. Then create your icon and [submit it to the Pictogrammers team for review](https://github.com/Templarian/MaterialDesign/issues/new?assignees=&labels=Icon+Request%2CContribution&template=2_contribution.yml).

#### Tips for Creating New Icons

- Really pay attention to [Material Design guidelines](https://material.io/design/iconography/system-icons.html#design-principles).
- Keep in mind that icons are meant to be contextual, not literal.
- When it comes to little details, less is more.
- If you're unsure, open an issue with MDI. They're more than happy to help you!
- If you're unsure, open an issue on their GitHub. They're more than happy to help you!
- Not all icons make it into the library and that is okay!

### Suggesting an Icon Alias

Sometimes an icon exists, but you aren't able to find it with the terms you were searching for. If this has ever happened to you, please [open an issue with the MDI team to suggest new aliases](https://github.com/Templarian/MaterialDesign/issues/new?assignees=&labels=Alias&template=4_alias.yml) that can be added to existing icons.
Sometimes an icon exists, but you aren't able to find it with the terms you were searching for. If this has ever happened to you, please [open an issue with the Pictogrammers team to suggest new aliases](https://github.com/Templarian/MaterialDesign/issues/new?assignees=&labels=Alias&template=4_alias.yml) that can be added to existing icons.
2 changes: 1 addition & 1 deletion source/_integrations/counter.markdown
Original file line number Diff line number Diff line change
Expand Up @@ -75,7 +75,7 @@ counter:
type: icon
{% endconfiguration %}

Pick an icon that you can find on [materialdesignicons.com](https://materialdesignicons.com/) to use for your input and prefix the name with `mdi:`. For example `mdi:car`, `mdi:ambulance` or `mdi:motorbike`.
Pick an icon that from [Material Design Icons](https://pictogrammers.com/library/mdi/) to use for your input and prefix the name with `mdi:`. For example `mdi:car`, `mdi:ambulance` or `mdi:motorbike`.

### Restore State

Expand Down
2 changes: 1 addition & 1 deletion source/_integrations/panel_custom.markdown
Original file line number Diff line number Diff line change
Expand Up @@ -43,7 +43,7 @@ sidebar_title:
required: false
type: string
sidebar_icon:
description: Icon for entry. Pick an icon that you can find on [materialdesignicons.com](https://materialdesignicons.com/) to use for your input and prefix the name with `mdi:`. For example `mdi:car`, `mdi:ambulance`, or `mdi:motorbike`.
description: Icon for entry. Pick an icon that from [Material Design Icons](https://pictogrammers.com/library/mdi/) to use for your input and prefix the name with `mdi:`. For example `mdi:car`, `mdi:ambulance`, or `mdi:motorbike`.
required: false
default: "mdi:bookmark"
type: icon
Expand Down
2 changes: 1 addition & 1 deletion source/_integrations/timer.markdown
Original file line number Diff line number Diff line change
Expand Up @@ -60,7 +60,7 @@ timer:
default: false
{% endconfiguration %}

Pick an icon that you can find on [materialdesignicons.com](https://materialdesignicons.com/) to use for your timer and prefix the name with `mdi:`. For example `mdi:car`, `mdi:ambulance`, or `mdi:motorbike`.
Pick an icon from [Material Design Icons](https://pictogrammers.com/library/mdi/) to use for your timer and prefix the name with `mdi:`. For example `mdi:car`, `mdi:ambulance`, or `mdi:motorbike`.

## Possible States

Expand Down
2 changes: 1 addition & 1 deletion source/_integrations/weather.markdown
Original file line number Diff line number Diff line change
Expand Up @@ -17,7 +17,7 @@ Home Assistant currently supports free web services some of which require regist

## Condition mapping

The `weather` platform only knows the below listed conditions. The reason for this is that for these conditions is an icon from [Material Design Icons](https://materialdesignicons.com/) available and mapped in the frontend.
The `weather` platform only knows the below listed conditions. The reason for this is that for these conditions is an icon from [Material Design Icons](https://pictogrammers.com/library/mdi/) available and mapped in the frontend.

- 'clear-night'
- 'cloudy'
Expand Down
2 changes: 1 addition & 1 deletion source/_integrations/zone.markdown
Original file line number Diff line number Diff line change
Expand Up @@ -86,7 +86,7 @@ Devices that are in the zone **'Home'** will not appear on the map in the Home A

## Icons

It is recommended that you pick an icon to use for your zone. Pick any icon that you can find on [materialdesignicons.com](https://materialdesignicons.com/) and prefix the name with `mdi:`. For example `mdi:school`, `mdi:briefcase`, `mdi:home`, `mdi:cart`, or `mdi:castle`.
It is recommended that you pick an icon to use for your zone. Pick any icon from [Material Design Icons](https://pictogrammers.com/library/mdi/) and prefix the name with `mdi:`. For example `mdi:school`, `mdi:briefcase`, `mdi:home`, `mdi:cart`, or `mdi:castle`.

## State

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@ categories:
- Core
---

<img src='/images/screenshots/custom-icons.png' style='float: right;' />We have all been hard at work to get this latest release ready. One of the big highlights in this release is the introduction of an extended iconset to be used in the frontend (credits to [@happyleavesaoc] for idea and prototype). To get started with customizing, pick any icon from [MaterialDesignIcons.com], prefix the name with `mdi:` and stick it into your `customize` section in `configuration.yaml`:
<img src='/images/screenshots/custom-icons.png' style='float: right;' />We have all been hard at work to get this latest release ready. One of the big highlights in this release is the introduction of an extended iconset to be used in the frontend (credits to [@happyleavesaoc] for idea and prototype). To get started with customizing, pick any icon from [Material Design Icons], prefix the name with `mdi:` and stick it into your `customize` section in `configuration.yaml`:

```yaml
homeassistant:
Expand All @@ -21,7 +21,7 @@ homeassistant:

#### Breaking changes

- Any existing zone icon will have to be replaced with one from [MaterialDesignIcons.com].
- Any existing zone icon will have to be replaced with one from [Material Design Icons].
- LimitlessLED light services require colors to be specified in RGB instead of XY.

#### Changes
Expand All @@ -43,7 +43,7 @@ homeassistant:
* Switch RGB as the color unit used in light component ([@balloob])
* Re-install platform and component dependencies after a Home Assistant version upgrade ([@balloob])

[MaterialDesignIcons.com]: https://MaterialDesignIcons.com
[Material Design Icons]: https://pictogrammers.com/library/mdi/
[@sander76]: https://github.com/sander76
[@happyleavesaoc]: https://github.com/happyleavesaoc
[@ryanturner]: https://github.com/ryanturner
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -21,7 +21,7 @@ Also want to take a moment to thank Austin Andrews aka [Templarian] for his [Mat

[hass-fb]: https://www.facebook.com/homeassistantio
[diyAutomate]: https://www.youtube.com/c/diyautomate
[mli]: https://materialdesignicons.com/
[mli]: https://pictogrammers.com/library/mdi/
[Templarian]: https://github.com/templarian

## New integrations
Expand Down
2 changes: 1 addition & 1 deletion source/_posts/2019-02-06-release-87.markdown
Original file line number Diff line number Diff line change
Expand Up @@ -23,7 +23,7 @@ This release also includes a UI to manage the entity registry. The entity regist

We didn't forget about the frontend in this release. In the last release we introduced Lovelace, so for this release we focused on bug squashing, performance improvements and usability. The YAML editor is now rendered using a full editor including line numbers thanks to [@bramkragten]. There is also a new system health component that will help users diagnose problems from the "info" developer tool. [See changelog for the frontend.](https://github.com/home-assistant/home-assistant-polymer/releases/tag/20190130.1)

In this release we have also upgraded the Material Design Icons to 3.3.92, which renames some icons. Make sure to check [their changelog](https://dev.materialdesignicons.com/upgrade).
In this release we have also upgraded the Material Design Icons to 3.3.92, which renames some icons. Make sure to check [their changelog](https://pictogrammers.com/docs/library/mdi/releases/changelog/).

If you prefer a podcast over release notes, check out [the Hass Podcast](https://hasspodcast.io/ha043/) in which Phil and Rohan discuss each new Home Assistant release and keep a tap on what's happening in the home automation space.

Expand Down
4 changes: 2 additions & 2 deletions source/_posts/2020-07-01-release-113.markdown
Original file line number Diff line number Diff line change
Expand Up @@ -351,8 +351,8 @@ Please note: It is possible that custom integrations (also known as
custom components) use deprecated icons. These can throw warnings that need
to be addressed in the custom integration.

[mdi]: https://materialdesignicons.com
[mdi-upgrade]: https://dev.materialdesignicons.com/upgrade#4.9.95-to-5.0.45
[mdi]: https://pictogrammers.com/library/mdi/
[mdi-upgrade]: https://pictogrammers.com/docs/library/mdi/releases/upgrade/#4995-to-5045
[simple-icons]: https://simpleicons.org/
[hass-simpleicons]: https://github.com/vigonotion/hass-simpleicons

Expand Down
6 changes: 3 additions & 3 deletions source/_posts/2020-09-17-release-115.markdown
Original file line number Diff line number Diff line change
Expand Up @@ -814,7 +814,7 @@ Drag and and drop the entities in the order you want.

- The [Met.no](/integrations/met) now supports hourly forecasts, very nice [@bruxy70]!

- The MDI icons are updated to version [5.5.55](https://dev.materialdesignicons.com/changelog#version-5.5.55),
- The MDI icons are updated to version [5.5.55](https://pictogrammers.com/docs/library/mdi/releases/changelog/#version-5555),
this adds another 100 icons you can use!

- The Google Assistant integration got some updates:
Expand Down Expand Up @@ -1309,7 +1309,7 @@ corner of the Lovelace screen.
<summary><b>MDI Icons</b></summary>
<p>

The MDI icons are updated to version [5.5.55](https://dev.materialdesignicons.com/changelog#version-5.5.55),
The MDI icons are updated to version [5.5.55](https://pictogrammers.com/docs/library/mdi/releases/changelog/#version-5555),
this adds another 100 icons you can use!

In 5.5.55 there was 1 breaking change, if you used the icon `mdi:scooter` this
Expand All @@ -1318,7 +1318,7 @@ configuration.

All icons that were deprecated in [0.113.0](/blog/2020/07/22/release-113/#mdi-icons-updated)
have now been removed. Icons that were renamed or deleted in
version [5.0.45](https://dev.materialdesignicons.com/upgrade#4.9.95-to-5.0.45)
version [5.0.45](https://pictogrammers.com/docs/library/mdi/releases/upgrade/#4995-to-5045)
will no longer work.

</p>
Expand Down
2 changes: 1 addition & 1 deletion source/_posts/2021-10-06-release-202110.markdown
Original file line number Diff line number Diff line change
Expand Up @@ -162,7 +162,7 @@ they will keep working for the upcoming two releases. Home Assistant will
write warnings in the logs in case you are using one of the affected icons.
The breaking changes section has more information about this.

[mdi]: https://materialdesignicons.com/
[mdi]: https://pictogrammers.com/library/mdi/

## Encrypted communications support for ESPHome

Expand Down
2 changes: 1 addition & 1 deletion source/_posts/2021-11-03-release-202111.markdown
Original file line number Diff line number Diff line change
Expand Up @@ -185,7 +185,7 @@ Adding nice and matching icons to your entities, makes all the difference for
how your Home Assistant interface looks and feels.

Finding those icons was somewhat clumsy. You'd go to the
[Material Design Icons](https://materialdesignicons.com/) website to find one,
[Material Design Icons](https://pictogrammers.com/library/mdi/) website to find one,
remember its code and add the `mdi:<code>` to your entity. Not a great
experience, especially with the number of icons available your browser doesn't
always like that website.
Expand Down
2 changes: 1 addition & 1 deletion source/_posts/2022-04-06-release-20224.markdown
Original file line number Diff line number Diff line change
Expand Up @@ -495,7 +495,7 @@ noteworthy changes this release:
[Hue]: /integrations/hue
[Linn / OpenHome]: /integrations/linn
[Logitech Squeezebox]: /integrations/squeezebox
[Material Design Icons]: https://materialdesignicons.com/
[Material Design Icons]: https://pictogrammers.com/library/mdi/
[Music Player Daemon (MPD)]: /integrations/mpd
[Panasonic Viera]: /integrations/panasonic_viera
[RFXCOM RFXtrx]: /integrations/rfxtrx
Expand Down
2 changes: 1 addition & 1 deletion source/_posts/2022-08-03-release-20228.markdown
Original file line number Diff line number Diff line change
Expand Up @@ -784,7 +784,7 @@ to handle the extra decimal places.
{% details "Material Design Icons" %}

In the latest Material Design Icons update,
[several icons have been renamed or removed](https://dev.materialdesignicons.com/changelog#version-7.0.96).
[several icons have been renamed or removed](https://pictogrammers.com/docs/library/mdi/releases/changelog/#version-7096).
Removed and renamed icons will continue to work for the next two releases.

Please make sure you update any use of the following MDI icons:
Expand Down
4 changes: 2 additions & 2 deletions source/dashboards/badges.markdown
Original file line number Diff line number Diff line change
Expand Up @@ -30,7 +30,7 @@ name:
default: Name of entity
icon:
required: false
description: Overwrites icon or entity picture. You can use any icon from [MaterialDesignIcons.com](https://materialdesignicons.com). Prefix the icon name with `mdi:`, ie `mdi:home`.
description: Overwrites icon or entity picture. You can use any icon from [Material Design Icons](https://pictogrammers.com/library/mdi/). Prefix the icon name with `mdi:`, ie `mdi:home`.
type: string
default: Entity domain icon
image:
Expand Down Expand Up @@ -87,7 +87,7 @@ name:
type: string
icon:
required: false
description: Overwrites icon or entity picture. You can use any icon from [MaterialDesignIcons.com](https://materialdesignicons.com). Prefix the icon name with `mdi:`, ie `mdi:home`.
description: Overwrites icon or entity picture. You can use any icon from [Material Design Icons](https://pictogrammers.com/library/mdi/). Prefix the icon name with `mdi:`, ie `mdi:home`.
type: string
image:
required: false
Expand Down
2 changes: 1 addition & 1 deletion source/dashboards/dashboards.markdown
Original file line number Diff line number Diff line change
Expand Up @@ -110,7 +110,7 @@ dashboards:
type: string
icon:
required: false
description: The icon to show in the sidebar. You can use any icon from [MaterialDesignIcons.com](https://materialdesignicons.com). Prefix the icon name with `mdi:`, ie `mdi:home`.
description: The icon to show in the sidebar. You can use any icon from [Material Design Icons](https://pictogrammers.com/library/mdi/). Prefix the icon name with `mdi:`, ie `mdi:home`.
type: string
show_in_sidebar:
required: false
Expand Down
2 changes: 1 addition & 1 deletion source/dashboards/header-footer.markdown
Original file line number Diff line number Diff line change
Expand Up @@ -69,7 +69,7 @@ entities:
type: string
icon:
required: false
description: Override the entity icon. You can use any icon from [MaterialDesignIcons.com](https://materialdesignicons.com). Prefix the icon name with `mdi:`, ie `mdi:home`.
description: Override the entity icon. You can use any icon from [Material Design Icons](https://pictogrammers.com/library/mdi/). Prefix the icon name with `mdi:`, ie `mdi:home`.
type: string
image:
required: false
Expand Down
2 changes: 1 addition & 1 deletion source/dashboards/index.markdown
Original file line number Diff line number Diff line change
Expand Up @@ -29,4 +29,4 @@ To try it yourself, check out [the demo](https://demo.home-assistant.io).

- [Community Custom Cards](https://github.com/custom-cards)
- [Home Assistant Cards](https://home-assistant-cards.bessarabov.com/)
- [Material Design Icons](https://materialdesignicons.com/tag/community)
- [Material Design Icons](https://pictogrammers.com/library/mdi/)
2 changes: 1 addition & 1 deletion source/dashboards/views.markdown
Original file line number Diff line number Diff line change
Expand Up @@ -181,7 +181,7 @@ views:
default: view index
icon:
required: false
description: Icon-name from Material Design Icons. You can use any icon from [MaterialDesignIcons.com](https://materialdesignicons.com). Prefix the icon name with `mdi:`, ie `mdi:home`. Only for "View", not for "Subview".
description: Icon-name from Material Design Icons. You can use any icon from [Material Design Icons](https://pictogrammers.com/library/mdi/). Prefix the icon name with `mdi:`, ie `mdi:home`. Only for "View", not for "Subview".
type: string
background:
required: false
Expand Down