Metadata-Version: 2.4
Name: merge-front-back
Version: 1.0.0b2
Summary: Merge two single-sided scanned PDFs into a duplex document
Author-email: Doug Ransom <doug@ransom.vip>
Requires-Python: >=3.14
Description-Content-Type: text/markdown
Requires-Dist: pypdf>=4.0.0

# merge-front-back

Command line program merge_front_back to merge two single-sided scanned PDFs into a duplex document.

Scan the odd pages first with your scanner.  Flip your stack of paper over and scan the even pages into a seperate document.  The pages will be scanned in reverse order.  

Use merge_front_back to interleave the pages into a propertly ordered PDF.

Instructions are available, run the command without arguments:

```powershell
merge_front_back  
```



## Installation

### For General Use on an Operating system.

Install pipx if you don't already have it installed:  https://github.com/pypa/pipx.  

Install merge-front-back
```powershell
pipx install merge-front-back
```
#### On Windows
On Windows you can use this to install pipx:

Install [Scoop](https://scoop.sh/):

```powershell
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
Invoke-RestMethod -Uri https://get.scoop.sh | Invoke-Expression
```
.  

Install a systemwide Python.
If you have uv installed:
```powershell
uv python install --default
```
 Otherwise [install Python](https://www.python.org/downloads/windows/).

Install [pipx](https://github.com/pypa/pipx):
```powershell
scoop install pipx
pipx ensurepath
```

Now install merge-front-back:

```powershell
pipx install merge-front-back
```

### For Use in a Specific Python Enviornment 

This project uses Python packaging and is compatible with [uv](https://github.com/astral-sh/uv).  

For an editiable install:

```powershell
uv venv
source .venv/bin/activate
uv pip install -e .
```

To simply install in your current Python environment:
```powershell
pip install merge-front-back
```
