Documentation

How Encore works

Getting started

Encore lives in the menu bar. Click its icon, the repeat sign, to open the main window, or press ⌃⌥E.

The sidebar has five groups: Widgets (desktop widgets, the music player, the Dynamic Island), Look (presets, appearance, typography), Tools, This Mac and Encore (shortcuts, licence, settings).

Encore needs macOS 15 Sequoia or later and a Mac with Apple silicon. The download page has it, and says how to open it the first time.

Dynamic Island

The island has two states.

  1. Closed. Black, with a small indicator on each side of the notch. A second activity shows as a dot beside it; click the dot to swap the two.
  2. Open. Click it for controls and tools. Click elsewhere, or press Escape, to close it. ⌃⌥D does both from the keyboard.

With music playing it opens on the player: cover, title and artist, the line with the time gone and the time left, and the playback buttons. The grid symbol at the top leads to the tools (timers, clipboard, shelf, sound, this Mac, colours). A one-line preview when you point at the island can be switched on in the island's settings; it is off to begin with.

It has two looks, under Widgets → Dynamic Island. Original Black is black throughout. Liquid Glass is black when closed and opens black at the top, turning into glass further down; Adjust the Glass sets how much glass, see-through, blur, depth, reflections, rim, shadow and tint it has.

Timers started in macOS's Clock app appear too. Encore can show them but not pause or stop them.

Music and the lock screen

Encore reads what the Spotify app is playing, after macOS asks you once. The floating player shows cover, controls and lyrics; synced lyrics come from LRCLIB when it has them.

Under Widgets → Music Player you can switch on the player for the lock screen. It appears while the Mac is locked and a song is there, as a compact player. Click the cover and the blurred cover becomes the lock screen's background; click again for the lyrics; click again to come back. Your own wallpaper returns when you unlock. Preview shows the player over your desktop.

Customise… opens the editor. It shows the whole lock screen for each of the three views: drag an element to move it, drag its round handle to resize it, use the eye to show or hide it. Encore's own clock and date are among the elements. macOS's login field is kept free, and Reset This View brings back Encore's arrangement.

In the compact view the player is one piece: drag it and everything in it moves along; Reset Position puts it back, and switching off Move as one piece lets you arrange its parts. To move several elements together, drag across empty space or drag with the right mouse button to draw a rectangle around them, or Shift-click them; with several selected, the buttons on the right line them up on an edge or a middle. While you drag, a line appears when something lines up with the middle of the screen or with another element, and it snaps there. Hold ⌘ to move without that.

macOS has no lock screen slot for apps, so Encore uses an interface Apple doesn't document. If a macOS update removes it, the player simply stops appearing there.

Desktop widgets

Open Widgets → Desktop Widgets and click a widget to add it. It appears at the top left of your desktop, in front of your windows for a few seconds so you can see it, then settles behind them.

  • Drag a widget to move it. Its position is remembered.
  • Right-click it for its size, light or dark look, and options.
  • World Clock, Countdown, Weather and App Launcher have options: cities, a date, a city, apps.
  • Calendar and Reminders show a button the first time. Clicking it makes macOS ask for access.

Presets

A preset sets your wallpaper, your desktop widgets and where they sit, their look, your fonts and the island's look. Open Look → Presets, click one, choose which parts to apply, and click Apply Preset.

  • Restore Original Setup brings back the setup you had before your first preset. It is saved once and kept until you replace it yourself.
  • Undo goes back one step. Recent lists the presets you applied lately.
  • Save your own desktop as a preset, export it as a file, and import presets others send you. Nothing of yours is overwritten.

macOS lets an app change the wallpaper only on the desktop you are looking at, not on your other Spaces. A moving wallpaper can't be set by an app; Encore tells you if yours would have to be chosen again by hand.

Fonts

Open Look → Typography. Choose a font for text, for headings and for figures; adjust size, weight and spacing. The preview shows the result at once, and nothing else changes until you click Apply.

To use a font file, click Import Font or drop the file on the page. Encore accepts .otf, .ttf and .ttc, copies the file into its own folder and switches it on for Encore only. Web fonts (.woff) cannot be used by Mac apps. Use only fonts you have a licence for.

Encore Unlock

Under Encore → Settings → Encore Unlock you can have Encore's window ask for Touch ID, or your Mac's password, before it opens. Encore asks macOS whether it is you and gets back only yes or no; it never sees a fingerprint or a password. Switching it on or off is confirmed the same way.

It protects Encore's window. The island, the desktop widgets and the menu bar keep working while the window is locked. No Mac has Face ID; if one ever does, Encore uses it through the same system service.

Volume for one app

Open This Mac → Sound. Every app that is playing has a slider. Encore passes that app's sound through itself and turns it down; nothing is recorded. The first time, macOS asks whether Encore may listen to the Mac's sound. At 100 % Encore leaves the app alone.

This needs macOS 14.2 or later.

Licence

Encore runs in full for 7 days. After the trial its desktop widgets, island and floating player wait until a licence is entered; your layout and settings are kept. A licence costs US$2 once.

A licence runs Encore on one Mac at a time. To use it on a different Mac, open Encore → Licence on the Mac that has it and choose Move to Another Mac, then enter the key on the other one. If you no longer have the old Mac, enter the key on the new one and choose Move Licence Here; this works twice in 30 days.

Encore checks the licence about once a day while the Mac is online and keeps working for 14 days without a connection.

Updates

Encore asks its website once a day whether there is a newer version. When there is, a window shows what is new. Download and Install fetches it, checks it, puts it in place of the version you have and starts Encore again. Your settings, presets and data are not in the app and stay as they are.

Before anything is replaced, Encore checks the download's fingerprint and a signature that only Encore's maker can produce. A download that fails the check is thrown away and you are told why. If the connection drops, Try Again continues where it stopped.

Under Encore → Settings → Updates you can look right away or switch the daily look off. If Encore can't replace itself where it is, for example because it is still running from the downloaded folder, it shows the checked new version in the Finder for you to drag into Applications.

Permissions

Encore asks for a permission only when you first use what needs it.

  • Automation (Spotify): to read what is playing.
  • Accessibility: to move other apps' windows into layouts, and to list the menu bar's icons by name.
  • System Audio Recording: to change one app's volume.
  • Calendar and Reminders: for those widgets and for events in the island.
  • Screen Recording: for screenshots and recordings.
  • Notifications: for focus sessions and reminders.

Settings → Permissions shows which are granted and opens the right place in System Settings.

Troubleshooting

The island doesn't appear

It shows only while something is going on. Start a timer from the island's Timers page, or check Widgets → Dynamic Island → Show Dynamic Island.

A widget shows a button instead of content

It needs something from you first: a city for Weather, or access to Calendar or Reminders. Click the button.

An app went silent after I moved its volume

macOS didn't pass its sound to Encore. Encore notices within a few seconds and puts the app back to normal; allow Encore under System Settings → Privacy & Security → Screen & System Audio Recording and try again.

My wallpaper didn't come back

If it was a moving or changing wallpaper, macOS doesn't let apps set it. Choose it again in System Settings → Wallpaper. Everything else is restored.