# File Conversor
Python program to convert and compress audio/video/text/etc files to other formats
**Summary**:
- [File Conversor](#file-conversor)
- [External dependencies](#external-dependencies)
- [Installing](#installing)
- [For Windows](#for-windows)
- [Option 1. Chocolatey Package Manager](#option-1-chocolatey-package-manager)
- [Option 2. Scoop Package Manager](#option-2-scoop-package-manager)
- [Option 3. PyPi](#option-3-pypi)
- [Option 4. Installer (EXE)](#option-4-installer-exe)
- [For Linux / MacOS](#for-linux--macos)
- [Option 1. Homebrew (brew)](#option-1-homebrew-brew)
- [Option 2. PyPi](#option-2-pypi)
- [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)
- [Acknowledgements](#acknowledgements)
- [License and Copyright](#license-and-copyright)
## External dependencies
This project requires the following external dependencies to work properly:
- FFmpeg
- Ghostscript
- qpdf
The app will prompt for download of the external dependencies, if needed.
## Installing
### For Windows
#### Option 1. Chocolatey Package Manager
1. Open PowerShell with Admin priviledges and run:
```bash
choco install file_conversor
```
#### Option 2. Scoop Package Manager
1. Open PowerShell (no admin priviledges needed) and run:
```bash
scoop install file_conversor
```
#### Option 3. PyPi
```bash
pip install pipx
python -m pipx ensurepath
python -m pipx install file_conversor
```
#### Option 4. Installer (EXE)
1. Download the latest version of the app (check [Releases](https://github.com/andre-romano/file_conversor/releases/) pages)
2. Execute installer (.exe file)
### For Linux / MacOS
#### Option 1. Homebrew (brew)
```bash
brew install file_conversor
```
#### Option 2. PyPi
```bash
pip install pipx
python -m pipx ensurepath
python -m pipx install file_conversor
```
## Usage
### CLI - Command line interface
```bash
file_conversor COMMANDS [OPTIONS]
```
For more information about the usage:
- Issue `-h` for help
### GUI - Graphical user interface
*TODO*
### Windows Context Menu (Windows OS only)
1. Open Powershell and execute command below
```bash
file_conversor win install-menu
```
2. Right click a file in Windows Explorer
3. Choose an action from "File Conversor" menu
## Acknowledgements
- Icons:
- [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)
## License and Copyright
Copyright (C) [2025] Andre Luiz Romano Madureira
This project is licensed under the Apache License 2.0.
For more details, see the full license text (see [./LICENSE](./LICENSE) file).
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/0b/d8/95d1cadee71dbf8bc4e1dbbe3ea83a0d593d119cd3c97db3ec65109cc195/file_conversor-0.1.1.tar.gz",
"platform": null,
"description": "# File Conversor\r\nPython program to convert and compress audio/video/text/etc files to other formats\r\n\r\n**Summary**:\r\n- [File Conversor](#file-conversor)\r\n - [External dependencies](#external-dependencies)\r\n - [Installing](#installing)\r\n - [For Windows](#for-windows)\r\n - [Option 1. Chocolatey Package Manager](#option-1-chocolatey-package-manager)\r\n - [Option 2. Scoop Package Manager](#option-2-scoop-package-manager)\r\n - [Option 3. PyPi](#option-3-pypi)\r\n - [Option 4. Installer (EXE)](#option-4-installer-exe)\r\n - [For Linux / MacOS](#for-linux--macos)\r\n - [Option 1. Homebrew (brew)](#option-1-homebrew-brew)\r\n - [Option 2. PyPi](#option-2-pypi)\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 - [Acknowledgements](#acknowledgements)\r\n - [License and Copyright](#license-and-copyright)\r\n\r\n## External dependencies\r\n\r\nThis project requires the following external dependencies to work properly:\r\n- FFmpeg\r\n- Ghostscript\r\n- qpdf\r\n\r\nThe app will prompt for download of the external dependencies, if needed.\r\n\r\n## Installing\r\n\r\n### For Windows\r\n\r\n#### Option 1. Chocolatey Package Manager\r\n\r\n1. Open PowerShell with Admin priviledges and run:\r\n ```bash\r\n choco install file_conversor\r\n ```\r\n\r\n#### Option 2. Scoop Package Manager\r\n\r\n1. Open PowerShell (no admin priviledges needed) and run:\r\n ```bash\r\n scoop install file_conversor\r\n ```\r\n\r\n#### Option 3. PyPi\r\n\r\n```bash\r\npip install pipx\r\npython -m pipx ensurepath\r\npython -m pipx install file_conversor\r\n```\r\n\r\n#### Option 4. Installer (EXE)\r\n\r\n1. Download the latest version of the app (check [Releases](https://github.com/andre-romano/file_conversor/releases/) pages)\r\n2. Execute installer (.exe file)\r\n\r\n\r\n### For Linux / MacOS\r\n\r\n#### Option 1. Homebrew (brew)\r\n\r\n```bash\r\nbrew install file_conversor\r\n```\r\n\r\n#### Option 2. PyPi\r\n\r\n```bash\r\npip install pipx\r\npython -m pipx ensurepath\r\npython -m pipx 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\nFor more information about the usage:\r\n- Issue `-h` for help\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. Open Powershell and execute command below\r\n ```bash\r\n file_conversor win install-menu\r\n ```\r\n2. Right click a file in Windows Explorer\r\n3. Choose an action from \"File Conversor\" menu\r\n\r\n## Acknowledgements\r\n\r\n- Icons:\r\n - [Freepik](https://www.flaticon.com/authors/freepik)\r\n - [atomicicon](https://www.flaticon.com/authors/atomicicon)\r\n - [swifticons](https://www.flaticon.com/authors/swifticons)\r\n - [iconir](https://www.flaticon.com/authors/iconir)\r\n - [iconjam](https://www.flaticon.com/authors/iconjam)\r\n\r\n## License and Copyright\r\n\r\nCopyright (C) [2025] Andre Luiz Romano Madureira\r\n\r\nThis project is licensed under the Apache License 2.0. \r\n\r\nFor more details, see the full license text (see [./LICENSE](./LICENSE) file).\r\n\r\n",
"bugtrack_url": null,
"license": null,
"summary": "Universal file conversor for multimedia files (audio, video, pdf, docs, etc)",
"version": "0.1.1",
"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": "3e6d8369afe12967c538db5a669b9c318f81ce1bcde58c3519c64b3e27e7f681",
"md5": "2b8f44c1fdf0c4a096786472af104c49",
"sha256": "cb8be5d10ef7503af04cae5d71ec01c23a93b526ba4d4b094fa28b14fe13bdf3"
},
"downloads": -1,
"filename": "file_conversor-0.1.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "2b8f44c1fdf0c4a096786472af104c49",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "==3.13.*",
"size": 229126,
"upload_time": "2025-08-06T20:31:50",
"upload_time_iso_8601": "2025-08-06T20:31:50.753911Z",
"url": "https://files.pythonhosted.org/packages/3e/6d/8369afe12967c538db5a669b9c318f81ce1bcde58c3519c64b3e27e7f681/file_conversor-0.1.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "0bd895d1cadee71dbf8bc4e1dbbe3ea83a0d593d119cd3c97db3ec65109cc195",
"md5": "e583ef84e76133f34bc207626563982b",
"sha256": "13a54cb28ee0dae8abb5c61ec63e31fcb277b19c7f667cbb7e61cd5d0e725cb4"
},
"downloads": -1,
"filename": "file_conversor-0.1.1.tar.gz",
"has_sig": false,
"md5_digest": "e583ef84e76133f34bc207626563982b",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "==3.13.*",
"size": 197720,
"upload_time": "2025-08-06T20:31:52",
"upload_time_iso_8601": "2025-08-06T20:31:52.428851Z",
"url": "https://files.pythonhosted.org/packages/0b/d8/95d1cadee71dbf8bc4e1dbbe3ea83a0d593d119cd3c97db3ec65109cc195/file_conversor-0.1.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-08-06 20:31:52",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "andre-romano",
"github_project": "file_conversor",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "file-conversor"
}
JSON
