Deutsch

Installation of gocfl

Before we begin the workshop, gocfl must be installed on your system. Since gocfl is written in Go, it can be installed directly via the Go package manager.

1. Prerequisites

• An installed Go environment (Version 2.26.2 or newer is required).
• Internet access to download the repository.
• Helpful helper programs:
  • Image Magick
  • Ghostscript (MacOS)
  • ffmpeg
  • Tika Server (requires a Java Runtime)
• Image Magick, Ghostscript, and ffmpeg should be discoverable via the system’s path variable to enable automatic configuration.

2. Installation of Helper Programs

The following programs are required for advanced features (metadata extraction, thumbnail generation, PDF migration).

Homebrew (macOS / Linux)

Homebrew is a widely used package manager for macOS and Linux.

• Website: brew.sh
• Installation: Run the command provided on the brew.sh homepage under “Install Homebrew.”

Winget (Windows)

The Windows Package Manager (winget) is pre-installed in modern Windows versions (Windows 10 from 1809, Windows 11).

• Website: learn.microsoft.com/windows/package-manager/winget/
• Installation: If winget is missing, it can be obtained via the Microsoft Store (search for “App Installer”) or directly from GitHub.

Go

Required for installing and running gocfl.

• Windows: winget install GoLang.Go (or Download)
• macOS: brew install go (or Download)
• Linux (Ubuntu/Debian): Since apt often provides outdated versions, installation via Snap or PPA is recommended:
  • Snap (latest): sudo snap install go --classic
  • PPA (latest): sudo add-apt-repository ppa:longsleep/golang-backports && sudo apt update && sudo apt install golang-go
  • Manual: Official installation guide

ImageMagick

Used for image analysis and conversion.

• Windows: winget install ImageMagick.ImageMagick or Download
• macOS: brew install imagemagick
• Linux (Ubuntu/Debian): sudo apt install imagemagick

FFmpeg

Used for extracting audio and video metadata and for creating audio spectrograms.

• Windows: winget install ffmpeg or Download
• macOS: brew install ffmpeg
• Linux (Ubuntu/Debian): sudo apt install ffmpeg

Ghostscript

Required for working with PDF files (e.g., migration to PDF/A).

• Windows: winget install ArtifexSoftware.Ghostscript or Download
• macOS: brew install ghostscript
• Linux (Ubuntu/Debian): sudo apt install ghostscript

Java (JRE/JDK)

Required to run the Tika Server. A version of Java 11 or newer is recommended (e.g., Eclipse Temurin).

• Windows: winget install EclipseAdoptium.Temurin.17.JDK
• macOS: brew install --cask temurin
• Linux (Ubuntu/Debian): sudo apt install default-jre

3. Installation Command for gocfl

Run the following command in your terminal to install gocfl:

go install github.com/ocfl-archive/gocfl/v2/gocfl@v2.0.6-beta45

4. Tika Server

The Tika server can be started with the following command:

java -jar /home/ocfl/tika-server-standard-3.3.0.jar

---

Next to gocfl Usage

Back to Table of Contents