{"id":20347790,"url":"https://github.com/itext/xfdf-merger","last_synced_at":"2026-02-23T08:34:37.582Z","repository":{"id":84629935,"uuid":"460812202","full_name":"itext/xfdf-merger","owner":"itext","description":"XFDF annotation merging tool","archived":false,"fork":false,"pushed_at":"2023-01-13T13:47:36.000Z","size":47,"stargazers_count":4,"open_issues_count":0,"forks_count":1,"subscribers_count":8,"default_branch":"master","last_synced_at":"2026-01-28T09:58:43.903Z","etag":null,"topics":["annotations","itext","pdf","xfdf"],"latest_commit_sha":null,"homepage":"","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/itext.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":"CODE_OF_CONDUCT.md","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}},"created_at":"2022-02-18T10:42:48.000Z","updated_at":"2025-11-17T15:55:55.000Z","dependencies_parsed_at":null,"dependency_job_id":"8de8257c-42d7-474e-a959-dd54fb103065","html_url":"https://github.com/itext/xfdf-merger","commit_stats":null,"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/itext/xfdf-merger","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/itext%2Fxfdf-merger","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/itext%2Fxfdf-merger/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/itext%2Fxfdf-merger/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/itext%2Fxfdf-merger/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/itext","download_url":"https://codeload.github.com/itext/xfdf-merger/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/itext%2Fxfdf-merger/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29740026,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-23T07:44:07.782Z","status":"ssl_error","status_checked_at":"2026-02-23T07:44:07.432Z","response_time":90,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":["annotations","itext","pdf","xfdf"],"created_at":"2024-11-14T22:18:07.542Z","updated_at":"2026-02-23T08:34:37.562Z","avatar_url":"https://github.com/itext.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# XFDF annotation merging tool\n\n## Summary\n\nThis repository contains an experimental command-line tool to merge XFDF\nannotations into a PDF document. It's specifically geared towards annotations\nused for document review and errata processing.\n\nThe merge tool will process annotations of the following types:\n\n - **Caret**\n - **Text**\n - **Highlight**\n - **Squiggly**\n - **Underline**\n - **StrikeOut**\n - **Stamp**\n - **FreeText**\n\nThe positioning of the annotations in the final document can be manipulated\nto a degree. Concretely, the tool supports\n\n - shifting the page numbers to which the annotations are applied;\n - scaling the annotations' coordinates by a constant factor;\n - translating the annotations' coordinates by a constant vector.\n\n## Building\n\nThe project builds with Maven. After cloning, run the following command:\n\n```bash\nmvn package\n```\n\nIf the build finishes successfully, the `target` folder should contain two\n`.jar` files: `xfdf-merge-\u003cVERSION\u003e.jar` and\n`xfdf-merge-\u003cVERSION\u003e-jar-with-dependencies.jar`. Both are executable JAR\nfiles, but the latter includes all relevant dependencies.\n\n\n## Usage\n\nAfter building, the merge tool can be invoked as follows:\n\n```bash\n./xfdfmerge.sh input.pdf input.xfdf output.pdf [transform]\n```\n\nAlternatively:\n\n```bash\njava -jar target/xfdf-merge-\u003cVERSION\u003e-jar-with-dependencies.jar input.pdf input.xfdf output.pdf [transform]\n```\n\nParameters:\n\n - `input.pdf`: the input PDF document;\n - `input.xfdf`: the XFDF document containing the annotations to apply;\n - `output.pdf`: the output PDF document (will be overwritten);\n - `transform`: an optional transformation string (see below).\n\nThe optional transformation string takes the form\n`PGNUMSHIFT/XSHIFT/YSHIFT/SCALE`. If a transformation string is supplied, all\nparts must be present. They are processed as follows:\n\n - `PGNUMSHIFT`: constant integer added to the page numbers in the XFDF file\n    before applying annotations;\n - `XSHIFT,YSHIFT,SCALE`: geometric transformation parameters applied to \n   annotations before rendering.\n\nMore precisely, the following affine transformation is applied to all\nannotation coordinates: `(x, y) -\u003e (SCALE * x + XSHIFT, SCALE * y + YSHIFT)`.\nIn other words, the effective default value of `transform` is `0/0/0/1`.\n\n\n## Disclaimer\n\nThis is an experimental tool, not an iText product. It is provided to the\ncommunity under the terms of the AGPL (see [LICENSE](LICENSE.md)) on an as-is\nbasis.\n\n\n## Versioning\n\nPursuant to the disclaimer in the previous section, there are no stability\nguarantees between different versions or builds. However, since the release\nscript ensures that the build date is always embedded into the build version\nnumber, you can always tell which build is the most recent.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fitext%2Fxfdf-merger","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fitext%2Fxfdf-merger","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fitext%2Fxfdf-merger/lists"}