Repository navigation
Imports from Instapaper, Readwise Reader, Wallabag, Linkwarden and Karakeep, and a bookmarks file in the export - #169
Merged
Conversation
…as the note Settings, Import takes Instapaper's CSV (URL, Title, Selection, Folder, Timestamp and, in exports since late 2025, Tags as a JSON array in one cell). A folder's name becomes a Tag; Unread, Archive and Starred say where a link sat, so they do not, and the star is dropped. An older export with no Timestamp or Tags column reads too. The source picker now lists its sources from one table of the file each exports, which also decides whose file a dropped one is: the one its name says, else the one picked if it is that kind of file, else the first source that exports that kind. The import source type is the schema's, in the one place. Co-Authored-By: Claude <noreply@anthropic.com> Signed-off-by: NiallJoeMaher <nialljoemaher@gmail.com>
…was kept The CSV from Reader's "Export Library as CSV" (Title, URL, ID, Document tags, Saved date, Reading progress, Location, Seen). Document tags is one cell written as a Python list, read whichever quote it uses. Rows whose Location is feed are what Reader fetched from a subscription, not what the person kept, and stay behind. Reading progress, Seen and where a document sat are dropped. Co-Authored-By: Claude <noreply@anthropic.com> Signed-off-by: NiallJoeMaher <nialljoemaher@gmail.com>
An array of entries: url, title, tags (labels, or objects with a label as its API writes them), created_at and content. The content is the article as Wallabag kept it, with no document round it, so one is put round it and it is kept without fetching, as Omnivore's pages are. Where Wallabag's own fetch failed the content is its notice, and that link is fetched afresh. Archived, starred and annotations are dropped. The fields read from a JSON export are a schema in shared-schemas: a field that is missing or of another type reads as absent, a file of another shape is refused with a short reason, and the import says it could not be read. Co-Authored-By: Claude <noreply@anthropic.com> Signed-off-by: NiallJoeMaher <nialljoemaher@gmail.com>
Collections each hold their links: url, name, description (the note), tags and dates. A collection's name becomes a Tag beside the link's own, but for Unorganized, where links in no collection sit. importDate, the day a link Linkwarden itself imported was first kept, wins over createdAt. A PDF or image with no URL stays behind; pins, colours, icons and how collections nest are dropped. Co-Authored-By: Claude <noreply@anthropic.com> Signed-off-by: NiallJoeMaher <nialljoemaher@gmail.com>
…lists The bookmarks array of a Karakeep (once Hoarder) export: createdAt in Unix seconds, title, tags, note and a content that is a link or a text. Only a link has a URL, so a text and an uploaded file stay behind: an import makes link Items and has no way to make a Note. A list a link sits in becomes a Tag. Archived is dropped. A file from another app than the one picked fails as unreadable and makes nothing. Co-Authored-By: Claude <noreply@anthropic.com> Signed-off-by: NiallJoeMaher <nialljoemaher@gmail.com>
llms.txt, the home page's structured data and the Privacy page's "What we store" (in all ten languages) list Instapaper, Readwise Reader, Wallabag, Linkwarden and Karakeep beside Pocket, Omnivore and Raindrop. The line under the drop box in Settings names the kinds of file (CSV, JSON, zip, bookmarks HTML) instead of each source's, which the picker above it already does: nine would not fit the box. Co-Authored-By: Claude <noreply@anthropic.com> Signed-off-by: NiallJoeMaher <nialljoemaher@gmail.com>
…and other apps import One more file in the zip: the Netscape bookmark file every browser reads. Each Item with a URL is a link with its title, the day it was plucked (ADD_DATE) and its Tags (TAGS), with its note under it, in a folder for its Status; a Status with no links gets no folder. Notes, Todos and Things have no URL and are left out. Everything is escaped with the entities a browser's own file uses. Folders, not one flat list: every reader of the format takes them (browsers keep them, other apps turn them into folders or tags, Pluck's own import ignores them), and they are the only place a Status survives the trip. The price is that a folder's lines wait in memory until every Item has gone past, a few hundred bytes a link. Settings, README.txt in the zip and llms.txt say the file is there. Co-Authored-By: Claude <noreply@anthropic.com> Signed-off-by: NiallJoeMaher <nialljoemaher@gmail.com>
…rker runs out of memory Co-Authored-By: Claude <noreply@anthropic.com> Signed-off-by: NiallJoeMaher <nialljoemaher@gmail.com>
|
The latest updates on your projects. Learn more about Vercel for GitHub.
|
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
People arriving from the apps Pluck sits beside could not bring their libraries, and the export could only be read back by a script.
Settings picks the source from the file's name, as before. A CSV, JSON or bookmarks file over 100 MB is refused at once (only Omnivore's zip is read a page at a time). Every place that names the import sources is updated, in all ten languages.
Evidence
imports.test.ts: one test per new source from a real-shaped fixture (quotes and commas in a CSV title or quotes in JSON, a missing title, a non-Latin title, a duplicate URL), and malformed JSON fails as unreadable.import.test.ts: each of the five fixtures imports to the right Items with their Tags, notes and dates; a duplicate makes one Item; a second person is untouched; the wrong app's file fails as "could not be read".export.test.ts:bookmarks.htmlis in the zip; read back with the repo's own bookmarks parser it gives the same URLs, titles, Tags and dates;&,<and quotes are escaped; a Note is absent.pnpm typecheck,pnpm lintand the unit suite pass, rebased on main. Every commit is signed off.Merge Danger
Door: two-way
Blast Radius: import
bookmarks.htmlas<DD>, but Pluck's own bookmarks import does not read them back, and a Tag with a comma in it splits on re-import.🤖 Generated with Claude Code