Skip to main content

Open source Python CLI toolkit for conversion, manipulation, Analysis of files (All major file operations)

Project description

filemac

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 format 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 program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program.  If not, see <https://www.gnu.org/licenses/>.

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.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

filemac-1.1.7.tar.gz (77.1 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

filemac-1.1.7-py3-none-any.whl (91.5 kB view details)

Uploaded Python 3

File details

Details for the file filemac-1.1.7.tar.gz.

File metadata

  • Download URL: filemac-1.1.7.tar.gz
  • Upload date:
  • Size: 77.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.2

File hashes

Hashes for filemac-1.1.7.tar.gz
Algorithm Hash digest
SHA256 b6a420003445d568781063962aa826f7249c3d62657371d63a2f9796cb750f0e
MD5 77f146b2f9047f359feb1132a4e9fd79
BLAKE2b-256 d541e1a14893050c2a9e4f4e7ff517c326aa5b56d426c63471be9542d0bf5b9f

See more details on using hashes here.

File details

Details for the file filemac-1.1.7-py3-none-any.whl.

File metadata

  • Download URL: filemac-1.1.7-py3-none-any.whl
  • Upload date:
  • Size: 91.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.2

File hashes

Hashes for filemac-1.1.7-py3-none-any.whl
Algorithm Hash digest
SHA256 a8ff826d6cd1795bfc80de88b238671f7f71bed631c4cb342076ddca2ed2f43a
MD5 e12c9cffd0a779c2a1b8385a2d626ce5
BLAKE2b-256 3e7b4054952978f62eed3731e3f43693f4da01f624b80861dbdb3b5f6b9460a5

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page