File Conversor

A powerful Python-based CLI tool for converting, compressing, and manipulating audio, video, text, document, and image files.

Summary:

• File Conversor
  • Usage
    • CLI - Command line interface
    • Windows Context Menu (Windows OS only)
  • Why use File Conversor?
  • Features
  • External dependencies
  • Installing
    • For Windows
    • For Linux / MacOS
  • Contributing & Support
  • License and Copyright

Usage

CLI - Command line interface

Run file_conversor -h to explore all available commands and options.

Windows Context Menu (Windows OS only)

1. Right click a file in Windows Explorer
2. Choose an action from "File Conversor" menu

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

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

For full feature set, check FEATURE_SET.md

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 pages)
  • Execute installer (.exe file)

• Option 2. Scoop Package Manager

scoop install git
scoop bucket add file_conversor https://github.com/andre-romano/file_conversor
scoop install file_conversor

• Option 3. Choco Package Manager

choco install file_conversor -y

• Option 4. PyPi

pip install file_conversor

For Linux / MacOS

• Option 1. PyPi

pip install file_conversor

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, atomicicon, swifticons, iconir, iconjam, muhammad-andy, Shuvo.Das, Laisa Islam Ani, riajulislam (via Flaticon)

License and Copyright

Distributed under the Apache License 2.0. See LICENSE for details.