{"id":30722696,"url":"https://github.com/coderarjob/kpdfsync","last_synced_at":"2025-09-03T11:10:58.055Z","repository":{"id":44437471,"uuid":"454198144","full_name":"coderarjob/kpdfsync","owner":"coderarjob","description":"Annotates PDF files with the highlights and notes from Kindle Clippings.txt file.","archived":false,"fork":false,"pushed_at":"2023-03-13T17:35:30.000Z","size":19928,"stargazers_count":15,"open_issues_count":3,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2023-04-01T06:01:27.996Z","etag":null,"topics":["java","kindle","kindle-clippings","kindle-highlights","kindle-notes"],"latest_commit_sha":null,"homepage":"","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/coderarjob.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2022-01-31T23:00:53.000Z","updated_at":"2023-04-01T06:01:27.996Z","dependencies_parsed_at":"2023-02-09T20:30:38.994Z","dependency_job_id":null,"html_url":"https://github.com/coderarjob/kpdfsync","commit_stats":null,"previous_names":[],"tags_count":null,"template":null,"template_full_name":null,"purl":"pkg:github/coderarjob/kpdfsync","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/coderarjob%2Fkpdfsync","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/coderarjob%2Fkpdfsync/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/coderarjob%2Fkpdfsync/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/coderarjob%2Fkpdfsync/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/coderarjob","download_url":"https://codeload.github.com/coderarjob/kpdfsync/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/coderarjob%2Fkpdfsync/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":273431559,"owners_count":25104524,"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","status":"online","status_checked_at":"2025-09-03T02:00:09.631Z","response_time":76,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["java","kindle","kindle-clippings","kindle-highlights","kindle-notes"],"created_at":"2025-09-03T11:10:55.904Z","updated_at":"2025-09-03T11:10:58.047Z","avatar_url":"https://github.com/coderarjob.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"## About kpdfsync\n\n![Screenshot](/docs/images/screenshot_alpha.png)\n\nWhen reading PDF documents on Kindle, the major annoyance is that the it does not save the\nhighlights and notes on the files themselves.\n\nAs the highlights and notes can only seen on a Kindle, reading the PDF file in any other device is\nlike reading the file from the start. This also means that I cannot have backup of the file (with\nthe annotations from Kindle) or share it with anyone.\n\nThis software tries to provide a solution. **kpdfsync** reads the ‘My Clippings.txt’ text file for\nthe highlights and notes and then applies them in the correct place on a PDF file.\n\nCurrently it is **under development**, so all the features may not work or be present.\nThere can also be serious bugs present, so I **request you to keep backup of the files you give to\nkpdfsync (the clippings file and pdf files)**.\n\nHere is the rough roadmap of the development.\n\n## Roadmap\n\n- [X] Parsing the Clippings.txt file\n- [X] Search for the highlighted text in a page of the PDF file.\n- [X] Annotate highlight and notes on the PDF file.\n- [X] Graphical User Interface (GUI) testing.\n- [X] Highlights to notes mapping. This is required, because the clippings text file does not\n  provide information which can used to determine which notes are related to which highlight on a\n  single page. Some cases where a page contains a single note and highlight, automatic pairs are\n  created, however in cases where there are more than one note, these associations can be created\n  manually by the user.\n- [X] GUI finalizing for the Alpha release.\n- [X] Debug loggings\n- [X] **Alpha Release 1**\n\n----\n\n- [X] Bug Fixes\n- [X] Feature: Fixing common PDF errors.\n- [X] Usage guide for the end user.\n- [X] **Alpha Release 2**\n\n----\n\n- [X] Bug Fixes: Some common PDF bugs are now fixed.\n- [X] UI change to make it more suitable for screens with lower resolution.\n- [X] **Alpha Release 3**\n\n----\n\n- [X] Bug Fixes: Some minor fixes in UI\n- [X] Feature: Added new parser for reading older Kindle Clippings format.\n- [X] UI change to select different parsers.\n- [X] **Alpha Release 4**\n\n----\n\n- [ ] Fine tune the rough edges in the supporting library.\n- [ ] Memory/Resource optimization.\n- [ ] Finalizing and optimizing the Graphical User Interface.\n- [ ] **Beta Release**\n\n----\n\n## Installation\n\nOnce you have downloaded the [release binaries](https://github.com/coderarjob/kpdfsync/releases), and the minimum requirements are met,\nto start Kpdfsync, execute the `kpdfsync` file in Linux/Mac OS or `kpdfsync.bat` in Windows.\n\n### Minimum requirements\n- JRE 1.8 __Note: JRE headless will not work.__\n- Linux, Windows 7, Mac OS Sierra(\\*)\n- Linux: poppler-utils(\\*\\*)\n- Windows: poppler-utils(\\*\\*) is included with the release. (will work out of the box)\n\n(\\*) PDF fixing feature does not work on Mac OS.\n(\\*\\*) Required only for PDF fixing feature.\n\n----\n\n## Building from source\n\n### Minimum requirements\n- Linux, Windows 7, Mac OS Sierra\n- JDK 8\n- CMake 3.10\n\n### Steps\n\nClone the repo or download the source. Then to build, run the following command at the top-level of\nthe source directory.\n\nThis will build jar files in `build/bin` directory, then run `build/bin/coderarjob.kpdfsync.jar`.\n\n```\n$ cmake -Bbuild\n$ cd build\n$ cmake --build . run\n```\n\n----\n\n## Troubleshooting\n\n* (Windows) Error: api-ms-win-crt-runtime-l1-1-0.dll is missing.\nInstall (Update for Universal C Runtime)[https://support.microsoft.com/en-us/kb/2999226]\n\n## Troubleshooting\n\n### (Windows) Error: api-ms-win-crt-runtime-l1-1-0.dll is missing.\nInstall [Update for Universal C Runtime](https://support.microsoft.com/en-us/kb/2999226)\n\n## 3rd-party License\n\n* PDF Clown library is used to read and highlight on PDF files. PDF Clown library is covered under\nLGPL (GNU Lesser General Public License).\nMore information and source code can be found here [http://www.pdfclown.org](http://www.pdfclown.org)\n\n* Poppler is covered under GPL3 license.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcoderarjob%2Fkpdfsync","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcoderarjob%2Fkpdfsync","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcoderarjob%2Fkpdfsync/lists"}