# Reading and highlighting ## The reader Open a paper and press **Read**. The PDF opens full screen, on a phone too. Pinch or use **Zoom in / Zoom out**, and the moon button turns the pages dark for reading at night. **Esc** or the close button returns to the list, where Lightkone remembers the paper in **Recently read**. No PDF yet? **Get free PDF** looks for an open copy (arXiv, or Unpaywall with a contact email set under **Settings → PDFs**). **Attach PDF** adds a file of your own, and **Replace PDF** swaps it. ## Highlights and notes Select text on a page, then tap: - **Highlight** to mark it; - **Highlight + note** to mark it and write a note; - **Explain** (with a Claude key) to have Claude explain the passage, or an equation, in the context of the whole paper. It sees the PDF and a picture of what you selected, takes follow-up questions, and can keep its answer as the highlight's note. - **Ask** (with a Claude key) to put the passage in the chat beside the page, and ask your own question about it. Tap a highlight to edit its note or delete it. Highlights are saved in `lightkone/annotations/.json` next to the library, as plain JSON, and never inside the PDF, so the file stays as published. ## The side panel: notes and chat The panel button at the top right of the reader opens a side panel beside the pages, with two tabs: - **Notes** lists your highlights and their notes. Tap one to go to it; **Export as Markdown** or **Copy** takes them all. - **Chat** is one running conversation with Claude about the paper you are reading. It picks up where you left it, on any device: Claude sees the whole conversation so far with each question. **Summarize** (in the paper's details) and **Explain** on a passage add to the same running chat instead of starting new ones, and **Ask** on a selected passage asks in it. **+** starts a separate chat when you want a clean start, which then becomes the running one; the list at the top switches between the paper's chats, and the pencil names the chat shown (or the new one, before you ask). When a chat grows long (20 messages, or about 15,000 tokens of text sent again with each question), a note above the question box offers a new chat; **Keep going** hides it for that chat. Claude reads the whole PDF with each question. Every chat is kept with your other chats, under the paper, in `lightkone/history/` (in a shared or read-only library, in this browser only). The chat button opens it in Chats, to rename, pin or bring in other papers. ### Sources highlighted on the paper Claude backs each answer with quotes from the PDF: the passages that answer your question and those that help you follow the answer, such as a definition, an assumption, a step or an equation, several when several parts of the paper matter. Each quoted passage is highlighted in blue right on the page, with a numbered marker in the margin beside it, and the answer shows the same numbers with the page, like **2 · p. 3**. Tap a number in the answer, or a marker on the page, to go to that passage. The **Sources** bar over the page steps through them: **‹** and **›** go to the previous and next passage, and **Back** returns to where you were reading before the first jump. **×** hides the highlights (tapping a number in the answer shows them again). A passage whose words can't be found on the page (rare, for some scanned or unusual PDFs) is counted as "not marked", and its number opens its page instead. The highlights are those of the latest answer in the chat shown, and come back when you reopen the chat; they are not saved as your own highlights. A saved answer keeps its quotes, so it shows the same highlights without asking Claude again. Numbers in Ask and in Chats that point to a page of a paper open the paper there with the quoted passage highlighted the same way. On a computer, the three panel buttons next to the close button snap the panel to the right, the left or below the page, and the fourth floats it over the page as a window: drag its tab bar to move it and its bottom-right corner to resize it. Drag its inner edge to make it wider or narrower (taller or shorter below the page), or focus the edge and use the arrow keys; Lightkone remembers the place and the size for each place, and a double-click on the edge goes back to the default size. On a phone the panel is a sheet over the lower half of the screen, so the page stays in view above it; the arrow makes it taller, and it moves up above the keyboard while you type. Lightkone remembers which tab you used last. The paper's own **Notes** box (in its details) is for notes on the whole paper. It is searched along with everything else. ## Summaries and questions With a Claude key, a paper's details offer **Summarize** and **Chat about it**, which opens a chat about the paper in Chats. **Ctrl J** (⌘J) does the same while you read. When the PDF is stored, Claude reads the whole paper, not only the abstract. To ask across your whole library, use **Ask** at the top (see [Finding papers](FINDING.md#chats-with-claude)). ## Export to Obsidian **Export to Obsidian** (side bar, *Write*) writes one Markdown note per paper, named `@.md`, with the paper's details, your highlights (each linking back to its page in Lightkone) and your notes. Choose your vault's folder to write the notes straight into it (Chrome and Edge), or download a .zip. Run it again later and only the part above the marker line is rewritten: what you wrote below it in Obsidian is kept. ## Reading offline Lightkone keeps the last 25 PDFs you opened on the device. To choose more, for a flight or a trip, open **Offline papers** (in the side bar under Organize, or Ctrl/⌘K): - Pick a folder, tag, **Starred** or a search first. The panel then offers to keep every paper in that view, and downloads their PDFs, highlights and notes. - On a single paper, press **Keep offline** in its details. - Kept papers show an **Offline** label in the list. They stay until you remove them, one by one or with **Remove all**. - They take space on the device, within a limit you set (500 MB to 10 GB, 2 GB at first). Keeping stops at the limit and says so. For the app itself to open with no network, install it (**Install app** or **Add to Home Screen**) and open it once before you go. With no network you can read, highlight and take notes. Highlights are kept on the device and saved to your storage when you are back online, even if the app was closed meanwhile. Other changes (notes, stars, folders) are saved when you are back online as long as Lightkone stays open; the top bar says *Offline, saves later* until then. This applies to a bucket or a GitHub repository. With **This browser only**, everything is on the device already. ## Saved web pages A web page added to the library (a blog post, a report, documentation) is saved twice: its raw HTML exactly as it was fetched, and its main text as Markdown, found with Mozilla's Readability, the engine behind Firefox's reader view. **Read** opens the Markdown as a quiet column of text, with headings, figures, links, tables and math. **Saved page** shows the HTML as it was saved, in a sandbox where none of the page's scripts run. The moon gives a dark page, and the toolbar copies or downloads the Markdown, ready for Obsidian. The Markdown is also the page's text for search, Ask and the MCP server, as a PDF's text is. Pages that build their content with scripts after they load may save little text; their raw HTML is kept all the same. Figures stay on the site they came from, so they show only with a network. Some sites turn away anything that isn't a person's browser, often with a "checking your browser" page. Lightkone then reads the page through Jina Reader (r.jina.ai), which opens it in a real browser; only the page's address goes there, and **Settings → DOI, arXiv and BibTeX** switches it off. When that fails too, the page is still added, as a link with a title made from its address, and Add papers says why no copy was kept. To keep a copy, open the page in your browser and use the **+ Lightkone** bookmark (set it up once from Add papers; on a phone, tap the address bar, type Lightkone and tap the bookmark): the page as you see it goes to Lightkone and is saved. Or save the page in the browser (in Chrome on a phone, menu, then Download, an .mhtml file; on a computer, Save page as) and use **Add files** in Add papers, drop the file on Lightkone, or share it to the installed app. The saved page gets the same Markdown copy and reader as a fetched one, and a page already in the library as a link gets the copy. ## Reading at night With the Dullaby plugin set up (**Settings → Dullaby night reading**), **Read at night** opens a paper in Dullaby's calm, dim reading mode. The link that opens Dullaby also carries your library, as identifiers only: arXiv ids (or DOIs), newest first, marked when starred or never opened. No titles, authors, notes or PDFs. It travels in the part of the address after `#`, which browsers never send to a server, and Dullaby keeps it on that device. Dullaby then looks for new papers near yours and skips the ones you already have. **Read at night in Dullaby** under Discover opens it with the library and no paper, to bring it up to date. Papers you **Keep** in Dullaby come back here: its list of kept papers has **Add to Lightkone**, which opens this app's Add panel with the paper.