Filto

⚡ Fast, lightweight, and privacy-focused CLI tool for file conversion

Features • Installation • Usage • Examples • Contributing • License

Features

• Privacy First: Runs entirely offline - no file uploads to external servers
• Lightning Fast: Optimized for quick file conversions
• Versatile: Supports multiple file formats and conversion types
• Batch Processing: Convert multiple files or entire folders at once
• Cross-Platform: Works on Windows, macOS, and Linux

Supported Conversions

Currently Available

• Images → PDF (supports PNG, JPG)
• Images → Text (TXT) - Extract text from images using OCR
• PDF → Word (DOCX)
• PDF → PowerPoint (PPTX)
• PDF → Images (JPG)
• PDF → Text (TXT) - Extract text content from PDF files
• PDF Info → Display metadata (title, creator, page count, file size)
• Merge multiple PDFs

Coming Soon

• PowerPoint → PDF
• Excel → PDF
• HTML → PDF
• PDF compression
• PDF text extraction

Installation

Prerequisites

Tesseract OCR Installation

Filto uses Tesseract OCR for text extraction from images. You'll need to install Tesseract on your system first.

For more detailed installation instructions and additional language packs, please refer to the Tesseract documentation.

---

Quick Install

Install Filto using npm:

npm install filto

Verify Installation

filto --version

From Source

1. Clone the repository:

git clone https://github.com/OsamaRab3/filto.git
cd filto

2. Install dependencies:

npm install

3. Build the project:

npm run build

4. Link it globally:

npm link

Usage

filto convert <input> <output>

Basic Commands

1. Convert Images to PDF

Convert single or multiple images to PDF file

Single Image:

filto convert image.png output.pdf

Multiple Images:

if you have a multiple image put in folder then run

Using glob pattern

filto convert images/ output.pdf

---

2. Convert Pdf to Docx

filto convert input.pdf output.docx 

---

3. Convert Pdf to Pptx

filto convert input.pdf out.pptx

---

4. Convert Pdf to Images

filto convert input.pdf output.jpg

---

2. Get PDF Information

Display information about a PDF file

Show specific information (use any combination of flags):

filto info input.pdf -t -c -n -z

Flags:

• -t, --title: Show document title
• -c, --creator: Show document creator
• -n, --pages: Show number of pages
• -z, --size: Show file size

---

3. Extract Text from PDF

Extract text content from PDF files

Basic extraction:

filto extract input.pdf

Extract from specific page:

filto extract input.pdf -p 1

Save to output file:

filto extract input.pdf -o extracted.txt

Extract from specific page and save to file:

filto extract input.pdf --page 1 --output page1.txt

---

5. Extract Text from Images (OCR)

Extract text from images using OCR. Supports multiple languages.

# Basic usage
filto ocr image.png -l eng -o output.txt

Specify language (e.g., for Arabic text)

filto ocr documento.png -l ara -o texto_extraido.txt

Note: The -l or --language flag is required. Common language codes: eng (English), ara (Arabic), fra (French), deu (German), etc.

---

6. Merge PDF Files

Merge multiple PDF files into a single PDF

Basic usage:

filto merge file1.pdf file2.pdf output.pdf

Example with multiple files:

filto merge doc1.pdf doc2.pdf doc3.pdf merged_output.pdf

Note: You need to provide at least two PDF files to merge. The last argument will be used as the output file.

---

Contributing

Contributions are welcome! Please read our Contributing Guide for details on how to contribute to this project.

License

This project is licensed under the MIT License - see the LICENSE file for details.

---

Made with ❤️ by Osama Rabea