{"id":21978138,"url":"https://github.com/codeterrayt/docx-comparison-tool","last_synced_at":"2025-03-23T00:27:35.268Z","repository":{"id":246495895,"uuid":"821295889","full_name":"codeterrayt/DOCX-Comparison-Tool","owner":"codeterrayt","description":"The DOCX Comparison Tool is an advanced utility designed to meticulously compare two DOCX files, providing both a similarity percentage and a detailed PDF report that highlights any discrepancies. This tool identifies and reports a wide range of errors","archived":false,"fork":false,"pushed_at":"2024-06-28T08:42:56.000Z","size":71,"stargazers_count":1,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-01-28T03:43:50.214Z","etag":null,"topics":["comparer","docx-comparer","docx-tool","python","python-gui","python-gui-tkinter","python-project","python-projects","python-tools","tkinter","tools","typing-test","typing-tester"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/codeterrayt.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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-06-28T08:19:03.000Z","updated_at":"2024-12-11T13:03:00.000Z","dependencies_parsed_at":"2024-06-28T10:12:51.455Z","dependency_job_id":null,"html_url":"https://github.com/codeterrayt/DOCX-Comparison-Tool","commit_stats":null,"previous_names":["codeterrayt/docx-comparison-tool"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codeterrayt%2FDOCX-Comparison-Tool","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codeterrayt%2FDOCX-Comparison-Tool/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codeterrayt%2FDOCX-Comparison-Tool/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codeterrayt%2FDOCX-Comparison-Tool/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/codeterrayt","download_url":"https://codeload.github.com/codeterrayt/DOCX-Comparison-Tool/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245040220,"owners_count":20551297,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["comparer","docx-comparer","docx-tool","python","python-gui","python-gui-tkinter","python-project","python-projects","python-tools","tkinter","tools","typing-test","typing-tester"],"created_at":"2024-11-29T16:18:06.300Z","updated_at":"2025-03-23T00:27:35.225Z","avatar_url":"https://github.com/codeterrayt.png","language":"Python","readme":"# DOCX Comparison Tool\n\n## Description\n\nThe DOCX Comparison Tool is an advanced utility designed to meticulously compare two DOCX files, providing both a similarity percentage and a detailed PDF report that highlights any discrepancies. This tool identifies and reports a wide range of errors, making it invaluable for proofreading and quality control. Key features include:\n\n- **Missing Punctuation:**\n  - Commas\n  - Periods (dots)\n  - Exclamation marks\n  - Single inverted commas\n  - Double inverted commas\n- **Incorrect Spacing:**\n  - Extra or missing spaces\n- **Typographical Errors:**\n  - Spelling mistakes\n\nIdeal for ensuring the accuracy of typed documents against their original versions, this application is perfect for anyone needing to maintain high standards of document fidelity.\n\n## Outputs \n### GUI Output \n\u003cimg src=\"https://github.com/codeterrayt/DOCX-Comparison-Tool/assets/76623307/b80ffd41-ab59-421b-b0df-a363eb07a3bc\" width=400 /\u003e\n\n### PDF REPORT OUTPUT \n\u003cimg src=\"https://github.com/codeterrayt/DOCX-Comparison-Tool/assets/76623307/6782962e-9eaf-439e-9dea-d6585db29376\" width=400 /\u003e\n\n## Installation Guide\n\n### Prerequisites\n\nBefore you begin, ensure that Python 3.12.1 is installed on your system. If not, download it from the official [Python website](https://www.python.org/downloads/).\n\n### Installation Steps\n\n1. **Clone the Repository**\n\n    Begin by cloning the repository to your local machine:\n\n    ```sh\n    git clone https://github.com/codeterrayt/DOCX-Comparison-Tool.git\n    cd DOCX-Comparison-Tool\n    ```\n2. **Create and Activate a Virtual Environment (venv)**\n\n    It is recommended to use a virtual environment to manage dependencies. Follow these steps:\n\n    - **Create a virtual environment:**\n\n        ```sh\n        python3 -m venv venv\n        ```\n\n    - **Activate the virtual environment:**\n\n        - On Windows:\n\n            ```sh\n            venv\\Scripts\\activate\n            ```\n\n        - On macOS/Linux:\n\n            ```sh\n            source venv/bin/activate\n            ```\n\n3. **Install Requirements**\n\n    Next, install all necessary packages from the `requirements.txt` file using pip:\n\n    ```sh\n    pip3 install -r requirements.txt\n    ```\n\n4. **Run the Main Script**\n\n    Finally, execute the main script to launch the application:\n\n    ```sh\n    python main.py\n    ```\n\n## Usage Instructions\n\nUsing the DOCX Comparison Tool is straightforward. Follow these steps:\n\n1. **First Input:** Select the actual DOCX file.\n2. **Second Input:** Select the written or typed DOCX file.\n\nOnce the inputs are provided, the application will:\n\n1. Compare the two DOCX files.\n2. Calculate and display the similarity percentage.\n3. Generate a comprehensive PDF report detailing errors such as missing punctuation, incorrect spacing, and typographical mistakes.\n\nThis powerful tool ensures your documents are accurate and professionally formatted, saving you time and improving your workflow.\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcodeterrayt%2Fdocx-comparison-tool","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcodeterrayt%2Fdocx-comparison-tool","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcodeterrayt%2Fdocx-comparison-tool/lists"}