Skip to content

Commit

Permalink
Create README.md
Browse files Browse the repository at this point in the history
  • Loading branch information
aarinz authored Sep 1, 2024
1 parent 7f7be64 commit 24c6e63
Showing 1 changed file with 77 additions and 0 deletions.
77 changes: 77 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,77 @@
# QuickDoc
QuickDoc is a command-line tool for Linux that allows you to convert documents between different formats, such as DOCX to PDF, PDF to DOCX, and PPT to PDF. It leverages LibreOffice, the default office suite in many Linux distributions, for handling document conversions. QuickDoc supports searching for input files across the entire system and saves output files in the same directory as the input file, ensuring seamless and efficient document management.

I created QuickDoc because I found it frustrating that LibreOffice doesn't offer a direct option to convert PDF files to DOCX or other formats. It was inconvenient to rely on websites for file conversions, so I developed this command-line tool to simplify the process. QuickDoc makes it easy to convert files directly from the terminal, saving time and effort.

## Features

- Convert DOCX files to PDF
- Convert PDF files to DOCX
- Convert PPT files to PDF
- Search for input files across the system
- Save output files in the same directory as the input file

## Requirements

- Python 3.x
- LibreOffice (for PPT to PDF and DOCX to PDF conversion)
- Required Python packages:
- `pdf2docx`
- `docx2pdf`

## Installation

1. Clone the repository:

```bash
git clone https://github.com/yourusername/quickdoc.git
```

2. Navigate to the project directory:

```bash
cd quickdoc
```

3. Install the required Python packages:

```bash
pip install pdf2docx docx2pdf
```

4. Open a terminal and use `nano` to create a file named `quickdoc` in `/usr/local/bin/`:

```bash
sudo nano /usr/local/bin/quickdoc
```

5. Copy the contents of `quickdoc.py` into the file you just created with `nano`.

6. Save and exit `nano` by pressing `Ctrl + O` to write the file, then `Enter` to confirm, and `Ctrl + X` to exit.

7. Make the script executable:

```bash
sudo chmod +x /usr/local/bin/quickdoc
```

## Usage

### General Command Structure

```bash
quickdoc <conversion_type> --i <input_file> --o <output_file>
```

## Example

```bash
quickdoc pdf2docx --i EX3.pdf --o EX3.docx
```

### If File name is with spaces

```bash
quickdoc pdf2docx --i "EX 3.pdf" --o "EX 3.docx"
```

0 comments on commit 24c6e63

Please sign in to comment.