mirror of
https://github.com/walkxcode/dashboard-icons.git
synced 2024-11-13 07:07:59 +01:00
110 lines
No EOL
3.7 KiB
Markdown
110 lines
No EOL
3.7 KiB
Markdown
|
|
|
|
## Dashboard Icons
|
|
|
|
The best source for dashboard icons.<br />
|
|
[**View icons →**](ICONS.md)
|
|
|
|
## Table of Contents
|
|
- [Dashboard Icons](#dashboard-icons)
|
|
- [Table of Contents](#table-of-contents)
|
|
- [Icon Requests](#icon-requests)
|
|
- [Supported Dashboards](#supported-dashboards)
|
|
- [Usage and Details](#usage-and-details)
|
|
- [Direct Links](#direct-links)
|
|
- [Base URL](#base-url)
|
|
- [Name](#name)
|
|
- [Formats](#formats)
|
|
- [Dark/Light Versions](#darklight-versions)
|
|
- [Downloading Icons](#downloading-icons)
|
|
- [Disclaimer](#disclaimer)
|
|
|
|
## Icon Requests
|
|
|
|
If you're looking to add a new icon, please read the [Contribution Guidelines](CONTRIBUTING.md). Afterwards, submit a Pull Request or open an issue.
|
|
|
|
## Supported Dashboards
|
|
|
|
Several dashboards offer seamless integration with Dashboard Icons. Here are some of the most popular options:
|
|
|
|
- [Homepage](https://github.com/gethomepage/homepage)
|
|
- [Homarr](https://github.com/ajnart/homarr)
|
|
- [Dashy](https://github.com/Lissy93/dashy)
|
|
|
|
## Usage and Details
|
|
|
|
### Direct Links
|
|
|
|
Icons can be used directly from either GitHub or jsDelivr (recommended). Links consist of three components, each described below:
|
|
|
|
- **Base URL**
|
|
- **Name**
|
|
- **Format**
|
|
|
|
A complete link will look like this:
|
|
|
|
https://<Base URL>/<Format>/<Name>.<Format>
|
|
|
|
For example, the icon URL for the WEBP version of Nextcloud Calendar would be:
|
|
|
|
https://cdn.jsdelivr.net/gh/walkxcode/dashboard-icons/webp/nextcloud-calendar.webp
|
|
|
|
#### Base URL
|
|
|
|
We recommend using jsDelivr, a free and fast CDN:
|
|
|
|
- `https://cdn.jsdelivr.net/gh/walkxcode/dashboard-icons`
|
|
|
|
Alternatively, you can use direct links to the repository:
|
|
|
|
- `https://raw.githubusercontent.com/walkxcode/dashboard-icons/refs/heads/main`
|
|
|
|
#### Name
|
|
|
|
Icons are named using kebab case (lowercase words separated by hyphens). For example, "Nextcloud Calendar" becomes `nextcloud-calendar`.
|
|
|
|
#### Formats
|
|
|
|
Icons are available in the following formats:
|
|
|
|
- SVG
|
|
- PNG
|
|
- WEBP
|
|
|
|
All icons are generated from the SVG file as the base.
|
|
|
|
*Read more about the specifics and standards of icons in the [Contribution Guidelines](CONTRIBUTING.md).*
|
|
|
|
### Dark/Light Versions
|
|
|
|
In some cases, an icon might have very light or dark colors, making it hard to see on certain backgrounds. In this situation, a `-light` or `-dark` version will be added to the end of the icon's name, with colors adjusted accordingly.
|
|
|
|
For example, "2fauth" becomes `2fauth-light`.
|
|
|
|
*Read more about the specifics and standards of icons in the [Contribution Guidelines](CONTRIBUTING.md).*
|
|
|
|
### Downloading Icons
|
|
|
|
To download icons from the [icons page](ICONS.md), simply Right-click the icon link and select "Save link as".
|
|
|
|
**Warning**: Visiting the icons page will load every icon in the repository. This may result in:
|
|
|
|
- High data usage.
|
|
- System slowdowns.
|
|
- Browser crashes on some devices.
|
|
|
|
If you prefer not to load all icons at once, consider using the direct links or downloading icons individually.
|
|
|
|
To download icons using the terminal, use `curl` or `wget`. Refer to [Direct Links](#direct-links) for details on the link structure.
|
|
|
|
curl -O https://<Base URL>/<Format>/<Name>.<Format>
|
|
|
|
or
|
|
|
|
wget https://<Base URL>/<Format>/<Name>.<Format>
|
|
|
|
## Disclaimer
|
|
|
|
Unless otherwise indicated, all images and assets in this repository, including product names, trademarks, and registered trademarks, are the property of their respective owners. These images and assets are used for identification purposes only, and their use does not imply endorsement.
|
|
|
|
Read the [LICENSE](LICENSE) for more information about the project itself. For questions or concerns, contact me at [bjorn@lammers.media](mailto:bjorn@lammers.media). |