Flyingbee PDF Converter for Linux Quick Start Guide

1. Preparation

First, you need to use the WinSCP software to connect to your Linux server. Through WinSCP, you can upload the folder named "FPPDFConverter for Linux" to the /home/peter/ directory on the server. This step ensures that all necessary files are correctly placed in the specified location on your Linux system.

2. Logging into Linux and Executing Commands

1. Entering the Executable File Directory

   After logging into your Linux system, open the Terminal. To execute FPPDFConverter for Linux, you first need to navigate to the directory containing the executable file. Enter the following command to enter the directory:

   $ cd "/home/peter/FPPDFConverter for Linux"

   Note: Please ensure that the directory name is accurate. If there's a space in the directory name as in "FPPDFConverter for Linux", ensure you enclose the entire path in quotes or adjust the directory name to avoid spaces for simplicity.

2. Granting Executable Permission

   Since this is the first time you're using it, you need to ensure that the FPPDFConverter.out file has executable permission. This can be achieved by running the following command, which requires sudo privileges if the file was copied by the root user:

   $ chmod +x FPPDFConverter.out

   Note that the executable files in Linux have the .out extension, unlike .exe in Windows.

3. Using FPPDFConverter to Convert Files

After confirming that the file has executable permission, you can start using FPPDFConverter to convert PDF files. Here are some important notes:

• Permission Considerations: If the file was copied by the root user, you might need sudo privileges to execute it.

• Previewing Converted Files: After successful conversion, it's recommended to use Microsoft Office Word to preview the converted file for the best effect. If you use LibreOffice or WPS, the displayed style may differ.

• File Paths: In Linux, file paths use forward slashes / instead of backslashes used in Windows.

• File Naming: Avoid using Windows illegal directory names, such as ?/*, in file paths. Additionally, due to UTF-8 compatibility issues with some Windows local language encodings (like Chinese GBK) in Linux command lines, it's best to rename files to simple English names before conversion.

• Font Installation: For better recognition, install fonts like Arial, Consolas, Courier, and Times New Roman in your Linux system. These fonts are typically located in /usr/share/fonts or the user-level ~/.fonts directory.

4. Viewing Help Information

You can view the help information for FPPDFConverter by running the following command to understand all available options and commands:

$ ./FPPDFConverter -h
$ ./FPPDFConverter.out -a PDF2Files -i "Test.pdf" -f docx -p all

This will output information similar to the following (example):commands:

=== Welcome to use Flyingbee PDF Converter! ===
FPPDFConverter v1.6.1.0
FPPDFConverter - Convert PDF to Word/Excel/PPT, etc.
Usage: FPPDFConverter -a CMD_Name [input]filepath.pdf [options]docx [output]filepath.docx
Where options are:
 -a [app]The apps: "PDF2Files", "Images2PDF", "Text2Word"
 -h [help]print this help message
 -c [open]open converted file[todo]
...
=== Thank you for using our product! ===

PDF2Files Help commands:

$ ./FPPDFConverter -a PDF2Files -h

This will output information similar to the following (example):

Welcome to use Flyingbee PDF Converter!
FPPDFConverter v1.0.1
============ CMD: PDF2Files ==============
FPPDFConverter - Convert PDF to Word/Excel/PPT, etc.
usage: FPPDFConverter [input]filepath.pdf [options]docx [output]filepath.docx
where options are:
 -a PDF2Files
 -i input.pdf              [input]add a new file path for pdf conversion, absolute path
 -w password               [input password]password to open this file
 -o output.docx            [output]write conversion output to file path, absolute path
 -p 1-3,5,all              [options]setup pdf page ranges[todo fix]{default is all}
 -f docx,pptx,xlsx         [options]setup conversion formats{default is docx}, [docx,pptx,xlsx,csv,txt,jpeg,jpg,png,bmp,tif,tiff,gif]
 -t 0-12                   [options]use muti threads{default is 1}
 -x                        [options]xlsx, merge muti-sheets into one sheet",
 -d                        [options]pdf to image, image dpi, {default is 144} [72 ~ 600] 
 -c                        [open]open converted file[todo]
 -h                        [help]print this help message
=== Thank you for using our product! ===

5. Examples of Converting PDF Files

Here are some example commands using FPPDFConverter to convert PDF files along with the expected output references:

Example 1: Converting a PDF File to a Word Document (docx Format)

$ cd "/home/peter/FPPDFConverter"
$ ./FPPDFConverter -a PDF2Files -h 
$ ./FPPDFConverter -a PDF2Files -i "/home/peter/Desktop/中文" -f docx -p all
$ ./FPPDFConverter -a PDF2Files -i "/home/peter/Desktop/中文" -f jpg -p all
$ ./FPPDFConverter -a PDF2Files -i "/home/peter/Desktop/Test.pdf" -f docx -p all -t 5 -c
$ ./FPPDFConverter -a PDF2Files -i "/home/peter/Desktop/Test.pdf" -f jpeg -d 300 -p all -t 5 -c
$ ./FPPDFConverter -a PDF2Files -i "/home/peter/Desktop/Test.pdf" -f docx -p all -t 5 -c

This will output information similar to the following (example):

=== Welcome to use Flyingbee PDF Converter! ===
The app exe folder: /home/peter/FPPDFConverter
The input file: "/home/peter/Desktop/Test.pdf"
pdfPath1: /home/peter/Desktop/Test.pdf
pdfPath2: /home/peter/Desktop/Test.pdf
pdfPassword: pw
Let's convert PDF to docx
The number of pages in this PDF document: 20
Time of license remaining: 29 days, 23 hours, 50 minutes, 11 seconds
destDocPath: /home/peter/Desktop/Getting Started2.docx
The converter has started.
The conversion progress:  5%
The conversion progress:  10%
The conversion progress:  15%
The conversion progress:  20%
The conversion progress:  25%
The conversion progress:  30%
The conversion progress:  35%
The conversion progress:  40%
The conversion progress:  45%
The conversion progress:  50%
The conversion progress:  55%
The conversion progress:  60%
The conversion progress:  65%
The conversion progress:  70%
The conversion progress:  75%
The conversion progress:  80%
The conversion progress:  85%
The conversion progress:  90%
The conversion progress:  95%
The conversion progress:  100%
The converter will save document to disk...
The converter has ended.
Time for Conversion: 6 seconds
Successfully converted!
=== Thank you for using our product! ===

After executing this command, you'll see feedback similar to the "Output Reference Example" until the conversion is complete.

6. Feedback During Conversion

During the conversion process, FPPDFConverter provides feedback on the conversion progress until it's complete. Upon successful conversion, you'll see a "Successfully converted!" message, along with the time taken for the conversion.

7. Thank You for Using our product

We sincerely thank you for choosing Flyingbee PDF Converter! We hope our product brings convenience to your work and studies.