Lightkone docs Open Lightkone

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:

Tap a highlight to edit its note or delete it. Highlights are saved in lightkone/annotations/<paper id>.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:

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).

Export to Obsidian

Export to Obsidian (side bar, Write) writes one Markdown note per paper, named @<citation key>.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):

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.

Markdown · All docs as one text file · This page on GitHub