<p align="center">
  <img width="512px" src="https://raw.githubusercontent.com/jimeh/emacs-liquid-glass-icons/refs/heads/main/img/logo.png" alt="Logo">
</p>

<h1 align="center">
  Emacs Liquid Glass Icons
</h1>

<p align="center">
  <strong>
    Emacs app icons in macOS 26's new Liquid Glass style.
  </strong>
</p>

## Overview

Created with Apple's new [Icon Composer][] application, using SVG shapes
extracted from [emacs.svg][] image included in Emacs' sources.

[Icon Composer]: https://developer.apple.com/icon-composer/
[emacs.svg]: https://github.com/emacs-mirror/emacs/blob/emacs-30.1/etc/images/icons/hicolor/scalable/apps/emacs.svg

A series of `*.icns` files are provided for macOS 15 and earlier, and a
`Assets.car` file is provided for macOS 26 and later.

## Usage

### macOS 15 and earlier

Grab the `.icns` file you prefer from the `Resources` directory, and replace
`Contents/Resources/Emacs.icns` within your Emacs.app.

It may take a while for macOS to realize the change, you can try and speed it by
temporarily renaming the Emacs app to something else and then back again.

### macOS 26

On macOS 26, the icons support light/dark mode, clear glass mode, and custom
color tints as well. However, this works a bit different from the old `.icns`
files on earlier macOS versions.

Grab the `Assets.car` file from the `Resources` directory, and place it into
`Contents/Resources` within your Emacs.app.

Then edit `Contents/Info.plist`, and add/update the following:

```xml
<key>CFBundleIconName</key>
<string>EmacsLG1</string>
```

Set the value to one of `EmacsLG1`, `EmacsLG2`, or `EmacsLG3` depending on which
icon you want to use. All three are bundled into the `Assets.car` file.

The existing `Contents/Resources/Emacs.icns` file with Emacs' default icon can
be left alone.

## The Icons

### EmacsLG1

EmacsLG1 simplifies and changes the outer shape of the default icon to comply
with the shape of Liquid Glass icons.

![EmacsLG1 Preview](https://raw.githubusercontent.com/jimeh/emacs-liquid-glass-icons/refs/heads/main/img/preview-lg1.png)

### EmacsLG2

EmacsLG2 stays as close to the original round icon as possible, while giving it
that Liquid Glass flair.

![EmacsLG1 Preview](https://raw.githubusercontent.com/jimeh/emacs-liquid-glass-icons/refs/heads/main/img/preview-lg2.png)

### EmacsLG3

EmacsLG3 is the biggest divergence from Emacs' default icon, and is inspired by
the changes Apple has made to some of its own icons in macOS 26.

![EmacsLG1 Preview](https://raw.githubusercontent.com/jimeh/emacs-liquid-glass-icons/refs/heads/main/img/preview-lg3.png)
