{"id":20174306,"url":"https://github.com/guiltydolphin/emaps","last_synced_at":"2025-07-14T21:34:06.840Z","repository":{"id":85554645,"uuid":"61568872","full_name":"GuiltyDolphin/emaps","owner":"GuiltyDolphin","description":"Utilities for working with keymaps in Emacs","archived":false,"fork":false,"pushed_at":"2020-05-08T18:01:03.000Z","size":62,"stargazers_count":13,"open_issues_count":7,"forks_count":3,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-04-10T03:46:47.765Z","etag":null,"topics":["emacs","emacs-lisp"],"latest_commit_sha":null,"homepage":null,"language":"Emacs Lisp","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/GuiltyDolphin.png","metadata":{"files":{"readme":"README.org","changelog":"CHANGELOG.org","contributing":null,"funding":null,"license":"LICENSE","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}},"created_at":"2016-06-20T17:58:52.000Z","updated_at":"2021-09-30T23:49:51.000Z","dependencies_parsed_at":"2023-07-20T11:31:29.137Z","dependency_job_id":null,"html_url":"https://github.com/GuiltyDolphin/emaps","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/GuiltyDolphin/emaps","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GuiltyDolphin%2Femaps","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GuiltyDolphin%2Femaps/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GuiltyDolphin%2Femaps/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GuiltyDolphin%2Femaps/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/GuiltyDolphin","download_url":"https://codeload.github.com/GuiltyDolphin/emaps/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GuiltyDolphin%2Femaps/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":263541076,"owners_count":23477454,"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":["emacs","emacs-lisp"],"created_at":"2024-11-14T01:42:15.021Z","updated_at":"2025-07-04T12:32:17.863Z","avatar_url":"https://github.com/GuiltyDolphin.png","language":"Emacs Lisp","funding_links":[],"categories":[],"sub_categories":[],"readme":"#+TITLE: Emaps\n\n* Introduction\n\nEmaps provides utilities for working with keymaps and keybindings in Emacs.\n\n* Features\n\n** Defining keys\n\nEmacs has a built-in ~define-key~ function, but this can only handle one binding\nat a time, for example:\n\n#+BEGIN_SRC emacs-lisp\n(define-key keymap \"a\" 'fun-a)\n(define-key keymap \"b\" 'fun-b)\n(define-key keymap \"c\" 'fun-c)\n; etc.\n#+END_SRC\n\nEmaps provides the ~emaps-define-key~ function that provides the same\nfunctionality, but allows multiple keys to be defined at once, thus the\nabove becomes:\n\n#+BEGIN_SRC emacs-lisp\n(emaps-define-key keymap\n  \"a\" 'fun-a\n  \"b\" 'fun-b\n  \"c\" 'fun-c) ; etc.\n#+END_SRC\n\n** Viewing keymaps\n\nRun ~M-x emaps-describe-keymap-bindings~ to display the\nbindings for a given keymap (see below),\n~emaps-describe-keymap~ can be used to view keymaps as\nvariables (but with characters displayed instead of integers,\nwhere possible). Executing these commands with a prefix\nargument allows you to choose from only active keymaps.\n\n#+CAPTION: Display after running ~emaps-describe-keymap-bindings~ with ~magit-status-mode-map~.\n#+NAME:   fig:emaps-describe-keymap-bindings-magit-status-mode-map\n[[./images/emaps-describe-keymap-bindings.png]]\n\n** Recommended Bindings\n\nI recommend the following bindings with Emaps (though I\nencourage you to experiment and find what works best for you):\n\n| Key     | Command                          |\n|---------+----------------------------------|\n| ~C-h K~ | ~emaps-describe-keymap-bindings~ |\n\nWhich you can set with the following snippet:\n\n#+BEGIN_SRC emacs-lisp\n  (emaps-define-key global-map\n    (kbd \"C-h K\") 'emaps-describe-keymap-bindings)\n#+END_SRC\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fguiltydolphin%2Femaps","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fguiltydolphin%2Femaps","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fguiltydolphin%2Femaps/lists"}