README.md~

# 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
```shell
   filemac -h
   Filemac -h
   FILEMAC -h
   ```

## Installation
1. using pip

   ```shell
	pip install filemac
   ```
2. Install from github

    ```shell
    pip install git+https://github.com/skye-cyber/FileMAC.git
    ```
## Usage

To run the CLI app, use the following command:

```shell
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:

   ```shell
   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 format```pdf```

2. converting text mp3 to wav
   ```shell
   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

3. Extract text from images
    ```shell
    filemac --OCR image.jpg
    ```

    2. converting videos
   ```shell
   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

2. converting images
   ```shell
   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.
```shell
   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.