3 unstable releases
0.1.1 | Sep 21, 2024 |
---|---|
0.1.0 | Sep 20, 2024 |
0.0.0 | Aug 23, 2024 |
#285 in HTTP client
412 downloads per month
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
~6–20MB
~305K SLoC