{"id":15032111,"url":"https://github.com/librepdf/openpdf","last_synced_at":"2025-05-13T15:02:10.709Z","repository":{"id":38417692,"uuid":"63081349","full_name":"LibrePDF/OpenPDF","owner":"LibrePDF","description":"OpenPDF is a free Java library for creating and editing PDF files, with a LGPL and MPL open source license. OpenPDF is based on a fork of iText. We welcome contributions from other developers. Please feel free to submit pull-requests and bugreports to this GitHub repository.","archived":false,"fork":false,"pushed_at":"2024-11-27T06:09:15.000Z","size":38849,"stargazers_count":3847,"open_issues_count":176,"forks_count":640,"subscribers_count":77,"default_branch":"master","last_synced_at":"2025-05-05T22:15:10.446Z","etag":null,"topics":["hacktoberfest","itext","java","openpdf","pdf","pdf-generation"],"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/LibrePDF.png","metadata":{"files":{"readme":"README.md","changelog":"changelogs/1.3.27.md","contributing":"CONTRIBUTING.md","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,"zenodo":null}},"created_at":"2016-07-11T15:50:34.000Z","updated_at":"2025-05-05T01:37:23.000Z","dependencies_parsed_at":"2023-02-17T23:00:37.356Z","dependency_job_id":"c903c4fa-0101-4d08-b42f-aca93c555145","html_url":"https://github.com/LibrePDF/OpenPDF","commit_stats":{"total_commits":1394,"total_committers":176,"mean_commits":7.920454545454546,"dds":0.8048780487804879,"last_synced_commit":"00afd24a1e44520dc929187cf3840381f5ea8160"},"previous_names":[],"tags_count":80,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LibrePDF%2FOpenPDF","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LibrePDF%2FOpenPDF/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LibrePDF%2FOpenPDF/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LibrePDF%2FOpenPDF/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/LibrePDF","download_url":"https://codeload.github.com/LibrePDF/OpenPDF/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253968195,"owners_count":21992252,"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":["hacktoberfest","itext","java","openpdf","pdf","pdf-generation"],"created_at":"2024-09-24T20:17:21.513Z","updated_at":"2025-05-13T15:02:10.633Z","avatar_url":"https://github.com/LibrePDF.png","language":"Java","readme":"# OpenPDF is an open source Java library for PDF files\n\nOpenPDF is a Java library for creating and editing PDF files with a LGPL and MPL open source\nlicense. OpenPDF is the LGPL/MPL open source successor of iText, and is based on some forks of iText\n4 svn tag. We welcome contributions from other developers. Please feel free to submit pull-requests\nand bugreports to this GitHub repository.\n\n[![Maven Central](https://maven-badges.herokuapp.com/maven-central/com.github.librepdf/openpdf/badge.svg)](https://maven-badges.herokuapp.com/maven-central/com.github.librepdf/openpdf)\n![CI](https://github.com/LibrePDF/OpenPDF/actions/workflows/maven.yml/badge.svg)\n[![License (LGPL version 2.1)](https://img.shields.io/badge/license-GNU%20LGPL%20version%202.1-blue.svg?style=flat-square)](http://opensource.org/licenses/LGPL-2.1)\n[![License (MPL)](https://img.shields.io/badge/license-Mozilla%20Public%20License-yellow.svg?style=flat-square)](http://opensource.org/licenses/MPL-2.0)\n\n[![Codacy Badge](https://app.codacy.com/project/badge/Grade/791d40a437f64c77a0a802ae597a960c)](https://app.codacy.com/gh/LibrePDF/OpenPDF/dashboard?utm_source=gh\u0026utm_medium=referral\u0026utm_content=\u0026utm_campaign=Badge_grade)\n[![Codacy Badge](https://app.codacy.com/project/badge/Coverage/791d40a437f64c77a0a802ae597a960c)](https://app.codacy.com/gh/LibrePDF/OpenPDF/dashboard?utm_source=gh\u0026utm_medium=referral\u0026utm_content=\u0026utm_campaign=Badge_coverage)\n[![CodeQL](https://github.com/LibrePDF/OpenPDF/actions/workflows/codeql.yml/badge.svg)](https://github.com/LibrePDF/OpenPDF/actions/workflows/codeql.yml)\n[![Quality Gate Status](https://sonarcloud.io/api/project_badges/measure?project=LibrePDF_OpenPDF\u0026metric=alert_status)](https://sonarcloud.io/summary/new_code?id=LibrePDF_OpenPDF)\n[![CodeFactor](https://www.codefactor.io/repository/github/librepdf/openpdf/badge)](https://www.codefactor.io/repository/github/librepdf/openpdf)\n\n[![Join the chat at https://gitter.im/LibrePDF/OpenPDF](https://badges.gitter.im/LibrePDF/OpenPDF.svg)](https://gitter.im/LibrePDF/OpenPDF)\n\n## OpenPDF version 2.0.3 released 2024-08-07\n\nGet version 2.0.3 here: https://github.com/LibrePDF/OpenPDF/releases/tag/2.0.3\n\nPlease note: Repositories like Maven Central and others may take a few days to update.\n\n### Other versions\n\n- [OpenPDF 1.4.2 (release 2024-03-30)](https://github.com/LibrePDF/OpenPDF/releases/tag/1.4.2)\n- [OpenPDF 1.3.43 (release 2024-03-29)](https://github.com/LibrePDF/OpenPDF/releases/tag/1.3.43)\n- [Previous releases](https://github.com/LibrePDF/OpenPDF/releases)\n\n## Features\n\nSome of the features of OpenPDF include:\n\n* Creating PDFs: You can use OpenPDF to create new PDF documents from scratch.\n* Manipulating Existing PDFs: OpenPDF allows you to modify existing PDF documents by adding or removing pages, modifying\n  text, and more.\n* Text and Font Support: You can add text to PDF documents using various fonts and styles, and extract text from PDF\n  files.\n* Graphics and Images: OpenPDF supports the addition of images and graphics to PDF files.\n* Table Support: The library facilitates the creation of tables in PDF documents.\n* Encryption: You can encrypt PDF documents for security purposes.\n* Page Layout: OpenPDF allows you to set the page size, orientation, and other layout properties.\n\n## Use OpenPDF as Maven dependency\n\nAdd this to your pom.xml file to use the latest version of OpenPDF:\n\n```xml\n\n\u003cdependency\u003e\n  \u003cgroupId\u003ecom.github.librepdf\u003c/groupId\u003e\n  \u003cartifactId\u003eopenpdf\u003c/artifactId\u003e\n  \u003cversion\u003e2.0.3\u003c/version\u003e\n\u003c/dependency\u003e\n```\n\n## License\n\nOpenPDF uses dual licensing: when using the library, you may choose either Mozilla Public License Version 2.0\nor GNU Lesser General Public License 2.1.\n\nThe SPDX license identifier for OpenPDF licensing is `MPL-2.0 OR LGPL-2.1+`\n\n[GNU Lesser General Public License (LGPL), Version 2.1](https://www.gnu.org/licenses/old-licenses/lgpl-2.1)\n\n\u003e For a short explanation see https://en.wikipedia.org/wiki/GNU_Lesser_General_Public_License\n\n[Mozilla Public License Version 2.0](http://www.mozilla.org/MPL/2.0/)\n\n\u003e For a short explanation see https://en.wikipedia.org/wiki/Mozilla_Public_License\n\nYou can find also a nice explanation of these licenses under https://itsfoss.com/open-source-licenses-explained/\n\nWe want OpenPDF to consist of source code which is consistently licensed with the LGPL and MPL\nlicences only. This also means that any new contributions to the project must have a dual LGPL and\nMPL license only.\n\n## Documentation\n\n- [Examples](pdf-toolbox/src/test/java/com/lowagie/examples)\n- [JavaDoc](https://javadoc.io/doc/com.github.librepdf/openpdf/latest/index.html)\n- [Tutorial](https://github.com/LibrePDF/OpenPDF/wiki/Tutorial) (wiki, work in progress)\n- [Migration from iText, TIFF support](https://github.com/LibrePDF/OpenPDF/wiki/Migrating-from-iText-2-and-4)\n\n## Background\n\nOpenPDF is open source software with a LGPL and MPL license. It is a fork of iText version 4, more\nspecifically iText svn tag 4.2.0, which was hosted publicly on sourceforge with LGPL and MPL license\nheaders in the source code, and LGPL and MPL license documents in the svn repository. Beginning with\nversion 5.0 of iText, the developers have moved to the AGPL to improve their ability to sell\ncommercial licenses.\n\nOpenPDF ancestors in GitHub (in fork order):\n\n1. [@rtfarte](https://github.com/rtfarte) / [OpenPDF](https://github.com/rtfarte/OpenPDF) - parent\n   of LibrePDF/OpenPDF\n2. [@kulatamicuda](https://github.com/kulatamicuda)\n   / [iText-4.2.0](https://github.com/kulatamicuda/iText-4.2.0)\n3. [@daviddurand](https://github.com/daviddurand)\n   / [iText-4.2.0](https://github.com/daviddurand/iText-4.2.0)\n4. [@ymasory](https://github.com/ymasory) / [iText-4.2.0](https://github.com/ymasory/iText-4.2.0) -\n   original parent on GitHub\n\n## Projects using OpenPDF\n\n- [Spring Framework](https://github.com/spring-projects/spring-framework)\n- [flyingsaucer](https://github.com/flyingsaucerproject/flyingsaucer)\n- [Digital Signature Service](https://github.com/esig/dss)\n- Confluence PDF Export\n- OpenCMS, Nuxeo Web Framework, QR Invoice Library and many closed source commercial applications as\n  well.\n- Full list here: [Artifacts using OpenPDF](https://mvnrepository.com/artifact/com.github.librepdf/openpdf/usages)\n\n## Android\n\nOpenPDF can be used with Android, more info\nhere: [Android-support](https://github.com/LibrePDF/OpenPDF/wiki/Android-support)\n\n## Contributing\n\nRelease the hounds!  Please send all pull requests. Make sure that your contributions can be\nreleased with a dual LGPL and MPL license. In particular, pull requests to the OpenPDF project must\nonly contain code that you have written yourself. GPL or AGPL licensed code will not be acceptable.\n\nTo contribute code to the OpenPDF project, your GitHub account must contain your real name, so that\nwe can verify your identity. This is to ensure the trust, security and integrity of the OpenPDF\nproject, and to prevent security incidents such as the \"XZ Utils backdoor\". Knowning the real name\nof the contributors will also identify and prevent conflict of interests.\n\nMore details: [Contributing](CONTRIBUTING.md)\n\n### Coding Style\n\n- Code indentation style is 4 spaces. Maximum line length is 120 characters.\n- Generally try to preserve the coding style in the file you are modifying.\n\n## Dependencies\n\n### Required Dependencies\n\nWe have now different versions of OpenPDF, and they require different versions of Java:\n\n- The 2.0.x Branch requires Java 17 or later.\n- The 1.4.x Branch requires Java 11 or later.\n- The 1.3.x Branch requires Java 8 or later.\n- Some versions of 1.3 where release with Java 11 as minimum requirement, but we have reverted this\n  to Java 8 as minimum requirement.\n- OpenPDF versions 2.0.x: We are working on modernizing the OpenPDF library for Java\n  17+.\n\n### UTF-8 Fonts\n\nAs of 1.3.21 the UTF-8 Liberation fonts moved to its own module, to reduce the size of the OpenPDF\njar. If you want to use the bundled UTF-8 fonts, please add the following dependency to your project\nand use the class `org.librepdf.openpdf.fonts.Liberation`.\n\n```xml\n\n\u003cdependency\u003e\n  \u003cgroupId\u003ecom.github.librepdf\u003c/groupId\u003e\n  \u003cartifactId\u003eopenpdf-fonts-extra\u003c/artifactId\u003e\n  \u003cversion\u003e${openpdf.version}\u003c/version\u003e\n\u003c/dependency\u003e\n```\n\n### Supporting complex glyph substitution/ Ligature substitution\n\nOpenPDF supports glyph substitution which is required for correct rendering of fonts ligature substitution requirements.\nFOP dependency is required to enable this feature. Refer following wiki for\ndetails: [wiki](https://github.com/LibrePDF/OpenPDF/wiki/Multi-byte-character-language-support-with-TTF-fonts)\n\n### Supporting OpenType layout, glyph positioning, reordering and substitution\n\nOpenPDF supports OpenType layout, glyph positioning, reordering and substitution which is e.g. required for correct\npositioning of accents, the rendering of non-Latin and right-to-left scripts. OpenPDF supports DIN 91379.\nSee: [wiki](https://github.com/LibrePDF/OpenPDF/wiki/Accents,-DIN-91379,-non-Latin-scripts)\n\n### Optional\n\n- [BouncyCastle](https://www.bouncycastle.org/) (BouncyCastle is used to sign PDF files, so it's a recommended\n  dependency)\n  - Provider (`org.bouncycastle:bcprov-jdk18on` or `org.bouncycastle:bcprov-ext-jdk18on` depending\n    on which algorithm you are using)\n  - PKIX/CMS (`org.bouncycastle:bcpkix-jdk18on`)\n- Apache FOP (`org.apache.xmlgraphics:fop`)\n- Please refer to our [pom.xml](pom.xml) to see what version is needed.\n\n## Credits\n\nPlease see [Contributors.md](Contributors.md).\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flibrepdf%2Fopenpdf","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flibrepdf%2Fopenpdf","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flibrepdf%2Fopenpdf/lists"}