Help

Remember Windows Help

The same guide that’s built into the app. In the app, choose Remember Windows Help from the menu.

Getting Started

Remember Windows puts an app's windows back where you left them: the same size, the same place, on the same display and the same Desktop. It does this when the app launches, when your displays change, or whenever you ask.

Remember Windows lives in the menu bar. Click its icon (two overlapping windows) to open the menu. It has no Dock icon and no main window.

Allow Accessibility access

To move other apps' windows, Remember Windows needs Accessibility access in macOS. The first time you open it, the Welcome window walks you through it:

  1. Click Open System Settings… in the Welcome window. macOS opens Privacy & Security › Accessibility. If macOS shows an alert, click Open System Settings.
  2. Turn on Remember Windows in the list. macOS may ask for your password.
  3. Go back to the Welcome window. Within a couple of seconds it shows "Accessibility granted". You don't need to restart the app.

Until access is granted, the menu shows Grant Accessibility Access… instead of your apps. Choose it to open the Welcome window again. To see the Welcome window later, open Settings › General and click Show Welcome Window.

Remember your first app

  1. Open an app and arrange its windows the way you like them.
  2. Click the Remember Windows icon in the menu bar.
  3. Choose the app from Other Running Apps, then choose Remember.

The menu confirms how many windows were remembered, and the app moves up to Remembered Apps with a checkmark. From now on, when you quit and reopen that app, its windows go back to where you remembered them.

Remember Windows saves every standard window of the app, on every Desktop, including minimized windows. Full-screen windows are skipped.

What the menu shows

  • The first line names your current display setup, for example "2 displays: built-in + 1 external". You can rename it in Settings › Layouts.
  • Below it, the latest message from Remember Windows, such as how many windows were remembered or restored.
  • Remembered Apps lists running apps that have a saved layout for this display setup. Each app has its own submenu with Remember, Restore Now, Update Saved Layout, Auto-Restore Here and Forget.
  • Other Running Apps lists the running apps that don't have a layout here yet.
  • Groups appears once you create a group in Settings.
  • Restore All puts every remembered running app back in place.
  • Settings… (Command-Comma) opens Settings, with the General, Layouts and Groups tabs.

Start at login

To have Remember Windows ready whenever you log in, open Settings › General and turn on "Start Remember Windows at login".

Updates

Choose Check for Updates… from the menu to see if a newer version is available. Remember Windows can also check automatically; you can turn that on or off in Settings › General › Updates with "Check for updates automatically".

Learn more

  • Remembering and Restoring: everything the app menu does, and when windows are restored automatically.
  • Desktops and Displays: multiple displays, display setups and Desktops.
  • Groups and Hotkeys: restore several apps at once, from anywhere.
  • Troubleshooting: what to do when a window doesn't move.

You can also read this help on the web at remember-windows.pages.dev/help.

Remembering and Restoring

Each app has its own submenu in the Remember Windows menu. Remembered apps are listed under Remembered Apps; other running apps are under Other Running Apps. Only running apps appear in the menu. To see layouts for apps that aren't running, open Settings › Layouts.

The app menu

  • Remember saves the size, position, display and Desktop of every window the app has open. If this display setup already has a layout for the app, Remember Windows asks before replacing it. Select the checkbox in that alert if you don't want to be asked again.
  • Restore Now puts the app's windows back where they were saved. The app stays where it is in the window order; it isn't brought to the front.
  • Update Saved Layout saves the windows' current places without asking. It's available when windows have moved since they were saved, a saved window is missing, or a window is on a different Desktop.
  • Auto-Restore Here controls whether this app is restored automatically on this display setup. Turn it off for an app you sometimes arrange differently. Restore Now still works when it's off. When a compatible setup is in use, this changes the setup it borrows from (named at the top of the menu). With sync on, the change reaches your other Macs.
  • Forget deletes the app's layout for this display setup. Layouts for other display setups are kept. When a compatible setup is in use, this changes the setup it borrows from (named at the top of the menu). With sync on, the change reaches your other Macs.

Layouts are saved per display setup. The same app can have one layout for your laptop on its own and another for your laptop with a monitor attached. See Desktops and Displays.

Status icons

Icons next to an app's name in the menu tell you how it stands:

  • A checkmark means the app has a layout here and its windows are in place.
  • Circular arrows mean windows have moved since they were saved, a saved window is missing, or a window is on a different Desktop. Hold the pointer over the app's name to see what changed, for example "1 window moved". Choose Restore Now to put the windows back, or Update Saved Layout to keep them where they are.
  • A pause symbol means Auto-Restore Here is turned off for this app on this display setup. It takes the place of the circular arrows, so a paused app never shows them, even when its windows have moved. Update Saved Layout still works.
  • A warning triangle means the app didn't respond to Accessibility within 10 seconds of launching, so its windows couldn't be placed. See Troubleshooting.

Restore All

Restore All restores every running app that has a layout for this display setup. Apps with Auto-Restore Here turned off are skipped. You can give Restore All a hotkey; see Hotkeys.

Automatic restore

Remember Windows restores windows on its own in two situations. You can turn each one off in Settings › General › Automatic Restore:

  • "Restore an app's windows when it launches": when a remembered app opens, its windows are put back in place.
  • "Restore all windows when displays change": when you connect or disconnect a display, or change a display's resolution or arrangement, every remembered running app is put back in place for the new setup.

Apps with Auto-Restore Here turned off are skipped in both cases.

Timing

Some apps open their windows one by one, or change a window's title after it appears. Settings › General › Timing has two settings for this:

  • "Keep placing new windows for 60 s after launch": after an app launches, Remember Windows keeps watching for new windows and places each one as it appears. You can choose from 5 to 300 seconds. Raise it for apps that take a long time to open all their windows.
  • "Wait 3 s for displays to settle": after a display change, Remember Windows waits until the displays have stopped changing for this long before restoring. You can choose from 1 to 15 seconds. Raise it if your monitors take a while to wake up.

How windows are matched

When an app has several windows, each open window is matched to a saved one:

  1. A window with exactly the same title as a saved window takes its place.
  2. Then a window whose title fits a saved window's title pattern. See Layouts and Title Patterns.
  3. Then the remaining windows go to the saved windows closest to them in size, preferring the same Desktop.

Windows without a title wait for a title during the launch watch, so they don't take a place meant for a titled window. Windows beyond the number that were saved are left alone. If a display is now smaller than when you remembered, windows are moved and shrunk to fit on it.

Desktops and Displays

Display setups

A display setup (also called a display configuration) is the set of displays connected to your Mac. Remember Windows keeps a separate layout for each one, so your apps can be arranged one way on the laptop alone and another way at your desk.

Each window is saved relative to the display it was on. When you remember an app, the layout is stored for the displays connected right now. The first line of the menu shows which setup is in use.

Displays are recognized by their hardware identity, not by their position or name. Remember Windows looks for a saved setup that fits the displays you have now:

  • Exact: the same displays as when you remembered. The saved layout is used as is. An exact setup always wins.
  • Compatible: the same number of displays, with the same sizes, but not the same ones. For example, a different monitor of the same size, or another Mac. The saved layout is used, matching displays from left to right.

A compatible setup is used only while nothing is saved for your exact displays. If you choose Remember while a compatible setup is in use, the windows are saved in a new setup for the displays you have now. From then on that new setup is used here, so other apps saved only in the compatible setup no longer appear as remembered until you remember them again. The original setup keeps its layouts.

If no saved setup is exact or compatible, apps have no layout here until you remember them with these displays.

Naming and managing setups

Open Settings › Layouts to see every saved display setup. Each one shows its name, how many displays it has, and "current" next to the setup saved for the displays connected now. A compatible setup that's being borrowed isn't marked. You can:

  • Click the name to rename a setup. The new name appears at the top of the menu.
  • Open a setup to see the apps saved in it, and open an app to see each saved window.
  • Click the trash button to delete a setup, an app's layout in it, or a single saved window.

Desktops

Remember Windows works with all your Desktops (Spaces), not only the one you're looking at. When you remember an app, windows on every Desktop are saved, along with the number of the Desktop each one is on, as shown in Mission Control.

When you restore, each window goes back to its saved size and place, and back to its saved Desktop on the same display. The Desktop you're looking at doesn't change, and nothing is brought to the front.

  • If the saved Desktop no longer exists on that display (you saved a window on Desktop 3 and the display now has only 2 Desktops), the menu tells you. Add a Desktop in Mission Control, then restore again. Remember Windows doesn't create Desktops itself.
  • If a window can't be moved to its Desktop, the menu says so; drag the window to the right Desktop in Mission Control.
  • Windows are moved between Desktops only on the display they were saved on. When a compatible setup is in use, windows are placed on the matching display but stay on the Desktop they're on.
  • Minimized windows stay in the Dock and are not moved between Desktops.

Desktop numbers count only regular Desktops, from left to right in Mission Control. If "Displays have separate Spaces" is turned off in System Settings › Desktop & Dock, all displays share one list of Desktops.

Full-screen windows and Stage Manager

  • Full-screen windows are skipped. They aren't remembered and aren't moved. To include a window, take it out of full screen before you choose Remember.
  • Stage Manager is not supported. Windows inside stages may not restore correctly. For best results, turn off Stage Manager in Control Center.

Groups

A group restores several apps at once, for example everything you use for a project. A group can also launch apps that aren't running, and open web pages and files.

Create a group

  1. Choose Settings… from the menu, then click Groups.
  2. Click Add. A new group appears in the list.
  3. Type a name for the group.
  4. Under Apps, select the checkbox next to each app that belongs to it.

The Apps list shows every app that is running or has a saved layout. A member that isn't running and has no layout shows "not remembered"; one that can't be found on this Mac shows "not installed".

To delete a group, select it and click Delete.

Group options

  • "Launch apps that aren't running": on by default. When it's on, restoring the group opens members that aren't running, and their windows are placed as they appear. When it's off, those members are skipped.
  • Hotkey: click the field and press a key combination to restore the group from any app. See Hotkeys.
  • Also Open: web addresses and files to open whenever you restore the group. Click Add URL… to type a web address (it must include a scheme, such as https://), or Add File… to choose a file. Web addresses open in your default browser and files open in their default app, which then comes to the front. A file that no longer exists is shown in red.

Use a group

Groups appear in the menu under Groups. Each group has two commands:

  • Restore places the windows of every member that's running, launches the missing ones if the group allows it, and opens the group's web addresses and files.
  • Remember saves the windows of every member that's running, as if you chose Remember for each app. It's available when at least one member is running.

After a restore, the menu sums up what happened, for example "Writing: restored 2, launched 1, opened 1". Other words you may see there:

  • "no layout for": the member has no layout for this display setup, so its windows weren't placed.
  • "not installed": the member couldn't be found on this Mac.
  • "skipped": the member wasn't running and the group doesn't launch apps, or Auto-Restore Here is turned off for it on this display setup.
  • "missing": a file couldn't be found, or a web address couldn't be opened.

A launched app's windows are placed even if "Restore an app's windows when it launches" is turned off in Settings › General.

Hotkeys

Hotkeys let you restore windows without opening the menu. They work from any app.

Set a hotkey

  • Restore All: open Settings › General › Hotkeys, click the field next to Restore All, and press the key combination you want, such as Control-Option-R.
  • A group: open Settings › Groups, select the group, click the Hotkey field, and press a key combination.

To clear a hotkey, click the clear button (×) at the end of its field.

Things to know

  • Each key combination can be used once. If you press a combination that's already used for Restore All or another group, Remember Windows tells you which one has it and doesn't assign it.
  • A group's hotkey keeps working after you rename the group. Deleting a group removes its hotkey.
  • Choose combinations other apps don't use. Combinations that include Control and Option, like Control-Option-T, are a good place to start.
  • Hotkeys are stored on this Mac. They aren't included when you export layouts, and they don't sync to your other Macs, so set them on each Mac.
  • Hotkeys are registered with macOS. Remember Windows doesn't watch what you type.

Layouts and Title Patterns

Settings › Layouts shows everything Remember Windows has saved, for every display setup, including apps that aren't running.

The layouts list

The list is grouped by display setup. Open a setup to see its apps, and open an app to see its saved windows.

  • A setup shows its name (click to rename it), the number of displays, and "current" when it's saved for the displays connected now.
  • An app shows its name and number of saved windows, and an "Auto-restore here" checkbox that does the same as Auto-Restore Here in the menu.
  • A window shows its title (or "(untitled)"), its size, whether it was minimized, and a title pattern field.

Click a trash button to delete a setup, an app's layout, or a single window. Deleting can't be undone, but you can remember the app again at any time.

To see the file where layouts are kept, click Show Layouts File in Finder.

The arrangement map

Above the list, a map draws the displays of a setup in their real arrangement. The built-in display is tinted.

  • Click the map button next to a setup to show that setup's displays.
  • Click the map button next to an app to also draw that app's saved windows on them. Minimized windows have a dashed outline.

The map only shows what's saved; it doesn't move anything.

Title patterns

Remember Windows first matches windows by their exact title. Some apps change a window's title as you work, for example a chart window titled "AAPL / Morning" that becomes "MSFT / Morning" when you switch symbols. A title pattern lets that window still find its place.

A title pattern is a regular expression: a way to describe many titles at once, where some characters have special meanings (for example, .* stands for any text). A window whose title matches the pattern takes that saved window's place, before windows are matched by size.

  • Type a pattern in the field under a saved window, then press Return or click elsewhere to save it.
  • Click Suggest to fill in a pattern for you. It keeps the part of the title after the last separator, such as " / ", " - ", " — ", " | " or " · ", and matches anything before it. For "AAPL / Morning", the suggestion matches any title ending in " / Morning". Suggest is available only when the title has one of those separators.
  • To remove a pattern, clear the field.
  • A pattern that isn't a valid regular expression is outlined in red and ignored when matching.

When you remember the app again on the same display setup, a window keeps its pattern as long as its title is the same or still matches the pattern.

Patterns are case-sensitive. The suggestion starts with ^ and ends with $, so it matches whole titles only.

Sync and Backup

Sync between Macs

If you use Remember Windows on more than one Mac, it can share your layouts and groups between them through iCloud Drive.

  1. On each Mac, open Settings › General.
  2. Under Sync, turn on "Sync layouts and groups between Macs".

Remember Windows uses a folder named RememberWindows in your iCloud Drive. To use a different folder, such as one synced by another service, click Choose Folder…. If iCloud Drive isn't turned on, Remember Windows asks you to choose a folder.

How sync works:

  • Each Mac writes its own file to the folder and reads the files of the other Macs. Because no two Macs write the same file, there are never sync conflicts.
  • Changes arrive within a few seconds of iCloud Drive delivering them, and Remember Windows also checks the folder every minute. Click Sync Now to sync right away.
  • When two Macs have saved a layout for the same app on the same display setup, the most recent one wins. When you forget a layout or delete a group on one Mac, it's removed on the others too.
  • A synced layout is used on another Mac when that Mac's displays match: the same monitors, or, when nothing is saved for that Mac's exact displays, the same number of displays with the same sizes. See Desktops and Displays.
  • Auto-Restore Here is part of an app's layout, so it syncs along with it. The settings in Settings › General, such as timing and automatic restore, and your hotkeys stay on each Mac.

While sync is on, a cloud icon appears next to the first line of the menu. Settings shows when the last sync happened and which other Macs were seen. When something goes wrong, Settings shows the error and the cloud next to the menu's first line gets an exclamation mark.

To stop syncing, turn the switch off. Your layouts on this Mac stay as they are. To also stop sharing this Mac's layouts with the others, click Remove My File from the Sync Folder. This turns sync off and deletes this Mac's file from the folder; the other Macs keep what they already have.

Export and import

You can save all your layouts in a file, as a backup or to move them to another Mac by hand.

  • Export Layouts… (Settings › General › Backup) saves your layouts, groups and settings in a JSON file, named with today's date. It suggests your Downloads folder.
  • Import Layouts… replaces everything with the contents of a file you exported. Remember Windows shows how many display setups and groups you have now and how many the file has, and asks before replacing. Your current layouts are kept as a backup file next to the layouts file. A file that isn't a Remember Windows layouts file is rejected, and nothing changes.

When sync is on, imported layouts are shared with your other Macs, but nothing is deleted on them.

Hotkeys aren't part of an export. After importing on a different Mac, set them again in Settings.

Where your layouts are kept

Layouts are stored in ~/Library/Application Support/RememberWindows/layouts.json. Click Show Layouts File in Finder in Settings › Layouts to open its folder.

If the file ever becomes unreadable, Remember Windows moves it aside as a file whose name starts with layouts.json.broken, starts with an empty set of layouts, and tells you in the menu.

Troubleshooting

Windows don't move

Check these in order:

  1. Accessibility access. If the menu shows Grant Accessibility Access… instead of your apps, Remember Windows can't move windows. Choose it and follow the steps in the Welcome window.
  2. The display setup. The first line of the menu names the setup in use. Layouts are kept per display setup, so an app remembered with a monitor attached has no layout on the laptop alone. Remember the app again with the current displays.
  3. Auto-Restore Here. A pause symbol next to the app's name means automatic restore is off for it on this display setup. Choose Auto-Restore Here in the app's submenu to turn it back on.
  4. Automatic restore settings. Make sure "Restore an app's windows when it launches" and "Restore all windows when displays change" are on in Settings › General.
  5. Slow apps. If some windows of an app appear late and aren't placed, raise "Keep placing new windows" in Settings › General › Timing.

macOS asks for Accessibility access again

After you update Remember Windows, macOS may ask for Accessibility access again, or the switch may be on but windows still don't move. To fix it:

  1. Open System Settings › Privacy & Security › Accessibility.
  2. Select Remember Windows in the list and click the Remove button (−).
  3. Choose Grant Accessibility Access… from the Remember Windows menu, click Open System Settings… in the Welcome window, and turn on Remember Windows in the list again.

Remember Windows notices the change within a couple of seconds; you don't need to restart it.

A window goes to the wrong place

  • Windows are matched by title first, then by size. If a window's title changes (a document name, a chart symbol) and several windows are the same size, it may swap places with another. Give it a title pattern in Settings › Layouts. See Layouts and Title Patterns.
  • If you moved windows on purpose, choose Update Saved Layout in the app's submenu to save their new places.
  • If an app was remembered while a window was in full screen, that window wasn't saved. Take it out of full screen and choose Remember again.

Some apps move slowly

Many apps built with web technology (Electron apps, for example) animate every move and resize. Remember Windows waits for each animation to finish and checks the result before it moves on, so restoring these apps takes a moment longer. This is expected.

A window stays on the wrong Desktop

  • If the menu says a Desktop doesn't exist, the display has fewer Desktops than when you remembered. Add Desktops in Mission Control, then restore again.
  • If the menu says a window couldn't be moved, drag it to the right Desktop in Mission Control.
  • Windows are moved between Desktops only on the display they were saved on. See Desktops and Displays.

An app shows a warning triangle

The app didn't answer Accessibility requests within 10 seconds of launching, so Remember Windows couldn't place its windows. Some apps, such as Steam and apps that run under X11, don't support Accessibility at all, so their windows can't be moved. If the app usually works, choose Restore Now once it has finished opening. The triangle goes away the next time the app launches and responds.

Stage Manager and full screen

Stage Manager is not supported; windows inside stages may not restore correctly. Full-screen windows are skipped. See Desktops and Displays.

Updates

Choose Check for Updates… from the menu to make sure you have the latest version. Fixes for problems like these arrive in updates.

Still stuck

Open the Console app, click Start, choose Action › Include Info Messages, type me.kirill.RememberWindows in the search field, then restore the app again to see what Remember Windows does. More help is on the web at remember-windows.pages.dev/help.

Privacy

Remember Windows has no accounts, no analytics and no crash reporting. Your layouts stay on your Mac unless you turn on sync.

What leaves your Mac

Only two things:

  • The check for updates. Remember Windows asks remember-windows.pages.dev whether a newer version exists, and downloads it if you choose to install it. The check sends no personal information and no profile of your Mac. Like any web request, it includes the app's version and your network address.
  • Sync, if you turn it on. Your layouts and groups are written to a folder in your own iCloud Drive (or a folder you choose), and Apple syncs that folder to your other Macs through your iCloud account. Remember Windows doesn't run a server and never sees them.

Nothing else is sent anywhere.

What is stored on your Mac

  • Your layouts, in ~/Library/Application Support/RememberWindows/layouts.json: for each remembered app, its name and bundle identifier, and for each window its title, size, position, display, Desktop number and whether it was minimized. Display setups are stored with each display's name, size, position and hardware identifier.
  • Your groups: their names, member apps, and the web addresses and file paths they open.
  • Your settings for automatic restore and timing, saved in layouts.json too.
  • In the app's standard macOS preferences: your hotkeys, your sync choice and folder, a few window and alert preferences, and Sparkle's update bookkeeping (when it last checked for updates, and your choice about automatic checks).
  • A random identifier for this Mac, created at first launch and kept in the same preferences. It isn't derived from your Mac's hardware. Sync uses it to tell which Mac saved what: layouts.json records it with each layout and group, and when sync is on it names this Mac's file in the sync folder.

Window titles often contain document or page names. Remember Windows keeps them so it can tell windows apart. They're stored only in layouts.json, in the import backups and broken-file copies in the same folder, in exports you save, and in the sync folder when sync is on.

When sync is on, each Mac's file in the sync folder also holds that Mac's name (as set in System Settings › General › About), so your other Macs can show where a layout came from.

What Accessibility access is used for

Remember Windows uses Accessibility access only to list other apps' windows with their titles, sizes and positions, and to move, resize, minimize and unminimize them. It doesn't read what's inside windows, and it doesn't record your keystrokes. Hotkeys are registered with macOS, which tells Remember Windows only when one of your hotkeys is pressed.

You can turn off its access at any time in System Settings › Privacy & Security › Accessibility.

The full privacy policy is at remember-windows.pages.dev/privacy.

Uninstalling

To remove Remember Windows and everything it stores:

  1. If sync is on and you want your other Macs to stop receiving this Mac's layouts, open Settings › General and click Remove My File from the Sync Folder.
  2. If "Start Remember Windows at login" is on, turn it off in Settings › General.
  3. Choose Quit Remember Windows from the menu.
  4. Drag Remember Windows from your Applications folder to the Trash.
  5. In the Finder, choose Go › Go to Folder, enter ~/Library/Application Support, and move the RememberWindows folder to the Trash. It holds your layouts, settings and their backups.
  6. Open System Settings › Privacy & Security › Accessibility, select Remember Windows, and click the Remove button (−).
  7. Open System Settings › General › Login Items & Extensions and make sure Remember Windows isn't listed under Open at Login. If it is, select it and click the Remove button (−).

Your hotkeys and a few other preferences are in ~/Library/Preferences/me.kirill.RememberWindows.plist. You can move that file to the Trash too.

If you used sync and no longer need it on any Mac, you can also delete the RememberWindows folder in iCloud Drive.

If you only want to start over, you don't need to uninstall: delete display setups in Settings › Layouts, or quit the app and move the RememberWindows folder in Application Support to the Trash.

If sync is on, deleting setups also deletes them on your other Macs. Turning sync off first only delays this: the deletions are shared when you turn sync on again. To keep them on your other Macs, quit the app and move the folder instead. After you move the folder, if sync is on, layouts from your other Macs come back the next time Remember Windows syncs.