Skip to main content

A curses-based TiVo remote control

Project description

tivo

usage: tivo [-h] [-H] [-v] [-V] [--config FILE] [--print-config] [--print-url]
            [--completion [SHELL]]
            COMMAND ...

`tivo` controls remote TiVo™ devices. When no `COMMAND` is given,
tivo listens for broadcasts from remote devices, and presents an
interactive terminal application to display their status, change
channels, navigate menus, enter text into search box, etc. with the
full computer keyboard.

Channels may also be changed from the command line.

Specify one of:
  COMMAND
    downch              Tune to previous channel on `HOST`.
    emulator            Run a TiVo set-top device emulator.
    getch               Get and print channel from `HOST`.
    list                List `HOST`s.
    setch               Tune `HOST` to `CHANNEL`.
    upch                Tune to next channel on `HOST`.

Configuration file:
  TiVo devices broadcast a unique, non-readable `identity` string
  every few minutes. The `--config FILE` maps `identity` to `host`
  names, like `/etc/hosts`.

General options:
  -h, --help            Show this help message and exit.
  -H, --long-help       Show help for all commands and exit.
  -v, --verbose         `-v` for detailed output and `-vv` for more detailed.
  -V, --version         Print version number and exit.
  --config FILE         Use config `FILE` (default: `~/.tivo.toml`).
  --print-config        Print effective config and exit.
  --print-url           Print project url and exit.
  --completion [SHELL]  Print completion scripts for `SHELL` and exit
                        (default: `bash`).

tivo downch

usage: tivo downch [-h] HOST

The `tivo downch` command tunes `HOST` down to previous channel.

positional arguments:
  HOST        Target tivo device.

options:
  -h, --help  Show this help message and exit.

tivo emulator

usage: tivo emulator [-h] [-n NUM_DEVICES] [-s STAGGER] [-i INTERVAL] [-r]

Tivo Device Emulator.

This program emulates a TiVo set-top device, which:
    1. Sends a UDP broadcast message every minute or so,
    2. Listens for TCP connections, and responds to requests.

This is for testing basic features of the client application
without an actual device.

options:
  -h, --help            Show this help message and exit.
  -n, --num_devices NUM_DEVICES
                        Number of TiVo devices to emulate (default: `1`).
  -s, --stagger STAGGER
                        Delay the start of each device's TCP-listener in
                        seconds. Meaningful when NUM_DEVICES is greater than 1
                        (default: `0`).
  -i, --interval INTERVAL
                        Interval between broadcasts in seconds (default:
                        `60`).
  -r, --randomize       Randomize the interval, by 50-150%, between each
                        device's broadcast (default: `False`).

tivo getch

usage: tivo getch [-h] HOST

The `tivo getch` command gets and prints channel from `HOST`.

positional arguments:
  HOST        Target tivo device.

options:
  -h, --help  Show this help message and exit.

tivo list

usage: tivo list [-h]

The `tivo list` command lists known `HOST`s.

options:
  -h, --help  Show this help message and exit.

tivo setch

usage: tivo setch [-h] HOST CHANNEL

The `tivo setch` command tunes `HOST` to `CHANNEL`.

positional arguments:
  HOST        Target tivo device.
  CHANNEL     Change to `CHANNEL` on `HOST`.

options:
  -h, --help  Show this help message and exit.

tivo upch

usage: tivo upch [-h] HOST

The `tivo upch` command tunes `HOST` up to next channel.

positional arguments:
  HOST        Target tivo device.

options:
  -h, --help  Show this help message and exit.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

rlane_tivo-1.0.5.tar.gz (16.4 kB view details)

Uploaded Source

Built Distribution

rlane_tivo-1.0.5-py3-none-any.whl (20.2 kB view details)

Uploaded Python 3

File details

Details for the file rlane_tivo-1.0.5.tar.gz.

File metadata

  • Download URL: rlane_tivo-1.0.5.tar.gz
  • Upload date:
  • Size: 16.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.1 CPython/3.13.0

File hashes

Hashes for rlane_tivo-1.0.5.tar.gz
Algorithm Hash digest
SHA256 7f0d75aac00f51a1edbcb456087af52294cd0e5a10cbfd1b75a913f856cac498
MD5 06a8ac591ddfef2ddbb127eb64f3da5e
BLAKE2b-256 251877d26f57f2e9c49aa2370d4d9d9d95e77f6314706acaaad970c3b2c080cc

See more details on using hashes here.

File details

Details for the file rlane_tivo-1.0.5-py3-none-any.whl.

File metadata

  • Download URL: rlane_tivo-1.0.5-py3-none-any.whl
  • Upload date:
  • Size: 20.2 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.1 CPython/3.13.0

File hashes

Hashes for rlane_tivo-1.0.5-py3-none-any.whl
Algorithm Hash digest
SHA256 93ed0a12ac30abae0bbe8dc646f9e0c6640ec494489b45ce554da72fa4bf3aae
MD5 597ac3097ad3842e4384df0ae92ec8e9
BLAKE2b-256 2e19bcac9d9464ed23fac9d5a7a5a2e4502006e1321f2b4253f4eeb08b4e4e81

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page