Skip to content

Latest commit

 

History

History
149 lines (128 loc) · 4.28 KB

README.md

File metadata and controls

149 lines (128 loc) · 4.28 KB
Raw

fconverter

A python file conversion, manipulation, Analysis toolkit `This is a Linux command-line interface (CLI) utility that coverts documents from one format to another, analyzes files, manipulates files. Your can also convert text file to mp3 formart using google Text to speech library (gTTS).

Name variations

   filemac -h
   Filemac -h
   FILEMAC -h

Installation

  1. using pip

     pip install filemac

  2. Install from github

    pip install git+https://github.com/skye-cyber/FileMAC.git

Usage

To run the CLI app, use the following command:

FileMAC [options] stdin format

Replace [options] with the appropriate command-line options based on the functionality you want to execute.

Available Options

*

  • 1: --convert_doc (doc* inter-conversion + tts)
  • 2: --convert_audio
  • 3: --convert_video
  • 4: --convert_image
  • 5: --extract_audio
  • 6: --Analyze_video
  • 8: --OCR
  • 9: --convert_doc2image
  • 10: --extract_audio
  • 11: --Analyze_video
  • 12: --resize_image
  • 13: --doc_long_image (convert pdf/doc/docx to long image)
  • 14: --scanAsImg (scan text from pdf)
  • 15: --scanAsLong_Image (scan text from pdf)
  • 15: --AudioJoin
  • 15: --extract_pages
  • 15: --manipulate_audio
  • 15: --pdfjoin

Examples

  1. Example command 1:

    filemac --convert_doc example.docx -t pdf
     ``Supported formats For document conversion``
      `1`.  PDF to DOCX
      `2`.  PDF to TXT
      `3`.  PDF to Audio(ogg,mp3,wav..*)
      `4`.  DOCX to PDF
      `5`.  DOCX to pptx
      `6`.  DOCX to TXT
      `7`.  DOCX to Audio(ogg,mp3,wav..*)
      `8`.  TXT to PDF
      `9`.  TXT to DOCX
      `10`' TXT to Audio(ogg,mp3,wav..*)
      `11`. PPTX to DOCX
      `12`. XLSX to Sql
      `13`. XLSX to CSV
      `14`. XLSX to TXT
      `15`. XLSX to DOCX

This promt parses convert_doc signifying that the inteded operation id document conversion then parses example.docx as the input file(file path can also be provided) to be converted to format pdf. the output file assumes the base name of the input file but the extension conforms to the parsed formatpdf

  1. converting text mp3 to wav

    filemac --convert_audio example.mp3 -t wav
         ``Supported formats For audio conversion``
         `1`. wav
         `2`. mp3
         `3`. ogg
         `4`. flv
         `5`. avi
         `6`. ogv
         `7`. matroska
         `8`. mov
         `9`. webm

  2. Extract text from images

    filemac --OCR image.jpg
    1. converting videos
    filemac --convert_video example.mp4 -t wav
         ``Supported formats For video conversion``
         `1`. MP4
         `2`. AVI
         `3`. OGV
         `4`. WEBM
         `5`. MOV
         `6`. MKV
         `7`. FLV
         `8`. WMV

  3. converting images

    filemac --convert_image example.png -t jpg
         ``Supported formats For audio conversion``
         `1`.JPEG: `.jpg`
         `2`.PNG": `.png`
         `3`.GIF": `.gif`
         `4`.BM":  `.bmp`
         `5`.TIFF: `.tiff`
         `6`.EXR   `.exr`
         `7`.PDF:  `.pdf`
         `8`.WebP: `.webp`
         `9`.ICNS: `.icns`
         `10`.PSD: `.psd`
         `11`.SVG: `.svg`
         `12`.EPS: `.eps`

Help

in any case you can pass the string help to an option to see its supported operations or inputs nd output formats.

   filemac --convert_doc help

The above command displays the surported input and output formats for document conversion.

Contributing

Contributions are welcome! If you encounter any issues or have suggestions for improvements, please open an issue or submit a pull request.

License

This project is an open source software. Under GPL-3.0 license

Feel free to modify and customize this template according to your specific project requirements and add any additional sections or information that you think would be helpful for users.