# look-like-scanned
[](https://github.com/navchandar/look-like-scanned/actions/workflows/pylint.yml) [](https://github.com/navchandar/look-like-scanned/actions/workflows/tests.yml)
[](https://github.com/navchandar/look-like-scanned/issues)
[](https://www.python.org/)
- Python script to make documents look like they were scanned.
- Local, Private, Secure, Open-Source and Transparent!
- Converts every page of a given PDF file into an image-based page and applies random askew and brightness (very mild) effects to simulate the appearance of scanned documents.
- The resulting pages are then combined back into an Output PDF file.
- There are options to combine / convert image files into PDF as well.
- Output PDF files are saved in the same folder with a suffix _"File_Name_output.pdf"_
## Installation
Install from the [Python Package Index (PyPI)](https://pypi.org/project/look-like-scanned/)
```shell
pip install look-like-scanned
```
Or to install latest version from GitHub
```shell
git clone https://github.com/navchandar/look-like-scanned.git
cd look-like-scanned
pip install poetry
poetry install
pip install .
```
### Verify Installation:
```shell
# Print help message and usage options available
scanner -h
```
## Usage
This package uses [PIL](https://pypi.org/project/Pillow/) and [pypdfium2](https://pypi.org/project/pypdfium2/) to convert and manipulate image and pdf objects.
This is extended to provide a command-line interface (CLI) for easy usage.
```shell
# Convert all pdf files in folder to scanned pdf
scanner -i .\tests
scanner -i .\tests -f "pdf"
# Convert all pdf files in folder to scanned without askew
scanner -i .\tests -a no
# Convert specific pdf file in folder to scanned pdf
scanner -i .\tests -f "test.pdf"
# Convert all jpg, jpeg, png, webp files in folder to one pdf file
scanner -i .\tests -f "image"
# Convert all image files in folder in the order of file names
scanner -i .\tests -f "image" -s "name"
# Convert all png files in folder to pdf with 100% quality to one pdf file
scanner -i .\tests -f "png" -q 100
# Convert specific jpg file in folder to pdf with 75% quality to one pdf file
scanner -i .\tests -f "JPG_Test.jpg" -q 75
# Convert all PDF files including sub folders
scanner -i .\tests -f "pdf" -r yes
# Convert all Images including sub folders into one PDF
scanner -i .\tests -f "image" -r yes
# Convert all PDF files including sub folders and save in black & white format
scanner -i .\tests -f "pdf" -r yes -b yes
# Convert all png files including sub folders and make it a little blurry
scanner -i .\tests -f "png" -r yes -b yes -l yes
```
## Arguments
These are the command-line arguments accepted:
- `-i, --input_folder` : Specifies the input folder to read files from and convert. The default value is the current directory.
- Example: `-i /path/to/files` or `-i C:\files\documents`
- `-f, --file_type_or_name` : Specifies the file types to process or the file name to convert. The default value is "pdf" to convert all pdf files in the given input folder.
- Example: `-f pdf` or `-f image.jpg` or `-f image`
- `-q, --file_quality` : Specifies the quality of the converted output files. The value must be between 50 and 100. The default value is 95.
- Example: `-q 90`
- `-a, --askew` : Controls whether to make the output documents slightly askew or slightly tilted. Accepted values are "yes" or "no". The default value is "yes".
- Example: `-a yes` or `--askew no`
- `-b, --black_and_white` : Controls whether to save output documents in black and white format (to make it look like a photocopy) . Accepted values are "yes" or "no". The default value is "no".
- Example: `-b yes` or `--black_and_white no`
- `-l, --blur` : Controls whether to make the output a little bit blurry. Accepted values are "yes" or "no". The default value is "no".
- Example: `-l yes` or `--blur no`
- `-r, --recurse` : Allows scripts to find all matching files including subdirectories. Accepted values are "yes" or "no". The default value is "yes".
- Example: `-r yes` or `--recurse no`
- `-s, --sort_by` : Allows scripts to sort the files based on name, creation time or modified time. Accepted values are "name", "ctime", "mtime", "none". The default value is "name". If "none" is selected, then the default order of files returned by the OS is used for document conversion.
- Example: `-s name` or `--sort_by none`
❗❗ **Note:** ❗❗
- The supported file types are: ".jpg", ".png", ".jpeg", ".webp", ".pdf".
- The output PDF file size **will be bigger** than the input file because the pages are stored in image format.
- Bookmarks / Links / Metadata will be removed when saving the output file.
- Transparency will be removed from png files when converting to pdf.
- Password protected PDF files are not yet supported.
- [Youtube: How to Insert a Signature on a PDF File](http://www.youtube.com/watch?v=FKlAwFcMutY)
## License
[MIT license](LICENSE)
## Support This Project
[](https://paypal.me/navchandar/)
[](https://www.buymeacoffee.com/navchandar/)
[](https://ko-fi.com/navchandar/)
Raw data
{
"_id": null,
"home_page": "https://navchandar.github.io/look-like-scanned/",
"name": "look-like-scanned",
"maintainer": null,
"docs_url": null,
"requires_python": "<4.0,>=3.8",
"maintainer_email": null,
"keywords": "pdf, scan, scanner, image-to-pdf, pdf-to-scan, convert-pdf",
"author": "navchandar",
"author_email": "12165092+navchandar@users.noreply.github.com",
"download_url": "https://files.pythonhosted.org/packages/1d/ce/e22a430b86d8d36929e55bbcde4968fdc53387ccfa91e86e08b6da03f3d9/look_like_scanned-1.0.5.tar.gz",
"platform": null,
"description": "# look-like-scanned\n\n[](https://github.com/navchandar/look-like-scanned/actions/workflows/pylint.yml) [](https://github.com/navchandar/look-like-scanned/actions/workflows/tests.yml)\n\n[](https://github.com/navchandar/look-like-scanned/issues)\n[](https://www.python.org/) \n\n - Python script to make documents look like they were scanned.\n\n - Local, Private, Secure, Open-Source and Transparent!\n\n - Converts every page of a given PDF file into an image-based page and applies random askew and brightness (very mild) effects to simulate the appearance of scanned documents.\n \n - The resulting pages are then combined back into an Output PDF file.\n\n - There are options to combine / convert image files into PDF as well.\n\n - Output PDF files are saved in the same folder with a suffix _\"File_Name_output.pdf\"_\n\n\n## Installation\n\nInstall from the [Python Package Index (PyPI)](https://pypi.org/project/look-like-scanned/)\n```shell\npip install look-like-scanned\n```\n\nOr to install latest version from GitHub\n```shell\ngit clone https://github.com/navchandar/look-like-scanned.git\ncd look-like-scanned\npip install poetry\npoetry install\npip install .\n```\n\n### Verify Installation:\n```shell\n# Print help message and usage options available\nscanner -h\n```\n\n\n## Usage\n\nThis package uses [PIL](https://pypi.org/project/Pillow/) and [pypdfium2](https://pypi.org/project/pypdfium2/) to convert and manipulate image and pdf objects.\n\nThis is extended to provide a command-line interface (CLI) for easy usage.\n\n\n```shell\n# Convert all pdf files in folder to scanned pdf\nscanner -i .\\tests\nscanner -i .\\tests -f \"pdf\"\n\n# Convert all pdf files in folder to scanned without askew\nscanner -i .\\tests -a no\n\n# Convert specific pdf file in folder to scanned pdf\nscanner -i .\\tests -f \"test.pdf\"\n\n# Convert all jpg, jpeg, png, webp files in folder to one pdf file\nscanner -i .\\tests -f \"image\"\n\n# Convert all image files in folder in the order of file names\nscanner -i .\\tests -f \"image\" -s \"name\"\n\n# Convert all png files in folder to pdf with 100% quality to one pdf file\nscanner -i .\\tests -f \"png\" -q 100\n\n# Convert specific jpg file in folder to pdf with 75% quality to one pdf file\nscanner -i .\\tests -f \"JPG_Test.jpg\" -q 75\n\n# Convert all PDF files including sub folders\nscanner -i .\\tests -f \"pdf\" -r yes\n\n# Convert all Images including sub folders into one PDF\nscanner -i .\\tests -f \"image\" -r yes\n\n# Convert all PDF files including sub folders and save in black & white format\nscanner -i .\\tests -f \"pdf\" -r yes -b yes\n\n# Convert all png files including sub folders and make it a little blurry\nscanner -i .\\tests -f \"png\" -r yes -b yes -l yes\n\n```\n\n## Arguments\n\nThese are the command-line arguments accepted:\n\n- `-i, --input_folder` : Specifies the input folder to read files from and convert. The default value is the current directory. \n - Example: `-i /path/to/files` or `-i C:\\files\\documents`\n\n- `-f, --file_type_or_name` : Specifies the file types to process or the file name to convert. The default value is \"pdf\" to convert all pdf files in the given input folder.\n - Example: `-f pdf` or `-f image.jpg` or `-f image`\n\n- `-q, --file_quality` : Specifies the quality of the converted output files. The value must be between 50 and 100. The default value is 95. \n - Example: `-q 90`\n\n- `-a, --askew` : Controls whether to make the output documents slightly askew or slightly tilted. Accepted values are \"yes\" or \"no\". The default value is \"yes\". \n - Example: `-a yes` or `--askew no`\n\n- `-b, --black_and_white` : Controls whether to save output documents in black and white format (to make it look like a photocopy) . Accepted values are \"yes\" or \"no\". The default value is \"no\". \n - Example: `-b yes` or `--black_and_white no`\n\n- `-l, --blur` : Controls whether to make the output a little bit blurry. Accepted values are \"yes\" or \"no\". The default value is \"no\". \n - Example: `-l yes` or `--blur no`\n\n- `-r, --recurse` : Allows scripts to find all matching files including subdirectories. Accepted values are \"yes\" or \"no\". The default value is \"yes\". \n - Example: `-r yes` or `--recurse no`\n\n- `-s, --sort_by` : Allows scripts to sort the files based on name, creation time or modified time. Accepted values are \"name\", \"ctime\", \"mtime\", \"none\". The default value is \"name\". If \"none\" is selected, then the default order of files returned by the OS is used for document conversion.\n - Example: `-s name` or `--sort_by none`\n\n\n\u2757\u2757 **Note:** \u2757\u2757\n\n- The supported file types are: \".jpg\", \".png\", \".jpeg\", \".webp\", \".pdf\".\n\n- The output PDF file size **will be bigger** than the input file because the pages are stored in image format.\n\n- Bookmarks / Links / Metadata will be removed when saving the output file.\n\n- Transparency will be removed from png files when converting to pdf.\n\n- Password protected PDF files are not yet supported.\n\n- [Youtube: How to Insert a Signature on a PDF File](http://www.youtube.com/watch?v=FKlAwFcMutY)\n\n\n## License\n \n [MIT license](LICENSE)\n\n\n## Support This Project\n\n[](https://paypal.me/navchandar/) \n[](https://www.buymeacoffee.com/navchandar/) \n[](https://ko-fi.com/navchandar/) \n\n",
"bugtrack_url": null,
"license": null,
"summary": "Python script to make documents look like they were scanned.",
"version": "1.0.5",
"project_urls": {
"Bug Tracker": "https://github.com/navchandar/look-like-scanned/issues",
"Funding": "https://www.buymeacoffee.com/navchandar/",
"Homepage": "https://navchandar.github.io/look-like-scanned/",
"Repository": "https://github.com/navchandar/look-like-scanned"
},
"split_keywords": [
"pdf",
" scan",
" scanner",
" image-to-pdf",
" pdf-to-scan",
" convert-pdf"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "774fcc2480797f5eb55e7d6c3d83358f508898af9b35c8c41052b8b9a409d96c",
"md5": "2d202a927a4ef90ca5e0491903d256ef",
"sha256": "0a239c4468464703ad471e3d4a9db38bc67db920455ceb068e401605be22204b"
},
"downloads": -1,
"filename": "look_like_scanned-1.0.5-py3-none-any.whl",
"has_sig": false,
"md5_digest": "2d202a927a4ef90ca5e0491903d256ef",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<4.0,>=3.8",
"size": 14207,
"upload_time": "2024-07-11T10:41:15",
"upload_time_iso_8601": "2024-07-11T10:41:15.886241Z",
"url": "https://files.pythonhosted.org/packages/77/4f/cc2480797f5eb55e7d6c3d83358f508898af9b35c8c41052b8b9a409d96c/look_like_scanned-1.0.5-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "1dcee22a430b86d8d36929e55bbcde4968fdc53387ccfa91e86e08b6da03f3d9",
"md5": "cb91fb02961795e41a9b2f9df82e5fbd",
"sha256": "eca2eeede41c1b808d295857c9505562398b32f99793c2f4d626cea25f9246b9"
},
"downloads": -1,
"filename": "look_like_scanned-1.0.5.tar.gz",
"has_sig": false,
"md5_digest": "cb91fb02961795e41a9b2f9df82e5fbd",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<4.0,>=3.8",
"size": 19270,
"upload_time": "2024-07-11T10:41:18",
"upload_time_iso_8601": "2024-07-11T10:41:18.072718Z",
"url": "https://files.pythonhosted.org/packages/1d/ce/e22a430b86d8d36929e55bbcde4968fdc53387ccfa91e86e08b6da03f3d9/look_like_scanned-1.0.5.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-07-11 10:41:18",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "navchandar",
"github_project": "look-like-scanned",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "look-like-scanned"
}
JSON
