On GitHub, xbmc/inputstream.ffmpegdirect has picked up 101 stars, C++. Supports streams opened by FFmpeg's libavformat or Kodi's cURL such as plain TS, HLS and DASH (non-DRM) as well as many others. There is support for Archive/Catchup services where there is a replay window and can timeshift across that span. Also provides timeshift for live streams where rewind/pause and fast-forward would not have been available.
Snapshot summary built from the project's own GitHub metadata — there's no written TopGit review yet. The page will update automatically when a full review is published.
WHY NO REVIEW YET
TopGit writes full reviews for the most-starred, most-requested repositories. This page is a snapshot until then — see the READ ME tab for the original README in full.
This is a Kodi input stream addon for streams that can be opened by either FFmpeg's libavformat or Kodi's cURL. Common stream formats such as plain TS, HLS and DASH are supported as well as many others. Note that the only DASH streams supported are those without DRM.
The addon also has support for Archive/Catchup services where there is a replay window (usually in days) and can timeshift across that span. In addition the addon can also provide timeshift to live streams where rewind/pause and fast-forward woud not have previously been possible.
Platform specific differences
There are a few minor differences between the implementations. If using the kodi Ubuntu PPA the underlying ffmpeg is the same as Kodi's, which means it won't support teletext or Dash without DRM but it will currently have AV1 support as Kodi does. For users who need it with teletext or Dash without DRM support please just build the addon using the instructions below.
On windows there is no teletext support unfortuntely as libzvbi is not currently building. If anyone would like to figure this out I'm sure the users would appreciate it.
Finally, outside of the Ubuntu PPA there is currently no support for AV1. This is simply because the python3/ninja/meson build system required to build libdav1d would have to be built from scratch specifically for the addon. I'm sure support will get added eventually when someone has the time to do it.
The addon files will be placed in ../../xbmc/build/addons so if you build Kodi from source and run it directly the addon will be available as a system addon.
Mac OSX
In order to build the addon on mac the steps are different to Linux and Windows as the cmake command above will not produce an addon that will run in kodi. Instead using make directly as per the supported build steps for kodi on mac we can build the tools and just the addon on it's own. Following this we copy the addon into kodi. Note that we checkout kodi to a separate directory as this repo will only only be used to build the addon and nothing else.
make -j$(getconf _NPROCESSORS_ONLN) -C tools/depends/target/binary-addons ADDONS="inputstream.ffmpegdirect" ADDON_SRC_PREFIX=$HOME
Note that the steps in the following section need to be performed before the addon is installed and you can run it in Kodi.
To rebuild the addon and copy to kodi after changes (after the initial addon build)
cd $HOME/inputstream.ffmpegdirect
./build-install-mac.sh ../xbmc-addon
If you would prefer to run the rebuild steps manually instead of using the above helper script check the appendix here
Settings
FFmpeg HTTP Proxy
This category contains the settings for network configuration such as FFmpeg proxy and bandwidth limits.
Use HTTP proxy when opening with FFmpeg: Whether or not a proxy should be used when opening with FFmpeg. Note that if opened using curl kodi's proxy settings will be used.
Server: Configure the proxy server address.
Port: Configure the proxy server port.
Username: Configure the proxy server username.
Password: Configure the proxy server password.
Stream selection bandwidth: Use this value as a maximum when selecting which HLS stream to use.
Timeshift
This category contains the settings for timeshift. Timeshifting allows you to pause live TV as well as move back and forward from your current position similar to playing back a recording.
Timeshift buffer path: The path used to store the timeshift buffer. The default is the addon_data/inputstream.ffmpegdirect/timeshift folder in userdata. Note that this folder will be cleared of timeshift files on Kodi startup. Only relevant when `inputstream.ffmpegdirect.stream_mode=timeshift" property is passed to the addon.
Enable timeshift limit: Enable this option to limit the length of the timeshift buffer.
Maximum timeshift buffer length: The length of the timeshift buffer in hours. Once the value is reached the older buffer data will be deleted to ensure the limit is not breached. Note that the storage for your device should be sufficient to allow the buffer to grow to it's maximum length (otherwise it's equivalent to disabling this option). A good heuristic for video size is 130MB per minute of 1080p video and 375MB per minute of 4K video.
Advanced
This category contains the advanced settings for the addon.
Allow FFmpeg logging: If enabled the addon will log any FFmpeg logging to the Kodi log.
Probe for FPS: Probe for frames per second. Default enabled. If disabled the value returned by the codec will be used.
Enable teletext: Allow teletext. Default enabled.
Use fast open for streams using a manifest file: Streams which have a manifest file (e.g. HLD/DASH/Smooth Streaming) can be opened more quickly with FFmpeg with this option enabled.
For catchup streams report stream is not realtime: For certain catchup streams such as HLS reporting that a live stream is not live can improve stream open times. If testing this option works for a catchup stream/provider, then add a #KODIPROP=inputstream.ffmpegdirect.is_realtime_stream=false to the M3U entry in question. This setting should not be left enabled for all streams.
Using the addon
The addon can be accessed like any other inputstream in Kodi. The following example will show how to manually choose this addon for playback when using IPTV Simple Client with the following entry in the M3U file (Note that the IPTV Simple Client will in fact automatcially detect a catchup stream and use the addon based on configured settings).
stream_mode: If the value timeshift is supplied the live stream will have a local timeshift buffer. If catchup is supplied the inputstream will start in catchup mode. Any other value or if omitted will open as a regular stream.
open_mode: If the value ffmpeg is supplied the inputstream will be opened with AVFormat. If the value curl is supplied the inputstream will be opened with cURL. If neither value is supplied the default is to open HLS, Dash and Smooth Streaming with AVFormat and anything else as a kodi file. Note that a mimetype or manifest_type property is required to be able to tell if a stream is HLS or Dash. If using Smooth streaming only a manifest_type property will work as Smooth Streaming does not have a mimetype.
manifest_type: Allowed values are hls for HLS, mpd for Dash and ism for Smooth Streaming.
default_url: The URL to use if a catchup URL cannot be generated for any reason.
playback_as_live: Should the playback be considerd as live tv, allowing skipping from one programme to the next over the entire catchup window, if so set to true. Otherwise set to false to treat all programmes as videos.
programme_start_time: The unix time in seconds of the start of the programme being streamed - optional.
programme_end_time: The unix time in seconds of the end of the programme being streamed - optional.
catchup_url_format_string: The URL including format specifiers to use to generate catchup URLs when seeking the stream.
catchup_url_near_live_format_string: Some providers require a different catchup URL when close to live playback so the stream does not stop.
catchup_buffer_start_time: The unix time in seconds of the start of catchup window.
catchup_buffer_end_time: The unix time in seconds of the end of catchup window.
catchup_buffer_offset: The offset from the catchup buffer start time where playback should begin.
catchup_terminates: Indicates with a value of true or false if a catchup stream will specify an end time and will stop eventually. Essentially means that the provider does not support delayed live streams. Value used by the addon to try and restart with a new end time near the end of the stream.
catchup_granularity: The granularity the catchup source can seek to in seconds. Generally a value of 1 or 60 is used.
timezone_shift: The value in seconds to shift the catchup times by for your timezone. Valid values range from -43200 to 50400 (from -12 hours to +14 hours).
default_programme_duration: If the programme duration is unknown use this default value in seconds instead. If this value is not provided 4 hours (14,400 secs) will be used will be used.
programme_catchup_id: For providers that require a programme specifc id the following value can be used in the url format string.
Notes:
Setting playback_as_live to true only makes sense when the catchup start and end times are set to the size of the catchup windows (e.g. 3 days). If the catchup start and end times are set to the programme times then playback_as_live will have little effect.
For catchup streams that terminate there is a minimum distance from live a stream can seek to/from. For streams with a 1 second granularity it's 1 minute, and for stream with a 60 second granularity it's 2 minutes. The reason for this window on terminating streams is to allow the restart functionality to work.
For all catchup streams any seek to within 10 seconds of live would be considered live and will switch to the default URL. For this reason seeking from live to less than 10 seconds has no effect.
Appendix
Manual Steps to rebuild the addon on MacOSX
The following steps can be followed manually instead of using the build-install-mac.sh in the root of the addon repo after the initial addon build has been completed.
Does xbmc/inputstream.ffmpegdirect have a project website?
No homepage URL was recorded for xbmc/inputstream.ffmpegdirect in TopGit's last sync. The README tab above frequently contains screenshots and demo links, or check the repository description on GitHub.
How active is development on xbmc/inputstream.ffmpegdirect?
The most recent commit recorded on xbmc/inputstream.ffmpegdirect was 1 month ago, based on the GitHub push timestamp. The repository has 54 forks — one of the better signals of community interest.
How many stars does xbmc/inputstream.ffmpegdirect have?
xbmc/inputstream.ffmpegdirect has 101 GitHub stars — refresh the page for the live number, or check github.com/xbmc/inputstream.ffmpegdirect. TopGit mirrors GitHub's count but does not claim minute-by-minute accuracy.
What language is xbmc/inputstream.ffmpegdirect written in?
xbmc/inputstream.ffmpegdirect is written primarily in C++. GitHub's language field is based on the largest share of bytes in the default branch.
What license does xbmc/inputstream.ffmpegdirect use?
xbmc/inputstream.ffmpegdirect is released under the GPL-2.0 license. Always verify the LICENSE file directly on GitHub for the authoritative terms — license strings can be edited out of sync with a project's actual stance.
What topics is xbmc/inputstream.ffmpegdirect associated with?
GitHub's repository topics for xbmc/inputstream.ffmpegdirect: "hacktoberfest", "kodi". TopGit's editorial category is open-source.
Where do I read more about xbmc/inputstream.ffmpegdirect?
This TopGit page is a snapshot — the READ ME tab shows the project's own README content (links stripped, images preserved). The GitHub repository at github.com/xbmc/inputstream.ffmpegdirect is the definitive source.
Read full README in the tab above.
Still deciding about inputstream.ffmpegdirect?
One click hands the question to an AI along with this page — see what it says about inputstream.ffmpegdirect.
