Configurable system tray widget for a group of related services

• Linux (amd64): binaries and deb/rpm packages released for Linux amd64.

servicetray is a go app with a C dependency, using https://github.com/getlantern/systray.

In order to install on other platforms, see that repo for installation requirements. NOTE that I haven't tested any other platforms yet.

Please send a documentation PR if you manage to install servicetray on another platform. Documentation would be great, github action would be even better.

Create a config file called servicetray.yml, before running servicetray

title: VPNs
items:
   - name: wireguard-am
     start:
       cmd: systemctl
       args: [start,wg-quick@am]
     stop:
       cmd: systemctl
       args: [stop,wg-quick@am]
     check:
       cmd: systemctl
       args: [status,wg-quick@am]

Typically you'd group multiple similar items together.

This example uses a 'template' for managing multiple vpns, via systemctl ...

title: VPNs
icon: /usr/share/icons/gnome/16x16/emblems/emblem-system.png
items:
   - name: wireguard-am
     template: systemctl
     vars:
       svc: wg-quick@am
   - name: openvpn-amir
     template: systemctl
     vars:
       svc: openvpn@am
   - name: openvpn-other
     template: systemctl
     vars:
       svc: openvpn@other
templates:
   - name: systemctl
     start:
       cmd: systemctl
       args: [start,"{{.svc}}"]
     stop:
       cmd: systemctl
       args: [stop,"{{.svc}}"]
     check:
       cmd: systemctl
       args: [status,"{{.svc}}"]

This example uses docker-compose to dynamically generate a list of services at startup

title: dev-project
icon: /usr/share/icons/docker/16x16/docker.png
pwd: /home/am/my-dockercompose-project
generators:
  - name: docker-compose
    find:
      cmd: docker-compose
      args: [ps,--services]
    template: docker-compose
templates:
  - name: docker-compose
    start:
      cmd: docker-compose
      args: [up,-d,"{{.svc}}"]
    stop:
      cmd: docker-compose
      args: [stop,"{{.svc}}"]
    check:
      cmd: /home/am/my-dockercompose-project/dcrunning.sh
      args: ["{{.svc}}"]

Note: docker-compose isn't the easiest for checking status, so this recipe uses a shell script. I included a bash script to give an idea of what to do ... ./helpers/dcrunning.sh

For Ubuntu Linux:

• Presss the <Super> key and launch Startup Applications
• The 'command' looks like this: servicetray -config /home/am/.config/servicetray/vpns.yml
• Note - if you installed from source, be aware that the PATH variable used here might not include your $GOPATH/bin. Either move your servicetray binary somewhere like /usr/local/bin, or specify the full path.

• Set up github actions for other platforms.
• Maybe include some icons.
• Maybe add some more utilities:
  • add 'recipes'
  • cross-platform utilites (like, a cross-platform dcrunning binary)
• Maybe add support for 'info/stats' for each item
• Generators:
  • Regularly re-loading generator results.
  • maybe, pinning/hiding of some generated items.