Thumbrella

@thumbrella/server is the npm launcher package for the Thumbrella server binary.

Thumbrella brings fast, beautiful thumbnails to any online gallery. Supporting 100+ formats: photos, video, documents, 3D models, and other media.

Run the server with one command and zero config. The open-source server comes with all the features and functionality. Then connect with client packages for the browser or any of the other supported languages.

Also check out the Thumbrella Cloud for a distributed server and caching system. This genuine free tier is built for real every day projects; connected in two clicks.

Quickstart

Install globally:

npx @thumbrella/server serve

To keep the server installed, use npm install -g @thumbrella/server and then run thumbrella serve.

Users can also run thumbrella check for quick configuration feedback.

By default the server listens on port 3114. Set TBR_PORT to choose a different port.

See the Server Documentation for full commands and configuration.

Formats

The server executable includes many formats built in statically. You can view available support with:

thumbrella formats

Some advanced formats use external applications from your environment. If those commands are unavailable, Thumbrella returns a placeholder thumbnail.

Alternates

Thumbrella server is available from multiple channels:

• Docker: docker run -p 3114:3114 -it --rm thumbrella/server

Or build from source:

• git clone https://github.com/thumbrella-dev/thumbrella && cd thumbrella
• bash ffs/build-linux.sh (or build-windows.ps1, or set your own FFMPEG_DIR)
• cargo run --release

Cloud Server

Thumbrella also provides a Cloud Server with usable free tiers.

Clients

Direct HTTP use:

curl http://localhost:3114/thumb.jpeg \
  --data-urlencode "url=https://demo.thumbrella.dev/media/harbor-trucks.mp4" \
  --output thumb.jpeg

See Client Libraries for:

• Javascript
• Python
• Rust