Simple to use OpenPGP API based on Bouncycastle
You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Go to file
Paul Schaub 96da3db2b8
Set AES-128 as default symmetric algorithm.
The crypto-refresh marks AES-128 as MUST implement.
2 days ago
.github Add workflow for pull requests 1 month ago
.reuse Add manpages, script to generate manpages 10 months ago
LICENSES Fix licenses for gh pages layout stuff 10 months ago
_layouts Tweaks to layout 10 months ago
assets Add pages logo 10 months ago
config/checkstyle Reuse compliance 2 years ago
docs Update quickstart document 2 months ago
gradle/wrapper Bump gradlew to 7.5 5 months ago
misc Add missing accept rule to message format diagram 3 weeks ago
pgpainless-cli Report PGPainless version in sop version --backend 4 weeks ago
pgpainless-core Set AES-128 as default symmetric algorithm. 2 days ago
pgpainless-sop Replace more occurrences of new Date().getTime() with System.currentTimeMillis() 3 days ago
sop-java sop-java, sop-java-picocli placeholder readme: add links to codeberg 1 year ago
sop-java-picocli sop-java, sop-java-picocli placeholder readme: add links to codeberg 1 year ago
.editorconfig Reuse compliance 2 years ago
.gitignore Fix mermaid-cli cmd 11 months ago
.readthedocs.yaml Fix mermaid-cli cmd 11 months ago
.travis.yml Add reuse tool to CI 2 years ago Update changelog 1 month ago
CNAME Merge gh-pages stuff into main 10 months ago Reuse compliance 2 years ago
LICENSE Add licenses for external dependencies to LICENSE file 2 years ago PGPainless 1.5.2-rc1 1 month ago Update 4 months ago
_config.yml Exclude irrelevant md files from gh-pages 10 months ago
build.gradle compileJava: Add --release = 8 4 weeks ago
gradlew Declare gradle license via .reuse/dep5 2 years ago
gradlew.bat Declare gradle license via .reuse/dep5 2 years ago
settings.gradle Moved sop-java and sop-java-picocli to its own repositories 1 year ago
version.gradle PGPainless 1.5.2-rc2-SNAPSHOT 1 month ago

PGPainless - Use OpenPGP Painlessly!

Build Status Coverage Status Interoperability Test-Suite PGP REUSE status Documentation Status

PGPainless is an easy-to-use OpenPGP library for Java and Android applications

Packaging status Maven Central


PGPainless aims to make using OpenPGP in Java projects as simple as possible. It does so by introducing an intuitive Builder structure, which allows easy setup of encryption/decryption operations, as well as straight forward key generation.

PGPainless is based around the Bouncy Castle java library and can be used on Android down to API level 10. It can be configured to either use the Java Cryptographic Engine (JCE), or Bouncy Castles lightweight reimplementation.

While signature verification in Bouncy Castle is limited to signature correctness, PGPainless goes much further. It also checks if signing subkeys are properly bound to their primary key, if keys are expired or revoked, as well as if keys are allowed to create signatures in the first place.

These rigorous checks make PGPainless stand out from other Java-based OpenPGP libraries and are the reason why PGPainless currently scores second place on Sequoia-PGPs Interoperability Test-Suite.

At FlowCrypt we are using PGPainless in our Kotlin code bases on Android and on server side. The ergonomics of legacy PGP tooling on Java is not very good, and PGPainless improves it greatly. We were so happy with our initial tests and with Paul - the maintainer, that we decided to sponsor further development of this library.

-Tom @

Finally, testing irrefutably confirmed that the library removes many associated difficulties with PGP use in its provision of an approachable and uncomplicated API. In this regard, Paul Schaub deserves the utmost praise.

-Mario @

Get Started

The very easiest way to start using OpenPGP on Java/Kotlin based systems is to use an implementation of sop-java. sop-java defines a very stripped down API and is super easy to get started with. Luckily PGPainless provides an implementation for the sop-java interface definitions in the form of pgpainless-sop.

If you need more flexibility, directly using pgpainless-core is the way to go.


Most of PGPainless' features can be accessed directly from the PGPainless class. If you want to get started, this class is your friend :)

For further details you should check out the javadoc!

Handle Keys

Reading keys from ASCII armored strings or from binary files is easy:

        String key = "-----BEGIN PGP PRIVATE KEY BLOCK-----\n"...
        PGPSecretKeyRing secretKey = PGPainless.readKeyRing()

Similarly, keys can quickly be exported::

        PGPSecretKeyRing secretKey = ...;
        String armored = PGPainless.asciiArmor(secretKey);
        ByteArrayOutputStream binary = new ByteArrayOutputStream();

Extract a public key certificate from a secret key:

        PGPSecretKeyRing secretKey = ...;
        PGPPublicKeyRing certificate = PGPainless.extractCertificate(secretKey);

Easily Generate Keys

PGPainless comes with a simple to use KeyRingBuilder class that helps you to quickly generate modern OpenPGP keys. There are some predefined key archetypes, but it is possible to fully customize key generation to your needs.

        // RSA key without additional subkeys
        PGPSecretKeyRing secretKeys = PGPainless.generateKeyRing()
                .simpleRsaKeyRing("Juliet <juliet@montague.lit>", RsaLength._4096);
        // EdDSA primary key with EdDSA signing- and XDH encryption subkeys
        PGPSecretKeyRing secretKeys = PGPainless.generateKeyRing()
                .modernKeyRing("Romeo <romeo@montague.lit>", "I defy you, stars!");

        // Customized key
        PGPSecretKeyRing keyRing = PGPainless.buildKeyRing()
                        KeyFlag.SIGN_DATA, KeyFlag.CERTIFY_OTHER))
                        KeySpec.getBuilder(ECDSA.fromCurve(EllipticCurve._P256), KeyFlag.SIGN_DATA)
                                        KeyFlag.ENCRYPT_COMMS, KeyFlag.ENCRYPT_STORAGE)
                ).addUserId("Juliet <juliet@montague.lit>")

Encrypt and Sign Data

PGPainless makes it easy and painless to encrypt and/or sign data. Passed in keys are automatically evaluated, so that you don't accidentally encrypt to revoked or expired keys. PGPainless will furthermore detect which algorithms are supported by recipient keys and will negotiate algorithms accordingly. Still it allows you to manually specify which algorithms to use of course.

        EncryptionStream encryptionStream = PGPainless.encryptAndOrSign()
                                new EncryptionOptions()
                                        // optionally encrypt to a passphrase
                                        // optionally override symmetric encryption algorithm
                                new SigningOptions()
                                        // Sign in-line (using one-pass-signature packet)
                                        .addInlineSignature(secretKeyDecryptor, aliceSecKey, signatureType)
                                        // Sign using a detached signature
                                        .addDetachedSignature(secretKeyDecryptor, aliceSecKey, signatureType)
                                        // optionally override hash algorithm
                        ).setAsciiArmor(true) // Ascii armor or not

        Streams.pipeAll(plaintextInputStream, encryptionStream);

        // Information about the encryption (algorithms, detached signatures etc.)
        EncryptionResult result = encryptionStream.getResult();

Decrypt and Verify Signatures

Decrypting data and verifying signatures is being done similarly. PGPainless will not only verify correctness of signatures, but also if the signing key was allowed to create the signature. A key might not be allowed to create signatures if, for example, it expired or was revoked, or was not properly bound to the key ring. Furthermore, PGPainless will reject signatures made using weak algorithms like SHA-1. This behaviour can be modified though using the Policy class.

        DecryptionStream decryptionStream = PGPainless.decryptAndOrVerify()
                .withOptions(new ConsumerOptions()
                        .addDecryptionKey(bobSecKeys, secretKeyProtector)

        Streams.pipeAll(decryptionStream, outputStream);

        // Result contains information like signature status etc.
        OpenPgpMetadata metadata = decryptionStream.getResult();

After the DecryptionStream was closed, you can get metadata about the processed data by retrieving the OpenPgpMetadata. Again, this object will contain information about how the message was encrypted, who signed it and so on.

Many more examples can be found in the examples package!!!

Include PGPainless in your Project

PGPainless is available on maven central. In order to include it in your project, just add the maven central repository and add PGPainless as a dependency.

repositories {

dependencies {
	implementation 'org.pgpainless:pgpainless-core:1.5.2-rc1'

Professional Support

Do you need a custom feature? Are you unsure of what's the best way to integrate PGPainless into your product? We offer paid professional services. Don't hesitate to send an inquiry to


Join the projects IRC channel #pgpainless on OFTC if you have any questions!

PGPainless is developed in - and accepts contributions from - the following places:

We are using SemVer (MAJOR.MINOR.PATCH) versioning, although MINOR releases could contain breaking changes from time to time.

If you want to contribute a bug fix, please check the release/X.Y branches first to see, what the oldest release is which contains the bug you are fixing. That way we can update older revisions of the library easily.

Please follow the code of conduct if you want to be part of the project.


Development on PGPainless is generously sponsored by Thank you very very very much! FlowCrypt Logo

Parts of PGPainless development (project page) will be funded by NGI Assure through NLNet.
NGI Assure is made possible with financial support from the European Commission's Next Generation Internet programme, under the aegis of DG Communications Networks, Content and Technology. NGI Assure Logo

Thanks to YourKit for providing a free license of the YourKit Java Profiler to support PGPainless Development! YourKit Logo

Big thank you also to those who decided to support the work by donating!
Notably @msfjarvis

You make my day!