https://github.com/myterminal/window-shaper

A utility to easily resize windows within Emacs
https://github.com/myterminal/window-shaper

emacs window

Last synced: about 1 month ago
JSON representation

A utility to easily resize windows within Emacs

• Host: GitHub
• URL: https://github.com/myterminal/window-shaper
• Owner: myTerminal
• License: gpl-3.0
• Created: 2017-12-28T16:45:39.000Z (over 8 years ago)
• Default Branch: master
• Last Pushed: 2021-07-14T05:35:19.000Z (almost 5 years ago)
• Last Synced: 2026-03-08T04:05:38.519Z (4 months ago)
• Topics: emacs, window
• Language: Emacs Lisp
• Size: 16.6 KB
• Stars: 1
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# window-shaper

[![Marmalade](https://img.shields.io/badge/marmalade-available-8A2A8B.svg)](https://marmalade-repo.org/packages/window-shaper)  

[![License](https://img.shields.io/badge/LICENSE-GPL%20v3.0-blue.svg)](https://www.gnu.org/licenses/gpl.html)

A utility to easily resize windows within Emacs.

You can use window-shaper to resize windows with a press of a single key.

## Installation

### Manual

Save the file *window-shaper.el* to disk and add the directory containing it to `load-path` using a command in your *.emacs* file like:

    (add-to-list 'load-path "~/.emacs.d/")

The above line assumes that you've placed the file into the Emacs directory '.emacs.d'.

Start the package with:

    (require 'window-shaper)

### Marmalade

If you have Marmalade added as a repository to your Emacs, you can just install *window-shaper* with

    M-x package-install window-shaper RET

## Usage

Enable *window-shaper-mode* in any buffer to be able to use single keystrokes

to resize windows.

    (window-shaper-mode)

You can also set a key-binding to enable *window-shaper-mode* from any

buffer.

    (global-set-key (kbd "C-x C-#") 'window-shaper-mode)

Once the *window-shaper-mode* is enabled you can use the following shortcuts:

* **right**: increase window width

* **left**: decrease window width

* **up**: increase window height

* **down**: decrease window height

* **q**: disable window-shaper-mode