README.md

TPPDF is a fast PDF builder for iOS & macOS using simple commands to create advanced documents!

_{Created and maintained by Philip Niedertscheider and all the amazing contributors.}

Features • Getting Started • Communication • Usage • Installation • Credits • License

Features

• Page header and footer
• Dynamic content layout with page alignment
• Support for tables and cell alignment
• Attributed strings
• Custom spacing
• Image support
• Horizontal line separators
• Custom indentation
• Custom top offset (good for layered rendering)
• Pagination
• Image caption
• Compress images
• Custom image size fit
• Images in the header and footer
• Horizontal line separators in the header and footer
• Generate PDF files directly to handle large PDF files (Details)
• PDF metadata
• Custom table styling
• Multi-column sections
• Swift Package Manager Support
• Tables with cell merging & automatic page breaking
• Hyperlinks in text
• Native progress tracking using Foundation.Progress

Getting Started

Building a PDF document is very easy:

First, you create a document with a paperformat...

let document = PDFDocument(format: .a4)

...then you add your information to a container...

document.add(.contentCenter, text: "Create PDF documents easily.")

...then you render the document...

let generator = PDFGenerator(document: document)
let url  = try generator.generateURL(filename: "Example.pdf")

...done!

If you need more details, checkout Usage.

Communication

Attention:

TPPDF is an Open Source side-project of techprimate. As we are currently working on multiple other projects, we only have limited time for fixing bugs and enhancing TPPDF.

That's why any issue reporting and especially Pull Requests are very welcome!

If you need professional support for your company, you can reach out to @philprimes on Twitter or on our website techprimate.com! This is mainly for custom or high-priority requests, therefore we won't publish a consulting pricing for now.

For everything else, please see Communication and this message. Thank you!

• If you need help, open an issue.
• If you found a bug, open an issue.
• If you have a feature request, open an issue.
• If you want to contribute, submit a pull request.

Example

Take a look at the Getting Started Guide or checkout the Examples (using of one of the following):

• Clone the repository and open the Examples.xcworkspace
• Run the Example macOS (SPM) or Example macOS (iOS)

Apps using TPPDF

If 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 :)

Burnout Coach by Stéphane Mégy	ChatHistory by techprimate	Hikingbook by Zheng-Xiang Ke	Bug Journal by David Johnson	EnergyTracker by Stefan Nebel	Lyrcs by ptrkstr

Credits

TPPDF is created and maintained by Philip Niedertscheider, co-founder of techprimate.

Contributors

Please consider backing this project by using the following GitHub Sponsor button.

We want to thank all contributors for their effort!