#file-format #office #pdf #convert #client #converting #office-convert-server

office-convert-client

Client library for interracting with office-convert-server

3 unstable releases

0.1.1 Sep 21, 2024
0.1.0 Sep 20, 2024
0.0.0 Aug 23, 2024

#297 in HTTP client

MIT license

19KB
296 lines

Office convert server

Simple server for converting office file formats into PDF files built on top of LibreOffice

Requirements

Requires LibreOffice and LibreOfficeKit

Debian:

sudo apt-get install libreoffice libreofficekit-dev clang

[!NOTE] On Debian bullseye you may not have the latest version of the libreofficekit-dev package which will likely cause the build to fail due to missing functions. I recommend building using Fedora or using Debian Bookworm with the "Bookworm Backports" package repo, which you can add using the following command:

echo "deb http://deb.debian.org/debian bookworm-backports main" | sudo tee /etc/apt/sources.list.d/bookworm-backports.list > /dev/null 

The install libreofficekit-dev through that package repo:

sudo apt-get -t bookworm-backports install -y libreofficekit-dev

Fedora:

sudo dnf install libreoffice libreoffice-sdk libreofficekit-devel clang

Ensure you set the following environment variable:

export LO_INCLUDE_PATH=/usr/include/LibreOfficeKit

Env variables

The server requires the following environment variables.

.env files will be loaded from the same and parent directories of the server

SERVER_ADDRESS=0.0.0.0:3000
LIBREOFFICE_SDK_PATH=/usr/lib64/libreoffice/program

Update LIBREOFFICE_SDK_PATH your specific LibreofficeSDK path. This is NOT your Libreoffice path

Building with docker

You can build the binary within docker using the following steps:

Build docker image

Build the docker image from the Dockerfile

docker build -t office_convert .

Create temp container

Create a temporary container for the converter

docker create --name temp_container office_convert

Copy binary from temp container

Then copy the binary from the container to your host:

docker cp temp_container:/app/office-convert-server ./office-convert-server

Cleanup the temp container

Once you have the binary on your host, you can remove the temporary container:

docker rm temp_container

Dependencies

~7–20MB
~300K SLoC