| Port details on branch 2025Q4 |
- imaginary HTTP microservice for high-level image processing
- 20250114_4 www
=0 20250114_4Version of this port present on the latest quarterly branch. - Maintainer: skozlov@FreeBSD.org
 - Port Added: 2025-11-01 15:53:31
- Last Update: 2025-11-01 15:48:35
- Commit Hash: ae07b4c
- License: MIT
- WWW:
- https://github.com/h2non/imaginary
- Description:
- Fast HTTP microservice written in Go for high-level image processing backed by
bimg and libvips. imaginary can be used as private or public HTTP service for
massive image processing with first-class support for Docker & Fly.io. It's
almost dependency-free and only uses net/http native package without additional
abstractions for better performance.
Supports multiple image operations exposed as a simple HTTP API, with
additional optional features such as API token authorization, URL signature
protection, HTTP traffic throttle strategy and CORS support for web clients.
imaginary can read images from HTTP POST payloads, server local path or remote
HTTP servers, supporting JPEG, PNG, WEBP, HEIF, and optionally TIFF, PDF, GIF
and SVG formats.
imaginary is able to output images as JPEG, PNG and WEBP formats, including
transparent conversion across them.
¦ ¦ ¦ ¦ 
- Manual pages:
- FreshPorts has no man page information for this port.
- pkg-plist: as obtained via:
make generate-plist - USE_RC_SUBR (Service Scripts)
-
- Dependency lines:
-
- imaginary>0:www/imaginary
- To install the port:
- cd /usr/ports/www/imaginary/ && make install clean
- To add the package, run one of these commands:
- pkg install www/imaginary
- pkg install imaginary
NOTE: If this package has multiple flavors (see below), then use one of them instead of the name specified above.- PKGNAME: imaginary
- Flavors: there is no flavor information for this port.
- distinfo:
- TIMESTAMP = 1751718612
SHA256 (h2non-imaginary-20250114-1d4e251cfcd58ea66f8361f8721d7b8cc85002a3_GH0.tar.gz) = 99b3b1669934520f7ea06d7f11dcf06ecffa6df8d7c636666cb20429a922853b
SIZE (h2non-imaginary-20250114-1d4e251cfcd58ea66f8361f8721d7b8cc85002a3_GH0.tar.gz) = 2023334
No package information for this port in our database- Sometimes this happens. Not all ports have packages. Perhaps there is a build error. Check the fallout link:

- Dependencies
- NOTE: FreshPorts displays only information on required and default dependencies. Optional dependencies are not covered.
- Build dependencies:
-
- gettext-runtime>=0.22_1 : devel/gettext-runtime
- go124 : lang/go124
- pkgconf>=1.3.0_1 : devel/pkgconf
- Library dependencies:
-
- libvips.so : graphics/vips
- libintl.so : devel/gettext-runtime
- libglib-2.0.so : devel/glib20
- libintl.so : devel/gettext-runtime
- There are no ports dependent upon this port
Configuration Options:
- No options to configure
- Options name:
- www_imaginary
- USES:
- gettext-runtime gnome go:modules pkgconfig
- pkg-message:
- For install:
- If you're running imaginary as a part of Nextcloud installation -
configure it using:
# sysrc imaginary_flags="-return-size -max-allowed-resolution 222.2"
Then add this to your Nextcloud's config.php:
'enabledPreviewProviders' => [
'OC\Preview\MP3',
'OC\Preview\TXT',
'OC\Preview\MarkDown',
'OC\Preview\OpenDocument',
'OC\Preview\Krita',
'OC\Preview\Imaginary',
],
'preview_imaginary_url' => 'http://<url of imaginary>:<port>',
- Master Sites:
|