{"id":24541297,"url":"https://github.com/1999azzar/doc-converter","last_synced_at":"2025-07-19T07:09:49.911Z","repository":{"id":273232528,"uuid":"919061902","full_name":"1999AZZAR/doc-converter","owner":"1999AZZAR","description":null,"archived":false,"fork":false,"pushed_at":"2025-02-24T13:05:39.000Z","size":157,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-03-16T05:44:11.159Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"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/1999AZZAR.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":"2025-01-19T16:02:47.000Z","updated_at":"2025-02-24T13:05:43.000Z","dependencies_parsed_at":null,"dependency_job_id":"86296026-6841-4687-80d3-cf1a3068d2bc","html_url":"https://github.com/1999AZZAR/doc-converter","commit_stats":null,"previous_names":["1999azzar/doc-converter"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/1999AZZAR/doc-converter","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/1999AZZAR%2Fdoc-converter","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/1999AZZAR%2Fdoc-converter/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/1999AZZAR%2Fdoc-converter/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/1999AZZAR%2Fdoc-converter/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/1999AZZAR","download_url":"https://codeload.github.com/1999AZZAR/doc-converter/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/1999AZZAR%2Fdoc-converter/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":265899940,"owners_count":23845879,"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":[],"created_at":"2025-01-22T18:17:29.687Z","updated_at":"2025-07-19T07:09:49.886Z","avatar_url":"https://github.com/1999AZZAR.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Doc Converter\n\n**Doc Converter** is a simple, cross-platform desktop application built with PyQt6 that allows users to convert documents between various formats, including **Markdown (`.md`)**, **Word (`.docx`)**, **OpenDocument (`.odt`)**, and **LaTeX (`.latex`)**. The application features a dark theme and provides a user-friendly interface for managing and converting files.\n\n------------------------------------------------------------------------\n\n## Features\n\n-   **Multi-Format Support**: Convert files between Markdown, Word, OpenDocument, and LaTeX formats.\n-   **Batch Conversion**: Convert multiple files at once.\n-   **File Preview**: Preview the content of selected files before conversion.\n-   **Dark Theme**: A sleek, modern dark theme for comfortable usage.\n-   **Progress Feedback**: A progress bar shows the status of the conversion process.\n-   **Cross-Platform**: Works on Windows, macOS, and Linux.\n\n------------------------------------------------------------------------\n\n## Supported Formats\n\n  Input Formats           Output Formats\n  ----------------------- -----------------------\n  Markdown (`.md`)        Markdown (`.md`)\n  Word (`.docx`)          Word (`.docx`)\n  OpenDocument (`.odt`)   OpenDocument (`.odt`)\n  LaTeX (`.latex`)        LaTeX (`.latex`)\n\n------------------------------------------------------------------------\n\n## Installation\n\n### Prerequisites\n\nBefore running the application, ensure you have the following installed:\n\n1.  **Python 3.7 or higher**: Download and install Python from [python.org](https://www.python.org/).\n2.  **Pandoc**: The application uses `pypandoc`, which requires Pandoc. Install Pandoc from [pandoc.org](https://pandoc.org/installing.html).\n\n### Steps\n\n1.  **Clone the Repository**:\n\n    ``` bash\n    git clone https://github.com/1999AZZAR/doc-converter.git\n    cd doc-converter\n    ```\n\n2.  **Install Dependencies**:\n    Install the required Python packages using `pip`:\n\n    ``` bash\n    pip install -r requirements.txt\n    ```\n\n    Alternatively, install the dependencies manually:\n\n    ``` bash\n    pip install PyQt6 pypandoc\n    ```\n\n3.  **Run the Application**:\n    Execute the script to launch the application:\n\n    ``` bash\n    python converted.py\n    ```\n\n------------------------------------------------------------------------\n\n## Usage\n\n1.  **Add Files**:\n    -   Click the **\"Add Files\"** button to select one or more files for conversion.\n    -   Supported file types: `.md`, `.docx`, `.odt`, `.tex`.\n2.  **Select Input and Output Formats**:\n    -   Choose the **input format** of the selected files from the dropdown menu.\n    -   Choose the **output format** for the converted files.\n3.  **Preview Files**:\n    -   Click on a file in the list to preview its content in the preview pane.\n4.  **Convert Files**:\n    -   Click the **\"Convert\"** button to start the conversion process.\n    -   The converted files will be saved in a `converted` folder within the same directory as the input files.\n5.  **Monitor Progress**:\n    -   A progress bar will show the status of the conversion process.\n    -   Once completed, a success message will be displayed.\n\n------------------------------------------------------------------------\n\n## Screenshots\n\n![Doc Converter Screenshot](screenshot.png)\n\n------------------------------------------------------------------------\n\n## Contributing\n\nContributions are welcome! If you'd like to contribute to the project, please follow these steps:\n\n1.  Fork the repository.\n2.  Create a new branch for your feature or bugfix.\n3.  Commit your changes and push to your branch.\n4.  Submit a pull request with a detailed description of your changes.\n\n------------------------------------------------------------------------\n\n## License\n\nThis project is licensed under the **MIT License**. See the [LICENSE](LICENSE) file for details.\n\n------------------------------------------------------------------------\n\n## Acknowledgments\n\n-   **PyQt6**: For the GUI framework.\n-   **Pandoc**: For the document conversion engine.\n-   **pypandoc**: For the Python bindings to Pandoc.\n\n------------------------------------------------------------------------\n\n## Contact\n\nFor questions, feedback, or support, please open an issue on the [GitHub repository](https://github.com/1999AZZAR/doc-converter/issues) or contact the maintainer directly.\n\n------------------------------------------------------------------------\n\nEnjoy using **Doc Converter**! 🚀\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F1999azzar%2Fdoc-converter","html_url":"https://awesome.ecosyste.ms/projects/github.com%2F1999azzar%2Fdoc-converter","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F1999azzar%2Fdoc-converter/lists"}