Release 3.07

Author: dinkypumpkin

CONTRIBUTORS

@@ -23,6 +23,7 @@ Matthew Boyle
 Mike Crowe
 Mike Fleetwood
 Murray
+Peter Oliver
 Phil Cole
 Ralf Baechle
 Sharon Kimble
@@ -36,4 +37,5 @@ dinkypumpkin
 fs ck
 fsck
 linuxcentrenet
+notnac
 willemw12

get_iplayer

@@ -24,8 +24,8 @@
 #
 #
 package main;
-my $version = 3.06;
-my $version_text = "3.07-dev";
+my $version = 3.07;
+my $version_text;
 $version_text = sprintf("v%.2f", $version) unless $version_text;
 #
 # Help:
@@ -2227,7 +2227,7 @@ sub usage {
 	my @man;
 	my @dump;
 	push @man,
-		'.TH GET_IPLAYER "1" "October 2017" "Phil Lewis" "get_iplayer Manual"',
+		'.TH GET_IPLAYER "1" "November 2017" "Phil Lewis" "get_iplayer Manual"',
 		'.SH NAME', 'get_iplayer - Stream Recording tool and PVR for BBC iPlayer',
 		'.SH SYNOPSIS',
 		'\fBget_iplayer\fR [<options>] [<regex|index> ...]',

get_iplayer.1

@@ -1,4 +1,4 @@
-.TH GET_IPLAYER "1" "October 2017" "Phil Lewis" "get_iplayer Manual"
+.TH GET_IPLAYER "1" "November 2017" "Phil Lewis" "get_iplayer Manual"
 .SH NAME
 get_iplayer \- Stream Recording tool and PVR for BBC iPlayer
 .SH SYNOPSIS
@@ -158,6 +158,9 @@ Show get_iplayer version and exit.
 \fB\-\-attempts <number>
 Number of attempts to make or resume a failed connection.  \-\-attempts is applied per\-stream, per\-mode.  Many modes have two or more streams available.
 .TP
+\fB\-\-audio\-only
+Only download audio stream for TV programme. 'hls' recording modes are not supported and ignored. Produces .m4a file. Implies \-\-force.
+.TP
 \fB\-\-exclude\-supplier <supplier>,<supplier>,...
 Comma\-separated list of media stream suppliers to skip.  Possible values: akamai,limelight,bidi
 .TP
@@ -173,6 +176,9 @@ Start recording matching programmes.  Search terms required unless \-\-pid speci
 \fB\-\-hash
 Show recording progress as hashes
 .TP
+\fB\-\-hls\-hq\-audio
+Attempt to download higher\-quality audio for 'hls' modes (TV only). Output file may require editing to sync audio and video.
+.TP
 \fB\-\-include\-https
 Allow HTTPS playlist/manifest/segment URLs for media streams.
 .TP
@@ -185,9 +191,6 @@ Force HLS/DASH download progress display to be captured when screen output is re
 \fB\-\-modes <mode>,<mode>,...
 Recording modes.  See \-\-tvmode and \-\-radiomode (with \-\-long\-help) for available modes and defaults.  Shortcuts: tvworst,tvworse,tvgood,tvvgood,tvbetter,tvbest,radioworst,radioworse,radiogood,radiovgood,radiobetter,radiobest (default=default for programme type).
 .TP
-\fB\-\-no\-hq\-audio
-Do not attempt to use higher\-quality audio with HLS TV streams ('hvf' and 'hls' modes).
-.TP
 \fB\-\-no\-proxy
 Ignore \-\-proxy setting in preferences and/or http_proxy environment variable.
 .TP
@@ -213,7 +216,7 @@ Record all related episodes if value of \-\-pid is a series or brand PID.  Requi
 Web proxy URL, e.g., http://username:password@server:port or http://server:port.  Value of http_proxy environment variable (if present) will be used unless \-\-proxy is specified. Used for both HTTP and HTTPS. Overridden by \-\-no\-proxy.
 .TP
 \fB\-\-radiomode <mode>,<mode>,...
-Radio recording modes (overrides \-\-modes): dafhigh,dafstd,dafmed,daflow,hafhigh,hafstd,hafmed,haflow,hlsaacstd,hlsaaclow. Shortcuts: worst,worse,good,vgood,better,best,daf,haf,hlsaac (default=dafhigh,hafhigh,dafstd,hafstd,hlsaacstd,dafmed,hafmed,daflow,haflow,hlsaaclow).
+Radio recording modes (overrides \-\-modes): dafhigh,dafstd,dafmed,daflow,hafhigh,hafstd,hafmed,haflow,hlsaachigh,hlsaacstd,hlsaacmed,hlsaaclow. Shortcuts: worst,worse,good,vgood,better,best,daf,haf,hlsaac (default=dafhigh,hafhigh,hlsaachigh,dafstd,hafstd,hlsaacstd,dafmed,hafmed,hlsaacmed,daflow,haflow,hlsaaclow).
 .TP
 \fB\-\-start <secs|hh:mm:ss>
 Recording/streaming start offset (actual start may be several seconds earlier for HLS and DASH streams)
@@ -231,10 +234,10 @@ Test only \- no recording (will show programme type)
 TV recording modes (overrides \-\-modes): dvfhd,dvfsd,dvfxsd,dvfhigh,dvfxhigh,dvflow,hlshd,hlsvhigh,hlsstd,hlsxstd,hvfhd,hvfsd,hvfxsd,hvfhigh,hvfxhigh,hvflow. Shortcuts: worst,worse,vgood,better,best,dvf,hls,hvf (default=hlshd,hvfxsd,hlsvhigh,hvfxhigh,hlsstd,hlsxstd,hvflow).
 .TP
 \fB\-\-url <url>,<url>,...
-Record the embedded media in the specified iPlayer episode URLs.  Use with \-\-type.
+Record the embedded media in the specified iPlayer episode URLs.
 .TP
 \fB\-\-versions <versions>
-Version of programme to record.  List is processed from left to right and first version found is downloaded.  Example: '\-\-versions=audiodescribed,default' will prefer audiodescribed programmes if available.
+Version of programme to record. List is processed from left to right and first version found is downloaded.  Example: '\-\-versions=audiodescribed,default' will prefer audiodescribed programmes if available.
 .SS "Output Options:"
 .TP
 \fB\-\-command, \-c <command>
@@ -258,6 +261,9 @@ Create metadata info file after recording.
 \fB\-\-metadata\-only
 Create specified metadata info file without any recording or streaming.
 .TP
+\fB\-\-no\-sanitise
+Do not sanitise output file and directory names. Implies \-\-whitespace. Invalid characters for Windows ('"*:<>?|') and macOS (':') will be removed.
+.TP
 \fB\-\-output, \-o <dir>
 Recording output directory
 .TP
@@ -497,8 +503,8 @@ Maximum number of connections to use for concurrent programme indexing.  Default
 \fB\-\-purge\-files
 Delete downloaded programmes more than 30 days old
 .TP
-\fB\-\-throttle <Mibit/s>
-Bandwidth limit (in Mibit/s) for media file download. Default: unlimited. Synonym: \-\-bw
+\fB\-\-throttle <Mb/s>
+Bandwidth limit (in Mb/s) for media file download. Default: unlimited. Synonym: \-\-bw
 .TP
 \fB\-\-trim\-history <# days to retain>
 Remove download history entries older than number of days specified in option value.  Cannot specify 0 \- use 'all' to completely delete download history
@@ -511,7 +517,7 @@ get_iplayer was written by Phil Lewis <iplayer2 (at sign) linuxcentre.net> and i
 .PP
 This manual page was originally written by Jonathan Wiltshire <[email protected]> for the Debian project (but may be used by others).
 .SH COPYRIGHT NOTICE
-get_iplayer v3.06, Copyright (C) 2008\-2010 Phil Lewis
+get_iplayer v3.07, Copyright (C) 2008\-2010 Phil Lewis
   This program comes with ABSOLUTELY NO WARRANTY; for details use \-\-warranty.
   This is free software, and you are welcome to redistribute it under certain
   conditions; use \-\-conditions for details.

get_iplayer.cgi

@@ -24,8 +24,8 @@
 # License: GPLv3 (see LICENSE.txt)
 #
 
-my $VERSION = 3.06;
-my $VERSION_TEXT = "3.07-dev";
+my $VERSION = 3.07;
+my $VERSION_TEXT;
 $VERSION_TEXT = sprintf("v%.2f", $VERSION) unless $VERSION_TEXT;
 
 use strict;