Docs
How the feed, the reader, and the shortcuts work.
Adding accounts
Open Accounts and choose Add Account. Pick Mastodon, Bluesky, Tumblr, or Micro.blog, then sign in.
For Mastodon, enter the instance hostname (the part after the @, such as mastodon.social). Other Mastodon-compatible servers, such as GoToSocial, work the same way. For Bluesky, enter the handle, such as example.bsky.social.
Tumblr and Micro.blog sign in on their own web page. Micro.blog can also use an app token: create one on Micro.blog under Account > Edit Apps, then paste it under Use an app token instead.
The app talks to each service directly. I never see the password.
Home is on for a new account (on Tumblr, that is the Dashboard). Everything else starts off, and you turn on only the timelines you want in the feed:
- Mastodon: Local, Federated, and any lists on that account.
- Bluesky: your lists, plus feeds.
- Micro.blog: Discover.
- Tumblr: the Dashboard is the only timeline.
Uncheck an account to leave it signed in but out of the feed. Delete removes it. If a sign-in expires, the feed shows a prompt and Accounts offers Sign in again.
Filters
The Filters button on the feed (and the Filters section in Settings on Mac) sets a minimum before a link appears:
- Min likes
- Min reposts
- Min appearances — how many posts in your accounts shared that same link
Zero means no minimum. A link has to clear every minimum you set.
The All / Unread control at the top of the list hides links you have already opened. Search (⌘+F on a hardware keyboard) matches the visible list.
Settings
Reading. Open links in default browser sends a tap on a link card to Safari or your Mac browser instead of the built-in reader. Background is Sepia or White. Type is Sans or Serif. Those last two apply to Reader mode.
Refresh. On Mac, auto-refresh can be every 5 minutes, every 15 minutes, every hour, or manual only. Keep scroll position when refreshing leaves you where you were instead of jumping to the newest link. You can also pull to refresh, or use the refresh button.
Read Later export. Choose one service — linkding, Pinboard, Instapaper, Readwise Reader, or Marked Share — and new bookmarks are sent there. Marked Share connects in the browser. The others take the credentials that service asks for.
Subscription. Manage or restore the App Store subscription from here.
The list
Each row is one link, even when several posts shared it. The counts under the card are likes, reposts, and how many times it was seen.
Tap the link card to open it. By default that is the built-in reader. With Open links in default browser on, it opens in the browser instead. Opening a link marks it read.
Tap the person’s picture or name at the top of the row, or the posts count at the bottom, to expand every post that shared the link. The collapsed row can bookmark, share the URL, or jump to the original post. The expanded posts add Like and Repost for that specific post, plus a share of the post text and the link. Like and repost use the account that fetched the post. A liked post stays marked.
Long post text has a more / less control. If the post is in another language, a translate button can show an on-device translation.
Keyboard shortcuts
These work on Mac, and on iPad with a hardware keyboard. Single-letter keys do nothing while a text field is focused. Command shortcuts still work.
Anywhere
| Key | Action |
|---|---|
| ⌘+1 | Feed |
| ⌘+2 | Read Later |
| ⌘+3 | Accounts |
| ⌘+4 | Settings |
| ⌘+, | Settings |
| ⌃+⌘+F | Toggle full screen (Mac only) |
List (Feed or Read Later)
| Key | Action |
|---|---|
| ↑ / ↓ | Previous / next link |
| J / K | Next / previous link |
| Return, →, O, or L | Open the selected link |
| 1–9 | Open that numbered link when a post has several |
| B | Open the selected link in the default browser |
| C | Copy the link |
| U | Mark read or unread |
| ⌘+D | Save to Read Later, or remove it |
| G G | Jump to the top of the list. Press the second G within a second |
| ⇧+G | Jump to the bottom of the list |
| ⌘+↑ / ⌘+↓ | Jump to the top / bottom of the list |
| ⌘+F | Search the list |
| ↑ / ↓ while searching | Move through the list |
| Esc | Close search |
| ⌘+R | Refresh the feed |
Reading a page
These act on the page in front. If a link frame is open, they act on the frame.
| Key | Action |
|---|---|
| ↑ / ↓ | Scroll a line |
| J / K | Scroll a line |
| Space / ⇧+Space | Page down / page up |
| G G | Jump to the top of the page |
| ⇧+G | Jump to the bottom of the page |
| ⌘+↑ / ⌘+↓ | Jump to the top / bottom of the page |
| ← or H | Leave the page and return to the list |
| ⌘+[ / ⌘+] | Back / forward in the page. Back closes the page when there is no history |
| Esc | Close the link frame |
| B | Open the current page in the default browser |
| C | Copy the page URL |
| U | Mark the page read or unread |
| ⌘+D | Save to Read Later, or remove it |
| ⌘+R | Reload the page |
| ⇧+⌘+R | Show or hide Reader mode |
| ⇧+⌘+A | Ask about the article |
| ⇧+⌘++ / ⇧+⌘+- / ⌘+0 | Zoom in, zoom out, actual size |
| F | Show link hints |
Link hints
F marks the visible links on the page you are reading. Type a hint’s letters to open that link. F again, or Esc, clears the hints. Delete removes the last letter you typed. H still returns to the list.
On iPad in landscape, the list and the reader sit side by side. On iPhone, opening a link pushes the reader onto its own screen.
Reader mode
With a page open, Show Reader extracts the article and drops the rest of the site. Hide Reader puts the original page back. The button appears when the page looks like an article. If there is nothing to extract, the reader says so and stays on the page.
Sepia or white, and sans or serif, come from Settings → Reading. Zoom, back, forward, reload, and share stay available in the reader bar.
Ask about a document
Ask About Article (the sparkles button, or ⇧+⌘+A) is there when the device has Apple Intelligence and the open page is an article, or Reader mode is already on.
It opens a sheet with the article title and a short summary as soon as it can write one. A field at the bottom takes the next question. Return sends it. Later questions can refer to the article and to earlier answers in that sheet. Closing the sheet forgets the conversation. Opening Ask again starts a new summary. The page itself does not change, and Reader mode is not turned on for you.
The model only sees the article text, clipped so it fits on device. There is no cloud model and no API key. If the answer is not in the article, it should say so. If Apple Intelligence is off, the button is hidden.
Share, repost, and like
Share on a collapsed row sends the link. Share on an expanded post sends that post’s text and the link. The reader bar shares whatever page is open.
Repost and Like are on each expanded post, not on the link as a whole. Repost boosts, reposts, or reblogs that post from the account that fetched it. A confirmation appears in the feed. If it fails, the error is shown there instead of failing quietly. Like toggles, and a post you have liked stays marked.
The bookmark marks the link for Read Later. If a Read Later service is connected, a new bookmark is also sent there.