https://github.com/frostyx/eyebrowse-restore

Never lose your Eyebrowse window configurations again.
https://github.com/frostyx/eyebrowse-restore

emacs emacs-mode emacs-package

Last synced: 4 months ago
JSON representation

Never lose your Eyebrowse window configurations again.

• Host: GitHub
• URL: https://github.com/frostyx/eyebrowse-restore
• Owner: FrostyX
• License: gpl-3.0
• Created: 2021-12-08T21:19:48.000Z (about 3 years ago)
• Default Branch: main
• Last Pushed: 2024-03-04T23:38:40.000Z (12 months ago)
• Last Synced: 2024-03-05T00:38:34.129Z (12 months ago)
• Topics: emacs, emacs-mode, emacs-package
• Language: Emacs Lisp
• Homepage:
• Size: 51.8 KB
• Stars: 18
• Watchers: 3
• Forks: 2
• Open Issues: 1
• Metadata Files:
  • Readme: README.org
  • License: LICENSE

Awesome Lists containing this project

README

        
#+TITLE: eyebrowse-restore

Never lose your [[https://depp.brause.cc/eyebrowse/][Eyebrowse]]

window configurations again.

** Installation

The package is in MELPA

#+BEGIN_SRC emacs-lisp

(use-package eyebrowse-restore

  :ensure t

  :config

  (eyebrowse-restore-mode))

#+END_SRC

Or install it from upstream using Quelpa (or your preferred package manager)

#+BEGIN_SRC emacs-lisp

(use-package eyebrowse-restore

  :ensure t

  :quelpa (eyebrowse-restore

           :fetcher github

           :repo "FrostyX/eyebrowse-restore"

           :branch "main")

  :config

  (eyebrowse-restore-mode))

#+END_SRC

** Usage

All Eyebrowse window configurations for all Emacs frames are

automatically saved with a periodicity of

~eyebrowse-restore-save-interval~. If you want to invoke this action

manually, run ~M-x eyebrowse-restore-save-all~.

Apart from that, when closing an Emacs frame, its Eyebrowse window

configurations are saved beforehand.

After an Emacs crash, god forbid, simply run ~M-x

eyebrowse-restore~ to use Eyebrowse workspace from a backup of

your choice.

[[images/eyebrowse-restore.png]]

For a better experience, I recommend naming your Emacs frames, e.g.

#+BEGIN_SRC emacs-lisp

(set-frame-parameter nil 'name "Main")

#+END_SRC

** Configuration

*** Multiple Emacs instances

There is no locking mechanism that would prevent multiple Emacs

instances from overriding each other's backups. Either enable

~eyebrowse-restore-mode~ only for one instance or configure

~eyebrowse-restore-dir~ to a different directory for each instance.

** Background

Eyebrowse separates window configurations per Emacs frame (in opposite

to Emacs instance). This is intended behavior and it is rooted in the

implementation details. In a daemon setup, window configurations are

assigned to an ~emacsclient~ frame instead of the daemon instance,

i.e. closing an ~emacsclient~ destroys all of its Eyebrowse window

configurations.

Making window configurations shared across all Emacs frames is a

controversial topic because the use-case is nonsensical for the

majority of users.

The main issue for me is not the absence of sharing window

configurations across all frames but recovering from reboots, window

manager crashes, Emacs crashes, or anything else that results in

having to spawn a new Emacs instance from scratch.

Thanks to the

[[https://www.gnu.org/software/emacs/manual/html_node/emacs/Saving-Emacs-Sessions.html#Saving-Emacs-Sessions][desktop.el]],

Eyebrowse supports persistent window configurations with one caveat -

it is reliable only for single-frame use. When using multiple Emacs

frames, it depends in what order the frames are closed, and only the

last one is remembered.

The ~eyebrowse-restore~ prevents you from losing the window

configurations for the rest of the frames.