Metadata-Version: 2.4
Name: pdfuck
Version: 1.1.1
Summary: PDFuck: Remove the password of your PDF file. A tool to remove PDF editing password, which is used in CLI (command line) mode.
Author-email: JiJi <i@mmdjiji.com>
License-Expression: GPL-3.0
Project-URL: Homepage, https://github.com/mmdjiji/pdfuck
Classifier: Programming Language :: Python :: 3
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: pikepdf
Dynamic: license-file

![](assets/logo.svg)

**English** | [简体中文](README_zh.md) 

---

## Introduction

[PDFuck](https://github.com/mmdjiji/pdfuck) is a tool to remove PDF editing password, which is used in CLI (command line) mode.

## Installation

Before installing, please ensure that you have installed Python (>=3.8) and its matching version of pip, and then enter the following command at the command prompt:

```bash
pip install pdfuck
```

Or use [uv](https://docs.astral.sh/uv/) to run directly without installing:

```bash
uvx pdfuck
```

Note: If you use this method, subsequent usage will require adding `uvx` before the command. You can also set an alias for easier use:

```bash
alias pdfuck='uvx pdfuck'
```

## Usage

### Remove PDF password

For example, if you want to remove the password from the PDF file which is located in `example.pdf`, just enter the following command:

```bash
pdfuck example.pdf
```

The default path of the output file is `example.fucked.pdf`.

### Manually specify the output file path

If you want to specify the path of the output file manually, you can use the `-o` parameter, for example:

```bash
pdfuck example.pdf -o target.pdf
```

### PDF file requires opening password

Use the `-p` parameter to manually specify the opening password, for example:

```bash
pdfuck example.pdf -p password
```

## Credit

Thanks for the following open source projects. The completion of this project is inseparable from the code contributed by these authors.

* [pikepdf](https://github.com/pikepdf/pikepdf)

## Workflow

### Configure development environment

```bash
uv pip install -e .
```

### Build

```bash
uv build
```

## License

[GPL-3.0](LICENSE)
