Settings
Open settings with ⌘, (Litr → Settings…). Settings show in place of the page; press Esc or ⌘, again to close them. Changes apply immediately and are saved.
| Setting | Options | Default | What it does |
|---|---|---|---|
| Search engine | DuckDuckGo, Google, Kagi, Bing | DuckDuckGo | Used when what you type in the address bar is not an address. |
| Default browser | Make Litr the Default Browser, Link Rules… | Not default | Makes Litr open links from other apps (macOS asks first), and sets link rules. Not shown in web apps. |
| Passwords | Passwords… | Opens the list of saved passwords: show, copy, delete, import from a CSV file. Not shown in web apps. | |
| Import from another browser | Import… | Brings over bookmarks, history, passwords and Arc's spaces from other browsers; see Bookmarks and importing. Not shown in web apps. | |
| Block ads | On, Off | On | Blocks ads and trackers on every site, YouTube included. Open pages reload when you change it. See Ad blocking. |
| Glass edge | On, Off | On | Translucent, blurred chrome tinted by the page's colour. Off gives solid chrome. See Appearance. |
| Restore tabs on launch | On, Off | On | Reopens your tabs (unloaded) when Litr starts. Pinned tabs are always restored. |
| Memory limit | Off, 500 MB, 1 GB, 1.5 GB, 2 GB, 3 GB | 1 GB | When Litr and its pages together use more, the heaviest background tab is unloaded. Tabs playing sound or in a call are never unloaded. See Tabs. |
| Agents (MCP) | On, Off, Copy Setup for Claude Code | Off | Lets coding agents look at your developer tabs (page, console, network, errors, screenshot), read-only. See Agents. |
| Pull Requests in the sidebar | On, Off | On | Your open pull requests and reviews asked of you, with how their checks went. Needs the GitHub CLI, signed in with gh auth login. See Tabs. |
| Show memory use | On, Off | On | Each loaded tab's memory in the sidebar, and a meter for the total. |
| Tabs kept in memory | 1, 2, 3, 4, 6 | 3 | How many tabs stay loaded at once, the active one included. Others are unloaded and reopen where you left off. See Tabs. |
| Unload background tabs after | 1 min, 5 min, 15 min, 1 hour, Never | 5 min | Unloads tabs you haven't used for this long. Tabs are also unloaded right away when macOS runs low on memory. |
| Picture in picture when you leave a video | On, Off | On | A video that plays goes into a small floating window when you switch tabs, and back into the page when you return. See Media. |
| Save energy on battery | On, Off | On | On battery or in Low Power Mode: background tabs are unloaded after 2 minutes, at most 2 stay loaded, and a background tab that keeps using a lot of energy is unloaded. See Tabs. |
| Save copies of articles | On, Off, Delete Saved Copies | On | Keeps a reader copy of articles you bookmark or highlight, to read when the page can't be opened. See Reader mode. Not shown in web apps. |
| History | Clear History | Deletes all history. | |
| Check for updates automatically | On, Off | On | Asks elyracode.com once a day whether a newer Litr exists. Nothing is installed until you choose Install. See Updates. |
| Web apps | Open, Move to Trash | Lists the web apps you created (not shown inside a web app). See Web apps. | |
| About Litr | Shows the version, website and developer. |
Each web app has its own settings, separate from Litr's.
For the lowest memory use
- Set Memory limit to 500 MB.
- Set Tabs kept in memory to 1 or 2.
- Set Unload background tabs after to 1 min.
- Keep Block ads on. Ads and trackers are among the heaviest parts of many pages.