Use SF Symbols in place of the default toolbar images packaged with Emacs (NS variant).
- This work is intended for use only on Emacs for macOS. This package does not support other platforms.
- Calle 24 - Proxy Emacs image assets with SF Symbols
- Features
- Known Issues
- How Does This Work?
- Installation
- Using Calle 24
- License
- Sponsorship
- Why the name Calle 24?
- Basic set of Emacs image assets are proxied.
- Support for light and dark OS appearance.
- Not all Emacs image assets are proxied.
- Low color and monochrome image assets are not covered.
By convention, Emacs tool bar code references an image file by doing a path-list search with the basename part of the image file name. The path-list is specified by the variable image-load-path. The basename is treated as a pseudo-logical reference key.
Calle 24 takes advantage of this by recreating the same directory of image file names packaged by Emacs but instead using SF Symbol data as the image file content. The path to this directory is then inserted at the start of the image-load-path variable. When the tool bar code looks for an image, it will pick up the directory containing SF symbols data first and render it accordingly.
Calle 24 requires Emacs 29.1+ running on macOS.
The Calle 24 package (calle24) is distributed on MELPA. Use your package manager of choice to install it.
Upon installation or subsequent updates of calle24 from MELPA, run the following command:
M-x calle24-installYou should restart Emacs after running the above command to see the tool bar images replaced with their SF Symbols equivalent.
Add the following code to your Emacs initialization to load appearance-specific images.
(calle24-refresh-appearance)
(add-hook 'compilation-mode-hook #'calle24-refresh-appearance)In the event that you do not wish to use Calle 24, perform the following
steps before deleting the calle24 package.
In the event that you do not wish to use Calle 24, perform the following command:
M-x calle24-uninstallThis command will do the following:
- Remove the directory
calle24-image-directoryinuser-emacs-directory. - Remove
calle24-image-directoryfromimage-load-path.
The calle24-install command uses your local install of rsync to install the image files. There have been reports of Homebrew builds not successfully running calle24-install using the default macOS install of rsync. A workaround is to install the Homebrew version of rsync which should navigate the required permissions to successfully install.
If you use “light” mode always, there’s really nothing needed to do. However if you have your appearance mode on auto then tool bar images will need to change with respect to the current appearance.
This can be controlled by calling the command calle24-refresh-appearance upon appearance change.
Explicit invocation of appearance can be done with the following commands:
calle24-light-appearancecalle24-dark-appearance
All SF Symbols images used by Calle 24 are copyrighted by Apple, Inc.
Calle 24 is intended only for use in Emacs for macOS.
All source code for Calle 24 is GPLv3 licensed.
If you enjoy using Calle 24, consider making a modest financial contribution to help support its development and maintenance.
As SF Symbols references San Francisco, Calle 24 references 24th Street in the Mission District of San Francisco. It also happens to be the gathering place for the Emacs SF meetup.