Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/mooerslab/emacsclient-custom-frames
Customized frames for instances of emacsclient instances.
https://github.com/mooerslab/emacsclient-custom-frames
bash bash-functions bash-script context-switching customized-frames emacs emacs-frame-label emacs-frames emacs-lisp emacsclient project-management project-management-tool
Last synced: 3 days ago
JSON representation
Customized frames for instances of emacsclient instances.
- Host: GitHub
- URL: https://github.com/mooerslab/emacsclient-custom-frames
- Owner: MooersLab
- License: mit
- Created: 2024-12-03T01:18:54.000Z (2 months ago)
- Default Branch: main
- Last Pushed: 2024-12-04T10:00:10.000Z (2 months ago)
- Last Synced: 2024-12-14T01:33:27.550Z (about 2 months ago)
- Topics: bash, bash-functions, bash-script, context-switching, customized-frames, emacs, emacs-frame-label, emacs-frames, emacs-lisp, emacsclient, project-management, project-management-tool
- Language: Shell
- Homepage:
- Size: 50.8 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
[](https://opensource.org/licenses/MIT)
# Customize emacsclient frames to make them distinguishable
## Problem addressed
Emacsclient opens a new frame (aka what non-Emacs users or non-Emacsens call a window).
It can be preferable to have multiple frames open rather than multiple panes (Emacsens call these windows) open in a frame, especially when working on multiple projects, each with an independent context.
The server can run for days or months, so the frames remain up for days or months.
It took me too long to grasp the joys of **emacslient**.
I wish that I had started using them earlier.
This above bash script `colored-clients.sh` provides 21 functions for calling **emacslient**, each with a unique foreground--background color combination.
They enable the opening of 21 uniquely colored frames.
These functions also take the project's name or index number as a command line argument.
The project name appears in the upper lefthand corner of the frame.
In the example below, the project index number is `6112`.
Its full name is `6112MooersLabGitHubLabRepos`, which I could have passed as a command line argument.
This label negates memorizing which color scheme is mapped to which project.
The snapshot below shows the upper lefthand corner of four frames, each with a different label.
## Further explanation of the problem
Emacs will take progressively longer to start when your initialization file becomes longer.
A file with a thousand lines may take five seconds to start.
This delay will be annoying, especially when the time approaches a minute or a few minutes.
Some of the delays can sometimes be associated with an over-configured shell.
One way around this problem is to start an Emacs server (M-x server-start) inside Emacs and then use the binary **emacsclient** to attach it to the server.
This binary resides in the same folder as your Emacs binary.
A new instance of the Emacs frame will open instantly with the configuration of the Emacs profile used to start the profile.
You can launch one server per profile if you have multiple profiles for distinct workflows.
You can name each server to attach it to your desired profile.
You may wind up with many Emacs frames that look identical.
You may have different buffers opened in the other frames, but they all share the same set of buffers.
The above script ,`colored-clients.sh`, of bash functions opens emacslient client instances with the project's name taken from the command line as an argument.
The bash functions are mapped to 21 foreground and background color combinations.
11 are dark on light, and 10 are light on dark.
## Easy recovery of the names of the customization functions
A table of the function names and the pairs of colored can be printed to the terminal by entering `efclients`.
The function named `efclients` aids in selecting a function that will generate a frame with the desired label and color scheme.
`ef` is my abbreviation for my Emacs profile, which named `e29fewpackages`.
`29` is the version number of the Emacs binary.
```bash
FunctionName bg color fg color
------------ + ----------------- + --------------
eflgc Light Green Black
eflyc Light Yellow Black
efwc White Black
eflgyc Light Gray Black
efic Ivory Black
efbec Biege Black
eflac Lavender Black
efmcc Mint Cream Black
efabc Alice Blue Black
efhdc Honey Drew Black
efptc Pale Turquoise Black
efsbtc Dark Slate Blue Thistle
efdglcc Dark Slate Gray Light Cyan
efmbcc Midnight Blue Lavender
efdgpgc Dark Olive Green Pale Green
efsbppc Saddle Brown Peach Puff
efdgpgc Dark Red Light Coral
efdmpc Dark Magenta Plum
efdcac Dark Cyan Aquamarin
efimpc Indigo Medium Purple
efdgmc Dark Goldenrod Moccasin
```
## Usage example
Enter the following command in the terminal after customizing and sourcing the above bash script.
```bash
efimpc 6112MooersLabGitHubLabRepos
```
## Naming an Emacs server after its profile
Give the server a unique name in the `init.el` file by adding the following line.
This server name will be used in the above bash functions to attach to the correct profile.
```elisp
(setq server-name "e29f")
```
You could make another set of functions to attach to a different profile, or these could be generalized by passing the profile name as a command line argument.
## Making text visible on highlighted lines
I would like to highlight the line that the cursor is currently on.
The color I selected for this highlighting blended too well with light-colored font when using dark backgrounds.
I had to pick a neutral color that would work against dark and light backgrounds.
I added the following code to my initialization file.
```elisp
;; Load hl-line mode
(require 'hl-line)
;; Set the hl-line face to a neutral color
(set-face-attribute 'hl-line nil :background "Gray70" :foreground nil)
;; Enable global hl-line mode
(global-hl-line-mode 1)
```
Likewise, I had a similar problem with selected text that was part of a region.
The following code will change the color of the selected text in a region to black.
```elisp
;; Set the region face to an intermediate color
(set-face-attribute 'region nil :background "SlateGray" :foreground "black")
;; Set the cursor color
(set-cursor-color "yellow")
```
## Update history
|Version | Changes | Date |
|:-----------|:------------------------------------------------------------------------------------------------------------------------------------------|:---------------------|
| Version 0.1 | Added badges, funding, and update table. Initial commit. | 2024 December 2 |
| Version 0.2 | Very extensive updates to the README.md file. Rewrote the text, added images, and added more code blocks. | 2024 December 3 |
## Sources of funding
- NIH: R01 CA242845
- NIH: R01 AI088011
- NIH: P30 CA225520 (PI: R. Mannel)
- NIH: P20 GM103640 and P30 GM145423 (PI: A. West)