Skip to content

McKael/samtv

Repository files navigation

samtvcli

samtvcli is a network CLI remote for Samsung TVs from 2014-2015 (I think those are models H & J).

You can use it to send keys with the command line or use its basic text user interface in a console.

You can also use samtv as a Golang library and build your own application.

I have tested it with a Samsung UE48JU6000 TV.

godoc license

Installation

Download

Check the Release page for some pre-built binaries.

Building from source

To install the application from source, just type:

go get -u github.com/McKael/samtv/samtvcli

and you should be able to run samtvcli.

Alternatively, if you use Go v1.11+, you can use go module support:

git clone https://github.com/McKael/samtv
cd samtv/samtvcli
go build

Usage

Get online help with samtvcli help.

Instead of providing IP and session information on the command line for each invocation, you can create a YAML configuration file (expected by default at $HOME/.config/samtvcli/keybindings.yaml). There is a sample configuration file in the repository.

To pair the application with the television, run

% samtvcli pair             # This should display the PIN page on TV
% samtvcli pair --pin CODE

Once paired, a basic text user interface can be used:

% samtvcli tui

Screenshot

The text user interface keybindings can be customized with a YAML configuration file.

You can also use the command line and send several keys at once:

% samtvcli key send KEY_MENU _ KEY_RETURN KEY_VOLUP

Use the help command (or the generated manpages for details).

Free free to send me a message if you like the software!