mirror of https://github.com/lissy93/dashy
📝 Adds docs for AdGuard widgets (#493)
This commit is contained in:
parent
5c896fded5
commit
1ad89958bc
150
docs/widgets.md
150
docs/widgets.md
|
@ -44,6 +44,10 @@ Dashy has support for displaying dynamic content in the form of widgets. There a
|
||||||
- [Recent Traffic](#recent-traffic)
|
- [Recent Traffic](#recent-traffic)
|
||||||
- [Stat Ping Statuses](#stat-ping-statuses)
|
- [Stat Ping Statuses](#stat-ping-statuses)
|
||||||
- [Synology Download Station](#synology-download-station)
|
- [Synology Download Station](#synology-download-station)
|
||||||
|
- [AdGuard Home Block Stats](#adguard-home-block-stats)
|
||||||
|
- [AdGuard Home Filters](#adguard-home-filters)
|
||||||
|
- [AdGuard Home DNS Info](#adguard-home-dns-info)
|
||||||
|
- [AdGuard Home Top Domains](#adguard-home-top-domains)
|
||||||
- **[System Resource Monitoring](#system-resource-monitoring)**
|
- **[System Resource Monitoring](#system-resource-monitoring)**
|
||||||
- [CPU Usage Current](#current-cpu-usage)
|
- [CPU Usage Current](#current-cpu-usage)
|
||||||
- [CPU Usage Per Core](#cpu-usage-per-core)
|
- [CPU Usage Per Core](#cpu-usage-per-core)
|
||||||
|
@ -1399,6 +1403,152 @@ Displays the current downloads/torrents tasks of your Synology NAS
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
|
### AdGuard Home Block Stats
|
||||||
|
|
||||||
|
Fetches data from your [AdGuard Home](https://adguard.com/en/adguard-home/overview.html) instance, and
|
||||||
|
displays total number of allowed and blocked queries, plus a pie chart showing breakdown by block type.
|
||||||
|
|
||||||
|
<p align="center"><img width="400" src="https://i.ibb.co/qgkcxsN/adguard-block-percent-2.png" /></p>
|
||||||
|
|
||||||
|
##### Options
|
||||||
|
|
||||||
|
**Field** | **Type** | **Required** | **Description**
|
||||||
|
--- | --- | --- | ---
|
||||||
|
**`hostname`** | `string` | Required | The URL to your AdGuard Home instance
|
||||||
|
**`username`** | `string` | _Optional_ | If you've got auth enabled on AdGuard, provide your username here
|
||||||
|
**`password`** | `string` | _Optional_ | If you've got auth enabled on AdGuard, provide your password here
|
||||||
|
|
||||||
|
##### Example
|
||||||
|
|
||||||
|
```yaml
|
||||||
|
- type: adguard-stats
|
||||||
|
useProxy: true
|
||||||
|
options:
|
||||||
|
hostname: http://127.0.0.1
|
||||||
|
username: admin
|
||||||
|
password: test
|
||||||
|
```
|
||||||
|
|
||||||
|
##### Info
|
||||||
|
- **CORS**: 🟠 Proxied
|
||||||
|
- **Auth**: 🟠 Optional
|
||||||
|
- **Price**: 🟢 Free
|
||||||
|
- **Host**: Self-Hosted (see [AdGuard Home](https://adguard.com/en/adguard-home/overview.html))
|
||||||
|
- **Privacy**: _See [AdGuard Privacy Policy](https://adguard.com/en/privacy.html)_
|
||||||
|
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### AdGuard Home Filters
|
||||||
|
|
||||||
|
Fetches data from your [AdGuard Home](https://adguard.com/en/adguard-home/overview.html) instance, to display the current status of each of your filter lists. Includes filter name, last updated, number of items, and a link to the list.
|
||||||
|
|
||||||
|
<p align="center"><img width="400" src="https://i.ibb.co/WsJkf5g/adguard-filters-list.png" /></p>
|
||||||
|
|
||||||
|
##### Options
|
||||||
|
|
||||||
|
**Field** | **Type** | **Required** | **Description**
|
||||||
|
--- | --- | --- | ---
|
||||||
|
**`hostname`** | `string` | Required | The URL to your AdGuard Home instance
|
||||||
|
**`username`** | `string` | _Optional_ | If you've got auth enabled on AdGuard, provide your username here
|
||||||
|
**`password`** | `string` | _Optional_ | If you've got auth enabled on AdGuard, provide your password here
|
||||||
|
**`showOnOffStatusOnly`** | `boolean` | _Optional_ | If set to `true`, will only show aggregated AdGuard filter status (on/off), instead of a list of filters
|
||||||
|
|
||||||
|
##### Example
|
||||||
|
|
||||||
|
```yaml
|
||||||
|
- type: adguard-filter-status
|
||||||
|
useProxy: true
|
||||||
|
options:
|
||||||
|
hostname: http://127.0.0.1
|
||||||
|
username: admin
|
||||||
|
password: test
|
||||||
|
showOnOffStatusOnly: false
|
||||||
|
```
|
||||||
|
|
||||||
|
##### Info
|
||||||
|
- **CORS**: 🟠 Proxied
|
||||||
|
- **Auth**: 🟠 Optional
|
||||||
|
- **Price**: 🟢 Free
|
||||||
|
- **Host**: Self-Hosted (see [AdGuard Home](https://adguard.com/en/adguard-home/overview.html))
|
||||||
|
- **Privacy**: _See [AdGuard Privacy Policy](https://adguard.com/en/privacy.html)_
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### AdGuard Home DNS Info
|
||||||
|
|
||||||
|
Fetches data from your [AdGuard Home](https://adguard.com/en/adguard-home/overview.html) instance, and displays the current status (Enabled / Disabled) of AdGuard DNS. Click show more to view detailed info, including upstream DNS provider, active ports, and the status of DNSSEC, EDNS CS, PTR and IPv6.
|
||||||
|
|
||||||
|
<p align="center"><img width="400" src="https://i.ibb.co/G0JngBb/adguard-dns-info.png" /></p>
|
||||||
|
|
||||||
|
##### Options
|
||||||
|
|
||||||
|
**Field** | **Type** | **Required** | **Description**
|
||||||
|
--- | --- | --- | ---
|
||||||
|
**`hostname`** | `string` | Required | The URL to your AdGuard Home instance
|
||||||
|
**`username`** | `string` | _Optional_ | If you've got auth enabled on AdGuard, provide your username here
|
||||||
|
**`password`** | `string` | _Optional_ | If you've got auth enabled on AdGuard, provide your password here
|
||||||
|
**`showFullInfo`** | `boolean` | _Optional_ | If set to `true`, the full DNS info will be shown by default, without having to click "Show Info"
|
||||||
|
|
||||||
|
##### Example
|
||||||
|
|
||||||
|
```yaml
|
||||||
|
- type: adguard-dns-info
|
||||||
|
useProxy: true
|
||||||
|
options:
|
||||||
|
hostname: http://127.0.0.1
|
||||||
|
username: admin
|
||||||
|
password: test
|
||||||
|
showFullInfo: false
|
||||||
|
```
|
||||||
|
|
||||||
|
##### Info
|
||||||
|
- **CORS**: 🟠 Proxied
|
||||||
|
- **Auth**: 🟠 Optional
|
||||||
|
- **Price**: 🟢 Free
|
||||||
|
- **Host**: Self-Hosted (see [AdGuard Home](https://adguard.com/en/adguard-home/overview.html))
|
||||||
|
- **Privacy**: _See [AdGuard Privacy Policy](https://adguard.com/en/privacy.html)_
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### AdGuard Home Top Domains
|
||||||
|
|
||||||
|
Fetches data from your [AdGuard Home](https://adguard.com/en/adguard-home/overview.html) instance, and displays a list of the most queried, and most blocked domains.
|
||||||
|
|
||||||
|
<p align="center"><img width="600" src="https://i.ibb.co/qRhYYTk/adguard-top-domains.png" /></p>
|
||||||
|
|
||||||
|
##### Options
|
||||||
|
|
||||||
|
**Field** | **Type** | **Required** | **Description**
|
||||||
|
--- | --- | --- | ---
|
||||||
|
**`hostname`** | `string` | Required | The URL to your AdGuard Home instance
|
||||||
|
**`username`** | `string` | _Optional_ | If you've got auth enabled on AdGuard, provide your username here
|
||||||
|
**`password`** | `string` | _Optional_ | If you've got auth enabled on AdGuard, provide your password here
|
||||||
|
**`limit`** | `number` | _Optional_ | Specify the number of results to show, between `1` and `100`, defaults to `10`
|
||||||
|
**`hideBlockedDomains`** | `boolean` | _Optional_ | Don't show the blocked domains list (queried domains only)
|
||||||
|
**`hideQueriedDomains`** | `boolean` | _Optional_ | Don't show the queried domains list (blocked domains only)
|
||||||
|
|
||||||
|
##### Example
|
||||||
|
|
||||||
|
```yaml
|
||||||
|
- type: adguard-top-domains
|
||||||
|
useProxy: true
|
||||||
|
options:
|
||||||
|
hostname: http://127.0.0.1
|
||||||
|
username: admin
|
||||||
|
password: test
|
||||||
|
limit: 10
|
||||||
|
```
|
||||||
|
|
||||||
|
##### Info
|
||||||
|
- **CORS**: 🟠 Proxied
|
||||||
|
- **Auth**: 🟠 Optional
|
||||||
|
- **Price**: 🟢 Free
|
||||||
|
- **Host**: Self-Hosted (see [AdGuard Home](https://adguard.com/en/adguard-home/overview.html))
|
||||||
|
- **Privacy**: _See [AdGuard Privacy Policy](https://adguard.com/en/privacy.html)_
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
## System Resource Monitoring
|
## System Resource Monitoring
|
||||||
|
|
||||||
The easiest method for displaying system info and resource usage in Dashy is with [Glances](https://nicolargo.github.io/glances/).
|
The easiest method for displaying system info and resource usage in Dashy is with [Glances](https://nicolargo.github.io/glances/).
|
||||||
|
|
Loading…
Reference in New Issue