Metadata-Version: 2.4
Name: pdfcipher
Version: 1.0.2
Summary: A command-line tool for encrypting and decrypting PDF files with password protection.
Author: James Cherti
License: GPL-3.0-or-later
Project-URL: Homepage, https://github.com/jamescherti/pdfcipher
Classifier: Development Status :: 5 - Production/Stable
Classifier: License :: OSI Approved :: GNU General Public License (GPL)
Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
Classifier: Environment :: Console
Classifier: Operating System :: POSIX :: Linux
Classifier: Operating System :: POSIX :: Other
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: System Administrators
Classifier: Intended Audience :: End Users/Desktop
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Security :: Cryptography
Classifier: Topic :: Utilities
Requires-Python: <4,>=3.6
Description-Content-Type: text/markdown

# pdfcipher - A command-line tool for encrypting and decrypting PDF files with password protection
[![License: GPL v3](https://img.shields.io/badge/License-GPLv3-blue.svg)](https://www.gnu.org/licenses/gpl-3.0)

The **pdfcipher** command-line tool enables encrypting and decrypting PDF files with password-based encryption. It allows users to set and remove passwords, ensuring secure access and distribution of PDF documents.

## Requirements

- The [qpdf](https://github.com/qpdf/qpdf) command-line tool.

## Installation

To install the *pdfcipher* executable locally in `~/.local/bin/` using [pip](https://pypi.org/project/pip/), run:
```
pip install --user pdfcipher
```

(Omitting the `--user` flag will install *pdfcipher* system-wide in `/usr/local/bin/`.)

## Usage

### Encrypt

Encrypt PDF files with password protection:
```
pdfcipher enc file1.pdf file2.pdf file3.pdf
```

The *pdfcipher* tool will prompt the user to enter a password, which will then be used to encrypt all the specified PDF files:

### Decrypt

Decrypt PDF files by entering the password used for encryption:
```
pdfcipher dec file1.pdf file2.pdf file3.pdf
```

If the entered password is correct, the tool will attempt to use it to decrypt all the other files. If any file fails to be decrypted, the tool will prompt you to re-enter the password for convenience.

## License

Copyright (c) 2023-2026 [James Cherti](https://www.jamescherti.com)

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see <https://www.gnu.org/licenses/>.

## Links

- [pdfcipher @GitHub](https://github.com/jamescherti/pdfcipher)
- [pdfcipher @PyPI](https://pypi.org/project/pdfcipher/)
