# 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).
## 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.
- `2`: --convert_audio.
- `3`: --convert_video.
- `4`: --convert_image.
- `5`: --extract_audio.
- `6`: --Analyze_video
- `7`: --OCR
## 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
`4`. DOCX to PDF
`5`. DOCX to pptx
`6`. DOCX to TXT
`7`. DOCX to Audio
`8`. TXT to PDF
`9`. TXT to DOCX
`10`' TXT to Audio
`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.
Raw data
{
"_id": null,
"home_page": null,
"name": "filemac",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.6",
"maintainer_email": null,
"keywords": "file-conversion, file-analysis, file-manipulation, ocr, image-conversion",
"author": "wambua",
"author_email": "wambuamwiky2001@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/04/66/124bcf030bd54377d5bdfcfd35b44a0960c8e42ddb4d2a8de2c1f598b969/filemac-1.0.2.tar.gz",
"platform": null,
"description": "# fconverter\nA python file `conversion`, `manipulation`, `Analysis` toolkit\n`This is a Linux command-line interface (CLI) utility that coverts documents from one format to another,\nanalyzes files, manipulates files.\nYour can also convert text file to mp3 formart using google Text to speech library (gTTS).\n\n## Installation\n1. using pip\n\n ```shell\n\tpip install filemac\n ```\n2. Install from github\n\n ```shell\n pip install git+https://github.com/skye-cyber/FileMAC.git\n ```\n## Usage\n\nTo run the CLI app, use the following command:\n\n```shell\nFileMAC [options] stdin format\n```\n\nReplace `[options]` with the appropriate command-line options based on the functionality you want to execute.\n\n## Available Options\n\n- `1`: --convert_doc.\n- `2`: --convert_audio.\n- `3`: --convert_video.\n- `4`: --convert_image.\n- `5`: --extract_audio.\n- `6`: --Analyze_video\n- `7`: --OCR\n\n## Examples\n\n1. Example command 1:\n\n ```shell\n filemac --convert_doc example.docx -t pdf\n ```\n ``Supported formats For document conversion``\n `1`. PDF to DOCX\n `2`. PDF to TXT\n `3`. PDF to Audio\n `4`. DOCX to PDF\n `5`. DOCX to pptx\n `6`. DOCX to TXT\n `7`. DOCX to Audio\n `8`. TXT to PDF\n `9`. TXT to DOCX\n `10`' TXT to Audio\n `11`. PPTX to DOCX\n `12`. XLSX to Sql\n `13`. XLSX to CSV\n `14`. XLSX to TXT\n `15`. XLSX to DOCX\n\n 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```.\nthe output file assumes the base name of the input file but the extension conforms to the parsed format```pdf```\n\n2. converting text mp3 to wav\n ```shell\n filemac --convert_audio example.mp3 -t wav\n ```\n ``Supported formats For audio conversion``\n `1`. wav\n `2`. mp3\n `3`. ogg\n `4`. flv\n `5`. avi\n `6`. ogv\n `7`. matroska\n `8`. mov\n `9`. webm\n\n3. Extract text from images\n ```shell\n filemac --OCR image.jpg\n ```\n\n 2. converting videos\n ```shell\n filemac --convert_video example.mp4 -t wav\n ```\n ``Supported formats For video conversion``\n `1`. MP4\n `2`. AVI\n `3`. OGV\n `4`. WEBM\n `5`. MOV\n `6`. MKV\n `7`. FLV\n `8`. WMV\n\n2. converting images\n ```shell\n filemac --convert_image example.png -t jpg\n ```\n ``Supported formats For audio conversion``\n `1`.JPEG: `.jpg`\n `2`.PNG\": `.png`\n `3`.GIF\": `.gif`\n `4`.BM\": `.bmp`\n `5`.TIFF: `.tiff`\n `6`.EXR `.exr`\n `7`.PDF: `.pdf`\n `8`.WebP: `.webp`\n `9`.ICNS: `.icns`\n `10`.PSD: `.psd`\n `11`.SVG: `.svg`\n `12`.EPS: `.eps`\n\n## Help\nin any case you can pass the string help to an option to see its supported operations or inputs nd output formats.\n```shell\n filemac --convert_doc help\n```\nThe above command displays the surported input and output formats for document conversion.\n## Contributing\n\nContributions are welcome! If you encounter any issues or have suggestions for improvements, please open an issue or submit a pull request.\n\n## License\n\nThis project is an open source software. Under GPL-3.0 license\n\n\nFeel 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.\n\n",
"bugtrack_url": null,
"license": "GPL v3",
"summary": "Open source Python CLI toolkit for conversion, manipulation, Analysis",
"version": "1.0.2",
"project_urls": null,
"split_keywords": [
"file-conversion",
" file-analysis",
" file-manipulation",
" ocr",
" image-conversion"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "b2ed83662a95b63881ccd8fcf901cc338e068f346a494674f8485f14e90ed7da",
"md5": "e232089cce098003460704f0c0642a41",
"sha256": "f007c7688cf755b9dcf7a87802e8dd41291ddcc9a07bcf0462f886b6f32e845a"
},
"downloads": -1,
"filename": "filemac-1.0.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "e232089cce098003460704f0c0642a41",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.6",
"size": 79965,
"upload_time": "2024-04-24T09:29:14",
"upload_time_iso_8601": "2024-04-24T09:29:14.575875Z",
"url": "https://files.pythonhosted.org/packages/b2/ed/83662a95b63881ccd8fcf901cc338e068f346a494674f8485f14e90ed7da/filemac-1.0.2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "0466124bcf030bd54377d5bdfcfd35b44a0960c8e42ddb4d2a8de2c1f598b969",
"md5": "c478f19b5f4136da49096c24379705e8",
"sha256": "9220de7c57066ffe98cc13a4624d26ce304dd76422a97aa6c8693bd16c4892c9"
},
"downloads": -1,
"filename": "filemac-1.0.2.tar.gz",
"has_sig": false,
"md5_digest": "c478f19b5f4136da49096c24379705e8",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.6",
"size": 85945,
"upload_time": "2024-04-24T09:29:17",
"upload_time_iso_8601": "2024-04-24T09:29:17.639463Z",
"url": "https://files.pythonhosted.org/packages/04/66/124bcf030bd54377d5bdfcfd35b44a0960c8e42ddb4d2a8de2c1f598b969/filemac-1.0.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-04-24 09:29:17",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "filemac"
}
JSON