<!-- [](https://www.patreon.com/andre-romano) -->
# File Conversor
A powerful Python-based CLI tool (also planned with GUI support) for converting, compressing, and manipulating audio, video, text, document, and image files.
**Summary**:
- [File Conversor](#file-conversor)
- [Features](#features)
- [External dependencies](#external-dependencies)
- [Installing](#installing)
- [For Windows](#for-windows)
- [For Linux / MacOS](#for-linux--macos)
- [Usage](#usage)
- [CLI - Command line interface](#cli---command-line-interface)
- [GUI - Graphical user interface](#gui---graphical-user-interface)
- [Windows Context Menu (Windows OS only)](#windows-context-menu-windows-os-only)
- [Why use File Conversor?](#why-use-file-conversor)
- [Contributing \& Support](#contributing--support)
- [License and Copyright](#license-and-copyright)
## Features
- **Format Conversion**
- **Documents**: `docx ⇄ odt`, `docx → pdf`, etc
- **Spreadsheets**: `xlsx ⇄ ods`, `xlsx → pdf`, etc
- **Video**: `mkv ⇄ mp4`, `avi ⇄ mp4`, etc.
- **Images**: `jpg ⇄ png`, `gif ⇄ webp`, `bmp ⇄ tiff`, etc.
- **Audio**: `mp3 ⇄ m4a`, etc.
- **Text**: `json ⇄ yaml`, `xml ⇄ json`, etc
- And more ...
- **Compression**
- Optimizes size for formats like MP4, MP3, PDF, JPG, and others.
- **Metadata Inspection**
- Retrieves EXIF data from images, stream details from audio/video.
- **File Manipulation**
- **PDFs**: split, rotate, encrypt, etc
- **Images**: rotate, enhance, and apply other transformations
- **Batch Processing**
- Use pipelines and config files for automation and advanced tasks.
- **Multiple Interfaces**
- **Windows Explorer integration**: right-click files for quick actions
- CLI for scripting and automation
- GUI (coming soon)
## External dependencies
This project has external dependencies.
Prompts will assist you in downloading missing dependencies when required.
## Installing
### For Windows
- **Option 1. Installer (EXE)**:
- Download the latest version of the app (check [Releases](https://github.com/andre-romano/file_conversor/releases/) pages)
- Execute installer (.exe file)
- **Option 2. Scoop Package Manager**
```bash
scoop bucket add file_conversor https://github.com/andre-romano/file_conversor
scoop install file_conversor
```
- **Option 3. Choco Package Manager**
```bash
choco install file_conversor -y
```
- **Option 4. PyPi**
```bash
pip install file_conversor
```
### For Linux / MacOS
- **Option 1. PyPi**
```bash
pip install file_conversor
```
## Usage
### CLI - Command line interface
```bash
file_conversor COMMANDS [OPTIONS]
```
Run ``file_conversor -h`` to explore all available commands and options.
### GUI - Graphical user interface
*TODO*
### Windows Context Menu (Windows OS only)
1. Right click a file in Windows Explorer
2. Choose an action from "File Conversor" menu
<img src="./readme/ctx_menu.jpg" width="600px">
## Why use File Conversor?
- Automate repetitive file conversion or compression tasks
- Manipulate various media formats with a single tool
- Integrate seamlessly with scripting workflows
- Configure advanced file processing pipelines
## Contributing & Support
- **Support us**:
- If you enjoy this project, consider supporting us with a donation in our Github Sponsors.
- **Acknowledgements**
- We're grateful to the icon designers whose work is featured in the app: [Freepik](https://www.flaticon.com/authors/freepik), [atomicicon](https://www.flaticon.com/authors/atomicicon), [swifticons](https://www.flaticon.com/authors/swifticons), [iconir](https://www.flaticon.com/authors/iconir), [iconjam](https://www.flaticon.com/authors/iconjam), [muhammad-andy](https://www.flaticon.com/authors/muhammad-andy) (via [Flaticon](https://www.flaticon.com))
## License and Copyright
Distributed under the **Apache License 2.0**.
See [`LICENSE`](./LICENSE) for details.
Raw data
{
"_id": null,
"home_page": null,
"name": "file-conversor",
"maintainer": null,
"docs_url": null,
"requires_python": "==3.13.*",
"maintainer_email": null,
"keywords": "file, conversion, multimedia, docs, video, audio, image, converter",
"author": null,
"author_email": "Andre Luiz Romano Madureira <andre@domain.com>",
"download_url": "https://files.pythonhosted.org/packages/06/01/da5aba2e7ccabfeb8d97221780591c71a5895c6bc2ad4f27d76fef210580/file_conversor-0.4.0.tar.gz",
"platform": null,
"description": "<!-- [](https://www.patreon.com/andre-romano) -->\r\n\r\n# File Conversor\r\nA powerful Python-based CLI tool (also planned with GUI support) for converting, compressing, and manipulating audio, video, text, document, and image files.\r\n\r\n**Summary**:\r\n- [File Conversor](#file-conversor)\r\n - [Features](#features)\r\n - [External dependencies](#external-dependencies)\r\n - [Installing](#installing)\r\n - [For Windows](#for-windows)\r\n - [For Linux / MacOS](#for-linux--macos)\r\n - [Usage](#usage)\r\n - [CLI - Command line interface](#cli---command-line-interface)\r\n - [GUI - Graphical user interface](#gui---graphical-user-interface)\r\n - [Windows Context Menu (Windows OS only)](#windows-context-menu-windows-os-only)\r\n - [Why use File Conversor?](#why-use-file-conversor)\r\n - [Contributing \\& Support](#contributing--support)\r\n - [License and Copyright](#license-and-copyright)\r\n\r\n## Features\r\n\r\n- **Format Conversion**\r\n - **Documents**: `docx \u21c4 odt`, `docx \u2192 pdf`, etc\r\n - **Spreadsheets**: `xlsx \u21c4 ods`, `xlsx \u2192 pdf`, etc\r\n - **Video**: `mkv \u21c4 mp4`, `avi \u21c4 mp4`, etc.\r\n - **Images**: `jpg \u21c4 png`, `gif \u21c4 webp`, `bmp \u21c4 tiff`, etc.\r\n - **Audio**: `mp3 \u21c4 m4a`, etc.\r\n - **Text**: `json \u21c4 yaml`, `xml \u21c4 json`, etc\r\n - And more ...\r\n\r\n- **Compression** \r\n - Optimizes size for formats like MP4, MP3, PDF, JPG, and others.\r\n\r\n- **Metadata Inspection** \r\n - Retrieves EXIF data from images, stream details from audio/video.\r\n\r\n- **File Manipulation** \r\n - **PDFs**: split, rotate, encrypt, etc \r\n - **Images**: rotate, enhance, and apply other transformations \r\n\r\n- **Batch Processing** \r\n - Use pipelines and config files for automation and advanced tasks.\r\n\r\n- **Multiple Interfaces** \r\n - **Windows Explorer integration**: right-click files for quick actions\r\n - CLI for scripting and automation \r\n - GUI (coming soon) \r\n\r\n## External dependencies\r\n\r\nThis project has external dependencies. \r\n\r\nPrompts will assist you in downloading missing dependencies when required.\r\n\r\n## Installing\r\n\r\n### For Windows\r\n\r\n- **Option 1. Installer (EXE)**:\r\n - Download the latest version of the app (check [Releases](https://github.com/andre-romano/file_conversor/releases/) pages)\r\n - Execute installer (.exe file)\r\n\r\n- **Option 2. Scoop Package Manager**\r\n```bash\r\nscoop bucket add file_conversor https://github.com/andre-romano/file_conversor\r\nscoop install file_conversor\r\n```\r\n\r\n- **Option 3. Choco Package Manager**\r\n```bash\r\nchoco install file_conversor -y\r\n```\r\n\r\n- **Option 4. PyPi**\r\n\r\n```bash\r\npip install file_conversor\r\n```\r\n\r\n### For Linux / MacOS\r\n\r\n- **Option 1. PyPi**\r\n\r\n```bash\r\npip install file_conversor\r\n```\r\n\r\n## Usage\r\n\r\n### CLI - Command line interface\r\n\r\n```bash\r\nfile_conversor COMMANDS [OPTIONS]\r\n```\r\n\r\nRun ``file_conversor -h`` to explore all available commands and options.\r\n\r\n### GUI - Graphical user interface\r\n\r\n*TODO*\r\n\r\n### Windows Context Menu (Windows OS only)\r\n\r\n1. Right click a file in Windows Explorer\r\n2. Choose an action from \"File Conversor\" menu\r\n \r\n<img src=\"./readme/ctx_menu.jpg\" width=\"600px\">\r\n\r\n## Why use File Conversor?\r\n\r\n- Automate repetitive file conversion or compression tasks\r\n- Manipulate various media formats with a single tool\r\n- Integrate seamlessly with scripting workflows\r\n- Configure advanced file processing pipelines\r\n\r\n## Contributing & Support\r\n\r\n- **Support us**:\r\n - If you enjoy this project, consider supporting us with a donation in our Github Sponsors.\r\n- **Acknowledgements**\r\n - We're grateful to the icon designers whose work is featured in the app: [Freepik](https://www.flaticon.com/authors/freepik), [atomicicon](https://www.flaticon.com/authors/atomicicon), [swifticons](https://www.flaticon.com/authors/swifticons), [iconir](https://www.flaticon.com/authors/iconir), [iconjam](https://www.flaticon.com/authors/iconjam), [muhammad-andy](https://www.flaticon.com/authors/muhammad-andy) (via [Flaticon](https://www.flaticon.com))\r\n\r\n## License and Copyright\r\n\r\nDistributed under the **Apache License 2.0**.\r\n\r\nSee [`LICENSE`](./LICENSE) for details.\r\n\r\n",
"bugtrack_url": null,
"license": null,
"summary": "Universal file conversor for multimedia files (audio, video, pdf, docs, etc)",
"version": "0.4.0",
"project_urls": {
"Homepage": "https://github.com/andre-romano/file_conversor"
},
"split_keywords": [
"file",
" conversion",
" multimedia",
" docs",
" video",
" audio",
" image",
" converter"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "94717b1cb34d7fbb2c614694ca84d82e48cf8973b2acbf4943021481cf923953",
"md5": "1573afdca242589194c1d028526c24b3",
"sha256": "e0012b4106d9450383a1b3949a88a259318c5d0368474992e18df8ca1145462c"
},
"downloads": -1,
"filename": "file_conversor-0.4.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "1573afdca242589194c1d028526c24b3",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "==3.13.*",
"size": 357846,
"upload_time": "2025-08-25T23:19:40",
"upload_time_iso_8601": "2025-08-25T23:19:40.752125Z",
"url": "https://files.pythonhosted.org/packages/94/71/7b1cb34d7fbb2c614694ca84d82e48cf8973b2acbf4943021481cf923953/file_conversor-0.4.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "0601da5aba2e7ccabfeb8d97221780591c71a5895c6bc2ad4f27d76fef210580",
"md5": "8f87b5695fe102dc4153529da887eff6",
"sha256": "bd95183b4fb45da52336bf1461413f53844357bfd8d43433b868e36a5232284e"
},
"downloads": -1,
"filename": "file_conversor-0.4.0.tar.gz",
"has_sig": false,
"md5_digest": "8f87b5695fe102dc4153529da887eff6",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "==3.13.*",
"size": 283495,
"upload_time": "2025-08-25T23:19:41",
"upload_time_iso_8601": "2025-08-25T23:19:41.958544Z",
"url": "https://files.pythonhosted.org/packages/06/01/da5aba2e7ccabfeb8d97221780591c71a5895c6bc2ad4f27d76fef210580/file_conversor-0.4.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-08-25 23:19:41",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "andre-romano",
"github_project": "file_conversor",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "file-conversor"
}
JSON
