Skip to content

cedricfung/mnm

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

52 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

mnm

Ⓜ️NⓂ️ is a process monitor which will automatically send notifications to the configured groups in Mixin Messenger.

  1. Get Mixin Messenger from https://messenger.mixin.one.
  2. Search mnm and add it as a contact.
  3. Add mnm to the groups you wish to receive notifications.
  4. Open https://mnm.sh from your desktop browser.

🎡 Typical Usages

Have a long running task already? Get notified when it's done:

mnm monitor PID

Make a large tarball? Let mnm monitor that and notify you when it's done:

mnm run 'tar jcvf snapshots.tar.bz2 snapshots'

Download a large file? Let mnm monitor that and notify you when it's done:

mnm run 'wget https://some.large/file.zip'

Even if you already have a passive external monitor for your services, you may use mnm as a proactive monitor for your service:

[Unit]
Description=Mixin Network Kernel Daemon
After=network.target

[Service]
User=one
Type=simple
ExecStart=/usr/bin/mnm run '/usr/bin/mixin kernel -dir /data/mixin -port 7239'
Restart=on-failure
LimitNOFILE=65536

[Install]
WantedBy=multi-user.target

🪝 Webhook Integration

mnm provides a standard webhook integration that allows any service to send messages to your Mixin groups. If you've configured mnm in a group, click on the group to get a webhook URL like:

https://mnm.sh/in/eca0f41a-eca0-eca0-eca0-cd13f392eca0

Simply use this URL in any service that supports webhooks, and you'll receive standard JSON notifications in your group.

For better readability, mnm supports jq syntax for content formatting. Add parameters to customize the message display:

https://mnm.sh/in/eca0f41a-eca0-eca0-eca0-cd13f392eca0?title=.data.issue.title&body=.data.body&link=.url

This extracts:

  • .data.issue.title as the message title
  • .data.body as the card content
  • .url as a clickable link

With this flexible formatting, any third-party service can send customized messages to your Mixin groups with just a webhook URL.

Endless possibilities, and yet convenient to go.

About

monitor & notifier to messenger

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Contributors 3

  •  
  •  
  •