Docent logo — a gallery room with a TV
Docent

Put art on your
TV. One click.

Drop an image into Docent, press "Display on Frame," and it's on your wall. No Samsung app, no USB drive, no cloud upload. A full gallery manager that actually gets art onto your TV.

Get Started GitHub ↗
The Starry Night by Vincent van Gogh, displayed in a Samsung Frame TV
Vincent van Gogh · The Starry Night · 1889

The whole gallery, on your network

Upload, organize, identify, and display. Everything happens locally.

📺

One-Click Display

This is the part people miss: Docent doesn't just manage your art — it sends it to your TV. Press "Display on Frame" and the image appears on your wall instantly. No Samsung app, no USB stick, no cloud upload. Just click.

🖼

Gallery View

Dense grid with hover titles, year grouping, sticky nav. Lightbox, keyboard shortcuts, lazy thumbnails.

🤖

AI Art Analysis

Google Vision finds the painting in museum databases. Then Claude or OpenAI fills in the rest — artist, title, year, medium, movement, mood. Every field links to Wikipedia so you can keep learning.

✂️

Upload & Crop

Drag-and-drop upload with automatic 16:9 compliance checking. Non-conforming images open a built-in crop editor. Choose from shadow box, modern, and panoramic mattes.

🌦

Atmosphere

It checks the weather, reads the mood tags on your art, and picks something that fits. Rainy Tuesday? Different wall than a bright Saturday. Comes with a little note explaining why.

A laptop running Docent in front of a Samsung Frame TV displaying the selected artwork Docent managing a gallery on a Samsung Frame TV

Two minutes, tops

No app store, no subscription, no cloud account. Runs on your machine, talks to your TV.

1

Clone & Launch

Double-click Docent.command or run from the terminal. A guided wizard handles setup — dependencies install automatically.

2

Connect Your TV

Enter your Frame TV's IP address. Docent connects over your local network. Your TV will ask you to allow it — press Allow on your remote.

3

Display

Browse your gallery, tap "Display on Frame" on any piece, and it's on your TV. That's it — one click from screen to wall. Or let Atmosphere pick for you based on the weather.

Two ways to figure out what's on the wall

Set up one or both. Either way, you get artist, title, year, and everything else back.

Optional

🔍 Stage 1: Identify

Google Vision reverse-image-searches your art across museum databases and art sites. Passes what it finds to Stage 2.

Google Vision
→

🎨 Stage 2: Analyze

A vision model looks at the art (plus any hints from Stage 1) and writes back artist, title, year, medium, movement, mood, and a description.

Claude OpenAI

Atmosphere

The weather changes. Your wall changes with it.

🌦 Today's Recommendation
The Starry Night
The Starry Night
☁️ 62°F · Partly cloudy · Arlington, VA

Getting started

Two ways to launch. Both take about two minutes.

🖱 One-Click

Recommended

Best for most users. The setup wizard walks you through everything.

  1. Clone the repo:
    git clone https://github.com/danmunz/docent.git
  2. Double-click Docent.command in Finder
  3. Follow the guided setup — enter your TV's IP, optionally add AI keys

Python and dependencies install automatically if needed.

⌨️ Terminal

For developers and terminal users.

# Clone and configure
git clone https://github.com/danmunz/docent.git
cd docent
cp .env.example .env
# Edit .env — set DOCENT_TV_IP

# Launch
uv run python3 server.py

Open http://localhost:8000 in your browser.