| Port details |
- imaginary HTTP microservice for high-level image processing
- 20251108_2 www
 =0      20250114_17Version of this port present on the latest quarterly branch. - Maintainer: skozlov@FreeBSD.org
- Port Added: 2025-07-06 12:12:05
- Last Update: 2026-08-19 17:39:04
- Commit Hash: 4867821
- 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 = 1784588118
SHA256 (h2non-imaginary-20251108-6a274b488759a896aff02f52afee6e50b5e3a3ee_GH0.tar.gz) = c1c2f9e2e9fdbc38b3e6fb9dd3cdd0a2dad2d2226ff8d1816093d8104c08c4c6
SIZE (h2non-imaginary-20251108-6a274b488759a896aff02f52afee6e50b5e3a3ee_GH0.tar.gz) = 2028551
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.26 : devel/gettext-runtime
- go126 : lang/go126
- 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 |
|---|
20251108_2
19 Aug 2026 17:39:04
 |
Dag-Erling Smørgrav (des) |
various: Bump go ports for go-1.25.14 / 1.26.7 |
20251108_1
14 Aug 2026 00:38:09
|
Dag-Erling Smørgrav (des) |
various: Bump go ports for go-1.25.13 / 1.26.6 |
20251108
20 Jul 2026 23:03:03
|
Serhii (Sergey) Kozlov (skozlov) |
www/imaginary: update to 20251108
Changelog:
https://github.com/h2non/imaginary/commit/6a274b488759a896aff02f52afee6e50b5e3a3ee |
20250114_15
10 Jul 2026 07:54:15
|
Dag-Erling Smørgrav (des) |
various: Bump go ports for go-1.25.12 / 1.26.5 |
20250114_14
03 Jun 2026 17:54:22
|
Dag-Erling Smørgrav (des) |
various: Bump go ports for go-1.25.11 / go-1.26.4 |
20250114_13
09 May 2026 17:25:51
|
Adam Weinberger (adamw) |
various: Bump ports for Go 1.25.10 |
20250114_12
10 Apr 2026 15:57:27
|
Dag-Erling Smørgrav (des) |
various: Bump go ports for go-1.25.9 / 1.26.2 |
20250114_11
06 Mar 2026 03:33:23
|
Adam Weinberger (adamw) |
various: Bump ports for Go 1.25.8 |
20250114_10
11 Feb 2026 19:21:45
|
Adam Weinberger (adamw) |
various: Bump ports for Go default 1.24->1.25 |
20250114_9
05 Feb 2026 16:48:00
|
Adam Weinberger (adamw) |
various: Bump Go ports for 1.24.13 |
20250114_8
16 Jan 2026 17:49:03
|
Adam Weinberger (adamw) |
various: Bump Go ports for 1.24.12 |
20250114_7
03 Dec 2025 18:24:45
|
Adam Weinberger (adamw) |
various: Bump Go ports for 1.24.11 |
20250114_6
06 Nov 2025 17:03:19
|
Adam Weinberger (adamw) |
various: Bump Go ports for 1.24.10 |
20250114_5
14 Oct 2025 15:13:55
|
Adam Weinberger (adamw) |
various: Bump go ports for go-1.24.9 |
20250114_4
08 Oct 2025 00:41:39
|
Adam Weinberger (adamw) |
many: Bump dependent ports after go124 update |
20250114_3
04 Sep 2025 17:53:24
|
Adam Weinberger (adamw) |
many: Bump go ports for go-1.24.7 |
20250114_2
07 Aug 2025 00:02:46
|
Adam Weinberger (adamw) |
go ports: Bump for 1.24.6 |
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 |
As an Amazon Associate I earn from qualifying purchases.