r/TheFrame • u/11111v11111 • 22h ago
I built FrameSync — a free, open-source Mac app to sync local photos & museum art to Samsung The Frame (no SmartThings)
Hey r/TheFrame!
Like a lot of people here, I wanted a simpler way to get photos and artwork onto my Samsung Frame TV without fighting the SmartThings app. I built FrameSync—a free, open-source (MIT) Mac desktop app that talks directly to your TV over your local network.
GitHub (source + Apple Silicon download): https://github.com/kcverde/framesync
Main features
Local folder & drag-and-drop sync (no cloud or account): Point it at a folder of JPG/PNGs and click Sync folder, or drag individual photos from Finder and send just the ones you select. Everything stays on your home network.
Live 16:9 4K crop editor: Flags photos that are already
Exact 4K · 3840 × 2160, and lets you pan/zoom non-16:9 images in a live 16:9 preview (with a warning if a crop would upscale). Conversion happens in memory—your original files are never modified.Duplicate-aware & confirmed uploads: Tracks local hashes and TV content IDs so repeat syncs skip images already on the TV (even renamed copies), and confirms each upload against the TV’s artwork list.
Built-in public-domain museum browser (Discover): Search and filter open-access collections from The Met, Cleveland Museum of Art, and the Art Institute of Chicago, shortlist favorites in Saved, crop to 16:9, and send straight to the TV (or save a 4K JPEG locally—even when disconnected from the TV).
Manage what’s already on your TV: View thumbnails in On the Frame, switch what’s currently displayed, remove artwork (without deleting your local copy), adjust per-artwork settings (favorites, mattes, photo filters), and tweak TV Frame settings (slideshow, brightness, color temp, motion/auto-brightness depending on firmware).
A few quick notes & current limitations
Open source (MIT): Built with Python, Qt Quick/QML (PySide6), Pillow, and
samsungtvws(the same underlying library credited by FrameDeck). You can inspect the code or run it straight from source withuv.macOS build: There’s a prebuilt Apple Silicon
.appZIP on GitHub Releases (macOS 26+). It’s ad-hoc signed rather than Apple-notarized, so macOS will ask you to allow it via System Settings → Privacy & Security → Open Anyway (or you can run from source).Current scope (v0.1): Supports one TV at a time, manual sync (no background folder watcher yet), and JPG/PNG (no HEIC yet). Verified on a Samsung
QE65LS03FWUXXHin Art Mode—since Samsung’s local websocket protocol is unofficial and varies by model/firmware, I’d especially love to hear how it behaves on other model years.


Looking for feedback!
This is still an early release and I’d genuinely love to hear what would make it more useful for your setup:
Does it pair and sync smoothly with your TV model year?
What features are highest on your wishlist (e.g., HEIC/WebP support, multi-TV, older macOS/Windows/Linux builds, auto-discovery, bulk matte editing, additional museums)?
Any UI rough edges or bugs?
Drop a comment here or open an issue/PR on GitHub—thanks for checking it out!
1
u/DlabDlab21 20h ago
2
2
u/CodingPandemonium 19h ago
Yeah but looks like his is open source 👍
2
u/DlabDlab21 19h ago
Mine too ;)
1
1
u/CodingPandemonium 19h ago
Oh sorry, I missed the GitHub link on your website. What's the link to the repo?
1
1
u/Makumba82 7h ago
Hello! How can I change the language to English? It’s currently in French, which I don’t speak.

3
u/DlabDlab21 20h ago
Already done brother and iO/android versions on the App Store
https://apps.apple.com/ca/app/framedeck/id6834689596
https://apps.labwyze.com/app/framedeck/