{"id":1551,"url":"https://github.com/Techprimate/TPPDF","last_synced_at":"2025-08-02T04:31:52.550Z","repository":{"id":10446953,"uuid":"65774775","full_name":"techprimate/TPPDF","owner":"techprimate","description":"TPPDF is a simple-to-use PDF builder for iOS and macOS written in Swift","archived":false,"fork":false,"pushed_at":"2024-11-05T15:09:55.000Z","size":25900,"stargazers_count":741,"open_issues_count":32,"forks_count":125,"subscribers_count":18,"default_branch":"main","last_synced_at":"2024-11-06T09:09:54.679Z","etag":null,"topics":["builder","cocoapods","generator","ios","pdf","swift"],"latest_commit_sha":null,"homepage":"https://techprimate.github.io/TPPDF/","language":"Swift","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/techprimate.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","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},"funding":{"github":"philprime","custom":"https://www.paypal.me/tprm8"}},"created_at":"2016-08-16T00:43:33.000Z","updated_at":"2024-11-05T15:09:57.000Z","dependencies_parsed_at":"2024-02-25T10:23:36.495Z","dependency_job_id":"627326ed-dcd1-479d-9a21-d520ca58d749","html_url":"https://github.com/techprimate/TPPDF","commit_stats":{"total_commits":829,"total_committers":23,"mean_commits":36.04347826086956,"dds":"0.43908323281061523","last_synced_commit":"1955ebbc090a3fb2149fb53e703595c3146689af"},"previous_names":[],"tags_count":47,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/techprimate%2FTPPDF","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/techprimate%2FTPPDF/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/techprimate%2FTPPDF/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/techprimate%2FTPPDF/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/techprimate","download_url":"https://codeload.github.com/techprimate/TPPDF/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":228438976,"owners_count":17920017,"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":["builder","cocoapods","generator","ios","pdf","swift"],"created_at":"2024-01-05T20:15:49.609Z","updated_at":"2024-12-06T08:31:16.529Z","avatar_url":"https://github.com/techprimate.png","language":"Swift","readme":"\u003cp align=\"center\"\u003e\n\t\u003cimg src=\"https://raw.githubusercontent.com/techprimate/tppdf/main/resources/header.png\" alt=\"TPPDF\"\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n\t\u003cb\u003e\n\tTPPDF is a fast PDF builder for iOS \u0026 macOS using simple commands to create advanced documents!\n\t\u003c/b\u003e\n\u003c/p\u003e\n\n\u003cdiv align=\"center\"\u003e\n  \u003ca href=\"https://swiftpackageindex.com/techprimate/TPPDF\"\u003e\n    \u003cimg src=\"https://img.shields.io/endpoint?url=https%3A%2F%2Fswiftpackageindex.com%2Fapi%2Fpackages%2Ftechprimate%2FTPPDF%2Fbadge%3Ftype%3Dswift-versions\" alt=\"Supported Swift Versions\"\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://swiftpackageindex.com/techprimate/TPPDF\"\u003e\n    \u003cimg src=\"https://img.shields.io/endpoint?url=https%3A%2F%2Fswiftpackageindex.com%2Fapi%2Fpackages%2Ftechprimate%2FTPPDF%2Fbadge%3Ftype%3Dplatforms\" alt=\"Supported Platforms\"\u003e\n  \u003c/a\u003e\n\t\u003cimg src=\"https://img.shields.io/badge/license-MIT-lightgrey.svg?style=flat-square\" alt=\"License\"/\u003e\n\u003c/div\u003e\n\n\u003cdiv align=\"center\"\u003e\n\t\u003cimg src=\"https://img.shields.io/badge/SPM-compatible-brightgreen.svg?style=flat-square\" alt=\"Swift Package Manager\"/\u003e\n\t\u003cimg src=\"https://img.shields.io/cocoapods/v/TPPDF.svg?style=flat-square\" alt=\"Cocoapods\"/\u003e\n\t\u003cimg src=\"https://img.shields.io/badge/Carthage-compatible-blue.svg?style=flat-square\" alt=\"Carthage\"/\u003e\n\u003c/div\u003e\n\n\u003cp align=\"center\"\u003e\n    \u003csub\u003eCreated and maintained by \u003ca href=\"https://github.com/philprime\"\u003ePhilip Niedertscheider\u003c/a\u003e and all the amazing \u003ca href=\"https://github.com/techprimate/TPPDF/graphs/contributors\"\u003econtributors\u003c/a\u003e.\u003c/sub\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"#features\"\u003eFeatures\u003c/a\u003e\n  • \u003ca href=\"#getting-started\"\u003eGetting Started\u003c/a\u003e\n  • \u003ca href=\"#communication\"\u003eCommunication\u003c/a\u003e\n  • \u003ca href=\"https://github.com/techprimate/TPPDF/blob/main/Documentation/Usage.md\"\u003e\u003cstrong\u003eUsage\u003c/strong\u003e\u003c/a\u003e\n  • \u003ca href=\"https://github.com/techprimate/TPPDF/blob/main/Documentation/Installation.md\"\u003eInstallation\u003c/a\u003e\n  • \u003ca href=\"#credits\"\u003eCredits\u003c/a\u003e\n  • \u003ca href=\"https://github.com/techprimate/TPPDF/blob/master/LICENSE\"\u003eLicense\u003c/a\u003e\n\u003c/p\u003e\n\n## Features\n\n- [x] Page header and footer\n- [x] Dynamic content layout with page alignment\n- [x] Support for tables and cell alignment\n- [x] Attributed strings\n- [x] Custom spacing\n- [x] Image support\n- [x] Horizontal line separators\n- [x] Custom indentation\n- [x] Custom top offset (good for layered rendering)\n- [x] Pagination\n- [x] Image caption\n- [x] Compress images\n- [x] Custom image size fit\n- [x] Images in the header and footer\n- [x] Horizontal line separators in the header and footer\n- [x] Generate PDF files directly to handle large PDF files ([Details](http://stackoverflow.com/questions/14691264/how-can-i-lower-memory-climb-when-generating-large-pdfs))\n- [x] PDF metadata\n- [x] Custom table styling\n- [x] Multi-column sections\n- [x] Swift Package Manager Support\n- [x] Tables with cell merging \u0026 automatic page breaking\n- [x] Hyperlinks in text\n- [x] Native progress tracking using `Foundation.Progress`\n\n## Getting Started\n\nBuilding a PDF document is very easy:\n\nFirst, you create a document with a paperformat...\n\n```swift\nlet document = PDFDocument(format: .a4)\n```\n\n...then you add your information to a container...\n\n```swift\ndocument.add(.contentCenter, text: \"Create PDF documents easily.\")\n```\n\n...then you render the document...\n\n```swift\nlet generator = PDFGenerator(document: document)\nlet url  = try generator.generateURL(filename: \"Example.pdf\")\n```\n\n**...done!**\n\nIf you need more details, checkout [Usage](https://github.com/techprimate/TPPDF/blob/main/Documentation/Usage.md).\n\n## Communication\n\n**Attention:**\n\nTPPDF is an Open Source side-project of [techprimate](https://techprimate.com/).\nAs we are currently working on multiple other projects, we only have limited time for fixing bugs and enhancing TPPDF.\n\nThat's why any issue reporting and especially **Pull Requests** are very welcome!\n\nIf you need professional support for your company, you can reach out to [@philprimes](https://twitter.com/philprimes) on Twitter or on our website [techprimate.com](https://techprimate.com/contact)!\nThis is mainly for custom or high-priority requests, therefore we won't publish a consulting pricing for now.\n\nFor everything else, please see [Communication](#communication) and [this message](https://github.com/techprimate/TPPDF/issues/250). Thank you!\n\n- If you **need help**, open an [issue](https://github.com/techprimate/TPPDF/issues/new?template=bug_report.md).\n- If you **found a bug**, open an [issue](https://github.com/techprimate/TPPDF/issues/new?template=bug_report.md).\n- If you **have a feature request**, open an [issue](https://github.com/techprimate/TPPDF/issues/new?template=feature_request.md).\n- If you **want to contribute**, submit a [pull request](https://github.com/techprimate/TPPDF/compare).\n\n## Example\n\nTake a look at the [Getting Started Guide](https://github.com/techprimate/TPPDF/blob/main/Documentation/Usage.md#getting-started) or checkout the Examples (using of one of the following):\n\n- Clone the repository and open the `Examples.xcworkspace`\n- Run the `Example macOS (SPM)` or `Example macOS (iOS)`\n\n## Apps using TPPDF\n\nIf you are using TPPDF in your app and want to be listed here, simply create a pull request or let us know on Twitter or via GitHub. We are always curious to see, who is using our project :)\n\n\u003ctable\u003e\n  \u003ctr\u003e\n    \u003ctd align=\"center\"\u003e\n      \u003ca href=\"https://itunes.apple.com/app/id1495886665\"\u003e\n        \u003cimg src=\"https://raw.githubusercontent.com/techprimate/TPPDF/main/resources/apps/BurnoutCoach.png\" alt=\"Burnout Coach\"/\u003e\n      \u003c/a\u003e\n    \u003c/td\u003e\n    \u003ctd align=\"center\"\u003e\n      \u003ca href=\"https://itunes.apple.com/app/id1464880768\"\u003e\n        \u003cimg src=\"https://raw.githubusercontent.com/techprimate/TPPDF/main/resources/apps/ChatHistory.png\" alt=\"ChatHistory\"/\u003e\n      \u003c/a\u003e\n    \u003c/td\u003e\n    \u003ctd align=\"center\"\u003e\n      \u003ca href=\"https://itunes.apple.com/app/id1464880768\"\u003e\n        \u003cimg src=\"https://raw.githubusercontent.com/techprimate/tppdf/main/resources/apps/Hikingbook.png\" alt=\"Hikingbook\"/\u003e\n      \u003c/a\u003e\n    \u003c/td\u003e\n    \u003ctd align=\"center\"\u003e\n      \u003ca href=\"https://itunes.apple.com/us/app/bug-journal/id1232077952\"\u003e\n        \u003cimg src=\"https://raw.githubusercontent.com/techprimate/tppdf/main/resources/apps/Bug_Journal.png\" alt=\"Bug Journal\"/\u003e\n      \u003c/a\u003e\n    \u003c/td\u003e\n    \u003ctd align=\"center\"\u003e\n      \u003ca href=\"https://itunes.apple.com/de/app/energy-tracker/id1193010972\"\u003e\n        \u003cimg src=\"https://raw.githubusercontent.com/techprimate/tppdf/main/resources/apps/EnergyTracker.jpg\" alt=\"EnergyTracker\"/\u003e\n      \u003c/a\u003e\n    \u003c/td\u003e\n  \t\u003ctd align=\"center\"\u003e\n      \u003ca href=\"https://apps.apple.com/us/app/lyrcs/id1599888045\"\u003e\n        \u003cimg src=\"https://raw.githubusercontent.com/techprimate/tppdf/main/resources/apps/Lyrcs.svg\" alt=\"Lyrcs\" height=120 /\u003e\n      \u003c/a\u003e\n    \u003c/td\u003e\n  \u003c/tr\u003e\n  \u003ctr\u003e\n    \u003ctd align=\"center\"\u003e\n      \u003ca href=\"https://itunes.apple.com/app/id1464880768\"\u003eBurnout Coach\u003c/strong\u003e\u003c/a\u003e\u003cbr\u003e\n      by Stéphane Mégy\n    \u003c/td\u003e\n    \u003ctd align=\"center\"\u003e\n      \u003ca href=\"https://itunes.apple.com/app/id1464880768\"\u003eChatHistory\u003c/a\u003e\u003cbr\u003e\n      by techprimate\n    \u003c/td\u003e\n    \u003ctd align=\"center\"\u003e\n      \u003ca href=\"https://itunes.apple.com/app/id1067838748\"\u003eHikingbook\u003c/a\u003e\u003cbr\u003e\n      by Zheng-Xiang Ke\n    \u003c/td\u003e\n    \u003ctd align=\"center\"\u003e\n      \u003ca href=\"https://itunes.apple.com/us/app/bug-journal/id1232077952\"\u003eBug Journal\u003c/a\u003e\u003cbr\u003e\n      by David Johnson\n    \u003c/td\u003e\n    \u003ctd align=\"center\"\u003e\n      \u003ca href=\"https://itunes.apple.com/de/app/energy-tracker/id1193010972\"\u003eEnergyTracker\u003c/a\u003e\u003cbr\u003e\n      by Stefan Nebel\n    \u003c/td\u003e\n    \u003ctd align=\"center\"\u003e\n      \u003ca href=\"https://apps.apple.com/us/app/lyrcs/id1599888045\"\u003eLyrcs\u003c/a\u003e\u003cbr\u003e\n      by ptrkstr\n    \u003c/td\u003e\n  \u003c/tr\u003e\n\u003c/table\u003e\n\n## Credits\n\nTPPDF is created and maintained by Philip Niedertscheider, co-founder of [techprimate](https://www.github.com/techprimate).\n\n\u003cp align=\"center\"\u003e\n\t\u003ca href=\"https://www.techprimate.com\"\u003e\n\t\t\u003cimg src=\"https://img.shields.io/badge/www-techprimate.com-lightgrey.svg?style=flat-square\" alt=\"techprimate.com\"\u003e\n\t\u003c/a\u003e\n\t\u003ca href=\"http://twitter.com/techprimate\"\u003e\n\t    \u003cimg src=\"https://img.shields.io/badge/twitter-@techprimate-blue.svg?style=flat-square\" alt=\"twitter\"\u003e\n\t\u003c/a\u003e\n\u003c/p\u003e\n\n### Contributors\n\nPlease consider backing this project by using the following **GitHub Sponsor** button.\n\nWe want to thank all [contributors](https://github.com/techprimate/TPPDF/graphs/contributors) for their effort!\n\n\u003ca href=\"https://github.com/techprimate/TPPDF/graphs/contributors\"\u003e\n  \u003cimg src=\"https://contributors-img.web.app/image?repo=techprimate/TPPDF\" /\u003e\n\u003c/a\u003e\n","funding_links":["https://github.com/sponsors/philprime","https://www.paypal.me/tprm8"],"categories":["Media"],"sub_categories":["PDF","Other free courses"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FTechprimate%2FTPPDF","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FTechprimate%2FTPPDF","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FTechprimate%2FTPPDF/lists"}