{"id":13646658,"url":"https://github.com/abo-abo/ace-window","last_synced_at":"2025-07-06T08:04:27.136Z","repository":{"id":15414215,"uuid":"18146357","full_name":"abo-abo/ace-window","owner":"abo-abo","description":"Quickly switch windows in Emacs","archived":false,"fork":false,"pushed_at":"2023-12-29T03:09:06.000Z","size":199,"stargazers_count":947,"open_issues_count":61,"forks_count":85,"subscribers_count":21,"default_branch":"master","last_synced_at":"2024-05-09T21:05:45.415Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Emacs Lisp","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/abo-abo.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","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},"funding":{"liberapay":"abo-abo","patreon":"abo_abo"}},"created_at":"2014-03-26T17:10:18.000Z","updated_at":"2024-05-30T01:30:12.161Z","dependencies_parsed_at":"2024-05-30T01:40:18.803Z","dependency_job_id":null,"html_url":"https://github.com/abo-abo/ace-window","commit_stats":{"total_commits":201,"total_committers":33,"mean_commits":6.090909090909091,"dds":0.263681592039801,"last_synced_commit":"77115afc1b0b9f633084cf7479c767988106c196"},"previous_names":[],"tags_count":10,"template":false,"template_full_name":null,"purl":"pkg:github/abo-abo/ace-window","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/abo-abo%2Face-window","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/abo-abo%2Face-window/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/abo-abo%2Face-window/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/abo-abo%2Face-window/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/abo-abo","download_url":"https://codeload.github.com/abo-abo/ace-window/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/abo-abo%2Face-window/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":263868203,"owners_count":23522315,"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-08-02T01:03:02.213Z","updated_at":"2025-07-06T08:04:27.113Z","avatar_url":"https://github.com/abo-abo.png","language":"Emacs Lisp","funding_links":["https://liberapay.com/abo-abo","https://patreon.com/abo_abo"],"categories":["Emacs Lisp"],"sub_categories":[],"readme":"# ace-window\n\n[![GNU ELPA](https://elpa.gnu.org/packages/ace-window.svg)](https://elpa.gnu.org/packages/ace-window.html)\n[![MELPA](https://melpa.org/packages/ace-window-badge.svg)](https://melpa.org/#/ace-window)\n[![MELPA Stable](https://stable.melpa.org/packages/ace-window-badge.svg)](https://stable.melpa.org/#/ace-window)\n\n**GNU Emacs package for selecting a window to switch to**\n\n## What and why\n\nI'm sure you're aware of the `other-window` command.  While it's great\nfor two windows, it quickly loses its value when there are more windows.\nYou need to call it many times, and since it's not easily predictable,\nyou have to check each time if you're in the window that you wanted.\n\nAnother approach is to use `windmove-left`, `windmove-up`, etc.  These\nare fast and predictable.  Their disadvantage is that they need 4 key\nbindings.  The default ones are shift+arrows, which are hard to reach.\n\nThis package aims to take the speed and predictability of `windmove`\nand pack it into a single key binding, similar to `other-window`.\n\n## Setup\n\nJust assign `ace-window` to a short key binding, as switching windows\nis a common task.  I suggest \u003ckbd\u003eM-o\u003c/kbd\u003e, as it's short and not\nbound to anything important in the default Emacs.\n\n## Usage\n\nWhen there are two windows, `ace-window` will call `other-window`\n(unless `aw-dispatch-always` is set non-nil).  If there are more, each\nwindow will have the first character of its window label highlighted\nat the upper left of the window.  Pressing that character will either\nswitch to that window or filter to the next character needed to select\na specific window.  Note that, unlike `ace-jump-mode`, the position of\npoint will not be changed, i.e. the same behavior as that of\n`other-window`.\n\nA special character defined by `aw-make-frame-char` (default = `z`)\nmeans create a new frame and use its window as the target.  The new\nframe's location is set relative to the prior selected frame's location\nand given by `aw-frame-offset`.  The new frame's size is given by\n`aw-frame-size`.  See their documentation strings for more information.\n\nThe windows are ordered top-down, left-to-right. This means that if you\nremember your window layouts, you can switch windows without even\nlooking at the leading char.  For instance, the top left window will\nalways be `1` (or `a` if you use letters for window characters).\n\n`ace-window` works across multiple frames, as you can see from the\n[in-action gif](http://oremacs.com/download/ace-window.gif).\n\n\n## Swap and delete window\n\n- You can swap windows by calling `ace-window` with a prefix argument \u003ckbd\u003eC-u\u003c/kbd\u003e.\n\n- You can delete the selected window by calling `ace-window` with a double prefix argument, i.e. \u003ckbd\u003eC-u C-u\u003c/kbd\u003e.\n\n## Change the action midway\n\nYou can also start by calling `ace-window` and then decide to switch the action to `delete` or `swap` etc.  By default the bindings are:\n\n- \u003ckbd\u003ex\u003c/kbd\u003e - delete window\n- \u003ckbd\u003em\u003c/kbd\u003e - swap windows\n- \u003ckbd\u003eM\u003c/kbd\u003e - move window\n- \u003ckbd\u003ec\u003c/kbd\u003e - copy window\n- \u003ckbd\u003ej\u003c/kbd\u003e - select buffer\n- \u003ckbd\u003en\u003c/kbd\u003e - select the previous window\n- \u003ckbd\u003eu\u003c/kbd\u003e - select buffer in the other window\n- \u003ckbd\u003ec\u003c/kbd\u003e - split window fairly, either vertically or horizontally\n- \u003ckbd\u003ev\u003c/kbd\u003e - split window vertically\n- \u003ckbd\u003eb\u003c/kbd\u003e - split window horizontally\n- \u003ckbd\u003eo\u003c/kbd\u003e - maximize current window\n- \u003ckbd\u003e?\u003c/kbd\u003e - show these command bindings\n\nFor proper operation, these keys *must not* be in `aw-keys`.  Additionally,\nif you want these keys to work with fewer than three windows, you need to\nhave `aw-dispatch-always` set to `t`.\n\n## Customization\nAside from binding `ace-window`:\n\n    (global-set-key (kbd \"M-o\") 'ace-window)\n\nthe following customizations are available:\n\n### `aw-keys`\n`aw-keys` - the list of initial characters used in window labels:\n\n    (setq aw-keys '(?a ?s ?d ?f ?g ?h ?j ?k ?l))\n\n`aw-keys` are 0-9 by default, which is reasonable, but in the setup\nabove, the keys are on the home row.\n\n### `aw-scope`\nThe default one is `global`, which means that `ace-window` will work\nacross frames.  If you set this to `frame`, `ace-window` will offer you\nonly the windows of the current frame.\n\n### `aw-background`\n\nBy default, `ace-window` temporarily sets a gray background and\nremoves color from available windows in order to make the\nwindow-switching characters more visible.  This is the behavior\ninherited from `ace-jump-mode`.\n\nThis behavior might not be necessary, as you already know the locations\nwhere to look, i.e. the top-left corners of each window.\nSo you can turn off the gray background with:\n\n    (setq aw-background nil)\n\n### `aw-dispatch-always`\n\nWhen non-nil, `ace-window` will issue a `read-char` even for one window.\nThis will make `ace-window` act differently from `other-window` for one\nor two windows.  This is useful to change the action midway and execute\nan action other than the default *jump* action.\nBy default, this is set to `nil`.\n\n### `aw-dispatch-alist`\n\nThis is the list of actions you can trigger from `ace-window` other than the\n*jump* default.  By default it is:\n\n\t(defvar aw-dispatch-alist\n\t  '((?x aw-delete-window \"Delete Window\")\n\t\t(?m aw-swap-window \"Swap Windows\")\n\t\t(?M aw-move-window \"Move Window\")\n\t\t(?c aw-copy-window \"Copy Window\")\n\t\t(?j aw-switch-buffer-in-window \"Select Buffer\")\n\t\t(?n aw-flip-window)\n\t\t(?u aw-switch-buffer-other-window \"Switch Buffer Other Window\")\n\t\t(?c aw-split-window-fair \"Split Fair Window\")\n\t\t(?v aw-split-window-vert \"Split Vert Window\")\n\t\t(?b aw-split-window-horz \"Split Horz Window\")\n\t\t(?o delete-other-windows \"Delete Other Windows\")\n\t\t(?? aw-show-dispatch-help))\n\t  \"List of actions for `aw-dispatch-default'.\")\n\nWhen using ace-window, if the action character is followed by a string,\nthen `ace-window` will be invoked again to select the target window for\nthe action.  Otherwise, the current window is selected.\n\n### `aw-minibuffer-flag`\n\nWhen non-nil, also display `ace-window-mode` string in the minibuffer\nwhen `ace-window` is active.  This is useful when there are many\nside-by-side windows and the `ace-window-mode` string is cutoff in the\nminor mode area of the modeline.\n\n### `aw-ignored-buffers`\n\nList of buffers and major-modes to ignore when choosing a window from\nthe window list.  Active only when `aw-ignore-on` is non-nil.  Windows\ndisplaying these buffers can still be chosen by typing their specific\nlabels.\n\n### `aw-ignore-on`\n\nWhen t, `ace-window` will ignore buffers and major-modes in\n`aw-ignored-buffers`.  Use M-0 `ace-window` to toggle this value.\n  :type 'boolean)\n\n### `aw-ignore-current`\n\nWhen t, `ace-window` will ignore `selected-window'.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fabo-abo%2Face-window","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fabo-abo%2Face-window","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fabo-abo%2Face-window/lists"}