For UK consumers who download BBC iPlayer content for offline viewing, managing the resulting video files can present challenges. The default filenames and formats are not always optimised for personal media libraries or compatibility with popular media centre software. Several open-source and free tools have been developed to address this, automating the process of converting, renaming, and organising downloaded iPlayer programmes. These tools can help users create a more accessible and structured personal archive of BBC content, though it is crucial to understand their technical nature and the legal framework surrounding the download and use of iPlayer programmes.
The core of this process typically involves the command-line utility get_iplayer, which is used to download BBC iPlayer programmes. The resulting files often have complex filenames and are in the MP4 format. Free, community-developed scripts and programmes are available to post-process these downloads, performing tasks such as converting the video to a more efficient codec, renaming files to a standard format compatible with media servers like Kodi, Jellyfin, or Sonarr, and moving them to a designated directory. These tools are not official BBC products but are created by developers to enhance the user experience for those who download programmes for personal, non-commercial use in accordance with the BBC's terms and conditions.
Understanding the Post-Processing Workflow
The typical workflow for managing downloaded iPlayer content involves several distinct steps. First, a programme is downloaded using get_iplayer. The downloaded file, an MP4 video, carries a default filename format that includes the programme name, episode title, and a unique programme identifier (PID). While descriptive, this filename is not structured for seamless integration with media library software. Post-processing scripts are designed to automate the subsequent steps.
A primary function of these tools is file conversion. One script, for instance, converts the downloaded MP4 files to the H.265 codec using the ffmpeg library. H.265 (also known as HEVC) is a video compression standard that offers significantly better compression efficiency than its predecessor, H.264, meaning video files can be reduced in size while maintaining a high level of visual quality. This is particularly useful for users with limited storage capacity. The conversion process in this script is configured with a Constant Rate Factor (CRF) of 24 and a medium preset, which represents a balance between file size and processing time.
Another critical task performed by these post-processing tools is renaming and reorganising the files. The goal is to adopt a naming convention that is widely recognised by media management software. For example, a file named Escape_to_the_Country_Series_25_-_07._Devon_m0023jdj_original.mp4 might be automatically detected and renamed to Escape to the Country S25E07.mp4. This standardised format, using the pattern Show Name SxxExx, allows media centres like Kodi, Jellyfin, and Sonarr to automatically scan, categorise, and display the programme correctly, fetching metadata such as episode summaries and cover art.
Furthermore, these tools often include smart file handling features. They can detect and skip files that are still in the process of being downloaded, preventing errors and ensuring that only complete files are processed. They also work to prevent the creation of duplicate files, which can occur if a user runs the conversion script multiple times on the same source directory. Once processed, the finalised files are typically moved to a designated "blackhole" directory or a specific destination folder, such as a directory monitored by a media server application.
Available Free Tools and Their Features
Several specific tools are documented in the provided source material, each with its own approach and features.
iplayer_convert.sh (A Bash Script)
This is a Bash script designed to automate the post-processing of get_iplayer downloads. Its key features include:
* Automatic Detection: It requires no initial configuration to detect the show name, series number, and episode number from the default filename format.
* H.265 Conversion: It uses ffmpeg to convert the video file to the H.265 codec to reduce file size.
* Media Centre Compatibility: It renames the output file to the Show Name SxxExx.mp4 format, making it compatible with Jellyfin and Sonarr.
* Unattended Operation: It is designed to run fully automatically, making it suitable for integration into an automated download workflow.
* Configuration Options: While it works with zero configuration, it also supports command-line overrides (e.g., --series 26, --show-name "Country House Rescue") and a persistent configuration file (~/.iplayer_convert.conf) for custom settings like source and destination directories.
get_iplayer-to-kodi-converter (A Perl Program)
This programme is specifically designed to make downloaded iPlayer content compatible with the Kodi media centre. Its operation is based on the following principles:
* File Type Handling: It works on the default file types downloaded by get_iplayer, which are .mp4 for films and TV programmes and .m4a for radio programmes.
* Metadata Dependency: The programme obtains the necessary information for renaming and reorganising from the associated .xml metadata file that get_iplayer can optionally download alongside the media file.
* Flexible File Management: By default, it copies files to the destination directory, but this behaviour can be changed to move the files via a command-line argument.
* Directory Structure: It allows for custom subdirectory names for different media types (films, TV, radio) and lets users specify the separator character used in file and directory names (underscore, period, or whitespace).
* Metadata Retrieval: It can be configured to attempt to download missing metadata files (like .cue, tracks.txt, and credits.txt) using get_iplayer if they are not present.
Technical Considerations and Limitations
While these free tools offer powerful automation for media management, there are technical limitations and important considerations. A significant point highlighted in the source data is the issue of DRM (Digital Rights Management) protection. One source notes that BBC iPlayer uses two different video formats: WMV and MP4. It states that while DRM-protected WMV files can be converted after being recorded using software like Windows Media Player or iTunes, "the software" (referring to a third-party DRM removal tool) is currently unable to convert the specific formatting of BBC iPlayer's MP4 files. This indicates that the conversion tools discussed here, which rely on ffmpeg, are intended for use after the download process, not for DRM removal. The tools are designed to work with the MP4 files as they are delivered by get_iplayer.
It is also important to note that get_iplayer itself is a separate, third-party utility. The post-processing scripts and converters depend on get_iplayer being installed and functional on the user's system. Some tools, like the Perl-based Kodi converter, will attempt to locate get_iplayer in the system's $PATH or allow the user to specify its path. Furthermore, these tools are primarily command-line based, which may present a learning curve for users who are not familiar with terminal commands. However, the provision of configuration files and clear command-line arguments helps to make them more accessible.
Legal and Ethical Context for UK Consumers
For UK consumers, it is essential to understand the legal framework surrounding the download of BBC iPlayer content. The BBC's terms and conditions allow users to download programmes for offline viewing, but this is strictly for personal, non-commercial use. The downloaded files are protected by DRM to prevent unauthorised redistribution. The free, open-source tools described in this article do not circumvent this DRM; they are designed to work with the downloaded files to improve their organisation and compatibility for personal media libraries. Using these tools in conjunction with get_iplayer for personal archiving is generally considered acceptable, but distributing the downloaded files or using them for commercial purposes is a violation of copyright and the BBC's terms of service.
The tools themselves are released under open-source licences (e.g., the GNU General Public License v3.0), which allows for free use, modification, and distribution of the code. They are developed and maintained by the community, and their use is at the user's own risk. As with any software, it is advisable to review the source code and documentation before use.
Conclusion
For UK consumers who regularly download BBC iPlayer programmes for offline viewing, free post-processing tools offer a valuable solution for managing their media collections. Tools like the iplayer_convert.sh Bash script and the get_iplayer-to-kodi-converter Perl programme automate the tasks of converting video to more efficient formats, renaming files to media-centre-compatible standards, and organising them into structured directories. These tools enhance the usability of downloaded content, making it easier to integrate into personal media servers like Kodi, Jellyfin, and Sonarr. However, users must be aware of the technical nature of these command-line utilities and operate within the legal boundaries set by the BBC for personal, non-commercial use of downloaded programmes.