{"id":18974505,"url":"https://github.com/m7a/lp-maerct","last_synced_at":"2025-10-18T05:52:41.326Z","repository":{"id":164554621,"uuid":"234567473","full_name":"m7a/lp-maerct","owner":"m7a","description":"Ma_Sys.ma Emergency Remote Control","archived":false,"fork":false,"pushed_at":"2024-04-28T19:54:46.000Z","size":18,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-06-04T22:13:02.327Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"C","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/m7a.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2020-01-17T14:41:09.000Z","updated_at":"2024-04-28T19:54:49.000Z","dependencies_parsed_at":"2024-04-28T20:50:36.251Z","dependency_job_id":null,"html_url":"https://github.com/m7a/lp-maerct","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/m7a/lp-maerct","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/m7a%2Flp-maerct","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/m7a%2Flp-maerct/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/m7a%2Flp-maerct/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/m7a%2Flp-maerct/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/m7a","download_url":"https://codeload.github.com/m7a/lp-maerct/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/m7a%2Flp-maerct/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":259426923,"owners_count":22855550,"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-11-08T15:15:15.135Z","updated_at":"2025-10-18T05:52:36.286Z","avatar_url":"https://github.com/m7a.png","language":"C","funding_links":[],"categories":[],"sub_categories":[],"readme":"---\nsection: 11\nx-masysma-name: maerct\ntitle: Ma_Sys.ma Emergency Remote Control\ndate: 2020/01/17 15:22:37\nlang: en-US\nauthor: [\"Linux-Fan, Ma_Sys.ma (Ma_Sys.ma@web.de)\"]\nkeywords: [\"programs\", \"c\", \"maerct\", \"linux\", \"keyboard\"]\nx-masysma-version: 1.1.0\nx-masysma-repository: https://www.github.com/m7a/lp-maerct\nx-masysma-website: https://masysma.net/11/maerct.xhtml\nx-masysma-owned: 1\nx-masysma-copyright: |\n  Copyright (c) 2020 Ma_Sys.ma.\n  For further info send an e-mail to Ma_Sys.ma@web.de.\n---\nName\n====\n\n`maerct` -- Ma_Sys.ma Emergency Remote Control: Kill X11 in case of hangs.\n\nSynopsis\n========\n\n\tmaerct [-f] FILE\n\nDescription\n===========\n\nThis program has to be run by the root user. It takes a Linux keyboard event\ndevice, e. g. `/dev/input/event0` and grabs it exclusively. Do not run it if\nyou only have one keyboard attached. `-f` forks twice.\n\n## Table of blink codes\n\nNumLock  CapsLock  ScrollLock  Description\n-------  --------  ----------  ------------------------------\nslow     off       off         Program operating correctly.\nfast     off       off         Program expecting input.\noff      fast      off         Process `X` takes \u003e80% CPU.\noff      slow      off         RAM exceeded.\noff      off       slow        Shorttime Load AVG greater 10.\noff      off       fast        Command is being executed.\noff      off       off         Program not operating.\n\n## Table of possible inputs\n\nKey  Description\n---  ----------------------------------------------------------\nESC  Cancel pending operation\nF1   Attempt to kill X11 process\nF2   Attempt to start (and immediately terminate) new X server.\nF4   Exit this program (no unlock required)\nu    Press this before another operation to unlock input.\n\nExtended Description\n====================\n\nThis program is intended to run as a background service on an interactively\nused machine with a second keyboard connected for the sole purpose of being\nused by this program (e. g. one can install otherwise unused PS2 keyboards for\nthe purpose).\n\nIt then outputs a limited amount of status information in form of regular blink\ncodes using the three keyboard LEDs: NumLock, CapsLock and ScrollLock.\n\nApart from displaying status, it can serve as a remote control (thus the name)\nfor killing the X-server. This might be an interesting feature for users of\nthird-party kernel modules (e. g. NVidia drivers or VirtualBox modules) which\nused to cause some X11 freezes on the machine this program was developed for.\nBy pressing [U], followed by [F1], one can cause the X-server to be\nterminated, freeing access to the console (if it does not work, sequence [U]\nfollowed by [F2] attempts to restart the X-server).\n\nBe aware that similar to SysRq-codes (which may also work in such cases), this\nprogram allows bypassing any running screensaver! In case you only want the\nkeyboard blinking, consider using [ma_capsblinker(11)](ma_capsblinker.xhtml)\n(currently does not provide any status information, but does not need to run\non a _separate_ keyboard).\n\nThis program is provided together with an LSB init script\n(`masysma-emergency-remote-control`) and a default configuration in\n`/etc/default/maerct` which is actually a shellscript sourced into the init\nscript, allowing for host-specific configuration or any other logic.\n\nCompilation\n===========\n\nTo compile this program, a C compiler is needed e. g. as provided by Debian\npackage `gcc-8-base`. Additionally, the `ant` build tool is needed and can then\nbe invoked by running `ant`. To build the Debian package (with the necessary\ndependencies installed), use `ant package`.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fm7a%2Flp-maerct","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fm7a%2Flp-maerct","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fm7a%2Flp-maerct/lists"}