Skip to content

A self-hostable bookmark-everything app (links, notes and images) with AI-based automatic tagging and full text search

feat: Add Readwise Reader import (#2690)

Luis G. Zúñiga3d84150ae521
diff --git a/apps/web/components/settings/ImportExport.tsx b/apps/web/components/settings/ImportExport.tsx
index 59b10d82..1f252d8a 100644
--- a/apps/web/components/settings/ImportExport.tsx
+++ b/apps/web/components/settings/ImportExport.tsx
@@ -309,6 +309,25 @@ export function ImportExportRow() {
<p>Import</p>
</FilePickerButton>
</ImportCard>
+ <ImportCard
+ text="Readwise Reader"
+ description={t(
+ "settings.import.import_bookmarks_from_readwise_reader_export",
+ )}
+ >
+ <FilePickerButton
+ size={"sm"}
+ loading={false}
+ accept=".csv"
+ multiple={false}
+ className="flex items-center gap-2"
+ onFileSelect={(file) =>
+ runUploadBookmarkFile({ file, source: "readwise-reader" })
+ }
+ >
+ <p>Import</p>
+ </FilePickerButton>
+ </ImportCard>
<ExportButton />
</div>
{importProgress && (
diff --git a/apps/web/lib/i18n/locales/en/translation.json b/apps/web/lib/i18n/locales/en/translation.json
index 9973aa32..3e7d81fe 100644
--- a/apps/web/lib/i18n/locales/en/translation.json
+++ b/apps/web/lib/i18n/locales/en/translation.json
@@ -311,6 +311,7 @@
"import_bookmarks_from_tab_session_manager_export": "Import Bookmarks from Tab Session Manager",
"import_bookmarks_from_mymind_export": "Import Bookmarks from mymind export",
"import_bookmarks_from_instapaper_export": "Import Bookmarks from Instapaper export",
+ "import_bookmarks_from_readwise_reader_export": "Import Bookmarks from Readwise Reader export",
"export_links_and_notes": "Export Links and Notes",
"imported_bookmarks": "Imported Bookmarks"
},
diff --git a/apps/web/lib/i18n/locales/en_US/translation.json b/apps/web/lib/i18n/locales/en_US/translation.json
index 205a814a..50dc7432 100644
--- a/apps/web/lib/i18n/locales/en_US/translation.json
+++ b/apps/web/lib/i18n/locales/en_US/translation.json
@@ -343,7 +343,8 @@
"export_links_and_notes": "Export Links and Notes",
"imported_bookmarks": "Imported Bookmarks",
"import_bookmarks_from_mymind_export": "Import Bookmarks from mymind export",
- "import_bookmarks_from_instapaper_export": "Import Bookmarks from Instapaper export"
+ "import_bookmarks_from_instapaper_export": "Import Bookmarks from Instapaper export",
+ "import_bookmarks_from_readwise_reader_export": "Import Bookmarks from Readwise Reader export"
},
"api_keys": {
"api_keys": "API Keys",
diff --git a/packages/shared/import-export/parsers.test.ts b/packages/shared/import-export/parsers.test.ts
index a5c61b23..3039a43e 100644
--- a/packages/shared/import-export/parsers.test.ts
+++ b/packages/shared/import-export/parsers.test.ts
@@ -578,3 +578,108 @@ describe("parsePocketBookmarkFile", () => {
expect(result.bookmarks[0].archived).toBeFalsy();
});
});
+
+describe("parseReadwiseReaderBookmarkFile", () => {
+ it("parses a Readwise Reader CSV file with multiple items", () => {
+ const csv = `Title,URL,ID,Document tags,Saved date,Reading progress,Location,Seen
+"Example Site","https://example.com","id1","['tag1','tag2']","2026-03-14 23:55:23.291000+00:00","0","new","True"
+"Example Tag less Site","https://notags.com","id2",,"2026-03-14 23:55:23.291000+00:00","100","new","True"
+"Archived Site","https://archived.com","id3",['tag1'],"2026-03-14 23:55:23.291000+00:00","100","archive","True"`;
+
+ const parsed = parseImportFile("readwise-reader", csv);
+ const result = parsed.bookmarks;
+
+ expect(result).toHaveLength(3);
+
+ expect(result[0]).toMatchObject({
+ title: "Example Site",
+ content: {
+ type: "link",
+ url: "https://example.com",
+ },
+ tags: ["tag1", "tag2"],
+ addDate: 1773532523.291,
+ archived: false,
+ });
+
+ expect(result[1]).toMatchObject({
+ title: "Example Tag less Site",
+ content: {
+ type: "link",
+ url: "https://notags.com",
+ },
+ tags: [],
+ addDate: 1773532523.291,
+ archived: false,
+ });
+
+ expect(result[2]).toMatchObject({
+ title: "Archived Site",
+ content: {
+ type: "link",
+ url: "https://archived.com",
+ },
+ tags: ["tag1"],
+ addDate: 1773532523.291,
+ archived: true,
+ });
+ });
+ it("filters out feed items", () => {
+ const csv = `Title,URL,ID,Document tags,Saved date,Reading progress,Location,Seen
+"Feed Item","https://feed.com","id1",,"2026-03-14 23:55:23.291000+00:00","0","feed","True"
+"Normal Item","https://normal.com","id2",,"2026-03-14 23:55:23.291000+00:00","0","new","True"`;
+
+ const parsed = parseImportFile("readwise-reader", csv);
+ const result = parsed.bookmarks;
+
+ expect(result).toHaveLength(1);
+ expect(result[0].title).toBe("Normal Item");
+ });
+
+ it("handles invalid JSON in DocumentTags", () => {
+ const csv = `Title,URL,ID,Document tags,Saved date,Reading progress,Location,Seen
+"Invalid Tags","https://invalid.com","id1","not-json","2026-03-14 23:55:23.291000+00:00","0","new","True"`;
+
+ const parsed = parseImportFile("readwise-reader", csv);
+ const result = parsed.bookmarks;
+
+ expect(result).toHaveLength(1);
+ expect(result[0].tags).toEqual([]);
+ });
+
+ it("handles empty URL", () => {
+ const csv = `Title,URL,ID,Document tags,Saved date,Reading progress,Location,Seen
+"No URL","","id1",,"2026-03-14 23:55:23.291000+00:00","0","new","True"`;
+
+ const parsed = parseImportFile("readwise-reader", csv);
+ const result = parsed.bookmarks;
+
+ expect(result).toHaveLength(0);
+ });
+
+ it("throws error for invalid Readwise Reader CSV", () => {
+ const csv = `Title,Url,Id
+"Missing Columns","https://missing.com","id1"`;
+
+ expect(() => parseImportFile("readwise-reader", csv)).toThrow(
+ "CSV file contains an invalid Readwise Reader bookmark file",
+ );
+ });
+
+ it("handles complex tag formatting in Readwise Reader CSV", () => {
+ const csv = `Title,URL,ID,Document tags,Saved date,Reading progress,Location,Seen
+"Single Tag","https://single.com","id1",['test'],"2026-03-14 23:55:23.291000+00:00","0","new","True"
+"Complex Tags","https://complex.com","id2","['test', 'test2', ""it's crazy""]","2026-03-14 23:55:23.291000+00:00","0","new","True"
+"Escaped Quotes","https://escaped.com","id3","['tag\\'s', 'another']","2026-03-14 23:55:23.291000+00:00","0","new","True"
+"Empty Tags","https://empty.com","id4",,"2026-03-14 23:55:23.291000+00:00","0","new","True"`;
+
+ const parsed = parseImportFile("readwise-reader", csv);
+ const result = parsed.bookmarks;
+
+ expect(result).toHaveLength(4);
+ expect(result[0].tags).toEqual(["test"]);
+ expect(result[1].tags).toEqual(["test", "test2", "it's crazy"]);
+ expect(result[2].tags).toEqual(["tag's", "another"]);
+ expect(result[3].tags).toEqual([]);
+ });
+});
diff --git a/packages/shared/import-export/parsers.ts b/packages/shared/import-export/parsers.ts
index dc8d4a7c..1984b517 100644
--- a/packages/shared/import-export/parsers.ts
+++ b/packages/shared/import-export/parsers.ts
@@ -17,6 +17,7 @@ export type ImportSource =
| "linkwarden"
| "tab-session-manager"
| "mymind"
+ | "readwise-reader"
| "instapaper";
export interface ParsedBookmark {
@@ -493,6 +494,86 @@ function parseInstapaperBookmarkFile(textContent: string): ParsedBookmark[] {
});
}
+function parseReadwiseReaderBookmarkFile(
+ textContent: string,
+): ParsedBookmark[] {
+ const zReadwiseReaderRecordScheme = z.object({
+ Title: z.string(),
+ URL: z.string(),
+ ID: z.string(),
+ "Document tags": z.string(),
+ "Saved date": z.string(),
+ "Reading progress": z.string(),
+ Location: z.string(),
+ Seen: z.enum(["True", "False"]),
+ });
+
+ const zReadwiseReaderExportScheme = z.array(zReadwiseReaderRecordScheme);
+
+ const record = parse(textContent, {
+ columns: true,
+ skip_empty_lines: true,
+ cast: function (value, context) {
+ //Replace for json parsing; original comes with \' instead of \" so it's not json parsable.
+ if (context.column === "Document tags") {
+ return value
+ .replace(/\\'/g, "'")
+ .replace(/(^|\[|,)\s*'/g, '$1"')
+ .replace(/'\s*(]|,|$)/g, '"$1')
+ .replace(/""/g, '"');
+ }
+ return value;
+ },
+ });
+
+ const parsed = zReadwiseReaderExportScheme.safeParse(record);
+
+ if (!parsed.success) {
+ throw new Error(
+ `CSV file contains an invalid Readwise Reader bookmark file: ${parsed.error.toString()}`,
+ );
+ }
+
+ //Feed (RSS) articles are included automatically, so filter them. Only include actively added links.
+ const feedFilteredArticles = parsed.data.filter(
+ (record) => record.Location !== "feed",
+ );
+ const emptyFilteredArticles = feedFilteredArticles.filter(
+ (record) => record.URL && record.URL.trim().length > 0,
+ );
+
+ return emptyFilteredArticles.map((record) => {
+ let content: ParsedBookmark["content"] = {
+ type: BookmarkTypes.LINK as const,
+ url: record.URL.trim(),
+ };
+
+ const addDate = new Date(record["Saved date"]).getTime() / 1000;
+
+ let tags: string[] = [];
+ try {
+ const documentTags = record["Document tags"];
+ if (documentTags) {
+ const parsedTags = JSON.parse(documentTags);
+ if (Array.isArray(parsedTags)) {
+ tags = parsedTags.map((tag) => tag.toString().trim());
+ }
+ }
+ } catch {
+ tags = [];
+ }
+
+ return {
+ title: record.Title || "",
+ content,
+ addDate,
+ tags,
+ paths: [], // TODO
+ archived: record.Location === "archive",
+ };
+ });
+}
+
function deduplicateBookmarks(bookmarks: ParsedBookmark[]): ParsedBookmark[] {
const deduplicatedBookmarksMap = new Map<string, ParsedBookmark>();
const textBookmarks: ParsedBookmark[] = [];
@@ -580,6 +661,9 @@ export function parseImportFile(
case "instapaper":
result = parseInstapaperBookmarkFile(textContent);
break;
+ case "readwise-reader":
+ result = parseReadwiseReaderBookmarkFile(textContent);
+ break;
}
return { bookmarks: deduplicateBookmarks(result), lists: [] };
}