https://github.com/mckael/samtv

samtvcli -- Network CLI remote for Samsung TVs (models 2014-2015)
https://github.com/mckael/samtv

cli cli-app go golang library samsung samsung-smart-tv smartview

Last synced: 17 days ago
JSON representation

samtvcli -- Network CLI remote for Samsung TVs (models 2014-2015)

• Host: GitHub
• URL: https://github.com/mckael/samtv
• Owner: McKael
• License: mit
• Created: 2018-09-28T19:35:56.000Z (about 6 years ago)
• Default Branch: master
• Last Pushed: 2023-02-25T09:22:51.000Z (over 1 year ago)
• Last Synced: 2024-10-03T12:34:52.735Z (about 1 month ago)
• Topics: cli, cli-app, go, golang, library, samsung, samsung-smart-tv, smartview
• Language: Go
• Homepage: https://lilotux.net/~mikael/pub/samtv/
• Size: 169 KB
• Stars: 40
• Watchers: 4
• Forks: 4
• Open Issues: 4
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# 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](https://img.shields.io/badge/godoc-reference-blue.svg?style=flat)](https://godoc.org/github.com/McKael/samtv)

[![license](https://img.shields.io/badge/license-MIT-red.svg?style=flat)](https://raw.githubusercontent.com/McKael/samtv/master/LICENSE)

## Installation

### Download

Check the [Release page](https://github.com/McKael/samtv/releases) 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](https://raw.githubusercontent.com/McKael/samtv/master/samtvcli/samtvcli.yaml) 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](samtvcli/doc/samtvcli_001.jpg "Screenshot")

The text user interface keybindings can be customized with a [YAML

configuration file](https://raw.githubusercontent.com/McKael/samtv/master/samtvcli/keybindings.yaml).

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](samtvcli/doc/manual/md/samtvcli.md)

for details).

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