{"id":13432256,"url":"https://github.com/max-mapper/monu","last_synced_at":"2025-04-12T22:27:42.620Z","repository":{"id":29077741,"uuid":"32605857","full_name":"max-mapper/monu","owner":"max-mapper","description":"menubar process monitor mac app [ALPHA]","archived":false,"fork":false,"pushed_at":"2018-01-28T06:09:18.000Z","size":470,"stargazers_count":1111,"open_issues_count":18,"forks_count":74,"subscribers_count":36,"default_branch":"master","last_synced_at":"2024-10-30T04:49:33.046Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://github.com/maxogden/monu/releases","language":"CSS","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-2-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/max-mapper.png","metadata":{"files":{"readme":"readme.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2015-03-20T20:35:45.000Z","updated_at":"2024-10-11T22:57:46.000Z","dependencies_parsed_at":"2022-08-22T17:40:44.096Z","dependency_job_id":null,"html_url":"https://github.com/max-mapper/monu","commit_stats":null,"previous_names":["max-mapper/monu","maxogden/monu"],"tags_count":11,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/max-mapper%2Fmonu","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/max-mapper%2Fmonu/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/max-mapper%2Fmonu/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/max-mapper%2Fmonu/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/max-mapper","download_url":"https://codeload.github.com/max-mapper/monu/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248639179,"owners_count":21137794,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-07-31T02:01:09.788Z","updated_at":"2025-04-12T22:27:42.582Z","avatar_url":"https://github.com/max-mapper.png","language":"CSS","readme":"### Monu\n\n![app.png](app.png)\n\nMonu is an open source process monitoring menu bar application for Mac OS. You can configure Monu to launch programs, and when Monu starts up it will start them. Additionally, it will monitor the processes and restart them if they crash.\n\nMonu is a portmanteau of 'monitor' and 'menu'. It has two C/C++ dependencies, [Electron](https://github.com/atom/electron) (which includes iojs) and the [mon](https://github.com/tj/mon) process monitor.\n\nMonu is currently **ALPHA STATUS** and is intended for developers/early adopters.\n\nTo download the latest version visit the [releases page](https://github.com/maxogden/monu/releases)\n\n[![js-standard-style](https://raw.githubusercontent.com/feross/standard/master/badge.png)](https://github.com/feross/standard)\n\n[![Build Status](https://travis-ci.org/maxogden/monu.svg?branch=master)](https://travis-ci.org/maxogden/monu)\n\n![screenshot.png](screenshot.png)\n\n##### How to use Monu\n\nTo configure Monu, click 'Open Config Folder' and open 'config.json' in a text editor. When you save and return to Monu your new configuration will be automatically loaded.\n\nBe sure your JSON syntax is valid when editing the configuration. Here are supported options. These should be added as top level key/value pairs to 'config.json':\n\n\u003cul\u003e\n  \u003cli\u003e\u003cb\u003eprocesses\u003c/b\u003e the processes to run (see below)\u003c/li\u003e\n  \u003cli\u003e\u003cb\u003elogs\u003c/b\u003e the directory to store logs in (default config/logs)\u003c/li\u003e\n  \u003cli\u003e\u003cb\u003epids\u003c/b\u003e the directory to store PIDs in (default config/pids)\u003c/li\u003e\n  \u003cli\u003e\u003cb\u003eon-error\u003c/b\u003e a command to run when a process cannot start (default none)\u003c/li\u003e\n  \u003cli\u003e\u003cb\u003eon-restart\u003c/b\u003e a command to run when a process restarts (default none)\u003c/li\u003e\n  \u003cli\u003e\u003cb\u003esleep\u003c/b\u003e sleep seconds before re-executing (default 1)\u003c/li\u003e\n  \u003cli\u003e\u003cb\u003eattempts\u003c/b\u003e restart attempts within 60 seconds before stopping app (default 10)\u003c/li\u003e\n  \u003cli\u003e\u003cb\u003eprefix\u003c/b\u003e add a string prefix to the log (default none)\u003c/li\u003e\n\u003c/ul\u003e\n\n##### Adding Processes\n\nIn the 'config.json' file add processes to the 'processes' key. The key must be a name (lowercase letters and hypens) and the value must be the launch command. For example:\n\n```json\n{\n  \"logs\": \"./logs\",\n  \"pids\": \"./pids\",\n  \"processes\": {\n    \"web-1\": \"http-server . -p 8081\",\n    \"web-2\": \"http-server . -p 8082\",\n    \"web-3\": \"http-server . -p 8083\"\n  }\n}\n```\n\n##### Launch on Startup\n\nWhen you open Monu.app, it will start all configured processes.\n\nIf you would like Monu.app to start when your Mac starts up, got to \u003cb\u003eSystem Preferences \u0026gt; Users and Groups\u003c/b\u003e and add Monu.app to \u003cb\u003eLogin Items\u003c/b\u003e for your User.\n\n##### Developing\n\n```bash\nnpm install # installs electron and all the deps needed for monu\nnpm start # runs the app in the electron wrapper\nnpm run build # builds the mac app\n```\n\n##### Publishing\n\nBefore publishing, make sure that your repo is clean, and that you've created a tag for the latest commit. `npm version [major|minor|patch]` will do this for you, increasing the package.json version, creating a commit and adding a tag.\n\nYou should see something like this:\n\n```\n🐈  make publish\nrm -rf Monu.app Monu.zip # prevent duplicates in the final bundle\nnpm run build\n\n\u003e monu@1.0.4 build /Users/maxogden/src/js/monu\n\u003e electron-packager . Monu --platform=darwin --arch=x64 --version=0.26.0 --ignore=node_modules/electron\n\nWrote new app to /Users/maxogden/src/js/monu/Monu.app\nditto -c -k --sequesterRsrc --keepParent Monu.app Monu.zip\nnpm run publish\n\n\u003e monu@1.0.4 publish /Users/maxogden/src/js/monu\n\u003e publish-release --template notes.md --assets Monu.zip\n\n? Git Tag: v1.0.4\n? Github repository owner: maxogden\n? Github repository name: monu\n? Release Name: Monu v1.0.4 Alpha\n\nUploading Monu.zip\n[=================================================\u003e] 100.0% (1.17 MB/s)\nDone! Published at: https://github.com/maxogden/monu/releases/tag/v1.0.4\n```\n","funding_links":[],"categories":["CSS","📦 Legacy \u0026 Inactive Projects"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmax-mapper%2Fmonu","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmax-mapper%2Fmonu","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmax-mapper%2Fmonu/lists"}