Skip to content

An xbar plugin to display Uptime Kuma Status on Mac taskbar

License

Notifications You must be signed in to change notification settings

mariogarridopt/xBar-Uptime-Kuma

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

14 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

xBar-Uptime-Kuma

This is a xBar Plugin & Uptime Kuma addon that allows you to display your monitored status on the Macbook taskbar.

screenshot

How to use it

  1. Copy the uptimekuma.30s.py file into your xBar scripts folder;
  2. Make sure the file has execution permissions chmod +x uptimekuma.30s.py;
  3. Install python dependencies pip install uptime-kuma-api
  4. Open uptimekuma.30s.py file and change the following fields:
# -------------------------------------------
BASE_URL = 'http://localhost:3001' # uptime kuma URL no trailing slash
USERNAME = 'admin' # uptime kuma username
PASSWORD = 'admin' # uptime kuma password
# -------------------------------------------
  1. You are ready!

Dependencies

Since Uptime Kuma does not have a formal API(#8), I had to use uptime-kuma-api. This is not great because for this to work now you have to install dependencies first:

pip install uptime-kuma-api

We might remove this dependence when Uptime Kuma publishes an official API.

Contributing

This project is only possible because of your help. If you find any bug please report it at issues.

How to make a contribution

License

This project is available under the GPL-3.0 license.