mAirList Watchdog – a small open-source tool that restarts mAirList and its DB processes automatically

Hi all,

I wrote a small utility (using Claude Code) for our own studio and I’m sharing it as open source in case it’s useful to others: mAirList Watchdog.

It starts mAirList, the DB Server and the DB Importer in the right order, watches them, and restarts the whole group as soon as one of them fails. A few notes on how it works:

  • One self-contained exe of about 2.7 MB. No .NET, no runtime, no installer. Runs on Windows 10/11 and Server 2022 and newer.
  • Uses no measurable CPU while idle. It waits on the process handles instead of polling, so a crash is noticed within milliseconds.
  • Recognises the three processes by their command line, not by name, so it never touches the wrong mAirList. It can also adopt instances that are already running and clean up accidental duplicate copies.
  • Tray icon with status, pause/resume, restart, an editor for the applications, and a log with a timestamp and PID for every start, stop and restart.
  • Optional: registers itself as a scheduled task at logon.

Repository (MIT licensed, with a full README):

To be clear: this is an independent tool and not affiliated with or endorsed by mAirList Software. mAirList itself is of course their software.

I’d really appreciate feedback: bug reports, ideas, or simply “works here on version X”. If it just runs fine for you, a thumbs up is very welcome too.

Thanks!
Vincent

Hi, that’s a great idea!

I’ll take a look later on…

Edit: is this for v7 only or can we change the observed version in the settings?

The watchdog isn’t tied to version 7. Version 7 is only what the defaults assume: the path C:\Program Files (x86)\mAirList 7\mAirList.exe and the arguments -mode dbserver and -mode dbimporter.

Everything else is generic. Each application in the config has its own path and arguments, and a running process is recognised by its executable name plus its command line (or an optional substring filter). So for another version, or a different install location, you just correct the path and arguments in the editor. If you’re not sure what the DB Server and Importer are started with on your version, start them by hand and click Show running processes… in the editor: it lists the exact command line of every mAirList process, which you can copy straight into the fields.

The only hard requirement is the OS: reading process command lines needs Windows 8.1 / Server 2012 R2 or newer, and I’ve tested on Windows 10/11 and Server 2022.

I’ve only run it against version 7 myself, so if you try it with 6.x (or older) I’d be glad to hear whether the defaults need changing.

Edit: version 8 will probably do as well. But let me know if it doesn’t for some reason.