{"id":15009674,"url":"https://github.com/paolpal/pdfwizard","last_synced_at":"2026-02-07T04:01:19.277Z","repository":{"id":236987465,"uuid":"793369548","full_name":"paolpal/PDFWizard","owner":"paolpal","description":"Toolkit for pdf editing.","archived":false,"fork":false,"pushed_at":"2024-06-17T23:27:22.000Z","size":47,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-07-19T12:48:05.679Z","etag":null,"topics":["bleed","bleeding","fitz","mirror","mirror-bleeding","mirrorbleed","pdf","py","pymupdf","pypdf","python"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/paolpal.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-04-29T05:10:26.000Z","updated_at":"2024-06-17T23:18:05.000Z","dependencies_parsed_at":"2024-05-03T10:29:21.301Z","dependency_job_id":"b0dfbd39-7fbe-4e0a-97ad-f0384774e159","html_url":"https://github.com/paolpal/PDFWizard","commit_stats":null,"previous_names":["paolpal/pdfwizard"],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/paolpal/PDFWizard","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/paolpal%2FPDFWizard","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/paolpal%2FPDFWizard/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/paolpal%2FPDFWizard/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/paolpal%2FPDFWizard/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/paolpal","download_url":"https://codeload.github.com/paolpal/PDFWizard/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/paolpal%2FPDFWizard/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29186042,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-07T03:35:06.566Z","status":"ssl_error","status_checked_at":"2026-02-07T03:34:57.604Z","response_time":63,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bleed","bleeding","fitz","mirror","mirror-bleeding","mirrorbleed","pdf","py","pymupdf","pypdf","python"],"created_at":"2024-09-24T19:27:25.578Z","updated_at":"2026-02-07T04:01:19.261Z","avatar_url":"https://github.com/paolpal.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# PDFWizard - PDF Editing Toolkit\n\n## Description\nThis repository contains Python scripts for editing PDF files, particularly focusing on tasks like removing specific marks and resizing pages with bleeding. These scripts can be handy for individuals or businesses needing to manipulate PDF documents programmatically.\n\n## Contents\n1. **pdfwizard:** This directory contains scripts for modifying the content of PDF files.\n   - **mirrorer.py:** PDFMirrorer allows mirroring a PDF on vertical, horizontal, or both axes using PyPDF.\n   - **redactor.py:** PDFRedactor removes specific marks from PDF documents using PyMuPDF (fitz).\n   - **scaler.py:** PDFScaler modifies the page size of every page of the PDF using PyMuPDF (fitz).\n   - **bleeder.py:** PDFBleeder adds the bleed margin to the PDF.\n   - **\\_\\_main\\_\\_.py:** This script serves as a program that exposes the functionalities provided by the pdfwizard scripts for editing PDF files. It demonstrates how to utilize these functionalities effectively.\n\n## Installation\n\n```sh\ngit clone git@github.com:paolpal/PDFWizard.git\ncd PDFWizard\npip install .\n```\n\n### Uninstall\nTo uninstall PDFWizard, run:\n\n```sh\npip uninstall pdfwizard\n```\n\n## Usage\n\nTo use the PDF transformation tool, run `pdfwizard` with the following command-line arguments:\n\n```bash\npdfwizard -i input.pdf -o output.pdf -n \"string_to_remove\" -s Letter -b 9 --no-bleed\n```\n\n### Command-line arguments:\n- `-i, --input`: Specify the input PDF file.\n- `-o, --output`: Specify the output PDF file (default: out.pdf if not specified).\n- `-n, --needle`: Optional. Specify a string to remove from the PDF pages.\n- `-s, --size`: Optional. Specify the page size for resizing the PDF (Letter, Legal, etc.).\n- `-b, --bleed`: Optional. Specify the bleed value for PDF pages (default: 0).\n- `--no-bleed`: Optional flag. Disable bleeding for PDF pages.\n\n### Examples\n1. Resize a PDF to A4 size:\n\n```bash\npdfwizard -i input.pdf -s A4\n```\n2. Remove a watermark from a PDF:\n\n```bash\npdfwizard -i input.pdf -n \"Confidential\"\n```\n3. Apply bleeding and resize a PDF:\n\n```bash\npdfwizard -i input.pdf -s A4 -b 5\n```\n\n### Notes:\nAt least one of -n, -s, or -b must be provided for the tool to perform any action.\nIf -o is not specified, the output PDF will default to out.pdf.\nEnsure all paths to PDF files are correctly specified.\n\n## Dependencies\n- PyMuPDF\n- PyPDF\n- tqdm\n\n## Disclaimer\nThese scripts are intended for automated or batch processing of PDF files. Ensure that you have the necessary permissions to modify the PDF files and that you understand the implications of the transformations being applied. Always make backups of important files before performing any modifications.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpaolpal%2Fpdfwizard","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpaolpal%2Fpdfwizard","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpaolpal%2Fpdfwizard/lists"}