Lines
All docs

Library

Books, comics, movies, shows, anime, videos, music, podcasts, articles and papers, kept in Lines as notes. Each is an ordinary Markdown note with a type (book, movie…), so it's searched, mentioned, synced and exported like any other, and listed in the sidebar's Library, a row for each kind with something in it, its notes with their covers and where you've got to.

Paste a link into a new note (after the # it starts with, or on its own), and Lines fills the note in with what the link is: its title, cover, details and a few sentences of what it's about.

---
type: movie
director: Denis Villeneuve
year: 2023
runtime: 166 min
genre: Science fiction, Adventure
link: https://www.imdb.com/title/tt15239678/
status: to watch
---
# Dune: Part Two

![Dune: Part Two|240](../attachments/3f9c….jpg)

Dune: Part Two is a 2024 American epic space opera film directed by Denis Villeneuve…
  • It's looked up when the note becomes just a link, or its link changes: at once when it's pasted or dropped in, or once it's stayed that link for a second while you type it, so a link half typed isn't. The link can be bare, in <…>, or a Markdown link ([text](…)), with nothing else in the note; or, in a note made just now, in what it was made with and nothing else: after its # , or under the properties a note started on a shelf has.
  • Notes that are already just a link are never looked up as they open or sync, nor as you write on around the same link (a line under it, say). Only Markdown notes are looked up, and never a locked note, nor one locked while it's looked up.
  • Meanwhile the note says "Looking up…" after the link, quietly, and screen readers hear it. Offline, or when the site couldn't be reached, it says so for a moment and stays a link.
  • Filled in, it's one change: undo (⌘Z) puts the link back. If you change the note while it's looked up, what was found is dropped; nothing you write is ever written over. If you've moved to another note by then, the note is filled in all the same; ⌘Z stays the note's you're in, and the link isn't put back.
  • The note leaves the Inbox: it's filed, on its shelf in the Library.
  • A site's page that isn't one of those but has a feed (a blog's front page, https://vercel.com/blog; a podcast's site, https://adspthepodcast.com) becomes a subscription to that feed, in the apps, as when subscribing to a site's link (Feeds, below). A blog's post stays an article: what a page says it is comes first.
  • A link Lines can't say what it is (a page that doesn't say it's a book, a movie, an article…, and has no feed) stays as it is. Nothing is guessed.
  • The cover is downloaded and kept with the note as an attachment, at most 1,200 pixels across, so it shows offline and syncs; the note shows it at a width that leaves room for the rest (240 pixels, a video's 400), which you can change as any picture's. It's kept only once the note is written, so a lookup dropped leaves nothing behind; and if it can't be kept then, it's taken out of the note again, so a note never shows a picture that can't be shown. Where it can't be downloaded (on the web, from a site that doesn't let pages download its pictures), the note has none rather than one shown from the site, and a picture a page gives that isn't on the web at large (an address on your own network, or not over https) isn't asked for. Only pictures are kept, told by their bytes rather than what they're called (as a feed's icon is, the same check): a JPEG, a PNG (one that's see-through in places is kept see-through), a GIF, a WebP, a BMP or an AVIF, read before it's drawn and refused if it says it's more than 8,192 pixels across; never a drawing (an SVG), which is a logo or a diagram rather than a cover. A film's or a show's is the poster its Wikipedia page shows, or else the photo Wikidata has of it; a page that shows only the series' logo (some do) leaves it without one. On its shelf, a cover that can't be shown is the kind's icon. In the apps, nothing the web gives (a feed a page names, a picture, a transcript, a redirect) is followed onto this computer or its network: not by its address, nor by a name that stands for one of its addresses (127.0.0.1.nip.io). Only an address you give yourself is asked wherever it is (a feed you run yourself, pasted into Subscribe or a note): what an OPML file lists on your network is left for you to subscribe to by its link, and the import says how many.
  • What a source says is written as just that text: a # or @ in a title, a value or a description is escaped (\#), so it makes no tag or mention, nor a heading, list, code block or picture; a value YAML would read as something else (Star Wars: Episode IV, "Heroes", *NSYNC) is quoted. Each request gives up after 15 seconds (arXiv's 20).
  • Settings → Library → Look up links turns it off; then nothing is contacted.

One note of each thing

However something's added (a link in a new note, Add to Library, a link's Add to Library, subscribing to its feed, saving a post), the Library has one note of it. Added again, what's there is opened instead, the keyboard at the end of its title, and it says Already in your Library, faintly at its end and to screen readers. Some ways only know once what was added is looked up (a link pasted into a new note, what Add to Library's search found, which is known by the ids its page gives), so a note was made for it meanwhile:

  • Nothing in it but what Lines put there: it goes to the Trash (restore it from there), and if it's the note you're in, the one there is opens in its place. If you've gone on to another note, you stay where you are.
  • Something typed into it meanwhile: it stays, saying Already in your Library after what you wrote, with Open, which opens the one there is, and Merge, which moves what you wrote (every line Lines didn't write) to the end of the one there is, opens it, and puts this one in the Trash. Nothing you typed is lost, and the copy is never kept without saying so.
  • A note that wasn't new (one of long ago you've made just the link by hand, a pinned one): it's left as it is, saying Already in your Library after the link, with Open. That isn't adding it again, so it isn't counted.

Imports (bookmarks, Readwise) leave out what's there, and say how many.

  • The same thing is the same page however its link is written: https://www.imdb.com/title/tt8962124/?ref_=nv and imdb.com/title/tt8962124 (its scheme, www., a closing /, and what the link says only of where it was shared from, utm_…, si, ref, are left out; what's after # isn't, as some sites show different things by it, but for a link to words on the page, #:~:text=…). Or the same id where a source knows one: an IMDb, Wikidata or YouTube id, an Open Library edition or an ISBN (an ISBN-10 is the same book as its ISBN-13; one whose check digit doesn't add up, a placeholder like 0000000000, is no book's), a MusicBrainz recording, an Apple Podcasts podcast or episode, an arXiv paper (any version), an AniList or MyAnimeList series (AniList knows both, so a manga added from either is one note). What Wikidata finds is known by the other sites' ids it has too, and by its Wikipedia pages in English and in Lines' language, so a film added from its Wikipedia page is the one added from IMDb. And a book's isbn, a feed's feed, an episode's audio: an episode is never found by its link, which a podcast's episodes often share (its site's), only by its sound. A subscription is found only by its feed, never by its link (its site's home page): a bookmark of the site, or the feed's address, isn't one, and a subscription doesn't make a page of its site, added or imported, "already there". Subscribing again opens the subscription there is, at its own address.
  • Counted. Each time something's added again its note counts it, times added: 2 the first time (none while it's been added once), dated as any change is, so it syncs as one rather than losing to a change made elsewhere. Settings → Library → Count adding again turns that off: adding again then only opens it.
  • Added again, a cover Lines kept that can't be shown (a logo kept before, or a file that isn't a picture) is mended from what's found again. One that hasn't arrived on this device yet is left to sync, and a cover is never taken out because what's found has none or can't be downloaded.

A page nothing can say more of

Added on purpose (a link pasted into Add to Library, or a link's menu → Add to Library), a page none of the sources can say more of (a product's home page, a tool, a post on a site that doesn't describe itself) isn't left out: it's kept as a resource, to read, on the Resources shelf, as bookmarks are. Its title is the page's own (og:title, else its <title>, else its site's name), with its site, the day it was added, its picture where it names one (og:image), and what it says of itself as its text, all as text, as anything from elsewhere is. Right-click it on its shelf → Look Up Details looks it up again later. A note that's just such a link stays as it is: only adding it on purpose keeps the page, nothing is guessed from a link typed into a note.

  • Its link is the one added, whatever the page calls itself (its canonical address) or wherever reading it ended: a site whose pages are all one app, naming its home page for every page, still has /docs/install kept as /docs/install. The other addresses only find it again, where they're of the same page (on its site, under the same first part of its path).
  • Nothing is made of a page that can't be read: offline, gone, on the web a site that doesn't let pages read it; one that sent Lines to sign in or to agree to cookies instead (Google's, Microsoft's, a consent. site, a /login, /signin or /auth page it was sent to); or one whose title says only that it isn't there ("Page not found", "404", in a few languages). It says it couldn't look the link up, and a link in a note stays a link.
  • On the web, where pages can't be asked what they are (Web Pages is the apps'), a page nothing else knows is kept as one, and Add to Library says so: "Kept as a page". The same page added in the apps may be an article or a video, as it says it is.

Add to Library

The + on the Library's heading in the sidebar opens Add to Library (with feeds on, it's in the +'s menu, beside Subscribe to a Feed): choose what to search for (Books, Comics, Movies, Shows, Anime, Music, Podcasts, Papers, as the sources on can search), and type a title, or a name with it. The catalogs answer as you type, each result with its cover, who made it and when; ↓ moves into them, and ↵ or a click adds the one chosen. Paste a link there instead to look it up as a note that's just a link is. Something the Library has a note of already, by its link, opens that note rather than making another. Blank starts one of the kind chosen to fill in by hand. What's added is filed on its shelf, not in the Inbox.

What's chosen is a new note on its shelf, opened at once with what the search said of it, then filled in from its page (its cover, and what it's about) as one change, which ⌘Z takes back.

Searching forSearched inOn the web
BooksOpen LibraryYes
ComicsAniList: manga, manhwa and manhua (light novels left out, as they're books)Yes
Movies, ShowsWikidata, with posters from WikipediaYes
AnimeAniList (none for adults only)Yes
Music (songs and albums)MusicBrainz, covers from the Cover Art ArchiveYes
PodcastsApple's iTunes SearchYes
PapersarXivNo

Only what's typed is sent to the catalog searched.

Right-click a link to a web page in any Markdown note (or put the cursor on it and press the menu key, or ⇧F10) for Open Link, Copy Link and Add to Library: Lines looks the link up, makes a library note of what it is, and puts a mention of it in the link's place, @[Dune: Part Two], as one change, which ⌘Z takes back (the library note stays, in the Library). The mention is of the note's title as it reads. It's never done unasked. If the library has a note with that link already, that's the one mentioned. If the link changed while it was looked up (typed into, or deleted), nothing is made or changed; if nothing can say what it is, the note says so after the link for a moment. Leave the note meanwhile and it goes on: the link is mentioned where it is in the note as stored (not taken back with ⌘Z, which is the note you're in's), and coming back while it's looked up shows how it's getting on. It gives up after 30 seconds.

Bookmarks

Settings → Library → Import Bookmarks… makes each bookmark in a file a browser exported a resource: a note in the Library, under Resources, that's its link and its name so far. Settings → Export and Import → Import Files… recognizes a bookmarks file too, and asks the same.

FromThe file
Chrome, Edge, Brave, Opera, Vivaldi, ArcBookmarks → Bookmark manager → ⋮ → Export bookmarks (an .html file)
FirefoxBookmarks → Manage Bookmarks → Import and Backup → Export Bookmarks to HTML…, or Backup… (a .json file)
SafariFile → Export → Bookmarks…
Pinboard, Raindrop, PocketTheir HTML export

All but Firefox's backup are Netscape's bookmark file, a page of links every browser writes a little differently. Lines reads it with the browser's own parser, in a document of its own, where nothing in it runs or loads; its icons are left out.

---
type: resource
folder: Bookmarks bar / Dev / Rust
added: 2023-11-14
link: https://doc.rust-lang.org/book/
---
# The Rust Programming Language

#rust #programming
  • Before anything's written, it says what will happen: how many bookmarks there are, how many are in the Library already (a note there has the same link: left out), repeated in the file (imported once) or not web pages (bookmarklets, the browser's own pages, Firefox's saved searches: left out). Tag with their folders (off) gives each its folders as a nested tag, #bookmarks-bar/dev/rust; either way its folders are kept, as its folder.
  • Then it imports them, a few hundred at a time, showing how far it's got (Stop stops it, keeping what's imported); five thousand take a second or two. After, it says what it did ("Imported 1,234 resources; 56 were already there"), and Undo Import there moves them all to the Trash, but any changed since. Closing Settings doesn't stop an import, and opening it again shows how it went, with Undo, until another is asked about.
  • Each is dated when it was bookmarked, created and last changed then, so Resources lists the latest bookmarked first and they don't crowd the top of your notes; added is that day. A file that has no dates (Safari's) keeps its order, dated as it's imported. A bookmark's tags (Firefox's, Pinboard's, Raindrop's, Pocket's) are its #tags, as Lines writes tags (Web Browsers is #web-browsers); what a bookmark says of itself (Firefox's and Safari's descriptions) is its text.
  • Nothing is looked up as they come in: thousands of bookmarks would ask thousands of sites. Right-click one on its shelf → Look Up Details, and it's looked up as a note that's just a link is: what its link is (a book, a video, an article…), where a source knows it, keeping its folder, added and tags. Or right-click its link in another note → Add to Library, which mentions it as it is.
  • Resources are filed, not in the Inbox. They're notes like any other, so with sync on, each is a file of its own in the synced folder or bucket: the first sync after importing thousands sends thousands of small files, which takes a while (a few minutes for 5,000 to a bucket), and every device then has them.

Kinds of things

TypeIn the LibraryProperties, in this orderStatus
bookBooksauthor, year, pages, publisher, isbnto read, reading, read
comicComicsauthor, artist, format (manga, manhwa, manhua, webtoon, comic or graphic novel), year, chapters, anilist, myanimelist (their ids there, so it's one note however it's added)to read, reading, read
movieMoviesdirector, year, runtime, genreto watch, watching, watched
showShowscreator, year, seasons, genreto watch, watching, watched
animeAnimeformat, studio, year, season, episodes, anilist, malto watch, watching, watched, on hold, dropped
videoVideoschannel (a mention of the channel's note while it's in the Library, else a link to its page on YouTube, or its name), published, duration, playlist (the playlist it was imported from, or a list of the playlists, an item each), added (the day it was added to the playlist)to watch, watching, watched
songMusicartist, album, year, durationto listen, listening, listened
albumMusicartist, year, tracksto listen, listening, listened
podcastPodcastsauthor, feed; stream, include and exclude, the streams and filters you give it
episodeEpisodespodcast (a mention of the podcast's note while it's in the Library, else its name), published, duration, audio, transcript, chaptersto listen, listening, listened
articleArticlesauthor, site, publishedto read, reading, read
paperPapersauthors, year, arxivto read, reading, read
feedFeeds (by its posts)author, feed; stream, include and exclude, the streams and filters you give it
channelChannelsfeed (its videos', on YouTube); stream, include and exclude, the streams and filters you give it
resourceResourcessite, folder, addedto read, reading, read (imported bookmarks start with none)

Each has link (where it's from) and status after its own properties, and only the properties a source found; a rating once it's rated. The keys and the status values are written in English, like type, so tables (@type.book), mentions (@[Dune].author) and the Library read them alike on every device; Lines shows the status in its own language. A note's status is set from its row's menu on its shelf (or by writing it), and it keeps its date, so the list stays as it is. A status of your own (status: abandoned) is shown as written.

A new note made while a shelf is shown starts as its kind, at its first status, as Blank in Add to Library does.

Ratings

Anything in the Library can be rated: its rating, a property like any other, which other apps read as it's written.

---
type: show
creator: Kanehito Yamada
rating: 9/10
story: 8/10
music: 10/10
status: watched
---
# Frieren: Beyond Journey's End
  • Setting it. On its shelf, its row's menu has Rate ▸, the scale's values the best first, the one set checked, and Remove Rating; with ratings of its own (below), a menu of each, Overall first. In the note, a click on a mark sets it, and a click on the one set takes it out; a click on a word (A) offers the scale's others; each is one change, which ⌘Z takes back, and the row's keeps the note's date, so the list doesn't move. Typing a key in its properties offers its kind's ratings it hasn't got (rating, story), and after one, its scale's values; or write it. Nothing writes an empty rating: into a note: a note has a rating once it's rated.
  • Where it shows. Drawn in the note's properties on its kind's scale (Linedown), small on its row on its shelf beside its status, and as marks in a @type.book table, whose header sorts by it, the best first or last. A value that doesn't fit the kind's scale shows as written, everywhere.
  • Scales. Settings → Library → Ratings chooses each kind's: Lines' own (Out of 5, in Little Touches' marks, which every kind starts on; Out of 10; Out of 100; Thumbs Up or Down; Grades, S to F), or one of yours. New Scale makes one: marks out of 2 to 10 in an icon (stars, hearts, circles, flames…), points out of up to 1,000, or words, the best first (Masterpiece, Great, Fine, Meh). Marks take halves, 3.5/5, which are drawn half filled and typed; a click or a menu gives whole ones. Points take tenths, 7.5/10; a menu offers out of more than 10 by tenths of the whole (100, 90…). A scale a kind is rated on can't be removed until the kind's on another.
  • Changing a kind's scale rewrites nothing. Ratings written on the old one show as written, and Settings says how many of its notes have a rating that doesn't fit. Change them by hand, or choose the scale again.
  • Ratings of its own. A kind can name more, beside the overall one: a show's Story, Animation and Music. Each is a property of its notes (story: 8/10, the name in lower case), on the kind's scale, offered in the row's Rate ▸ and as the note's properties are typed. In Settings, the pencil beside a kind adds, renames, moves and removes them. Renaming one renames it in the kind's notes too, where its value is a rating on the kind's scale (not in locked notes, nor a note that has the new one already), which keep their dates: Settings says in how many notes first, with Rename and Cancel. Removing one leaves the notes as they are. A name can't be one of the kind's own properties, matched as keys are (Run time is a movie's runtime), nor status, link or rating, nor another of its ratings (Voice-acting is Voice acting).
  • Synced. Each kind's scale and named ratings, and your scales, are kept in ratings.json beside the notes and synced choice by choice, the later winning (Sync), so every device draws a note's ratings alike. A scale a kind's rated on isn't lost to another device having removed it.

In the sidebar

The Library comes after the places and before Types, which no longer lists its kinds. It's there even while it's empty, to be found, and like any section it can be folded, hidden, its rows made small or tiles, hidden one by one (Show Hidden brings them back) and dragged into the order you like. Songs and albums share Music. Feeds is at its top.

On a shelf, each row shows the cover small at its side (in the shape the kind's covers come in: a book's or poster's tall, an album's square, a video's wide), the title, what it's by (author and year, director and year, artist and album, channel and length…) and its status. A row without a cover shows its kind's icon.

Where Lines looks

Each source is a plugin, which can be turned off in Settings → Plugins, and others can add theirs (Plugins). They're asked in turn, each site's first and then Web Pages, and the first that recognizes the link and finds what it is fills the note in.

SourceLinks it knowsWhat it's sentOn the web
YouTubeyoutube.com and youtu.be videos, Shorts; channels (/@handle, /channel/UC…, /c/name, /user/name, any of their tabs, and their feeds)the video's link, to YouTube's oEmbed; in the apps, the video's page; a channel's page (its Videos tab)Videos: yes, their title, channel and picture; when one came out, how long it is and what it's about only in the apps. Channels only in the apps: YouTube doesn't let web pages read its pages or feeds
Open Libraryopenlibrary.org books, and an ISBN in a link (a bookshop's, or Amazon's, whose number for a book is its ISBN-10)the book's id or ISBNYes
WikidataIMDb, The Movie Database, Letterboxd, Wikipedia and Wikidata links to films, series, comics and booksthe id in the link (or the page's title) to Wikidata, and the item's page title to Wikipedia, for its summary and posterYes
AniListanilist.co anime and manga, MyAnimeList's manga (myanimelist.net/manga), and in the apps MangaDex's, through the AniList id MangaDex has for itthe id in the link, or what's searched for, to AniList's GraphQL API (and a MangaDex id to MangaDex's API)Yes; MangaDex's links only in the apps: MangaDex doesn't let web pages ask it
MyAnimeListmyanimelist.net animethe id in the link, to Jikan, an open API that reads MyAnimeList for apps without an accountYes, as Jikan lets web pages ask it
MusicBrainzmusicbrainz.org songs and albums, and Spotify, Apple Music, Bandcamp, Deezer and Tidal links it knows (most albums, fewer songs); covers from the Cover Art Archivethe id in the link, or the linkYes
SoundCloudsoundcloud.com tracks, and someone's sounds when they're a podcast (SoundCloud's feed of them has any)the link, to SoundCloud's oEmbed; in the apps the track's page, for its length, and the person's feedTracks: title, artist, cover, what it's about. Someone's podcast only in the apps: SoundCloud doesn't let web pages read their feed. A set (an album or a playlist, which SoundCloud doesn't say) isn't looked up
Apple Podcastspodcasts.apple.com podcasts, and their latest 200 episodesthe podcast's and episode's ids, to Apple's iTunes Search API; the podcast's feed, for what it's aboutYes; what a podcast is about only where its feed lets web pages read it (few do)
Feedslinks that look like a feed's (….xml, ….rss, /feed, /rss, feeds.…), made subscriptionsthe link, to its siteOnly feeds whose sites let web pages read them
arXivarxiv.org papersthe paper's idNo: arXiv's API doesn't answer web pages
Web Pagesany pagethe link, to its own siteNo: sites don't let web pages read them

Web Pages reads what a page says about itself for search engines and for links shared elsewhere: its JSON-LD (schema.org's Book, Movie, TVSeries, VideoObject, MusicRecording, MusicAlbum, PodcastSeries, PodcastEpisode, Article, BlogPosting, NewsArticle, ScholarlyArticle…), its Open Graph tags (og:type of video.movie, music.song, book, article…), and an oEmbed it points to. That covers most sites: Letterboxd, Goodreads, Spotify, Bandcamp, Substack, blogs and news. The page is only read, never run or shown. IMDb doesn't answer apps, so its links are looked up through Wikidata.

A comic, not a book. Most sites of manga, manhwa and webtoons describe a series as a Book, so Web Pages looks closer at a book, or at a page that says of nothing what it is. It's a comic if the page says so (schema.org's ComicSeries, ComicIssue or ComicStory; an Open Graph type of a webtoon or a webcomic, as WEBTOON's and Tapas' are), or if it's a series on a site of comics (WEBTOON, Tapas, MangaDex, MangaUpdates, MyAnimeList's and AniList's manga). Otherwise two of these must agree: what its own description calls it (its JSON-LD genre, keywords or additionalType: Manga, Manhwa, Webtoon, Comics, Graphic Novel…), what the page labels it (the label after its Type, or Format: "MANHWA"), and where it is (a /comic/, /comics/, /manga/, /manhwa/, /manhua/ or /webtoon/ in its address). So a scanlation site's /series/comic/… page labelled Manhwa is a manhwa, while a book about comics (only its genre says comics), a novel a site keeps under /comic/ (only its address), or a shop's book with Manga in its menu (only a menu's label, not its Type) stay books. One labelled a novel (a light novel, a web novel; MyAnimeList's Type: too), or whose title files it among novels (Tapas' "Tapas Web Novels", which gives its novels its comics' Open Graph type), is never a comic. Its format is what the page says, most particular first: its Type, its description, its Open Graph type, its site's (WEBTOON's and Tapas' are webtoons), its address, else comic.

An anime looked up on AniList has its ids on both sites, anilist and mal (AniList knows MyAnimeList's); one looked up on MyAnimeList has its mal. Either id finds its note, however it was added: a MyAnimeList link to an anime added from AniList opens that note. A comic keeps MyAnimeList's id as myanimelist, apart from an anime's mal: MyAnimeList numbers manga and anime each from 1, so its anime 1 isn't its manga 1. AniList numbers them together, so anilist is either's. Its title is its English one where it has one, else as it's written in Latin letters (Sousou no Frieren); its season, Fall 2023; its format as AniList and MyAnimeList say it (TV, Movie, OVA, ONA, Special…). AniList is asked every two seconds at most, for anime and comics alike (it asks for no more than 30 requests a minute while it's busy), and Jikan once a second (it asks for three a second and sixty a minute).

Only what's needed is sent: the link, or an id read from it. Nothing from your notes. In the apps, Lines says it's lines/<version> (https://github.com/olekslitus/lines) to the services it asks, as MusicBrainz and Wikimedia ask apps to; nothing about you. MusicBrainz is asked once a second at most, and arXiv every three seconds, as they ask.

Feeds

Subscribe to blogs, sites and podcasts, and read their posts in Lines.

  • A subscription is a note with a feed: property: a podcast's (type: podcast, on the Podcasts shelf too) or a site's (type: feed), with its title, artwork, author, feed and link, made as any library note is. It syncs as notes do.
  • A feed's picture is its own (RSS's <image>, Atom's <logo> or <icon>, JSON Feed's icon or else its favicon, a podcast's artwork); a site's feed that names none gets its site's icon, as Hacker News shows its Y: the largest its site's page names (apple-touch-icon, <link rel="icon">), else the site's /favicon.ico. A podcast's is its artwork or none, never its site's icon. It's kept with the subscription's note as its cover as the note is made, a PNG at the icon's own size (128 pixels at most; an SVG drawn at 128), so it syncs and shows offline, and drawn wherever a podcast's artwork is: a small icon at its own size in the middle of its square rather than stretched, and one you can see through that would vanish into the theme (a black icon in a dark theme) on a tile of the theme's text color. Two requests to a site at most, its page and the icon, a few sites at a time and each once however many of its feeds there are; an icon heavier than a megabyte, or that says it's more than 8,192 pixels across, isn't kept. A picture is never added to the note afterwards by itself, so one taken out stays out, on every device: a subscription without one (made before Lines did this, or whose picture couldn't be had then) gets it from Get Its Picture in its menu, which asks again; Get Missing Pictures, in the menu of a kind of feeds' row (RSS Feeds, Atom Feeds, JSON Feeds, or Feeds), does that for each of its sites' feeds without one, a few at a time, and says how many it found (a podcast's is left to its own menu). Trashing or deleting the note, or taking out its feed:, unsubscribes; restoring it subscribes again, with its posts as they were. Unsubscribe, in a feed's menu, puts every note subscribing to it in the Trash.
  • Subscribe from the Library heading's + (Subscribe to a Feed), or the + over the Feeds: paste a feed's link, a site's (Lines finds the feed its page names, <link rel="alternate">, RSS first, then Atom, then JSON Feed (a page's plain application/json link only when its address says it's a feed, so not a site's API), or, for a page that names none, one where sites usually keep theirs: feed, rss, rss.xml, feed.xml, atom.xml, index.xml, atom or feed.json beside the page, then at the site's root, asked one at a time and given up on when the site asks to be left alone; a podcast's site whose own feed has no sound, or that has none, is subscribed to for its podcast, which it links to by its feed or its page on Apple Podcasts, if that feed says this is its site: one the page only mentions isn't taken for it), or a podcast's page on Apple Podcasts (Apple's lookup, the Apple Podcasts plugin's, gives its feed), or, in the apps, someone's on SoundCloud whose sounds are a podcast (SoundCloud's feed of them). A new note that's just a feed's link, or a site's page with a feed, becomes a subscription too, as any link becomes what it is. Settings → Library imports and exports OPML, the file other feed readers and podcast apps use.
  • RSS Feeds, Atom Feeds, JSON Feeds, Podcast Feeds and Video Feeds (YouTube channels'), at the top of the Library, each list their feeds' posts, newest first, unread ones marked; under each, its feeds, with their artwork and how many posts in their list are unread, and a quiet mark, saying why when pointed at, if one couldn't be fetched. A podcast's feed is in Podcast Feeds whatever it's written in, and RSS 1.0 is with RSS; a kind with no feeds has no row. Each row is moved, sized, hidden and folded as the Library's other rows are. Settings → Library → Feeds in the sidebar puts them together instead, By Kind or Together: one Feeds row of every feed's posts. A feed's format is learned each time it's fetched (at start, and every refresh); until then, one subscribed to before Lines knew it is with RSS, or, if its note is a podcast's, with Podcast Feeds. A post opens in the note's place, read-only, drawn as a note: its HTML made into Markdown (paragraphs, headings, links, emphasis, lists, quotes, code, pictures, simple tables), never shown as it came. Nothing in a post is more than text there: its code has no language, so nothing draws or runs it (a diagram, a request), its links go only to the web or to mail, and what would read as a tag, a mention, math or a link to a note stays words. Its title links to it, and the line under it says where it's from, the site it's of when that's another (an aggregator's, as Hacker News' are), by whom, when, and links to its comments where the feed has them (RSS's <comments>, Atom's replies page), which go to its discussion below where Lines reads it (next); a click on a link in a post opens it. A post whose picture comes apart from what it says (an image enclosure, Media RSS's, as NASA's Image of the Day's posts have it) shows it above what it says, unless what it says shows one; a podcast's episode doesn't show its artwork there, nor a video its picture, which their players show. A post that says nothing of its own but those links (Hacker News' say only "Comments") shows what the page it links to says of itself, its description and picture, in the apps while Look Up Links is on and Web Pages reads pages. Opening it marks it read; over it, Mark as Unread and Open in Browser. A feed's menu, and each row's, marks all its posts read.
  • Streams group feeds by topic or priority, under names of your choosing: "Must read", "Work", "Friends", "Later". A stream is a row at the top of the Library's feeds, before RSS Feeds (or Feeds), listing its feeds' posts together, newest first, with its feeds under it and how many of their posts are unread; RSS, Atom, JSON, Podcast and Video Feeds still list every feed. A feed can be in several, as a note can have several tags. Streams are dragged into the order you like, priority first, as the Library's other rows are, and have a feed group's menu, with Rename… and Delete Stream. A feed's menu has Add to Stream, a menu of the streams there are and New Stream… (named in a box there), and Remove from each it's in; a feed's row dragged onto a stream's puts it there. A stream is kept on its feeds' notes as stream: (stream: Must read, Work; a YAML list too), so it syncs as notes do, and writing that makes one too; it's the name its feeds have, matched without case, so a stream with no feeds isn't one. Rename rewrites each of its feeds' notes, and Delete Stream takes it off them (the feeds stay subscribed), each as an edit, dated, so sync weighs it against an edit made elsewhere as it would any; the row keeps its place, size and folding. A feed's streams are those its subscription names: the note edited last, if two notes subscribe to it. A name has no comma, which parts the list, and is written as words (stream: \#later for #later, so it's no tag).
  • Filters keep or hide posts by their words. A feed's menu has Filters…, a dialog of two lists of words and phrases between commas: Only show posts with keeps just its posts with any of them, Hide posts with takes out those with any of its; hiding wins. They're kept on the feed's note as include: and exclude: (exclude: sponsored, web3 summit), so they sync as notes do, and writing those works too; a word written like a tag or a mention (#ad) is written as words (\#ad), so the note isn't tagged. Settings → Library → Feed filters → Hide posts with hides posts with those words in every feed, on every device: it syncs as feeds/muted.json (Sync). A post has a word or phrase when its title, its text (as far as its first 2,000 characters), its author or its categories (or tags, where the feed gives them: RSS's and Atom's categories, Dublin Core's subjects, JSON Feed's tags) have it, whatever its case and the accents of Latin and Greek letters (cafe is "Café"; other scripts' marks make other letters, so か isn't "が"): as whole words where words are spaced apart (rust isn't in "trust"), and anywhere in the text in scripts written without spaces between words, Chinese, Japanese, Thai, Lao, Khmer and Burmese, and in Korean, whose words run into what follows them (広告 is in "新製品の広告です", 광고 in "광고를 봤다"). A filter changed changes the lists at once, the posts kept already too; each post is read once, when it's fetched or the filters change, not each time it's read or dismissed. Posts filtered out aren't deleted, nor counted: they're with those dismissed, under Show Dismissed, each saying which word kept it out ("Filtered: “crypto”") or that it has none of those its feed shows. Streams have no filters of their own (a stream is only a name on its feeds' notes); a feed's are for every stream it's in.
  • Dismissing takes a post out of every list it's in, for good, and reads it, so a feed can be kept as an inbox at zero: Dismiss, when you're done with it, or Not Interesting, when it isn't for you. Reading a post doesn't dismiss it, as reading a mail doesn't archive it; Settings → Library → Dismiss posts once read (off at first) dismisses the one open as you go on to another, unless you marked it unread. Dismiss is the button that shows on a post's row as it's pointed at or focused (always, on a touch screen), and both are in its menu and over the open post; by keyboard, in the list, E or ⌫ dismisses the post focused, and N dismisses it as not interesting. Dismissing the open post opens the next, as a mail app goes on to the next message. A feed's menu, and each row's, has Dismiss All, for a backlog. Each says what it did in a notice at the bottom of the window, with Undo, and ⌘Z undoes it too, until a note's changed: the posts come back as they were, read or unread, the one that was open opened again. A list with none left says "All caught up." Show Dismissed, in a feed's or row's menu (or under "All caught up."), lists its posts dismissed (and filtered out), newest first, each not interesting saying so; Restore, on its row, in its menu or over it, puts one back in the list, unread. The count beside a feed is of its posts unread and still in its list.
  • A post's discussion, where a plugin reads its comments link (Hacker News', Plugins), is under the post, loaded as it opens, the two scrolled as one and on one page (over a backdrop, one card for both; on ruled paper, the comments' text ruled too). How many comments there are, and Open on Hacker News; each comment's header, its author (the poster's in the accent) and how long ago, folds it with its replies, saying how many; replies drawn in under what they answer, four levels deep on a phone and seven where it's wider, and deeper ones saying whom they answer. A comment's text is only text, made from its HTML (paragraphs, quotes, code, lists, emphasis), and its links are opened by Lines in the browser. The byline's Comments goes to it. By keyboard it's one stop for Tab, and the arrow keys go from comment to comment (Accessibility). A big thread is drawn a few dozen comments a frame, each laid out only near the view, so thousands of comments scroll as a few do. Hacker News' come from Algolia's copy of the thread, in one request, with the official API's story for the order of its first comments (replies are oldest first) and how many there are; where it counts more than Algolia gave, the thread ends with how many more there are on Hacker News. Each is sent only the story's id; the official API is waited for two seconds at most. A discussion read is kept while Lines runs, so a post opened again shows it at once. Only to read: voting and replying need a Hacker News account, and it has no API for either.
  • YouTube channels, in the apps: subscribe to one by its link (youtube.com/@veritasium, /channel/UC…, /c/…, /user/…, any of its tabs) from Subscribe, Add to Library, a note that's just the link, or a link's menu (Add to Library); a video's link in Subscribe subscribes to its channel (elsewhere it's the video, a video note). It's a channel note on the Channels shelf, with the channel's name, its picture as its cover, what it says it's about, its link (its handle's page) and its feed, YouTube's feed of its 15 newest videos, Shorts among them. A channel already in the Library, by its feed (which names its id, whatever its handle), isn't added again, nor is its feed subscribed to as a site's before: Subscribe opens that note, as for any feed. Its videos are in Video Feeds, after the other kinds of feeds. A video's post shows its picture (from YouTube's image server, as it's shown) and what it says; Play loads YouTube's player in its place, from youtube-nocookie.com, which isn't asked for before, and which can go full screen or picture in picture. YouTube's feeds go missing at times (they answer 404 or 500 for hours or days): while one does, the channel's videos are read from its page, the newest 30, their dates a guess from "3 days ago" (shown as "about…", and not kept as a video's published when one's saved) until the feed's back with the real ones; what's kept of a video already (what it says) isn't taken from it, and a video first seen so that's older than the newest there is read already, not news. A page YouTube has changed past reading gives nothing, and the feed says it couldn't be fetched, as any feed does; it's asked no more often than any feed is. Saving a channel's video to the Library makes a video note as its link would, whose channel mentions the channel's note.
  • Save to Library (over an open post, or in its menu) keeps a post as a note of its own: an article, or an episode whose podcast mentions its subscription's note, or a channel's video.
  • Feeds are read as RSS 2.0, Atom, RSS 1.0 and JSON Feed (1.0 and 1.1), with iTunes' podcast tags (artwork, author, duration, season and episode) and Podcasting 2.0's season and episode. A JSON Feed item's content_html is read as a post's HTML is, and its content_text (or summary) as text only, its < and & what it says; its title is plain text, whatever looks like a tag or an entity in it kept as written; its authors (or 1.0's author), image, and an attachment that plays (with its duration_in_seconds) are read as RSS's are. A link post's external_url is where it links (when it has no url of its own), while its relative links stay its feed's site's. As with RSS, an item without an id is kept (by its link and title, or its title and date), and a field of the wrong kind is passed over. A feed that isn't quite XML (a bare &, an HTML entity, a stray character, a namespace never declared) is mended, and one cut short is read as far as it goes.
  • Refreshing, in the main window: when Lines starts and then every 30 minutes while it's open (Settings → Library → Refresh feeds: 15 minutes, 30, an hour, 4 hours, or only when asked), and with ⟳ over the list. Each feed is asked whether it changed since last time (its ETag and Last-Modified), a few at a time and never two from one site at once, feeds imported from OPML too. One that fails is asked again later each time it fails in a row (after the refresh interval, then twice that, and so on), and one that says to wait (429, 503) no sooner than it said; either way, a day at most. One that says it's gone for good (410) isn't asked again. ⟳ asks any of them anyway. The apps call themselves lines/<version> (+https://github.com/olekslitus/lines), and say nothing of who's using them.
  • What's kept: the newest 200 posts of each feed, which were read and which dismissed, and why, in this device's lines-feeds database (Storage), each under a random id, and encrypted while the app lock is on. Each device fetches the posts itself; what's done with them syncs, so a feed at zero on the Mac is at zero on the phone: read, unread, dismissed (and why) and restored, each post's marked with when, in a small file for each feed beside the notes, in feeds/ (Sync), and Dismiss All as a cut-off at the time it was done. A post's mark is under its feed's address and a fingerprint of its id (its guid, or else its link and title), which is the same wherever the feed is fetched, so a post one device marks before another has fetched it is as marked once it has, and a device new to a feed has its old posts as you left them. A mark is kept while its post is in its feed, and let go 90 days after it's gone. What you read, save to the Library and mark Not Interesting stays with each post kept, for a filter that learns what interests you to read later (Limitations).
  • On the web only feeds whose sites let web pages read them can be (CORS): most blogs' don't, and many podcast hosts' do. The Feeds and the box to subscribe say so. Apple Podcasts' lookup finds a podcast's feed on the web too, but subscribing still needs the feed itself to be readable. Nor can a site's answer be read when it doesn't allow it: a feed that says to wait, or that it's gone, looks like one that couldn't be reached, and is asked again as one that failed.

The podcast player

  • An episode plays in Lines: the play button on an episode's row in the Feeds, or over an open one; on an episode note, the button before its audio link, or Play Episode in its row's menu. The mini player sits at the bottom of the sidebar (or of the note list, where the sidebar's a drawer or hidden): the episode's artwork, title and show, which open it; where it's got to, with the time played and left; back 15 seconds, play or pause, forward 30, and the speed (0.75× to 2×, kept for the next).
  • It plays on across notes, tabs and views: there's one player for all of Lines, in the main window (a floating note's Play asks it to play there). Playing an episode pauses audio or video playing in a note, and the other way round. The slider's arrow keys go 5 seconds.
  • Where each episode was stopped is kept on this device, a feed's episode by its post, a note's by the note, and it starts there next time; an episode's row says how much is left. Locked or quit while it plays, it's back in the player afterwards, paused where it was. Played to the end, or stopped in its last 20 seconds, it's Played (its row's menu marks it played or not; Mark as Played on the one playing puts the player away), and an episode note's status becomes listened: done by Lines, not by you, so ⌘Z doesn't undo it. One that couldn't be played plays when Play is pressed again.
  • The system's media controls (media keys, the Mac's Now Playing) show what's playing and play, pause and skip it; previous and next go back 15 seconds and forward 30.
  • Episodes play from their feeds' addresses, over https (an http: one is asked for over https), as the apps' web views allow; nothing is downloaded to listen to offline yet.

Notes while listening

Part of the Feeds plugin, so off with it: Take Notes and the transcript in the player, and times in notes.

  • Take Notes, the pen at the left of the mini player's controls, opens the episode's note at its end, on a new item of a list of times, - [12:34] , the cursor after it, to write what you're hearing. A feed's episode is saved to the Library first, as Save to Library does (the pen spins meanwhile), and plays on, its place kept by its note from then on. Pressed again later, it's the next item (an item left empty starts again at the new time); ⌘Z takes it back. It writes in the note in the main pane, even with the note open beside, and screen readers hear why when it can't: the note's in the Trash, or locked, or couldn't be saved. Someone who types elsewhere while the episode is saved keeps their cursor: they hear the note's ready, and Take Notes again opens it.
  • Each note at the time it's taken: in the episode's own note, while its episode plays, or is paused after playing since it was put in the player (not one put back paused after a restart, until it plays again), Enter at the end of an item of a list of times (- [12:34] what was said) starts the next with the time the episode is at now (- [13:02] ), and screen readers hear it ("At 13:02"); one ⌘Z takes it back. On the list's last item with nothing after its time (one just started), Enter is Markdown's Enter on an empty item, the time taken out: the list ends, or a nested one moves out a level; one in the middle of a list keeps the time written on it, and the next starts after it. Only a list's real items: not text that looks like one in code, math, HTML or the note's properties. Anywhere else (another note, or the note when another episode's in the player), Enter goes on with the list as it does with any. Starting a list by typing - doesn't write a time: a todo typed as - [ ] would get one, and not every list in the note is of moments; Take Notes starts one with a time, and ⌃⌘T writes one. Settings → Library → Time new notes while listening turns it off.
  • A time in an episode's note, [12:34] ([1:02:03] from an hour on), is drawn as a chip in the accent with a play icon: clicking it plays the episode from there, and so does ⌥↵ with the cursor on it. With the cursor on it, it's its text, to change. In any other note, [12:34] alone is just text.
  • In any other note, a time is a link to the episode's sound at that moment: [12:34](https://…/episode.mp3#t=754), a Media Fragments address, so in other apps it's a link that a browser plays from there. Lines draws it as the same chip, and plays the episode it's of from where the link says (#t=), its text aside: its episode note's, else its feed's post's, else the sound alone (which opens no note, takes no notes, and marks none listened). Only links to sound files on the web are drawn so (https: or http:, ending .mp3, .m4a and the like): a show's notes link their own times to their page, which isn't to play.
  • Writing the time: ⌃⌘T (Ctrl+Alt+S on Windows and Linux, as Ctrl+Alt+T opens Ubuntu's terminal), or /time, writes the exact time the player is at where the cursor is, [12:34] in the episode's own note and the link anywhere else. With nothing in the player, the note says so after the cursor for a moment, quietly, and screen readers hear it; nothing's written, and a /time typed goes.
  • Playing without leaving the text: ⌃⌘P plays or pauses, ⌃⌘← goes back 15 seconds and ⌃⌘→ forward 30 (Ctrl+Alt+P, Ctrl+Alt+, and Ctrl+Alt+. on Windows and Linux), anywhere in the main window, a note's text too. They're the keys where those are on a US keyboard, in any layout, and on Windows a key that types a character with AltGr (Ctrl+Alt there) types it. Held down, play and pause is pressed once. The media keys and headphones' buttons work too (above).
  • Transcripts and chapters: an episode whose feed names a transcript or chapters (Podcasting 2.0's podcast:transcript, in SubRip, WebVTT, JSON or HTML, and podcast:chapters) has a Transcript button beside Take Notes. Save to Library keeps them in its note, transcript: and chapters:, so they're there once the feed lets the episode go, and on other devices. The button shows them above the player, at most about a third of the window: each sentence with its time and who says it (put together from the words or bits of lines some transcripts give), the chapters as headings between them, and the chapter it's in at the top. The sentence playing is marked and kept in view, unless you've just scrolled; a sentence plays from where it starts; ↑ and ↓ move between them, Home and End to the first and last, and Tab stops on one (the one playing, or the first). Quote in Note puts the sentence playing after the cursor's line in the Markdown note open (never in its properties), or at the end of the episode's note, > [12:34] What was said. — Speaker, as text that reads as just that. One that can't be read says why: its site doesn't let web pages read it, it isn't there any more, or it couldn't be read.
  • In a floating note, a time's chip plays it in the main window's player; writing the time and the player's keys don't work there yet. Nor are times drawn, written or quoted in LaTeX notes yet.

AniList and MyAnimeList

Sign in to AniList or MyAnimeList (or both) in Settings → Library, and your anime list there and the Library are kept in step: an anime's status, its rating and how many episodes you've watched, both ways. Each is its plugin's (Plugins), and was made from the sites' documentation and tried against stand-ins for them, not against real accounts yet (Limitations).

  • Signing in. AniList: Get Your Token on AniList, say yes there, and paste the token AniList shows into Settings. It lasts a year. MyAnimeList, only in the apps (it doesn't answer web pages): Sign In… opens MyAnimeList in your browser; say yes there, and the browser comes back to Lines, which listens for it on this computer only, at http://127.0.0.1:45291/myanimelist, for five minutes at most. Lines keeps what it's given (a token, and MyAnimeList's to get a new one as it runs out) on this device, encrypted under the app lock, and sends it only to the site. It isn't synced: sign in on each device you want to keep the list in step from. Sign Out forgets it; the notes stay.
  • Your list comes in. Once signed in, Settings says how many anime are on your list and how many the Library has already, and Import makes a note of each of the rest, on the Anime shelf, as a link to it would (title, cover, studio, year, season, episodes, its ids), with its status, rating and progress (episodes watched). Undo Import takes them back. Import Your List… asks again later. What's put on the list after you've signed in comes in by itself, once Lines' own sync has been through once since Lines started, so a note another device made of it is here first. Something there already is found by its id on the site (anilist, mal), the other site's id (AniList knows MyAnimeList's), or its link. One whose note is in the Trash, or locked and shut, isn't made again: its note stays as it is, in the Trash or locked, and isn't kept in step until it's back or open.
  • Kept in step, in the main window: when Lines starts, as often as feeds are fetched (Settings → Library → Refresh feeds; only when asked, there, means at start and when you change something), a few seconds after a note's status, rating or progress changes here, and with Sync Now. Each time, Lines reads the whole list (one request to AniList; MyAnimeList's, a thousand at a time), and for each anime compares both sides with how they were when they were last alike: a side that changed carries to the other; where both changed the same thing, the later wins (the note by when it was last changed, the site by when it says). The first time an anime's kept in step, the site's status comes first (a note made from a link starts to watch, and mustn't undo your list), but the note's rating and progress, where it has them: no note starts with those, so they're yours. Each side fills in what the other hasn't got. A rating that doesn't fit the kind's scale (great, on stars) isn't sent, so the site keeps its score. A note of the kind with its id on the site that isn't on your list is put on it. One taken off the list there stays a note, and isn't put back on it, until you change its status, rating or progress here. Only what changed is sent, so rating something you're watching again leaves it Rewatching. What Lines writes into a note keeps its date, so the list doesn't move, and ⌘Z stays with what you did.
  • Ratings go onto the site's scale and back: MyAnimeList's 0–10, or AniList's out of 100 (as AniList keeps every score, whichever way you've chosen to see yours there: out of 100, 10 by tenths or whole, 5, or 3 smileys, which you can change whenever), from the Anime kind's scale (Ratings): the same share of the way up, rounded half up to the site's step, never 0 (none) for one that's rated; words from the site's lowest to its top. Out of 5 with halves is MyAnimeList's 10 exactly. A value that reads the same on both sides (4/5 and 8) is left as it is, so nothing churns; one that doesn't fit the kind's scale is no score to the site. Statuses: to watch, watching, watched, on hold and dropped are AniList's Planning, Watching, Completed, Paused and Dropped (and its Rewatching is watching, and stays Rewatching there), and MyAnimeList's Plan to Watch, Watching, Completed, On Hold and Dropped; a status of your own stays the note's.
  • Problems are said quietly, in Settings under who's signed in: offline, a site that said to wait (AniList asks for no more than 30 requests a minute while it's busy, and says when to ask again; Lines asks it every two seconds at most, for looking things up and the list alike, and waits as long as it's told), or a token it no longer takes (AniList's after a year, MyAnimeList's if it can't be refreshed), which asks you to sign in again. Nothing is lost meanwhile: what changed on either side goes over once it can.
  • What's sent: to AniList and MyAnimeList, your token, and for each anime its id and its status, score and progress. Nothing else from your notes.
On the webIn the apps
AniListYesYes
MyAnimeListNo: it doesn't answer web pagesYes

Both need Lines' client id with each site, which a build of Lines has or hasn't (the downloads from GitHub's releases have them); without one, Settings says keeping that list in step isn't in this build. Building Lines yourself: README.

YouTube playlists

Settings → Library → YouTube brings a playlist's videos into the Library, each a video note, to watch, with its title, channel (mentioned, or linked to: Kinds of things), length and picture, the playlist it's in (playlist) and the day it was added there (added).

  • A playlist's link (youtube.com/playlist?list=…, or a video's link in one, watch?v=…&list=…), in the apps: typed or pasted into its field, or from a playlist link's menu in a note (Import Playlist…, which opens Settings there with the link, in Settings shown over the notes). Its page is read, then each next part of it as YouTube's own page asks for it, a second apart, 5,000 videos at most, saying how many it's read; Cancel stops it. If YouTube's answer has nothing new in it, or asks for a part it's given already, reading stops there and says so: what it read can still be imported. A Mix made for whoever's watching, Watch Later and Liked videos can't be read: only their owner can see them. A playlist must be public or Unlisted.
  • Watch Later, or any playlist, from Google Takeout (YouTube and YouTube Music → playlists → Watch later-videos.csv, <name>-videos.csv), on the web too: choose the file here, or give it to Export and Import's Import Files…. Takeout writes only each video's id and when it was added, so each video the Library hasn't is looked up through YouTube's oEmbed, five a second, saying how many of how many; Cancel stops it. Both shapes Takeout has written are read (Video ID,Playlist Video Creation Timestamp, or the playlist's details first and then Video Id,Time Added), whatever the case of their headers; the playlist's name is its details' title, or else the file's name. Or copy Watch Later's videos to a playlist of your own, made Unlisted, and import that by its link.
  • What it writes: what importing would do is said first (how many videos, how many new, how many there already and given this playlist too, how many there with it, how many deleted or private), then Import, and Undo Import after. A video the Library has, however it was added (as One note of each thing says: any link to it), isn't added again: the playlist is added to its playlist, a list once it names more than one (playlist: then - Watch later and - Physics, so a name with a comma in it is one name), and it's left as it is otherwise. That's worked out as it's written, from the note as it is then: what's been typed in it, or come with sync, since is kept. A video deleted or made private since it was listed is left out and counted. Importing a playlist again adds only what's new to it, and counts nothing as added again (its name compared with its spaces one each, as it's written). A Takeout video the Library had, so not looked up, whose note went to the Trash before Import, is left out, and what it did says so: import the file again to look it up.

From Readwise

Settings → Library → Readwise brings what Readwise and its Reader keep into the Library: each book, article, podcast's episode and tweet you highlighted, with the highlights, and what you saved in Reader, read or not. It's the Readwise plugin's, and was made from Readwise's documented API, not tried against a real account yet (Limitations).

---
type: book
author: Herman Melville
readwise: 1001
---
# Moby-Dick

![Moby-Dick|240](../attachments/3f9c….jpg)

#classics

Read on the train, a chapter a day.

## Highlights

> Call me Ishmael.
> — Location 12 · 2024-03-01 #openings

The best first line there is.
  • The token. Readwise gives you an access token to copy at readwise.io/access_token. Paste it and Find: it's sent to readwise.io and nowhere else, used for this import, and not kept. The field empties once Readwise has answered, and Settings closing takes it. If Readwise doesn't take it, it says so, and the field has it to correct.
  • Before anything's written it says what it found: how many books, articles, episodes, videos and papers are new, with how many highlights; which notes there already get highlights they haven't got (by title); and what's left out (Readwise's supplemental books, its suggestions rather than your highlights). Import, or Cancel. With nothing new, it says so.
  • Importing shows how far it's got, and Stop stops it, keeping what it wrote. Closing Settings doesn't stop it, and opening it again shows where it's got to. Then it says what it did, with Undo Import: the notes it made go to the Trash, but those you've changed since; the notes it added highlights to are as they were, but those you've changed since. If something goes wrong partway, it says so, and Undo Import takes back what it wrote.
  • Each thing is a library note of its kind, made as a link's is (its cover downloaded and kept with it, but Readwise's own picture for something without one), with nothing looked up: Readwise has said what it is. A book is a book (its author, and the link Readwise gives, which a Kindle book hasn't got), an article (a newsletter, a post saved from a feed, or a tweet) an article (author, site, published), a podcast's highlights an episode (its podcast), a PDF saved in Reader a paper (the file isn't downloaded), a video a video. Where Reader says how far you've got, that's its status: Archive is read (watched), opened is reading, the rest is to read. A book only in Readwise has no status: Readwise doesn't know. Readwise's id of it is kept as readwise:, Reader's as reader:. It's dated when it was saved, or first highlighted.
  • Its highlights are under ## Highlights (in English in every language, as property keys are), after its tags and what you wrote about it, each a quote with where it is (a page, a Kindle location, a time into an episode) and the day it was made, linked to its own page if it has one (a tweet, a podcast's clip), its tags after; your note on it is under the quote. Tags are written as Lines writes tags (continental philosophy is #continental-philosophy), as a bookmark's are. What came from Readwise is written as just that text, as everything the Library writes is: nothing in a highlight or a note on it is a heading, a list, a table, a link or a tag.
  • Importing again adds only what's new. Something Lines has already isn't made again: it's found by its readwise: or reader: id, its link, or its kind, title and who it's by (both saying who, and not linking to different pages), so a book you added yourself is found too, and two copies of one book in Readwise (Kindle's and Apple Books') are one note. It gets the highlights it hasn't got, at its end, under ## Highlights (added if it hasn't got it), and nothing else of it changes, not even its date. A highlight is there if a quote in the note has its words, a long one anywhere in the note, however it's been laid out since.
  • Reader's feeds come as OPML: in Reader, Export Feeds as OPML on your account's page, then Import OPML under Feeds. What's in Reader's Feed (posts not saved) isn't brought.
  • On the web too: Readwise lets web pages ask it. Reader's list is asked no more than 20 times a minute, as Readwise asks; when Readwise says to wait, it waits, and a page that fails or doesn't come is asked again a few times, a while later each time.

Books you keep

A book's own file, a PDF or an EPUB (without DRM), can be kept with its note and read in the note's place.

  • Adding one. Add to Library on Books has Add a Book from a File…, and a PDF or EPUB dropped on Lines where nothing else takes it (the note list, the sidebar) is added too. The note is filled in from what the file says of itself, on the device: an EPUB's title, authors, publisher, language, ISBN, description and cover (its package's Dublin Core); a PDF's title and author (its XMP, or its Info dictionary), pages, the ISBN printed on its first pages, and its first page as the cover. Nothing is looked up. The file is kept with the note as an attachment, under the note's text, [Emma.epub](../attachments/….epub), so it syncs and exports as any attachment does. A file added again, or dropped twice, opens its one note. A file over 512 MB isn't kept, and Lines says so, as it says when a file can't be read.
  • Reading it. On a library note that keeps a PDF or an EPUB (a book, a paper, an article), Read the Book (the open book over the note) shows it in the note's place, and again goes back to the note. Around it: Contents (a PDF's outline, an EPUB's table of contents, nested as the book's are); a search of the whole book, its matches under the chapter or page each is in, which open where they are, marked; Pages or Scroll; and where it's at, how far through, and the previous and next page. ←, →, Page Up, Page Down and the space bar turn pages (scrolling, ← and → turn them and the rest scroll); in a book written right to left, ← goes on. Other keys are Lines' as anywhere (⌘Z, ⌘⇧F). A PDF's pages are as printed, or with the paintbrush in the theme's colors, its pictures as they are; their text can be chosen and is read by screen readers. An EPUB is in the theme's colors and the notes' font and size, its own style kept for the rest (italics, headings, pictures), a column as wide as a note's. Pictures, character maps and fonts a PDF needs but doesn't carry come with Lines, fetched only by a PDF that needs them.
  • Quotes. Choose text and Keep Quote (⌘⇧H) puts it at the end of the note, as a quote, with a link to where it is: [Page 12](../attachments/….pdf#page=12), or an EPUB's chapter and its CFI, [Chapter 3](../attachments/….epub#epubcfi(/6/8!/4/2/10/1:0)), as other readers write them. Following the link opens the book there; with no reader for it (its plugin off, or its note gone or locked), it opens the file in its app. ⌘Z takes a quote back.
  • Where you are. Where each book was left is kept on this device (with the podcast player's places, encrypted while the app lock is on), and the book opens there again. How far it's been read goes into the note, progress: 37%, as the reader closes, and as Lines locks, quits or is closed; its status follows along its kind's (to read, reading, read: started, then at its end), for a kind that has statuses. Only pages read count: going to a place (the contents, a search, a quote's link) and reading on from there doesn't, until you're back within what's been read, and it never goes back, so a device that's read less leaves it as it is. Both sync with the note, and its row on Books shows a line of how far through.
  • Safe to open. An EPUB is a small website, and can carry scripts, forms and links to anything. Before a chapter is shown, everything that could run, load a page or take input is taken out (scripts, frames, objects, forms, image maps, SVG's animations, on… attributes); its links are kept for Lines to follow, so the frame itself can't be led anywhere, and is put back if it is; its pictures, stylesheets and fonts are its own files, of kinds that can't run anything, and what its styles point to elsewhere, however it's written, is dropped. It's shown in a frame of its own whose policy runs no script and loads nothing but those files and Lines' fonts; Lines' own policy lets frames show only its pages. Its links to the web open in the browser.

Not yet

See Limitations for what's missing, and the README's roadmap for what's planned: a grid of covers, and where episodes were stopped synced between devices.

Edit this page on GitHub