Skip to main content

CLI for reading swedish text-tv

Project description

txtv - A client for reading swedish text tv in the terminal

Text-tv is great! plaintext and to-the-point news with no filler. Now you can read it without touching your mouse or your tv-remote :)

screenshot

Installation

If you have Python 3.6 or later with pip installed, just run

pip install --user txtv

Currently wont work natively on the Windows command line because of readline; but you can use it with Ubuntu for Windows.

Usage

Running with no arguments will enter interactive mode.

txtv

From there you can run any of these commands:

help | h | ? -- show this help text.
quit | q | exit -- quit the program (duh)
list | ls | l -- list all articles
next | n | > -- show next available page.
previous | prev | p | < -- show previous available page.
<PAGE NUMBER> -- show the page at the specified number

You can also give any of these commands as an argument on the normal command line to run un-interactively. Except for quit, next, and previous, because that would make no sense.

txtv 100  # show page 100

txtv ls   # list all news articles

Configuration

txtv.py will automatically generate a config file at ~/.config/txtv/txtv.cfg with default values. It uses format of configparser.

alias

under the alias category you can specify any number of aliases for txtv commands. These will work both in interactive mode and as subcommands when calling txtv from your shell.

example:

[alias]
	all=list

will let you list all articles from shell with

txtv all

or by typing all in interactive mode.

general

So far there is only one option here, named prompt. It is just the prompt string used in interactive mode.

example:

[general]
	prompt = kommandorörelse>

show

Here you can filter out some parts of the pages you might find unnecessary or distracting. These are all boolean variables and the accepted values are those that configparser accepts as true/false:

... config parsers consider the following values True: '1', 'yes', 'true', 'on' and the following values False: '0', 'no', 'false', 'off'.

these are all on by default.

Option Description
svt_header The line at the top that looks like 100 SVT Text Fredag 12 apr 2019. Keep in mind that turning this off might make it hard to keep track of what page you are on in interactive mode. HMU or make a PR if you would like to see only the page number.
publicerad_header The blue line that says when the article was published (INRIKES PUBLICERAD 12 APRIL)
navigation_footer The bottom line that usually says Inrikes 101 Utrikes 104 Innehåll 700. If it does not follow this format (like when the article continues on the next page) it will still be shown.

Right now the most interesting thing there is aliases which work both in CLI mode and interactive mode. You can also change what your interactive prompt looks like if you care about that.

Links

Here is the trello for the development of txtv: https://trello.com/b/aBI0DpN3/txtv

Here is where it's scraping data from: https://www.svt.se/svttext/web/pages/100.html

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

txtv-1.2.1.tar.gz (7.3 kB view hashes)

Uploaded Source

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