Skip to content

tits4net/goframegui

Repository files navigation

goframegui

App Screenshot

Motivation

An alternative GUI client for Samsung The Frame TV, as both the smartphone app (SmartThings) and the TV's built-in UI are often cumbersome. This project was developed for my own usage but might be useful for others. It is still in its early stages but works well for my specific use cases, focusing primarily on bulk processing (matte settings, uploading, deleting, etc.).

Usage

  1. Add the TV's IP address.
  2. Allow this software on the TV screen (a prompt should appear on the TV).
  3. You may need to ensure "External Control" is enabled in the TV's settings.

Note

For large uploads, it is recommended to use the USB port on the TV and import images directly. This method is more reliable, although you can still attempt uploads using this software.

Building

This project is built using Go. A Makefile is provided for convenience.

Build for Linux

make build

Build for Windows (Using Docker - Recommended)

If your local mingw-w64 version is older than v12.0.0 (common on Ubuntu/Mint), you will encounter linker errors (isblank). In this case, use Docker to build the binary using a Fedora-based environment:

make build-windows-docker

The resulting .exe will be in the bin/ directory.

Build for Windows (Local)

To build for Windows directly on your host (requires mingw-w64 v12.0.0+):

make build-windows

Support

  • Linux: Tested and working.
  • Windows: Supported (via cross-compilation). Minimal testing, feedback welcome.
  • macOS: Not tested. Feedback is welcome.

TV Support

Model Art API Version Status
Samsung The Frame 32" (2023) (QE32LS03) 4.3.4.0 Supported

Note

This project was partially "vibecoded". I took all care to review and test it but well ... you may reach unexpected behavior.

Contribute

Feel free to open a Pull Request. Feedback and suggestions are also welcome!

Acknowledgments

Special thanks to the following projects for their work in reverse-engineering the protocol:

About

An alternative client for Samsung The Frame TV

Resources

License

Stars

Watchers

Forks

Packages