{"id":15716054,"url":"https://github.com/thebenforce/logseq-plugin-my-highlights","last_synced_at":"2025-04-30T23:24:01.774Z","repository":{"id":37814876,"uuid":"464265618","full_name":"theBenForce/logseq-plugin-my-highlights","owner":"theBenForce","description":"Import highlights from various sources","archived":false,"fork":false,"pushed_at":"2023-05-08T21:39:51.000Z","size":4917,"stargazers_count":36,"open_issues_count":9,"forks_count":4,"subscribers_count":5,"default_branch":"main","last_synced_at":"2025-03-27T23:17:08.485Z","etag":null,"topics":["kindle-clippings","kindle-highlights","logseq-plugin"],"latest_commit_sha":null,"homepage":"","language":"HTML","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/theBenForce.png","metadata":{"files":{"readme":"readme.md","changelog":"CHANGELOG.md","contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":"theBenForce","ko_fi":"thebenforce","custom":["https://buymeacoffee.com/theBenForce"]}},"created_at":"2022-02-27T22:09:21.000Z","updated_at":"2024-11-10T15:02:28.000Z","dependencies_parsed_at":"2024-10-24T13:09:02.505Z","dependency_job_id":"810b09d5-2d9c-4a57-989a-a698b62eb931","html_url":"https://github.com/theBenForce/logseq-plugin-my-highlights","commit_stats":null,"previous_names":[],"tags_count":45,"template":false,"template_full_name":"pengx17/logseq-plugin-template-react","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/theBenForce%2Flogseq-plugin-my-highlights","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/theBenForce%2Flogseq-plugin-my-highlights/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/theBenForce%2Flogseq-plugin-my-highlights/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/theBenForce%2Flogseq-plugin-my-highlights/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/theBenForce","download_url":"https://codeload.github.com/theBenForce/logseq-plugin-my-highlights/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246379378,"owners_count":20767694,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["kindle-clippings","kindle-highlights","logseq-plugin"],"created_at":"2024-10-03T21:43:55.301Z","updated_at":"2025-03-30T20:43:13.608Z","avatar_url":"https://github.com/theBenForce.png","language":"HTML","funding_links":["https://github.com/sponsors/theBenForce","https://ko-fi.com/thebenforce","https://buymeacoffee.com/theBenForce","https://www.buymeacoffee.com/theBenForce/e/80852"],"categories":[],"sub_categories":[],"readme":"# My Highlights\n\n[![GitHub release (latest by date)](https://img.shields.io/github/v/release/theBenForce/logseq-plugin-my-highlights)](https://github.com/theBenForce/logseq-plugin-my-highlights/releases)\n[![Releases](https://github.com/theBenForce/logseq-plugin-my-highlights/actions/workflows/release.yml/badge.svg)](https://github.com/theBenForce/logseq-plugin-my-highlights/actions/workflows/release.yml)\n![GitHub all releases](https://img.shields.io/github/downloads/theBenForce/logseq-plugin-my-highlights/total)\n\n## Features\n\n  - easliy import highlights and notes directly from your kindle\n  - creates author links\n  - highlights can be imported into your jounal or directly onto the book's page\n  - Book page names can be customized\n\n## Importing Highlights\n\nTo import highlights from your kindle's clipping file, click the highlighter icon in logseq.\nA dialog will open, click the \"Load Clippings File\" button, this will open a file selection dialog.\nBrowse to your kindle and select the \"My Clippings.txt\" file.\n\nAfter selecting the clippings file you will be presented with a list of books that you can\nimport highlights from. Select the checkbox next to each book that you would like to import and click\nthe \"Import\" button.\n\n### Customizing Import Settings\n\nIf you open Settings -\u003e Plugin Settings and select \"My Highlights\", you'll see a few options to\ncustomize how \"My Highlights\" imports data.\n\n![Plugin Settings](docs/settings.jpg)\n\n#### Highlight Location\n\nYour highlights can be imported into two different locations: journal pages or a page for the book. When importing into the journal, they will be placed on the date that the highlight was created, under a link to the book page.\n\n#### Highlight Path\n\nThe setting that changes how your highlights are imported the most is the \"Highlight Path\" setting. This\nchanges the title of the page where your imports will be stored. You can set this to anything that you\nwant, but each book will need a unique title.\n\nWhen editing the highlight path you can use the following variables:\n\n| Variable | Description |\n| --- | --- |\n| {title} | Title of the book that's being imported |\n| {author} | Name of the first author listed on the book |\n| {type} | Type of highlights being imoprted, right now this will only be 'Book' |\n| {zettel} | A date time string to guarantee uniqueness. Only us this if you don't want to import more highlights later |\n\n#### Fallback Author\n\nIf for some reason the clippings file doesn't have an author listed, this value will be used instead.\n\n#### Author First Name First\n\nBy default, author names are listed as \"Last, First\". Check this box if you would rather have authors listed as \"First Last\".\n\n### Adding More Details (beta)\n\n\u003e This feature is in beta testing and may not work yet\n\nIf you would like to add the book's cover image, ASIN, and a link to the kindle web reader to the\nbook page during import click the \"Next\" button instead of \"Import\". This will take you to a second\npage.\n\nOn the second page, select a book from the list on the left and you will see search results from\nAmazon on the right. Select the search result that matches the selected book. If you don't see the\nbook that you want in the initial search results, change the query and click \"Search\" to see different\nresults.\n\nAfter you've selected the details once, you shouldn't need to select them again on future imports.\n\n![Importing Highlights](./docs/sample_import.gif)\n\n## Hiding Highlight ID Properties\n\nTo hide the highlight IDs, open settings and click \"Edit config.edn\". Towards\nthe bottom you'll see a comment about hiding specific properties, modify that\nsection to look like this:\n\n```\n ;; hide specific properties for blocks\n ;; E.g. #{:created-at :updated-at}\n :block-hidden-properties #{:highlight-id}\n```\n\n## Manual Installation\n\nYou can manually install this plugin by downloading the [latest release](https://github.com/theBenForce/logseq-plugin-my-highlights/releases). Download the `logseq-plugin-my-highlights-*.zip` file and unzip its contents to `USER_DIR/.logseq/plugins/logseq-plugin-my-highlights`. Now just reload logseq and you should see the \"My Highlights\" icon in your toolbar.\n\n## References\n  1. https://github.com/believer/kindle-highlights/tree/main/packages/parser\n  2. https://reactjsexample.com/logseq-plugin-boilerplate-w-react-vite/\n  3. https://github.com/hadynz/obsidian-kindle-plugin\n  4. https://www.npmjs.com/package/@hadynz/kindle-clippings\n\n## Support\n\nIf you find this plugin useful, please consider [buying me a coffee](https://www.buymeacoffee.com/theBenForce/e/80852).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthebenforce%2Flogseq-plugin-my-highlights","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fthebenforce%2Flogseq-plugin-my-highlights","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthebenforce%2Flogseq-plugin-my-highlights/lists"}