https://github.com/mswift42/nip

command line app to search for and download BBC iplayer programmes.
https://github.com/mswift42/nip

cli go golang iplayer

Last synced: about 1 year ago
JSON representation

command line app to search for and download BBC iplayer programmes.

• Host: GitHub
• URL: https://github.com/mswift42/nip
• Owner: mswift42
• License: mit
• Created: 2018-02-07T16:38:03.000Z (over 8 years ago)
• Default Branch: master
• Last Pushed: 2019-09-04T14:58:54.000Z (almost 7 years ago)
• Last Synced: 2025-03-27T15:47:36.515Z (over 1 year ago)
• Topics: cli, go, golang, iplayer
• Language: Go
• Homepage:
• Size: 22.7 MB
• Stars: 10
• Watchers: 2
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
nip - query [BBC iplayer](https://www.bbc.co.uk/iplayer) for selected tv categories, search for programmes by title, lookup programme info and download programmes using

[youtube-dl](https://github.com/rg3/youtube-dl).

- [INSTALLATION](#installation)

- [DESCRIPTION](#description)

- [LICENSE](#license)

- [COMMANDS](#commands)

- [USAGE](#usage)

# INSTALLATION

## Dependencies

If you want to download iplayer programmes, You need to install [youtube-dl](https://github.com/rg3/youtube-dl).

If you have the Go programming language installed, you can run 

`go get -u github.com/mswift42/nip`

to install nip.

Else, you can grab a binary from the [releases](https://github.com/mswift42/nip/releases) section.

# DESCRIPTION

nip builds a database of the most common iplayer tv categories, and stores that 

as a json file to disk. You can search for programmes by title or category, print

a programmes synopsis, go to a programmes homepage, list related links for a programme

and download programmes using youtube-dl.

# LICENSE

nip is licensed under the [MIT License](https://github.com/mswift42/nip/blob/master/LICENSE).

# COMMANDS

-   list, l              list all available categories.

-   category, c          list all programmes for a category.

-   search, s            search for a programme.

-   show, sh             open a programme's homepage.

-   synopsis, syn        print programme's synopsis

-   links, lnk           show related links for a programme

-   download, g, d, get  use youtube-dl to download programme with index n

-   formats, f           list youtube-dl formats for programme with index n

-   refresh, r           refresh programme db

# USAGE

enter `nip` followed by the command you want to run.

**Examples**

`nip l` lists all categories,

`nip c crime` lists all programmes in category crime.

`nip --help` shows the help output.

`nip s pride` lists all programmes with "pride" in their title.

`nip g 133` downloads programme with index 133 in the best available index.

`nip g 133 ` downloads it with the specified youtube-dl format.