Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!


Project Description

Download, convert subtitles for NRK TV ( programmes.


  • Python 3.4+
  • Beautiful Soup 4
  • Requests


To download subtitles for a programme, you first need to figure out the programme ID. This can be easily extracted from the programme URL. For example, the ID for this programme,, is MUHH29005014.

Provide this ID to nrksub as the first argument to fetch the subtitles:

$ ./ MUHH29005014


All command line options and arguments, and their purposes can be queried using the help switch:

$ ./ --help


By default, nrksub will print the subtitles out to STDOUT. To write to a file, provide a file name as the second argument:

$ ./ MUHH29005014


nrksub can translate the Norwegian subtitles provided by NRK automatically using Google Translate. The translations are by no means perfect, but they are better than nothing. By default, the subtitles are translated to English, but you can use any language supported by Google Translate:

$ ./ --lang es MUHH29005014
Spanish output
$ ./ --lang de MUHH29005014
German output

If you want the original Norwegian subtitles, set the language to no (for Norwegian). This will skip the translation process:

$ ./ --lang no MUHH29005014


By default, nrksub will output SRT format subtitles. nrksub can also output TTML format subtitles, but this is mostly for debugging purposes and of little use, as rarely any video player supports them:

$ ./ --format ttml MUHH29005014

More formats maybe added in the future, if I have the time.

Release History

Release History

History Node


History Node


This version
History Node


Download Files

Download Files

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

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
nrksub-0.2.0.tar.bz2 (14.5 kB) Copy SHA256 Checksum SHA256 Source Apr 3, 2015
nrksub-0.2.0.tar.gz (16.7 kB) Copy SHA256 Checksum SHA256 Source Apr 3, 2015

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting