# Pictorium

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](</app/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](<https://store.elfhosted.com/product/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](<https://pictorium.elfhosted.com>), where you create a profile and bring your own TMDB key.

Pictorium is built and maintained by [Eful97](<https://github.com/Eful97/Pictorium>), and is powered by the upstream project unmodified.

[Get a 7-day trial of ElfHosted Pictorium! 🪄](<https://store.elfhosted.com/product/pictorium/>)

## How do I access Pictorium?

Pictorium is available:

- From your dashboard: [https://your-username.elfhosted.com](<https://your-username.elfhosted.com>)
- Directly: [https://your-username-pictorium.elfhosted.com](<https://your-username-pictorium.elfhosted.com>)

> [!NOTE]
>
> **Signed-in users see their own URLs**
>
> The addresses above show the general pattern. [Sign in](<https://docs-internal.elfhosted.com/app/pictorium/>) 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](</app/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`*).

> [!NOTE]
>
> **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](</app/aiometadata/>), instead.

## Pictorium also works with

- [x] [AIOMetadata](</app/aiometadata/>)
- [x] [AIOStreams](<https://store.elfhosted.com/product/aiostreams/>)
- [x] [PostersPlus](</app/postersplus/>)

## How do I get support for Pictorium?

1. For general use of Pictorium, refer to the [official site](<https://github.com/Eful97/Pictorium>) 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](</get-help/>)!

## Sponsor Pictorium ❤️

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

- [Ko-fi](<https://ko-fi.com/eful97>)

## Pictorium resources

- [Pictorium (*official site*)](<https://github.com/Eful97/Pictorium>)
- [Pictorium Discord](<https://discord.gg/sYfWyXYVUp>)