contented

A file / image / paste upload server with a focus on embedding.

You can use contented as a standalone upload server, or you can use the SDK to embed its upload widget into another website.

The name is a pun on "content" and the -d suffix for server daemons.

Features

Use local disk or S3-backed storage
Drag and drop upload
Multiple files upload
Pastebin upload
Custom drawing upload (via drawingboard.js)
Ctrl-V upload
Galleries and nested galleries
SDK-oriented design for embedding, including CORS support
Mobile friendly HTML interface
Preserves uploaded filename and content-type metadata
Hash verification (SHA512/256)
Detect duplicate upload content and reuse storage
Options to limit the upload filesize, upload bandwidth, and maximum source filesize for thumbnailing
Short URLs (using Hashids algorithm)
Image thumbnailing
Optional multi-tenant binary (contented-multi)

Usage (Server)

Usage of contented:
  -concurrentthumbs int
        Simultaneous thumbnail generation (default 16)
  -data string
        Directory for stored content (default ".")
  -db string
        Path for metadata database (default "contented.db")
  -diskFilesWorldReadable
        Save files as 0644 instead of 0600
  -enableHomepage
        Enable homepage (disable for embedded use only) (default true)
  -enableUpload
        Enable uploads (disable for read-only mode) (default true)
  -listen string
        IP/Port to bind server (default "127.0.0.1:80")
  -max int
        Maximum size of uploaded files in MiB (set zero for unlimited) (default 8)
  -speed int
        Maximum upload speed in bytes/sec (set zero for unlimited)
  -title string
        Title used in web interface (default "contented")
  -trustXForwardedFor
        Trust X-Forwarded-For reverse proxy headers

If you are hosting behind a reverse proxy, remember to set its post body size parameter appropriately (e.g. client_max_body_size for nginx).

Usage (HTTP)

The server responds on the following URLs:

URL	Method	Description
`/get/{ID}`	`GET`	Download item content
`/p/{ID}`	`GET`	Preview item content (HTML)
`/p/{ID}-{ID}-...`	`GET`	Preview multiple item content (HTML)
`/info/{ID}`	`GET`	Get item content metadata (JSON)
`/thumb/{Type}/{ID}`	`GET`	Get item thumbnail image (JPEG). "Type" should match `[sbtmlh]`.
`/about`	`GET`	Get server metadata (JSON)

Usage (Embedding for web)

Your webpage should load the SDK from the contented server, then call the contented.init function to display the upload widget over the top of an existing DOM element:

<script type="text/javascript" src="SERVER_ADDR/sdk.js"></script>
contented.init("#target");

You can optionally supply additional ordered parameters to contented.init:

A callback, that will be passed an array of file IDs of any uploaded items
A callback, that will be called if the SDK widget is closed

Changelog

2023-05-20: 1.5.1

Improve support for albums with no images, and for albums with missing interior images

2023-05-19: 1.5.0

Feature: Support S3-backed storage
Feature: New contented-multi binary to host multiple server configurations from a single process
Enhancement: Better client-side caching for thumbnails
Option to cap source filesize for thumbnailing (default 20MiB)

2023-05-17: 1.4.0

BREAKING: Remove support for some old web browsers (require jQuery 3, ES6 template literals, Promises, Canvas.toBlob)
Feature: Initial album support with custom titles
Feature: Support readonly mode
Enhancement: Use lazy-loading for large image galleries
Enhancement: Better tab titles on preview pages
Fix an issue with continuing server-side thumbnailing work even if the http client has gone away
Fix an issue with not warning on colliding hashIDs
Internal: Refactor the SDK's initialization phase
Internal: Update bolt library dependency

2020-07-25: 1.3.1

Fix an issue with dependencies causing failure to compile in Modules mode

2020-07-25: 1.3.0

Feature: Option to limit concurrent thumbnail generation
Enhancement: Set charset=UTF-8 when serving user-submitted text/plain content
Fix an issue with large memory usage for multipart file uploads

2018-06-09: 1.2.1

Feature: Add OpenGraph tags on preview pages, for rich metadata in chat applications
Update thumbnailing library to improve quality
Use dep for vendoring
⬇️ contented-1.2.1-win32.7z (1.51 MiB)
⬇️ contented-1.2.1-src.zip (1.49 MiB)
⬇️ contented-1.2.1-linux64.tar.gz (2.21 MiB)

2017-11-18: 1.2.0

Feature: Thumbnail support
Feature: File preview page
Feature: Album mode (via URL /p/{file1}-{file2}-...)
Feature: New -diskFilesWorldReadable option to save files with 0644 mode
⬇️ contented-1.2.0-win32.7z (1.36 MiB)
⬇️ contented-1.2.0-src.zip (178.94 KiB)
⬇️ contented-1.2.0-linux64.tar.gz (2.03 MiB)

2017-10-15: 1.1.0

Feature: Drawing mode
Feature: Ctrl+V image upload
Feature: Option to trust X-Forwarded-For headers when using a reverse proxy
Feature: Add getDownloadURL, getInfoJSONURL, getPreviewURL SDK methods
Feature: Option to disable uploading via the homepage
Feature: Add button to repeat when uploading from homepage
Enhancement: Automatically load library dependencies
Enhancement: Display homepage widget using the full screen size
Include drawingboard.js 0.4.6 (MIT license)
Fix a cosmetic issue with javascript console output
Fix a cosmetic issue with error messages if an upload failed
⬇️ contented-1.1.0-win32.7z (1.11 MiB)
⬇️ contented-1.1.0-src.zip (142.82 KiB)
⬇️ contented-1.1.0-linux64.tar.gz (1.67 MiB)

2017-10-08: 1.0.1

Fix an issue with CORS preflight requests
Fix an issue with index URLs
⬇️ contented-1.0.1-win32.7z (1.10 MiB)
⬇️ contented-1.0.1-src.zip (109.08 KiB)
⬇️ contented-1.0.1-linux64.tar.gz (1.65 MiB)

2017-10-08: 1.0.0

Initial public release
Include jQuery 1.12.4 (MIT license)
⬇️ contented-1.0.0-win32.7z (1.10 MiB)
⬇️ contented-1.0.0-src.zip (102.45 KiB)
⬇️ contented-1.0.0-linux64.tar.gz (1.65 MiB)

7.3 KiB Raw Blame History