Compare commits

...

3 Commits

Author SHA1 Message Date
shamoon
0b61b6c1b8 Merge branch 'dev' 2026-03-27 20:23:47 -07:00
github-actions[bot]
7b552f5080 New Crowdin translations by GitHub Action (#6433)
Co-authored-by: Crowdin Bot <support+bot@crowdin.com>
2026-03-27 15:16:31 -07:00
Steven Harris
0f767d14bb Feature: UniFi Drive (UNAS) service widget (#6461)
Co-authored-by: shamoon <4887959+shamoon@users.noreply.github.com>
2026-03-27 15:10:18 -07:00
53 changed files with 629 additions and 93 deletions

View File

@@ -0,0 +1,24 @@
---
title: UniFi Drive
description: UniFi Drive Widget Configuration
---
Learn more about [UniFi Drive](https://ui.com/integrations/network-storage).
## Configuration
Displays storage statistics from your UniFi Network Attached Storage (UNAS) device. Requires a local UniFi account with at least read privileges.
Allowed fields: `["total", "used", "available", "status"]`
```yaml
widget:
type: unifi_drive
url: https://unifi.host.or.ip
username: your_username
password: your_password
```
!!! hint
If you enter incorrect credentials and receive an "API Error", you may need to recreate the container or restart the service to clear the cache.

View File

@@ -171,6 +171,7 @@ nav:
- widgets/services/truenas.md
- widgets/services/tubearchivist.md
- widgets/services/unifi-controller.md
- widgets/services/unifi-drive.md
- widgets/services/unmanic.md
- widgets/services/unraid.md
- widgets/services/uptime-kuma.md

View File

@@ -66,6 +66,11 @@
"wait": "Wag asseblief",
"empty_data": "Substelsel status onbekend"
},
"unifi_drive": {
"healthy": "Healthy",
"degraded": "Degraded",
"no_data": "No storage data available"
},
"docker": {
"rx": "RX",
"tx": "TX",

View File

@@ -66,6 +66,11 @@
"wait": "Please wait",
"empty_data": "حالة النظام الفرعي غير معروفة"
},
"unifi_drive": {
"healthy": "Healthy",
"degraded": "Degraded",
"no_data": "No storage data available"
},
"docker": {
"rx": "استقبال",
"tx": "ارسال",

View File

@@ -66,6 +66,11 @@
"wait": "Моля изчакайте",
"empty_data": "Неизвестен статус на подсистема"
},
"unifi_drive": {
"healthy": "Healthy",
"degraded": "Degraded",
"no_data": "No storage data available"
},
"docker": {
"rx": "ПЧ",
"tx": "ИЗ",

View File

@@ -66,6 +66,11 @@
"wait": "Si us plau espera",
"empty_data": "Estat del subsistema desconegut"
},
"unifi_drive": {
"healthy": "Healthy",
"degraded": "Degraded",
"no_data": "No storage data available"
},
"docker": {
"rx": "Rebut",
"tx": "Transmès",

View File

@@ -66,6 +66,11 @@
"wait": "Čekejte prosím",
"empty_data": "Stav podsystému neznámý"
},
"unifi_drive": {
"healthy": "Healthy",
"degraded": "Degraded",
"no_data": "No storage data available"
},
"docker": {
"rx": "RX",
"tx": "TX",

View File

@@ -66,6 +66,11 @@
"wait": "Please wait",
"empty_data": "Subsystem status ukendt"
},
"unifi_drive": {
"healthy": "Healthy",
"degraded": "Degraded",
"no_data": "No storage data available"
},
"docker": {
"rx": "RX",
"tx": "TX",

View File

@@ -66,6 +66,11 @@
"wait": "Bitte warten",
"empty_data": "Subsystem-Status unbekannt"
},
"unifi_drive": {
"healthy": "Healthy",
"degraded": "Degraded",
"no_data": "No storage data available"
},
"docker": {
"rx": "RX",
"tx": "TX",
@@ -115,7 +120,7 @@
"movies": "Filme",
"series": "Serien",
"episodes": "Episoden",
"songs": "Songs"
"songs": "Titel"
},
"esphome": {
"offline": "Offline",
@@ -185,10 +190,10 @@
"plex_connection_error": "Prüfe Plex-Verbindung"
},
"tracearr": {
"no_active": "No Active Streams",
"no_active": "Keine aktiven Streams",
"streams": "Streams",
"transcodes": "Transcodes",
"directplay": "Direct Play",
"transcodes": "Transkodieren",
"directplay": "Direkte Wiedergabe",
"bitrate": "Bitrate"
},
"omada": {
@@ -290,10 +295,10 @@
"available": "Verfügbar"
},
"seerr": {
"pending": "Pending",
"approved": "Approved",
"available": "Available",
"completed": "Completed",
"pending": "Ausstehend",
"approved": "Bestätigt",
"available": "Verfügbar",
"completed": "Abgeschlossen",
"processing": "Processing",
"issues": "Open Issues"
},
@@ -811,7 +816,7 @@
"series": "Serien"
},
"booklore": {
"libraries": "Libraries",
"libraries": "Bibliotheken",
"books": "Bücher",
"reading": "Reading",
"finished": "Finished"
@@ -1176,7 +1181,7 @@
"environment_not_found": "Umgebung nicht gefunden"
},
"sparkyfitness": {
"eaten": "Eaten",
"eaten": "",
"burned": "Burned",
"remaining": "Remaining",
"steps": "Steps"

View File

@@ -66,6 +66,11 @@
"wait": "Please wait",
"empty_data": "Άγνωστη κατάσταση υποσυστήματος"
},
"unifi_drive": {
"healthy": "Healthy",
"degraded": "Degraded",
"no_data": "No storage data available"
},
"docker": {
"rx": "RX",
"tx": "TX",

View File

@@ -66,6 +66,11 @@
"wait": "Please wait",
"empty_data": "Subsystem status unknown"
},
"unifi_drive": {
"healthy": "Healthy",
"degraded": "Degraded",
"no_data": "No storage data available"
},
"docker": {
"rx": "RX",
"tx": "TX",

View File

@@ -66,6 +66,11 @@
"wait": "Please wait",
"empty_data": "Subsistemostatuso nekonata"
},
"unifi_drive": {
"healthy": "Healthy",
"degraded": "Degraded",
"no_data": "No storage data available"
},
"docker": {
"rx": "RX",
"tx": "TX",

View File

@@ -66,6 +66,11 @@
"wait": "Espere, por favor",
"empty_data": "Se desconoce el estado del subsistema"
},
"unifi_drive": {
"healthy": "Healthy",
"degraded": "Degraded",
"no_data": "No storage data available"
},
"docker": {
"rx": "Recibido",
"tx": "Transmitido",

View File

@@ -66,6 +66,11 @@
"wait": "Please wait",
"empty_data": "Subsystem status unknown"
},
"unifi_drive": {
"healthy": "Healthy",
"degraded": "Degraded",
"no_data": "No storage data available"
},
"docker": {
"rx": "RX",
"tx": "TX",

View File

@@ -66,6 +66,11 @@
"wait": "Please wait",
"empty_data": "Subsystem status unknown"
},
"unifi_drive": {
"healthy": "Healthy",
"degraded": "Degraded",
"no_data": "No storage data available"
},
"docker": {
"rx": "RX",
"tx": "TX",

View File

@@ -66,6 +66,11 @@
"wait": "Veuillez patienter",
"empty_data": "Statut du sous-système inconnu"
},
"unifi_drive": {
"healthy": "Healthy",
"degraded": "Degraded",
"no_data": "No storage data available"
},
"docker": {
"rx": "Rx",
"tx": "Tx",

View File

@@ -66,6 +66,11 @@
"wait": "נא להמתין",
"empty_data": "מצב תת-מערכת לא ידוע"
},
"unifi_drive": {
"healthy": "Healthy",
"degraded": "Degraded",
"no_data": "No storage data available"
},
"docker": {
"rx": "RX",
"tx": "TX",

View File

@@ -66,6 +66,11 @@
"wait": "Please wait",
"empty_data": "Subsystem status unknown"
},
"unifi_drive": {
"healthy": "Healthy",
"degraded": "Degraded",
"no_data": "No storage data available"
},
"docker": {
"rx": "RX",
"tx": "TX",

View File

@@ -66,6 +66,11 @@
"wait": "Pričekaj",
"empty_data": "Stanje podsustava nepoznato"
},
"unifi_drive": {
"healthy": "Healthy",
"degraded": "Degraded",
"no_data": "No storage data available"
},
"docker": {
"rx": "RX",
"tx": "TX",

View File

@@ -66,6 +66,11 @@
"wait": "Kérjük várjon",
"empty_data": "Az alrendszer állapota ismeretlen"
},
"unifi_drive": {
"healthy": "Healthy",
"degraded": "Degraded",
"no_data": "No storage data available"
},
"docker": {
"rx": "RX",
"tx": "TX",

View File

@@ -66,6 +66,11 @@
"wait": "Please wait",
"empty_data": "Status subsistem tdk diketahui"
},
"unifi_drive": {
"healthy": "Healthy",
"degraded": "Degraded",
"no_data": "No storage data available"
},
"docker": {
"rx": "RX",
"tx": "TX",

View File

@@ -66,6 +66,11 @@
"wait": "Please wait",
"empty_data": "Stato del sottosistema sconosciuto"
},
"unifi_drive": {
"healthy": "Healthy",
"degraded": "Degraded",
"no_data": "No storage data available"
},
"docker": {
"rx": "RX",
"tx": "TX",

View File

@@ -66,6 +66,11 @@
"wait": "お待ちください",
"empty_data": "サブシステムの状態は不明"
},
"unifi_drive": {
"healthy": "Healthy",
"degraded": "Degraded",
"no_data": "No storage data available"
},
"docker": {
"rx": "受信済み",
"tx": "送信済み",

View File

@@ -66,6 +66,11 @@
"wait": "잠시만 기다려주세요",
"empty_data": "서브시스템 상태 알 수 없음"
},
"unifi_drive": {
"healthy": "Healthy",
"degraded": "Degraded",
"no_data": "No storage data available"
},
"docker": {
"rx": "수신",
"tx": "송신",
@@ -108,14 +113,14 @@
"songs": "음악"
},
"jellyfin": {
"playing": "Playing",
"transcoding": "Transcoding",
"bitrate": "Bitrate",
"no_active": "No Active Streams",
"movies": "Movies",
"series": "Series",
"episodes": "Episodes",
"songs": "Songs"
"playing": "재생 중",
"transcoding": "트랜스코딩 중",
"bitrate": "비트레이트",
"no_active": "활성 스트림 없음",
"movies": "영상",
"series": "시리즈",
"episodes": "에피소드",
"songs": "음악"
},
"esphome": {
"offline": "오프라인",
@@ -185,11 +190,11 @@
"plex_connection_error": "Plex 연결 확인"
},
"tracearr": {
"no_active": "No Active Streams",
"streams": "Streams",
"transcodes": "Transcodes",
"directplay": "Direct Play",
"bitrate": "Bitrate"
"no_active": "활성 스트림 없음",
"streams": "스트림",
"transcodes": "트랜스코드",
"directplay": "다이렉트 플레이",
"bitrate": "비트레이트"
},
"omada": {
"connectedAp": "연결된 AP",
@@ -290,12 +295,12 @@
"available": "이용 가능"
},
"seerr": {
"pending": "Pending",
"approved": "Approved",
"available": "Available",
"completed": "Completed",
"processing": "Processing",
"issues": "Open Issues"
"pending": "대기 중",
"approved": "승인됨",
"available": "사용 가능",
"completed": "완료됨",
"processing": "처리 중",
"issues": "열린 이슈"
},
"netalertx": {
"total": "전체",
@@ -546,7 +551,7 @@
"up": "업",
"pending": "대기 중",
"down": "다운",
"ok": "Ok"
"ok": "확인"
},
"healthchecks": {
"new": "신규",
@@ -618,9 +623,9 @@
"sites": "Sites",
"resources": "Resources",
"targets": "Targets",
"traffic": "Traffic",
"in": "In",
"out": "Out"
"traffic": "트래픽",
"in": "수신",
"out": "송신"
},
"peanut": {
"battery_charge": "배터리 충전",
@@ -719,8 +724,8 @@
"volumeAvailable": "사용 가능"
},
"dispatcharr": {
"channels": "Channels",
"streams": "Streams"
"channels": "채널",
"streams": "스트림"
},
"mylar": {
"series": "시리즈",
@@ -787,7 +792,7 @@
"gross_percent_today": "오늘",
"gross_percent_1y": "1년",
"gross_percent_max": "전체 기간",
"net_worth": "Net Worth"
"net_worth": "순자산"
},
"audiobookshelf": {
"podcasts": "팟캐스트",
@@ -811,10 +816,10 @@
"series": "시리즈"
},
"booklore": {
"libraries": "Libraries",
"books": "Books",
"reading": "Reading",
"finished": "Finished"
"libraries": "라이브러리",
"books": "",
"reading": "읽는 중",
"finished": "완료"
},
"jdownloader": {
"downloadCount": "대기열",
@@ -1150,30 +1155,30 @@
"bytes_added_30": "추가된 용량"
},
"yourspotify": {
"songs": "Songs",
"time": "Time",
"artists": "Artists"
"songs": "음악",
"time": "시간",
"artists": "아티스트"
},
"arcane": {
"containers": "Containers",
"images": "Images",
"image_updates": "Image Updates",
"images_unused": "Unused",
"environment_required": "Environment ID Required"
"containers": "컨테이너",
"images": "이미지",
"image_updates": "이미지 업데이트",
"images_unused": "미사용",
"environment_required": "환경 ID 필요"
},
"dockhand": {
"running": "Running",
"stopped": "Stopped",
"running": "실행 중",
"stopped": "정지됨",
"cpu": "CPU",
"memory": "Memory",
"images": "Images",
"volumes": "Volumes",
"events_today": "Events Today",
"pending_updates": "Pending Updates",
"stacks": "Stacks",
"paused": "Paused",
"total": "Total",
"environment_not_found": "Environment Not Found"
"memory": "메모리",
"images": "이미지",
"volumes": "볼륨",
"events_today": "오늘의 이벤트",
"pending_updates": "대기 중인 업데이트",
"stacks": "스택",
"paused": "일시정지됨",
"total": "전체",
"environment_not_found": "환경 없음"
},
"sparkyfitness": {
"eaten": "Eaten",

View File

@@ -66,6 +66,11 @@
"wait": "Please wait",
"empty_data": "Subsystem status unknown"
},
"unifi_drive": {
"healthy": "Healthy",
"degraded": "Degraded",
"no_data": "No storage data available"
},
"docker": {
"rx": "RX",
"tx": "TX",

View File

@@ -66,6 +66,11 @@
"wait": "Please wait",
"empty_data": "Status subsistem tak diketahui"
},
"unifi_drive": {
"healthy": "Healthy",
"degraded": "Degraded",
"no_data": "No storage data available"
},
"docker": {
"rx": "RX",
"tx": "TX",

View File

@@ -66,6 +66,11 @@
"wait": "Even geduld",
"empty_data": "Subsysteem status onbekend"
},
"unifi_drive": {
"healthy": "Healthy",
"degraded": "Degraded",
"no_data": "No storage data available"
},
"docker": {
"rx": "RX",
"tx": "TX",

View File

@@ -66,6 +66,11 @@
"wait": "Please wait",
"empty_data": "Ukjent undersystemstatus"
},
"unifi_drive": {
"healthy": "Healthy",
"degraded": "Degraded",
"no_data": "No storage data available"
},
"docker": {
"rx": "RX",
"tx": "TX",

View File

@@ -66,6 +66,11 @@
"wait": "Proszę czekać",
"empty_data": "Status podsystemu nieznany"
},
"unifi_drive": {
"healthy": "Healthy",
"degraded": "Degraded",
"no_data": "No storage data available"
},
"docker": {
"rx": "Rx",
"tx": "Tx",

View File

@@ -66,6 +66,11 @@
"wait": "Please wait",
"empty_data": "Status de Subsistema Desconhecido"
},
"unifi_drive": {
"healthy": "Healthy",
"degraded": "Degraded",
"no_data": "No storage data available"
},
"docker": {
"rx": "Rx",
"tx": "Tx",

View File

@@ -14,7 +14,7 @@
"date": "{{value, date}}",
"relativeDate": "{{value, relativeDate}}",
"duration": "{{value, duration}}",
"months": "M",
"months": "mo",
"days": "d",
"hours": "h",
"minutes": "m",
@@ -66,9 +66,14 @@
"wait": "Por favor, aguarde",
"empty_data": "Status do Subsistema desconhecido"
},
"unifi_drive": {
"healthy": "Healthy",
"degraded": "Degraded",
"no_data": "No storage data available"
},
"docker": {
"rx": "Rx",
"tx": "Tx",
"rx": "RX",
"tx": "TX",
"mem": "MEM",
"cpu": "CPU",
"running": "Executando",
@@ -101,21 +106,21 @@
"playing": "A reproduzir",
"transcoding": "Transcodificação",
"bitrate": "Taxa de bits",
"no_active": "Sem Streams Ativos",
"no_active": "Sem Transmissões Ativas",
"movies": "Filmes",
"series": "Séries",
"episodes": "Episódios",
"songs": "Canções"
},
"jellyfin": {
"playing": "Playing",
"playing": "Jogando",
"transcoding": "Transcoding",
"bitrate": "Bitrate",
"no_active": "No Active Streams",
"movies": "Movies",
"series": "Series",
"episodes": "Episodes",
"songs": "Songs"
"movies": "Filmes",
"series": "Séries",
"episodes": "Episódios",
"songs": "Músicas"
},
"esphome": {
"offline": "Offline",
@@ -290,12 +295,12 @@
"available": "Disponível"
},
"seerr": {
"pending": "Pending",
"approved": "Approved",
"available": "Available",
"completed": "Completed",
"processing": "Processing",
"issues": "Open Issues"
"pending": "Pendente",
"approved": "Aprovado",
"available": "Disponível",
"completed": "Concluído",
"processing": "Processando",
"issues": "Erros pendentes"
},
"netalertx": {
"total": "Total",
@@ -616,7 +621,7 @@
"pangolin": {
"orgs": "Orgs",
"sites": "Sites",
"resources": "Resources",
"resources": "Recursos",
"targets": "Targets",
"traffic": "Traffic",
"in": "In",
@@ -719,8 +724,8 @@
"volumeAvailable": "Disponível"
},
"dispatcharr": {
"channels": "Channels",
"streams": "Streams"
"channels": "Canais",
"streams": "Transmissões"
},
"mylar": {
"series": "Séries",
@@ -811,10 +816,10 @@
"series": "Séries"
},
"booklore": {
"libraries": "Libraries",
"books": "Books",
"reading": "Reading",
"finished": "Finished"
"libraries": "Bibliotecas",
"books": "Livros",
"reading": "Lendo",
"finished": "Finalizado"
},
"jdownloader": {
"downloadCount": "Fila de espera",
@@ -1155,23 +1160,23 @@
"artists": "Artistas"
},
"arcane": {
"containers": "Containers",
"images": "Images",
"image_updates": "Image Updates",
"images_unused": "Unused",
"containers": "Recipientes",
"images": "Imagens",
"image_updates": "Atualizações de Imagem",
"images_unused": "Não utilizado",
"environment_required": "Environment ID Required"
},
"dockhand": {
"running": "Running",
"running": "Executando",
"stopped": "Stopped",
"cpu": "CPU",
"memory": "Memory",
"images": "Images",
"volumes": "Volumes",
"events_today": "Events Today",
"pending_updates": "Pending Updates",
"stacks": "Stacks",
"paused": "Paused",
"memory": "Memória",
"images": "Imagens",
"volumes": "Quantidades",
"events_today": "Eventos hoje",
"pending_updates": "Atualizações pendentes",
"stacks": "Pilhas",
"paused": "Pausado",
"total": "Total",
"environment_not_found": "Environment Not Found"
},

View File

@@ -66,6 +66,11 @@
"wait": "Please wait",
"empty_data": "Starea subsistemului este necunoscut"
},
"unifi_drive": {
"healthy": "Healthy",
"degraded": "Degraded",
"no_data": "No storage data available"
},
"docker": {
"rx": "RX",
"tx": "TX",

View File

@@ -66,6 +66,11 @@
"wait": "Пожалуйста, подождите",
"empty_data": "Статус подсистемы неизвестен"
},
"unifi_drive": {
"healthy": "Healthy",
"degraded": "Degraded",
"no_data": "No storage data available"
},
"docker": {
"rx": "RX",
"tx": "TX",

View File

@@ -66,6 +66,11 @@
"wait": "Čakajte, prosím",
"empty_data": "Stav podsystému neznámy"
},
"unifi_drive": {
"healthy": "Healthy",
"degraded": "Degraded",
"no_data": "No storage data available"
},
"docker": {
"rx": "Prijaté",
"tx": "Odoslané",

View File

@@ -66,6 +66,11 @@
"wait": "Please wait",
"empty_data": "Neznani status podsistema"
},
"unifi_drive": {
"healthy": "Healthy",
"degraded": "Degraded",
"no_data": "No storage data available"
},
"docker": {
"rx": "RX",
"tx": "TX",

View File

@@ -66,6 +66,11 @@
"wait": "Молим сачекајте",
"empty_data": "Статус подсистема непознат"
},
"unifi_drive": {
"healthy": "Healthy",
"degraded": "Degraded",
"no_data": "No storage data available"
},
"docker": {
"rx": "RX",
"tx": "TX",

View File

@@ -66,6 +66,11 @@
"wait": "Please wait",
"empty_data": "Subsystem status unknown"
},
"unifi_drive": {
"healthy": "Healthy",
"degraded": "Degraded",
"no_data": "No storage data available"
},
"docker": {
"rx": "RX",
"tx": "TX",

View File

@@ -66,6 +66,11 @@
"wait": "Please wait",
"empty_data": "Subsystem status unknown"
},
"unifi_drive": {
"healthy": "Healthy",
"degraded": "Degraded",
"no_data": "No storage data available"
},
"docker": {
"rx": "RX",
"tx": "TX",

View File

@@ -66,6 +66,11 @@
"wait": "Please wait",
"empty_data": "Subsystem status unknown"
},
"unifi_drive": {
"healthy": "Healthy",
"degraded": "Degraded",
"no_data": "No storage data available"
},
"docker": {
"rx": "RX",
"tx": "TX",

View File

@@ -66,6 +66,11 @@
"wait": "Lütfen bekleyin",
"empty_data": "Alt sistem durumu bilinmiyor"
},
"unifi_drive": {
"healthy": "Healthy",
"degraded": "Degraded",
"no_data": "No storage data available"
},
"docker": {
"rx": "Gelen Veri",
"tx": "Giden Veri",

View File

@@ -66,6 +66,11 @@
"wait": "Будь ласка, зачекайте",
"empty_data": "Статус підсистеми невідомий"
},
"unifi_drive": {
"healthy": "Healthy",
"degraded": "Degraded",
"no_data": "No storage data available"
},
"docker": {
"rx": "RX",
"tx": "TX",

View File

@@ -66,6 +66,11 @@
"wait": "Vui lòng chờ",
"empty_data": "Trạng thái hệ thống phụ không xác định"
},
"unifi_drive": {
"healthy": "Healthy",
"degraded": "Degraded",
"no_data": "No storage data available"
},
"docker": {
"rx": "RX",
"tx": "TX",

View File

@@ -66,6 +66,11 @@
"wait": "Please wait",
"empty_data": "子系統狀態未知"
},
"unifi_drive": {
"healthy": "Healthy",
"degraded": "Degraded",
"no_data": "No storage data available"
},
"docker": {
"rx": "接收",
"tx": "發送",

View File

@@ -66,6 +66,11 @@
"wait": "请稍候",
"empty_data": "子系统状态未知"
},
"unifi_drive": {
"healthy": "Healthy",
"degraded": "Degraded",
"no_data": "No storage data available"
},
"docker": {
"rx": "接收",
"tx": "发送",

View File

@@ -66,6 +66,11 @@
"wait": "Please wait",
"empty_data": "子系統狀態未知"
},
"unifi_drive": {
"healthy": "Healthy",
"degraded": "Degraded",
"no_data": "No storage data available"
},
"docker": {
"rx": "接收",
"tx": "傳送",

View File

@@ -147,6 +147,7 @@ const components = {
tubearchivist: dynamic(() => import("./tubearchivist/component")),
truenas: dynamic(() => import("./truenas/component")),
unifi: dynamic(() => import("./unifi/component")),
unifi_drive: dynamic(() => import("./unifi_drive/component")),
unmanic: dynamic(() => import("./unmanic/component")),
unraid: dynamic(() => import("./unraid/component")),
uptimekuma: dynamic(() => import("./uptimekuma/component")),

View File

@@ -0,0 +1,58 @@
import Block from "components/services/widget/block";
import Container from "components/services/widget/container";
import { useTranslation } from "next-i18next";
import useWidgetAPI from "utils/proxy/use-widget-api";
export default function Component({ service }) {
const { t } = useTranslation();
const { widget } = service;
const { data: storageData, error: storageError } = useWidgetAPI(widget, "storage");
if (storageError) {
return <Container service={service} error={storageError} />;
}
if (!storageData) {
return (
<Container service={service}>
<Block field="unifi_drive.total" label="resources.total" />
<Block field="unifi_drive.used" label="resources.used" />
<Block field="unifi_drive.available" label="resources.free" />
<Block field="unifi_drive.status" label="widget.status" />
</Container>
);
}
const { data: storage } = storageData;
if (!storage) {
return (
<Container service={service}>
<Block value={t("unifi_drive.no_data")} />
</Container>
);
}
const { totalQuota, usage, status } = storage;
const totalBytes = totalQuota ?? 0;
const usedBytes = (usage?.system || 0) + (usage?.myDrives || 0) + (usage?.sharedDrives || 0);
const availableBytes = Math.max(0, totalBytes - usedBytes);
let statusValue = status;
if (status === "healthy") statusValue = t("unifi_drive.healthy");
else if (status === "degraded") statusValue = t("unifi_drive.degraded");
return (
<Container service={service}>
<Block field="unifi_drive.total" label="resources.total" value={t("common.bytes", { value: totalBytes })} />
<Block field="unifi_drive.used" label="resources.used" value={t("common.bytes", { value: usedBytes })} />
<Block
field="unifi_drive.available"
label="resources.free"
value={t("common.bytes", { value: availableBytes })}
/>
<Block field="unifi_drive.status" label="widget.status" value={statusValue} />
</Container>
);
}

View File

@@ -0,0 +1,92 @@
// @vitest-environment jsdom
import { screen } from "@testing-library/react";
import { beforeEach, describe, expect, it, vi } from "vitest";
import { renderWithProviders } from "test-utils/render-with-providers";
import { expectBlockValue } from "test-utils/widget-assertions";
const { useWidgetAPI } = vi.hoisted(() => ({ useWidgetAPI: vi.fn() }));
vi.mock("utils/proxy/use-widget-api", () => ({ default: useWidgetAPI }));
import Component from "./component";
describe("widgets/unifi_drive/component", () => {
beforeEach(() => {
vi.clearAllMocks();
});
it("renders placeholders while loading", () => {
useWidgetAPI.mockReturnValue({ data: undefined, error: undefined });
const service = { widget: { type: "unifi_drive" } };
const { container } = renderWithProviders(<Component service={service} />, { settings: { hideErrors: false } });
expect(container.querySelectorAll(".service-block")).toHaveLength(4);
expect(screen.getByText("resources.total")).toBeInTheDocument();
expect(screen.getByText("resources.used")).toBeInTheDocument();
expect(screen.getByText("resources.free")).toBeInTheDocument();
expect(screen.getByText("widget.status")).toBeInTheDocument();
});
it("renders error when API fails", () => {
useWidgetAPI.mockReturnValue({ data: undefined, error: new Error("fail") });
const service = { widget: { type: "unifi_drive" } };
renderWithProviders(<Component service={service} />, { settings: { hideErrors: false } });
expect(screen.getAllByText("widget.api_error", { exact: false }).length).toBeGreaterThan(0);
});
it("renders no_data when storage data is missing", () => {
useWidgetAPI.mockReturnValue({ data: { data: null }, error: undefined });
const service = { widget: { type: "unifi_drive" } };
renderWithProviders(<Component service={service} />, { settings: { hideErrors: false } });
expect(screen.getByText("unifi_drive.no_data")).toBeInTheDocument();
});
it("renders storage statistics when data is loaded", () => {
useWidgetAPI.mockReturnValue({
data: {
data: {
totalQuota: 1000000000000,
usage: { system: 100000000000, myDrives: 200000000000, sharedDrives: 50000000000 },
status: "healthy",
},
},
error: undefined,
});
const service = { widget: { type: "unifi_drive" } };
const { container } = renderWithProviders(<Component service={service} />, { settings: { hideErrors: false } });
expect(container.querySelectorAll(".service-block")).toHaveLength(4);
expectBlockValue(container, "resources.total", 1000000000000);
expectBlockValue(container, "resources.used", 350000000000);
expectBlockValue(container, "resources.free", 650000000000);
expectBlockValue(container, "widget.status", "unifi_drive.healthy");
});
it("renders degraded status", () => {
useWidgetAPI.mockReturnValue({
data: {
data: {
totalQuota: 100,
usage: { system: 10, myDrives: 20, sharedDrives: 5 },
status: "degraded",
},
},
error: undefined,
});
const service = { widget: { type: "unifi_drive" } };
const { container } = renderWithProviders(<Component service={service} />, { settings: { hideErrors: false } });
expect(container.querySelectorAll(".service-block")).toHaveLength(4);
expectBlockValue(container, "widget.status", "unifi_drive.degraded");
expectBlockValue(container, "resources.free", 65);
});
});

View File

@@ -0,0 +1,36 @@
import getServiceWidget from "utils/config/service-helpers";
import createUnifiProxyHandler from "utils/proxy/handlers/unifi";
import { httpProxy } from "utils/proxy/http";
const drivePrefix = "/proxy/drive";
async function getWidget(req, logger) {
const { group, service, index } = req.query;
if (!group || !service) return null;
const widget = await getServiceWidget(group, service, index);
if (!widget) {
logger.debug("Invalid or missing widget for service '%s' in group '%s'", service, group);
return null;
}
return widget;
}
async function resolveRequestContext({ cachedPrefix, widget }) {
if (cachedPrefix !== null) {
return { prefix: cachedPrefix };
}
const [, , , responseHeaders] = await httpProxy(widget.url);
return {
prefix: drivePrefix,
csrfToken: responseHeaders?.["x-csrf-token"],
};
}
export default createUnifiProxyHandler({
proxyName: "unifiDriveProxyHandler",
resolveWidget: getWidget,
resolveRequestContext,
});

View File

@@ -0,0 +1,82 @@
import { beforeEach, describe, expect, it, vi } from "vitest";
import createMockRes from "test-utils/create-mock-res";
const { httpProxy, getServiceWidget, cache, logger } = vi.hoisted(() => {
const store = new Map();
return {
httpProxy: vi.fn(),
getServiceWidget: vi.fn(),
cache: {
get: vi.fn((k) => (store.has(k) ? store.get(k) : null)),
put: vi.fn((k, v) => store.set(k, v)),
del: vi.fn((k) => store.delete(k)),
_reset: () => store.clear(),
},
logger: { debug: vi.fn(), error: vi.fn() },
};
});
vi.mock("memory-cache", () => ({ default: cache, ...cache }));
vi.mock("utils/logger", () => ({ default: () => logger }));
vi.mock("utils/config/service-helpers", () => ({ default: getServiceWidget }));
vi.mock("utils/proxy/http", () => ({ httpProxy }));
vi.mock("widgets/widgets", () => ({
default: { unifi_drive: { api: "{url}{prefix}/api/{endpoint}" } },
}));
import unifiDriveProxyHandler from "./proxy";
const widgetConfig = { type: "unifi_drive", url: "http://unifi", username: "u", password: "p" };
describe("widgets/unifi_drive/proxy", () => {
beforeEach(() => {
vi.clearAllMocks();
cache._reset();
});
it("returns 400 when widget config is missing", async () => {
getServiceWidget.mockResolvedValue(null);
const res = createMockRes();
await unifiDriveProxyHandler(
{ query: { group: "g", service: "s", endpoint: "v1/systems/storage?type=detail" } },
res,
);
expect(res.statusCode).toBe(400);
});
it("returns 403 when widget type has no API config", async () => {
getServiceWidget.mockResolvedValue({ ...widgetConfig, type: "unknown" });
const res = createMockRes();
await unifiDriveProxyHandler({ query: { group: "g", service: "s", endpoint: "storage" } }, res);
expect(res.statusCode).toBe(403);
});
it("uses /proxy/drive prefix and returns data on success", async () => {
getServiceWidget.mockResolvedValue({ ...widgetConfig });
httpProxy
.mockResolvedValueOnce([200, "text/html", Buffer.from(""), {}])
.mockResolvedValueOnce([200, "application/json", Buffer.from('{"data":{}}'), {}]);
const res = createMockRes();
await unifiDriveProxyHandler({ query: { group: "g", service: "s", endpoint: "storage" } }, res);
expect(httpProxy.mock.calls[0][0]).toBe("http://unifi");
expect(httpProxy.mock.calls[1][0].toString()).toContain("/proxy/drive/api/");
expect(cache.put).toHaveBeenCalledWith("unifiDriveProxyHandler__prefix.s", "/proxy/drive");
expect(res.statusCode).toBe(200);
});
it("skips prefix detection when cached", async () => {
getServiceWidget.mockResolvedValue({ ...widgetConfig });
cache.put("unifiDriveProxyHandler__prefix.s", "/proxy/drive");
httpProxy.mockResolvedValueOnce([200, "application/json", Buffer.from('{"data":{}}'), {}]);
const res = createMockRes();
await unifiDriveProxyHandler({ query: { group: "g", service: "s", endpoint: "storage" } }, res);
expect(httpProxy).toHaveBeenCalledTimes(1);
expect(httpProxy.mock.calls[0][0].toString()).toContain("/proxy/drive/api/");
expect(res.statusCode).toBe(200);
});
});

View File

@@ -0,0 +1,14 @@
import unifiDriveProxyHandler from "./proxy";
const widget = {
api: "{url}{prefix}/api/{endpoint}",
proxyHandler: unifiDriveProxyHandler,
mappings: {
storage: {
endpoint: "v1/systems/storage?type=detail",
},
},
};
export default widget;

View File

@@ -0,0 +1,11 @@
import { describe, it } from "vitest";
import { expectWidgetConfigShape } from "test-utils/widget-config";
import widget from "./widget";
describe("unifi_drive widget config", () => {
it("exports a valid widget config", () => {
expectWidgetConfigShape(widget);
});
});

View File

@@ -137,6 +137,7 @@ import trilium from "./trilium/widget";
import truenas from "./truenas/widget";
import tubearchivist from "./tubearchivist/widget";
import unifi from "./unifi/widget";
import unifi_drive from "./unifi_drive/widget";
import unmanic from "./unmanic/widget";
import unraid from "./unraid/widget";
import uptimekuma from "./uptimekuma/widget";
@@ -296,6 +297,7 @@ const widgets = {
truenas,
unifi,
unifi_console: unifi,
unifi_drive,
unmanic,
unraid,
uptimekuma,