Out of the box, Beebo lists your movies by their file names. Add one free key and your library blooms into proper posters, cast photos, descriptions, release years, and ratings — the polished look you know from the big streaming apps. You do this once, on the computer running Beebo.
What is TMDB? TMDB (The Movie Database) is a free, community-run movie and TV database. Beebo uses your own free key to look up the artwork and details for the films you already own. Your library never leaves your computer — Beebo just fetches the matching poster and description.
You’ll create a free TMDB account and copy your personal key. We’ve made a friendly, illustrated walkthrough with pictures for every click:
Open the illustrated TMDB key guide →
In short: sign up at themoviedb.org, confirm the email they send, open your API settings, request a free Developer key, and copy the long string labelled API Key (v3 auth).
On the computer running Beebo, click the ⚙️ Settings tab.
Paste your key there. Either the short v3 API key or the long v4 Read Access Token works — either one is fine.
The button shows Saved ✓. Beebo starts filling in posters and cast photos right away. New films you add later get matched automatically.
✨ That’s the whole setup. Give it a minute and your grid of file names turns into a wall of posters. If a poster is missing at first, it usually appears once Beebo finishes scanning.
FOLLOW THE NUMBERS
Existing Android screenshot from an earlier build. Labels or layout may differ in your version. Sample library content is not included with Beebo.
Planning to watch somewhere with no internet — a cabin, a campsite, a long drive? In Settings, choose a folder under Offline mode (no internet needed, e.g. at a cabin), then click Download all TMDB info for offline use while you still have internet. Beebo saves every poster, title, year, and cast photo to that folder, so your library stays beautiful even completely off the grid.
Posters and details need a key, but getting one is completely free for a home server and takes about three minutes. Without it, Beebo still plays everything — you’ll just see file names instead of artwork.
Open Settings and use the Re-check all movie matches (force refresh) option — it re-matches every title from scratch and fixes mismatches in one pass. Cleaner file names (for example The Matrix (1999).mp4) also help Beebo find the right match.
In the Beebo desktop app: Settings → TMDB API key / token. Paste, then click Save. You only do this on the computer running Beebo, not on each phone.
No. Your key stays in your Beebo settings on your own PC, and your video files never leave your computer. Beebo only asks TMDB for public artwork and descriptions.
People often say “IMDb” to mean movie posters and info in general. Beebo uses TMDB, a free open database that provides exactly that — posters, cast, and descriptions — with a free key.
This guide uses TMDB and is not endorsed or certified by TMDB. TMDB and the TMDB logo are trademarks of The Movie Database.
