Metadata-Version: 2.4
Name: pyfile-convert
Version: 0.1.1
Summary: FileForge — a free, batteries-included file-conversion toolkit (CLI).
Author: K1LLLAGT
License: MIT
Project-URL: Homepage, https://github.com/K1LLLAGT/File-Forge
Project-URL: Repository, https://github.com/K1LLLAGT/File-Forge
Keywords: file,conversion,cli,pdf,image,ocr
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Environment :: Console
Classifier: Topic :: Utilities
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Provides-Extra: images
Requires-Dist: Pillow>=10.0; extra == "images"
Provides-Extra: pdf
Requires-Dist: pypdf>=4.0; extra == "pdf"
Provides-Extra: ocr
Requires-Dist: pytesseract>=0.3.10; extra == "ocr"
Requires-Dist: Pillow>=10.0; extra == "ocr"
Provides-Extra: tts
Requires-Dist: pyttsx3>=2.90; extra == "tts"
Provides-Extra: yaml
Requires-Dist: PyYAML>=6.0; extra == "yaml"
Provides-Extra: markdown
Requires-Dist: markdown>=3.5; extra == "markdown"
Provides-Extra: cloud
Requires-Dist: fastapi>=0.110; extra == "cloud"
Requires-Dist: uvicorn>=0.29; extra == "cloud"
Requires-Dist: python-multipart>=0.0.9; extra == "cloud"
Provides-Extra: server
Requires-Dist: fastapi>=0.110; extra == "server"
Requires-Dist: uvicorn>=0.29; extra == "server"
Requires-Dist: python-multipart>=0.0.9; extra == "server"
Provides-Extra: video
Requires-Dist: ffmpeg-python>=0.2; extra == "video"
Provides-Extra: pro
Requires-Dist: Pillow>=10.0; extra == "pro"
Requires-Dist: pypdf>=4.0; extra == "pro"
Requires-Dist: pytesseract>=0.3.10; extra == "pro"
Requires-Dist: pyttsx3>=2.90; extra == "pro"
Requires-Dist: PyYAML>=6.0; extra == "pro"
Requires-Dist: markdown>=3.5; extra == "pro"
Provides-Extra: dev
Requires-Dist: pytest>=8.0; extra == "dev"
Requires-Dist: pytest-cov>=5.0; extra == "dev"
Dynamic: license-file

# FileForge

**A multi-tier file-conversion product ecosystem** — one shared engine powering
a free CLI, a Pro desktop/Android build, a Cloud API, and Enterprise licensing.

![status](https://img.shields.io/badge/status-active-brightgreen)
![python](https://img.shields.io/badge/python-3.9%2B-blue)
![license](https://img.shields.io/badge/license-MIT%20(core)-green)

> The free CLI is fully functional and MIT-licensed. Pro / Cloud / Enterprise
> features unlock over the **same engine** with a license key.

---

## Quick start (free CLI)

```bash
pip install -e .            # or: pip install pyfile-convert  (once published; import/command stay `fileforge`)
fileforge list             # show conversions available to your tier
fileforge convert notes.md notes.html
fileforge convert data.json data.csv
fileforge convert report.txt report.pdf     # pure-Python PDF, no deps
```

Optional accelerators:

```bash
pip install -e '.[images]'   # PNG/JPG/WEBP/... via Pillow
pip install -e '.[pdf]'      # PDF merge/split (Pro)
pip install -e '.[ocr]'      # Tesseract OCR (Pro)
pip install -e '.[cloud]'    # run the Cloud API locally
```

## What's in the box

| Path                | Tier / Strategy                    | What it is                                   |
|---------------------|------------------------------------|----------------------------------------------|
| `src/fileforge/`    | Free CLI + shared engine           | Conversion registry, converters, licensing   |
| `src/fileforge/pro/`| Pro (batch, OCR, PDF, TTS)         | License-gated advanced features              |
| `cloud-api/`        | Strategy 3 & 7 — Cloud API         | FastAPI convert/formats/usage + metering     |
| `desktop/`          | Strategy 6 — Desktop GUI           | Tkinter reference GUI (PyQt/Electron in Pro) |
| `android/`          | Strategy 2 — Android GUI           | Compose + Chaquopy architecture & skeleton   |
| `magisk-module/`    | Strategy 9 — Magisk module         | Flashable system-wide install                |
| `scripts/`          | Fulfillment / packaging            | License issuing, Magisk zip builder          |
| `docs/monetization-plan.md` | Business document          | Full 10-strategy monetization & roadmap      |

## Tiers

| Tier           | Package                                      |
|----------------|----------------------------------------------|
| **Free**       | CLI tool                                     |
| **Pro**        | Advanced features, GUI, automation, cloud    |
| **Enterprise** | Licensing, API access, support, custom builds|

See **[docs/monetization-plan.md](docs/monetization-plan.md)** for the complete
pricing, feature matrix, distribution, marketing, revenue projections, and
six-month execution roadmap.

## Everything is free

FileForge is **completely free** — every feature (batch, parallel processing,
OCR, PDF merge/split, video presets, TTS) is available to everyone with no
license required:

```bash
fileforge batch ./images png jpg --recursive --workers 8
fileforge video clip.mov out.mp4 --preset web-720p
```

The Ed25519 licensing system and the license server are **kept in the repo but
dormant** — `licensing.require()` is a no-op, so nothing is gated. If you ever
want to reintroduce paid tiers, restore the tier check in
`src/fileforge/licensing.py` (the original code is preserved in a comment there)
and re-enable the `license-server/`.

## Run the Cloud API locally

```bash
pip install -e '.[cloud]'
cd cloud-api && uvicorn app.main:app --reload
# POST a file:
curl -s -H 'X-API-Key: demo-lifetime' \
     -F file=@notes.md 'http://127.0.0.1:8000/v1/convert?target=html' -o out.html
```

## Development

```bash
pip install -e '.[dev]'
pytest -q
```

## License

Core engine and CLI: **MIT** (see `LICENSE`). Pro/Cloud/Enterprise builds and
assets are commercial; see the monetization plan.
