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
    • GUI - Graphical user 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.

GUI - Graphical user interface

Run file_conversor gui start to launch the GUI application or double click the Windows Shortcut.

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.

In Windows and MacOS prompts will assist you in downloading missing dependencies when required.

In Linux you may need to install them manually using your package manager.

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, howcolour (via Flaticon)

License and Copyright

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