Skip to content

Kleopatra4Mac is an all-in-one prebuilt port of KDE's GPG utility for use on MacOS.

License

Notifications You must be signed in to change notification settings

algertc/homebrew-kleopatra4mac

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

37 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Contributors Forks Stargazers Issues MIT License


Logo

KDE Kleopatra GPG Utility for Mac
Report Bug · Contribute

Table of Contents
  1. About The Project
  2. Getting Started
  3. Roadmap
  4. Contributing
  5. License
  6. Acknowledgments





About The Project

WorkFlow

Kleopatra4Mac is an all-in-one prebuilt port of KDE's GPG utility for use on MacOS. Kleopatra is a certificate manager and a universal crypto GUI. It supports managing X.509 and OpenPGP certificates in the GpgSM keybox and retrieving certificates from LDAP servers.

Features:

  • Integrated Notepad
  • Smartcards
  • Simplified Certificate Management
  • Contacts

(back to top)

Getting Started

Prerequisites

  • Homebrew

    /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
  • GnuPG/GPG

    brew install gnupg

    **Must run gpg at least once to generate configs

  • GnuPG Pinentry

    brew install pinentry-mac

Installation

  • Precompiled Binaries (Recommended)

  1. Brew Install

    brew install algertc/kleopatra4mac/kleopatra
  • Build From Source (Advanced)

  1. Check the Brew "Bottle" Documentation for Full Explanation

  2. To Rebuild From Kleopatra.rb in This Repo

    brew install --build-from-source

  3. If You Decide to Make Changes, You Can Create Your Own New Bottle (Please Consider Submitting a Pull Request!)

    Bottles are produced by installing a formula with brew install --build-bottle <formula> and then bottling it with brew bottle <formula>

After Installation

The Following Section is For ARM/Apple Silicon. Intel Instructions Can Be Found Here

  1. Make Sure dbus is Running

    brew services start dbus
  2. Select pinentry-mac as the Default Program

    echo "pinentry-program /opt/homebrew/bin/pinentry-mac" > ~/.gnupg/gpg-agent.conf
    killall -9 gpg-agent
  3. If You Need to Have Kleopatra First in Your PATH, Run:

    echo 'export PATH="/opt/homebrew/opt/kleopatra/bin:$PATH"' >> ~/.zshrc

    (Note: Command here is for zshell)

  4. If You Want to Add This Application to the Launchpad, Run:

    cd /Applications && unzip /opt/homebrew/opt/kleopatra/app.zip
  5. Kleopatra is Keg-Only, Which Means it Was Not Symlinked Into /opt/homebrew to Prevent Conflicts With Any GPGme or KDE Libraries. If You Must Create a Symlink, Run:

    export LDFLAGS="-L/opt/homebrew/opt/kleopatra/lib"
    export CPPFLAGS="-I/opt/homebrew/opt/kleopatra/include"
  6. For compilers to find kleopatra, You May Need to Set:

    export LDFLAGS="-L/opt/homebrew/opt/kleopatra/lib"
    export CPPFLAGS="-I/opt/homebrew/opt/kleopatra/include"
  7. For pkg-config to Find Kleopatra, You May Need to Set:

    export PKG_CONFIG_PATH="/opt/homebrew/opt/kleopatra/lib/pkgconfig"

(back to top)

Roadmap

(back to top)

Contributing

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement". Don't forget to give the project a star! Thanks again!

  1. Fork the Project
  2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
  3. Commit your Changes (git commit -m 'Add some AmazingFeature')
  4. Push to the Branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

(back to top)

License

Distributed under the GPL 2.0 License. See LICENSE.txt for more information.

(back to top)

Acknowledgments

(back to top)