https://github.com/algertc/homebrew-kleopatra4mac
Kleopatra4Mac is an all-in-one prebuilt port of KDE's GPG utility for use on MacOS.
https://github.com/algertc/homebrew-kleopatra4mac
arm bottle crypto cryptography gnu gnupg gpg homebrew kde m1 m1-mac mac macos pgp
Last synced: 2 months ago
JSON representation
Kleopatra4Mac is an all-in-one prebuilt port of KDE's GPG utility for use on MacOS.
- Host: GitHub
- URL: https://github.com/algertc/homebrew-kleopatra4mac
- Owner: algertc
- License: gpl-2.0
- Created: 2022-08-15T02:21:12.000Z (almost 3 years ago)
- Default Branch: main
- Last Pushed: 2023-04-17T02:37:10.000Z (about 2 years ago)
- Last Synced: 2024-10-30T12:48:30.131Z (7 months ago)
- Topics: arm, bottle, crypto, cryptography, gnu, gnupg, gpg, homebrew, kde, m1, m1-mac, mac, macos, pgp
- Language: Ruby
- Homepage: https://github.com/KDE/kleopatra
- Size: 3.29 MB
- Stars: 72
- Watchers: 2
- Forks: 8
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- License: LICENSE.txt
Awesome Lists containing this project
README
[![Contributors][contributors-shield]][contributors-url] [![Forks][forks-shield]][forks-url] [![Stargazers][stars-shield]][stars-url] [![Issues][issues-shield]][issues-url] [![MIT License][license-shield]][license-url]
Table of Contents
## About The Project
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
## Getting Started
### Prerequisites
* [Homebrew](https://brew.sh/)
```sh
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
```
* [GnuPG/GPG](https://www.gnupg.org/)
```sh
brew install gnupg
```
**Must run gpg at least once to generate configs
* [GnuPG Pinentry](https://www.gnupg.org/related_software/pinentry/index.html)
```sh
brew install pinentry-mac
```
## Installation
* ### Precompiled Binaries (Recommended)
1. Brew Install
```sh
brew install algertc/kleopatra4mac/kleopatra
```
* ### Build From Source (Advanced)
2. Check the [Brew "Bottle" Documentation](https://docs.brew.sh/Bottles) for Full Explanation
3. To Rebuild From [*Kleopatra.rb*](https://github.com/algertc/homebrew-kleopatra4mac/blob/main/kleopatra.rb) in This Repo
`` brew install --build-from-source``
4. 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 ` and then bottling it with `brew bottle `
## After Installation
### ❗*The Following Section is For ARM/Apple Silicon. Intel Instructions Can Be Found [Here](https://github.com/algertc/homebrew-kleopatra4mac/blob/main/intel_instructions.md)*
1. Make Sure dbus is Running
```sh
brew services start dbus
```
2. Select pinentry-mac as the Default Program
```js
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:
```sh
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:
```sh
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:
```sh
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:
```sh
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:
```sh
export PKG_CONFIG_PATH="/opt/homebrew/opt/kleopatra/lib/pkgconfig"
```
## Roadmap
- [x] Dark mode
- [x] Universal Font
- [ ] Fix symlink spotlight search ranking
- [ ] Beautify/Modernize UI
- [ ] Mimic [Plasma Styling](https://kde.org/images/screenshots/kleopatra.png)
- [ ] Transparency
- [ ] Fix Unintended Pagination ([Issue #1](https://github.com/algertc/homebrew-kleopatra4mac/issues/1))
- [ ] Exclude Default Icon from KDE's "kiconthemes" and Point to: [Modernized Application Icon](https://github.com/algertc/homebrew-kleopatra4mac/blob/main/images/Icon.svg)
## 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
## License
Distributed under the GPL 2.0 License. See `LICENSE.txt` for more information.
## Acknowledgments
* [Vadim Panov](https://www.linkedin.com/in/vadim-panov-55a5a036)
[contributors-shield]: https://img.shields.io/github/contributors/algertc/kleopatra4mac.svg?style=for-the-badge
[contributors-url]: https://github.com/algertc/kleopatra4mac/graphs/contributors
[forks-shield]: https://img.shields.io/github/forks/algertc/kleopatra4mac.svg?style=for-the-badge
[forks-url]: https://github.com/algertc/kleopatra4mac/network/members
[stars-shield]: https://img.shields.io/github/stars/algertc/kleopatra4mac.svg?style=for-the-badge
[stars-url]: https://github.com/algertc/kleopatra4mac/stargazers
[issues-shield]: https://img.shields.io/github/issues/algertc/kleopatra4mac.svg?style=for-the-badge
[issues-url]: https://github.com/algertc/kleopatra4mac/issues
[license-shield]: https://img.shields.io/github/license/algertc/kleopatra4mac.svg?style=for-the-badge
[license-url]: https://github.com/algertc/kleopatra4mac/blob/master/LICENSE.txt
