Port details |
- imaginary HTTP microservice for high-level image processing
- 20250114_1 www
=0 Package not present on quarterly.This port was created during this quarter. It will be in the next quarterly branch but not the current one. - Maintainer: skozlov@FreeBSD.org
 - Port Added: 2025-07-06 12:12:05
- Last Update: 2025-07-09 16:11:00
- Commit Hash: 2759752
- 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 - 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
Packages (timestamps in pop-ups are UTC):
- 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:
|
Commit History - (may be incomplete: for full details, see links to repositories near top of page) |
Commit | Credits | Log message |
20250114_1 09 Jul 2025 16:11:00
    |
Adam Weinberger (adamw)  |
many: Bump PORTREVISION for go-1.24.5 update |
20250114 06 Jul 2025 23:03:52
    |
Serhii (Sergey) Kozlov (skozlov)  |
www/imaginary: fix build
- Add the new port to www/Makefile
- Explicitly depend on pkgconf, which is needed for build |
20250114 06 Jul 2025 12:09:44
    |
Serhii (Sergey) Kozlov (skozlov)  |
www/imaginary: new port
Used mainly as a high-performance preview generator microservice for
Nextcloud |