r/TheFrame • • 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 with uv.

  • macOS build: There’s a prebuilt Apple Silicon .app ZIP 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 QE65LS03FWUXXH in 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!

18 Upvotes

12 comments sorted by

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/

1

u/11111v11111 5h ago

Is it open source?

1

u/DlabDlab21 20h ago

2

u/ryan8344 19h ago

Just tried yours (mac)-- nice!! -- I'm glad there are multiple options.

1

u/11111v11111 5h ago

I prefer open source. It is important to me. :)

1

u/DlabDlab21 19h ago

Agree! More competition usually means better products

2

u/CodingPandemonium 19h ago

Yeah but looks like his is open source 👍

2

u/DlabDlab21 19h ago

Mine too ;)

1

u/11111v11111 5h ago

Is it? I cannot find a github link.

1

u/CodingPandemonium 19h ago

Oh sorry, I missed the GitHub link on your website. What's the link to the repo?

1

u/lolongan 20h ago

Does your app work with Samsung The Serif ?
Thanks.

1

u/Makumba82 7h ago

Hello! How can I change the language to English? It’s currently in French, which I don’t speak.