Homepage Widget for NUTify

[drewstopherlee]

If anyone else runs Homepage and is interested in adding a widget to display some data about the UPS, I'll post my config here. Add everything from widget: down to your existing entry for NUTify in your homepage services.yaml file.

Don't forget to update the url: IP address and port to match your installation!

- Example Section:
    - NUTify:
        href: http://10.0.0.91:5050/
        widget:
          type: customapi # Defines widget type per https://gethomepage.dev/widgets/services/customapi/
          url: http://10.0.0.91:5050/api/data/all # API endpoint for NUTify (change this to match your NUTify instance)
          refreshInterval: 5000 # Refresh every 5 seconds
          method: GET
          mappings:
            - field: # Get UPS status from NUTify (see https://networkupstools.org/docs/developer-guide.chunked/new-drivers.html#_status_data for an explanation of what these mean)
                data: ups_status
              label: UPS Status
              format: text #Display the API data as text
            - field:
                data: battery_charge # Get battery percentage from NUTify
              label: Battery Charge
              format: percent # and display it as a percent
            - field:
                data: ups_load # Get system load
              label: System Load
              format: percent # Also displayed as a percent
            - field: 
                data: ups_realpower # Get the power usage of the UPS
              label: Power Usage
              format: number # Display it as a number
              suffix: "W" # And add a W at the end to signify Watts

And here's what it should look like:

If anyone has suggestions or is interested in other stats being displayed, please let me know and I can rework this config. Thanks! :D
EDIT: Also if anyone is more familiar with React/JS than I am and would like to tackle a custom widget to be integrated into Homepage, I'm sure @DartSteven wouldn't mind ;)

[DartSteven]

Great job, thank you very much!

[drewstopherlee]

Did you use the remapping that I had in the other discussion thread? I didn't add them here because it didn't work correctly for @ercflemng or I.

[yeeahnick]

Remapping worked for me.

            mappings:
            - field: # Get UPS status from NUTify 
                data: ups_status
              label: UPS Status
              format: text #Display the API data as text
              remap:
                - value: OL
                  to: Online

[drewstopherlee]

Thanks @yeeahnick, I'll add that back into my config example then!

[yeeahnick]

Great work and thanks for sharing. Does anyone know where to get the Nutify icon?

[drewstopherlee]

https://raw.githubusercontent.com/DartSteven/Nutify/refs/heads/main/nutify/static/img/favicon.ico should work!

[yeeahnick]

Thanks, it's a bit pixelated but it works.