Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/muffinmad/emacs-mini-frame

Show minibuffer in child frame on read-from-minibuffer
https://github.com/muffinmad/emacs-mini-frame

childframe emacs minibuffer

Last synced: 3 months ago
JSON representation

Show minibuffer in child frame on read-from-minibuffer

Host: GitHub
URL: https://github.com/muffinmad/emacs-mini-frame
Owner: muffinmad
License: gpl-3.0
Created: 2020-02-05T06:52:51.000Z (almost 5 years ago)
Default Branch: master
Last Pushed: 2024-01-06T08:42:18.000Z (11 months ago)
Last Synced: 2024-02-17T08:35:51.803Z (9 months ago)
Topics: childframe, emacs, minibuffer
Language: Emacs Lisp
Size: 1.85 MB
Stars: 306
Watchers: 9
Forks: 19
Open Issues: 21
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

README

        [![Stand With Ukraine](https://raw.githubusercontent.com/vshymanskyy/StandWithUkraine/main/banner2-direct.svg)](https://stand-with-ukraine.pp.ua)

[![License GPL 3](https://img.shields.io/badge/license-GPL_3-green.svg)](http://www.gnu.org/copyleft/gpl.html)

[![MELPA](http://melpa.org/packages/mini-frame-badge.svg)](http://melpa.org/#/mini-frame)

# emacs-mini-frame

Place minibuffer at the top of the current frame on `read-from-minibuffer`.

While it's fine for me to have eldoc, flymake and other messages to appear at the bottom of the screen, editing minibuffer (find file, create VC branch, etc.) feels more comfortable in the upper area of the screen.

`mini-frame-mode` makes an advice around `read-from-minibuffer` function to create and show minibuffer-only child frame to accept input.

## How it looks like

By default mini-frame is placed at the top of the current frame and occupies full width. Here is `execute-extended-command` (M-x) with `icomplete-mode` enabled:



  



Those who use vertical completion candidates list may configure mini-frame not to occupy full width:

```elisp

(custom-set-variables

 '(mini-frame-show-parameters

   '((top . 10)

     (width . 0.7)

     (left . 0.5))))

```

Here is `switch-to-buffer` (C-x b) with `ido-vertical-mode`:



  



And `execute-extended-command` (M-x) with `ivy-mode`:



  



`mini-frame-mode` also creates a separate child frame to display completions list:



  



## Mini-frame size

Users of Emacs 27 will benefits the most because of `resize-mini-frames` variable: mini-frame will be resized vertically to fit content.

Users of Emacs 26 will need to configure frame height explicitly, e.g.:

```elisp

(custom-set-variables

 '(mini-frame-show-parameters

   '((top . 0)

     (width . 1.0)

     (left . 0.5)

     (height . 15))))

```

### Gnome shell does not resize Emacs child frames

Until [this issue](https://gitlab.gnome.org/GNOME/mutter/-/issues/840) will be solved, Gnome Shell users must also set mini-frame height.

Another option for Gnome Shell users is to use the following code in initialization file:

```elisp

(setq x-gtk-resize-child-frames 'resize-mode)

```

## Ignore commands

One can configure the list of commands that must not be shown in the child frame by customizing the `mini-frame-ignore-commands`. The `eval-expression` command is there by default because mini-frame have no modeline to display eldoc hints. And because there must be some place to turn `mini-frame-mode` off if something goes wrong (I hope not) :)

## Installation and usage

`mini-frame` is available on [MELPA](https://melpa.org/#/mini-frame).

Alternatively, you can download `mini-frame.el` and run:

M-x `package-install-file` RET `` RET

M-x `mini-frame-mode` RET