Support
Something not working? The answers below cover almost everything. If not, email contact+broadsheet@victorshammas.com. I read every message.
- Adding links
- Making the book
- Sign-ins and subscriptions
- Broadsheet for Chrome
- Packets
- When an article doesn't come through
- Keyboard shortcuts
- Contact
Adding links
How do I add links?
Any of these:
- Paste Links (⌘V): every link on the clipboard goes straight in. Copy a whole note, an email or a web page; Broadsheet finds the links in it.
- Drag links, text or files onto the window or its Dock icon.
- Type Links… (⌘L): a box to type or paste addresses into, and edit them before they're added.
- Import Links from a File… (⇧⌘I): a bookmarks file exported from Safari, Chrome or Firefox (File › Export Bookmarks), a Pocket or Instapaper export, or a CSV, JSON or
.weblocfile. A file with many links opens a list to pick from, the newest ticked. - Articles from a Feed… (⇧⌘F): type a site's address and pick recent articles from its feed. Save feeds you come back to.
The same link twice is added once, and so are two links that turn out to be the same page.
Can I paste the link previews from Apple Notes?
Yes. Copy the note (or part of it) and paste it into Broadsheet: each link preview becomes a link, titled with its headline. The preview pictures themselves aren't added.
Can I change the order, or take an article out?
Drag articles up and down the list, or sort them with View › Sort Articles (by date added, date published, site or length). Select one and press ⌫ to take it out. Right-click an article to open it in your browser, copy its link or read it again.
Making the book
Which format should I choose?
- PDF to print or to read on a tablet: typeset pages with running heads and page numbers. Web links are listed as numbered notes at the end of each article, since paper can't be clicked.
- EPUB for Apple Books, Kobo, Calibre or Send to Kindle. E-readers set their own type and page size; footnotes appear as pop-ups.
- HTML for one self-contained web page, pictures included, that opens in any browser, even offline.
Choose the format at the bottom of the window, then click Make (or File › Make PDF…, ⌘E). The PDF opens in Preview and the EPUB in Books when it's done.
Can I change how it looks?
The options button beside the format holds the title, a subtitle and the layout. Broadsheet › Settings… (⌘,) has the rest:
- Layout: two columns, like a literary review, or one column, like a book or an e-reader page.
- Paper: A4, US Letter or A5.
- Typeface: Charter, New York, Iowan Old Style, Palatino, Baskerville or Georgia, and the text size.
- Pictures: full width, small or none.
- Notes for links, justified text, and whether each article starts on a new page.
The preview beside the list (View › Show Preview, ⇧⌘P) changes as you change them.
What's on the first page?
The contents: the date, the number of articles and the reading time, then each article's title and site, the first with its summary. If you give the book a title, it appears above them. Without one, the book is named after the day and time you started it.
Sign-ins and subscriptions
An article is behind a sign-in or a subscription I have. How do I get it in?
Two ways, with your own account:
- Sign In or Verify… on the article's row opens the page in Broadsheet. Sign in as you would in a browser (or finish the site's "are you human?" check), then click Use This Page. Broadsheet remembers the sign-in, and reads that site's other articles again with it.
- Broadsheet for Chrome reads the article in Chrome, where you're probably signed in already (see below).
Broadsheet never gets around a paywall: it can only read what your own sign-in lets you read.
Why do some articles say "only the part shown before a subscription"?
The site sent its preview for people who aren't signed in. Use Sign In or Verify, or Broadsheet for Chrome, to read the whole article with your own subscription, or take it out of the list.
Broadsheet for Chrome
What does the Chrome extension do?
It sends pages to Broadsheet as Chrome shows them, with your Chrome sign-ins: click its button to add the page you're reading, or right-click a link to add it. It also reads the articles Broadsheet couldn't get by itself, in background tabs that close on their own. It's free, it's optional, and it talks only to Broadsheet on your Mac.
How do I set it up?
- Install Broadsheet for Chrome from the Chrome Web Store.
- In Broadsheet, open Settings › Chrome and click Copy beside the connection code.
- Click the Broadsheet button in Chrome's toolbar, paste the code and click Connect. This is done once.
- Optional: click Allow on All Sites, so articles Broadsheet couldn't read are read in Chrome without asking site by site.
The code lets the app and the extension recognise each other, so your pages go to Broadsheet and nothing else. New Code in Settings disconnects Chrome until the new one is pasted there.
Chrome says it can't connect.
- Broadsheet has to be open: the extension talks to the app, not to a server.
- If you made a new code, paste the new one into the extension.
- Settings › Chrome shows why the last request from Chrome was turned away, if one was.
Packets
What is a packet?
The links you're putting together, with the articles as read and the book's settings. Broadsheet keeps the one you're working on between launches. Once you've made a book from it and changed nothing since, the next launch starts a fresh packet, and the finished one waits in File › Open Recent.
Can I keep a packet, or share it?
File › Save Packet (⌘S) saves it as a .broadsheet file, with everything already read, so it can be bound again later without fetching anything. Double-click the file, or use File › Open Packet… (⌘O), to open it.
When an article doesn't come through
An article is marked in red or orange. What does it mean?
- Red, "Couldn't be read": the reason is beside it. If a sign-in might help, the row offers Sign In or Verify. If the site couldn't be reached, it offers Read Again. A missing page, or a link to a PDF or a download, offers Open in Browser.
- Orange: it was read, but it may not be what you wanted, for example only a few words, a video or podcast page whose description is all there is, a subscriber's preview, or a page that is mostly links. It still goes in the book unless you take it out.
Some sites say "check that a person is asking".
Some sites ask every visitor to prove they're a person. Broadsheet gets past the automatic checks the way a browser does; when a site wants you to solve a puzzle, click Sign In or Verify and solve it once. The site's other articles are then read again.
Can Broadsheet include PDF files?
Not yet. Links to PDF documents are listed as not being web pages.
Keyboard shortcuts
| Shortcut | Action |
|---|---|
| ⌘N | New packet |
| ⌘V | Paste links |
| ⌘L | Type links |
| ⇧⌘I | Import links from a file |
| ⇧⌘F | Articles from a feed |
| ⌘E / ⌥⌘E / ⇧⌘E | Make PDF / EPUB / HTML |
| ⌘O | Open a packet |
| ⌘S / ⇧⌘S | Save the packet / Save As |
| ⇧⌘P | Show or hide the preview |
| ⌘, | Settings |
| ⌫ | Take the selected articles out |
Contact
Email contact+broadsheet@victorshammas.com. It helps to include your macOS version and Broadsheet version (Broadsheet › About Broadsheet). If an article comes out wrong, include its link.
Refunds for App Store purchases are handled by Apple at reportaproblem.apple.com.