{"id":26063673,"url":"https://github.com/gsidhu/winocr_cli","last_synced_at":"2026-04-17T18:33:27.556Z","repository":{"id":230726782,"uuid":"780020858","full_name":"gsidhu/winocr_cli","owner":"gsidhu","description":"A command line application to convert images/PDFs to text using Windows native OCR APIs","archived":false,"fork":false,"pushed_at":"2024-04-19T12:58:43.000Z","size":9,"stargazers_count":11,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-08T17:18:09.271Z","etag":null,"topics":["cli","ocr","windows"],"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/gsidhu.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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2024-03-31T13:26:49.000Z","updated_at":"2025-01-01T06:15:58.000Z","dependencies_parsed_at":"2024-03-31T14:42:38.651Z","dependency_job_id":null,"html_url":"https://github.com/gsidhu/winocr_cli","commit_stats":null,"previous_names":["gsidhu/winocr_cli"],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/gsidhu/winocr_cli","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gsidhu%2Fwinocr_cli","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gsidhu%2Fwinocr_cli/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gsidhu%2Fwinocr_cli/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gsidhu%2Fwinocr_cli/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/gsidhu","download_url":"https://codeload.github.com/gsidhu/winocr_cli/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gsidhu%2Fwinocr_cli/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31940944,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-17T17:29:20.459Z","status":"ssl_error","status_checked_at":"2026-04-17T17:28:47.801Z","response_time":62,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: 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":["cli","ocr","windows"],"created_at":"2025-03-08T17:18:18.213Z","updated_at":"2026-04-17T18:33:27.541Z","avatar_url":"https://github.com/gsidhu.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# winocr_cli: WinOCR Command Line Interface\nA minimal command line application for converting images and PDFs to text using Windows native OCR APIs.\n\nThe application is just a wrapper around the [winocr](https://github.com/GitHub30/winocr) Python package.\n\n## How to use it\n1. **Download the executable:** Download the `winocr_cli.exe` file from the [Releases](https://github.com/gsidhu/winocr_cli/releases) section of this repository.\n2. **Open Command Prompt or PowerShell:** Navigate to the directory where you downloaded the `winocr_cli.exe` file.\n3. **Run the command:** Use the following command syntax:\n```\nwinocr_cli.exe -l \"en\" -i \\path\\to\\image.png -o \\path\\to\\output.txt\n```\n- Replace `\\path\\to\\image.png` with the path to your input image file.\n- Replace `\\path\\to\\output.txt` with the path where you want to save the output text file.\n- Optionally, you can specify the language parameter `-l` (default is \"en\").\n- To process multiple input and output files, you can specify multiple pairs of input-output using the same command format:\n```\nwinocr_cli.exe -l \"en\" -i image1.png image2.png -o output1.txt output2.txt\n```\n\nOnce the command is executed, the output text file(s) will be generated at the specified location(s).\n\n## How to build it from source \n1. **Clone the repository.**\n2. **Install dependencies:** Navigate to the cloned directory and install the [required dependencies](#dependencies).\n3. **Run the script:** In the directory root, run this script using Python:\n```\npython winocr_cli.py -l \"en\" -i \\path\\to\\image.png -o \\path\\to\\output.txt\n```\n\nIf you are using `venv` on Windows, in Powershell, you may have to run `Set-ExecutionPolicy Unrestricted -Scope Process` before running `venv\\Scripts\\activate`.\n\nIf the script runs as expected, you can now build the app.\n\n4. **Build the app:** Run `pyinstaller --onefile winocr_cli.py` to build the executable. \n\nIf you get an error saying: _The term 'pyinstaller' is not recognized as the name of a cmdlet, function, script file, or operable program._, try running `python -m PyInstaller --onefile winocr_cli.py` instead.\n\n### Dependencies\n(Required) For building the app -\n- `winocr`\n- `pillow` (PIL)\n- `pdf2image`\n- `pyinstaller` (for creating the executable file)\n\n(Optional) For running the app -\n- `poppler` (for handling PDFs; run `winocr_cli.exe --setup` to download poppler in the default location)\n\n## Note\n- Ensure that the input image file exists and is accessible from the command line.\n- The application bundles all necessary dependencies, so there's no need to install them separately.\n- The executable might trigger security warnings on your machine. Feel free to bypass them to use the app. Or build it yourself from source.\n- Language support is constrained by the languages available on your Windows installation.\n\n## Contributing\nContributions are welcome! If you'd like to contribute to winocr_cli, please submit a pull request detailing the changes you made.\n\n## License\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE.txt) file for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgsidhu%2Fwinocr_cli","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgsidhu%2Fwinocr_cli","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgsidhu%2Fwinocr_cli/lists"}