Skip to content

Pictorium

Updated

Pictorium composes high-definition posters on the fly for Stremio and other media centers. Each poster starts from clean TMDB artwork and gets a logo-style title placed where the image has room for it, text coloured to suit the artwork's brightness, a soft background blur and vignette, and whichever badges you switch on: IMDb, TMDB, Rotten Tomatoes and Metacritic ratings, live Top 10 ribbons, award marks, studio and network logos, and 4K / FHD / HD quality badges.

It works two ways. Install it as a Stremio addon and it serves its own catalogs (trending, streaming charts, anime, MDBList lists and more) with its posters already applied. Or use only its poster endpoint as the poster source for another addon, such as AIOMetadata, and keep the catalogs you already have.

Your own ElfHosted instance comes with TMDB and MDBList keys already in place, gives you the exact value of every setting (any accent colour, custom badge text, precise slider positions), and renders only your posters. The editor opens with your ElfHosted login, so there is no separate profile password to keep.

Pictorium is also part of the Stremio Addons Bundle. In the bundle it starts switched off: turn it on from your apps dashboard whenever you want it.

Just want to try it first? ElfHosted also sponsors a free public instance at pictorium.elfhosted.com, where you create a profile and bring your own TMDB key.

Pictorium is built and maintained by Eful97, and is powered by the upstream project unmodified.

Get a 7-day trial of ElfHosted Pictorium! 🪄

How do I access Pictorium?

Pictorium is available:

Signed-in users see their own URLs

The addresses above show the general pattern. Sign in and these become your personal, clickable links.

How do I use it?

Open Pictorium from your apps dashboard to reach the editor. The editor is behind your ElfHosted login; the parts Stremio needs (the addon manifest, catalogs, metadata and the poster images) are reachable without it, because Stremio can't sign in.

As a Stremio addon

Choose your badge style, ratings, region and catalogs in the editor, then use Install to Stremio. Your addon manifest lives at:

Replace <domain> with the domain in your dashboard's address (for example elfhosted.com).

https://<your-username>-pictorium.<domain>/manifest.json

As a poster source for AIOMetadata

Point any addon that accepts a custom poster URL at Pictorium's poster endpoint. With AIOMetadata, use the TMDB id placeholder where you can, and the IMDb id where you can't:

https://<your-username>-pictorium.<domain>/api/poster/{type}/{tmdb_id}
https://<your-username>-pictorium.<domain>/api/poster/{type}/{imdb_id}

The editor's install dialog builds these patterns for you, including your badge and style choices as query parameters.

API keys

Your instance comes with TMDB and MDBList keys already set, so posters and catalogs work straight away. To use your own keys instead (for your own rate limits, or MDBList lists tied to your account), set them as environment variables with ElfBot:

Quick-paste into Pictorium's environment variables using ElfBot
PICTORIUM_TMDB_KEY=<your TMDB v3 API key>
PICTORIUM_MDBLIST_KEY=<your MDBList API key>
PICTORIUM_TVDB_API_KEY=<your TheTVDB key, for alternate season ordering>

Keys typed into the editor itself are stored in your browser only. They help the editor's search and previews, but Stremio never sees them, so anything Stremio should use belongs in the environment variables above.

Region

Streaming charts, availability, "Coming Soon" detection and the 4K / FHD / HD quality badge follow a region, which defaults to the United States on ElfHosted. The quality badge reports what streaming services offer in that region. Change it in the editor, or set a default with PICTORIUM_REGION (e.g. GB, DE, IT).

Wrapping other addons

The editor's Proxy tool, which re-skins another addon's catalogs with Pictorium posters, is not available on ElfHosted instances. Use Pictorium's own catalogs, or its poster endpoint with AIOMetadata, instead.

Pictorium also works with

How do I get support for Pictorium?

  1. For general use of Pictorium, refer to the official site or to one of the links in the resources section below.

  2. For specific support re your ElfHosted configuration / account, see the ElfHosted support options!

You can contribute directly to the development of Pictorium using the following:

Pictorium resources

What users say..

We're rocking some excellent ⭐⭐⭐⭐⭐ TrustPilot Reviews, and here's what some of our usersfriends say..

Set up can be intimidating and lots of options but once you get things figured out its been the best service I have used for streaming

★★★★☆ M H. (Trustpilot)

The support from the Discord channels and quick setup using the White Glove VIP setup service is second to none ! I’ve never used a service this refined and polished. I’d highly recommend anyone to sign up and get in the discord straight away the information and help is second to none.

Thanks BSM and Funky Penguelf for the amazing community and streaming stack.

★★★★★ Eric (Trustpilot)

Products work as advertised. Priced what I would consider reasonably for what you get. Had one outage in a month but took them about ten minutes to resolve it so that's fine.

I've not had to use support personally but it seems to be responsive from what I've seen when other people ask for help.

You'd normally get worse service, and a worse product for the amount you're paying, so I can recommend.

★★★★★ IllusiveCam (Trustpilot)

Top Notch service. Products are a great benefit

★★★★★ James D. (Trustpilot)