Plugin "plugin.video.arteplussept" to watch Arte content on Kodi (ex XBMC). Can be used without or with Arte account in order to benefit from a better cross-device experience. For instance starting a video or a serie on the mobile app and resume it on kodi.
- Browse and watch Arte replays
- Watch Arte live stream
- Search for content on Arte
- Browse or search multi-page content
- Play serie as a playlist or browse serie as a menu.
- Resume a serie from the first not completed episode thanks to Arte history (login required)
- Load serie as a playlist, when watching one of its episode
- Login with your Arte account without storing password on filesystem - only the token
- Resume videos from where you stopped them (cross device) (login required)
- Manage - view or purge - your Arte history (login required)
- Manage - view, add, delete or purge - your Arte favorites (login required)
- Supported language : DE, EN, FR, IT, PL, RO
- Multiple language content
- Subtitles
- Geo blocking
- Display of availability / broadcasting dates
For feature requests or reporting issues go here.
The extension is free. Nevertheless, any donation will motivate me to maintain it. Various donation methods are listed at https://thomas-ernest.github.io/
Contributions are welcome ! You may look at the issues or unsupported features above.
Follow the steps bellow depending on your system and software version
Kodi is installed on a different path according to the operating system it is installed on. You can refer to this page. Go to $KODI_FOLDER/addons/
In Kodi addons folder
- clone this repository or one of if its forks (preferred) and move source to plugin folder
git clone https://github.com/thomas-ernest/plugin.video.arteplussept.gitmv plugin.video.arteplussept/plugin.video.arteplussept plugin.video.arteplussept
- or download the plugin :
- If you downloaded a zip, extract the content of the zip in the
addonsfolder. - Make sure that the addon is in folder
plugin.video.arteplussept(and notplugin.video.arteplussept-masterif you downloaded the latest commit of master for instance or inplugin.video.arteplussept/plugin.video.arteplusseptif you missed the mv operation).
For instance for Linux:
unzip -x plugin.video.arteplussept-master.zip
mv plugin.video.arteplussept plugin.video.arteplussept-backup OR rm -fr plugin.video.arteplussept
mv plugin.video.arteplussept-master plugin.video.arteplussept
- Done ! The plugin should show up in your video add-ons section.
If you get an issue after a fresh manual installation, you should try either to restart in order to install dependencies automatically either to install the dependancies manually. The dependancies are :
- xbmcswift2 (script.module.xbmcswift2)
- requests (script.module.requests)
- dateutil (script.module.dateutil)
They should be in the "addon libraries" section of the official repository.
If you are having issues with the add-on, you can open a issue and join your log file. The log file will contain your system user name and sometimes passwords of services you use in the software, so you may want to sanitize it beforehand. Detailed procedure here.
- Compatible with python 3 only and Kodi Matrix (based on Python 3.8) since version 1.1.5
- Coding guideline :
- 4 space indentation. No tab.
- Snake case for variables and methods
- No parenthesis around keywords like if, elif, for, while...
- Spaces around = when used in body and script. No space around = when setting method parameters
- Double quotes for strings used to end_users or logs.
- Single quotes for dict indices and strings for internal purpose.
- Object oriented (preferred), not fully applied given original
- Pylint guidelines : pydoc for every module and methods...
- Flake8 guidelines except line length is 100 instead of 79.
- Pylint and Flake8 are run in CI. You might want to install them on your local env.
Steps to be followed by a contributor to create a release. Preferablly you can use scripts/create-release.sh in a BASH to do the same. It has a parameter --no-push, if you want to check the results before applying changes remotely.
- Releases are in master branch. Make sure HEAD in master reflects the content of the next release.
- Set the version $MAJOR.$MINOR.$BUGFIX (without v) in addon.xml /addon/@version
- Describe the changes of the news version in:
- CHANGELOG.md. Ignore changelog.txt remaining here for legacy purpose.
- addon.xml /addon/extension[@point="xbmc.addon.metadata"]/news. Ensure it counts less than 1500 chars.
- Create a commit with version bump
- git add addon.xml CHANGELOG.md && git commit -m "Bump version to $MAJOR.$MINOR.$BUGFIX"
- Create and push tag "vMaj.Min.Bug" (with v) to GitHub in order to create a GitHub release and submit a PR to official XBMC repo with the CI.
- git tag -a v$MAJOR.$MINOR.$BUGFIX
- Fill the tag message with the description of the changes of the news version. It will be used as GitHub release notes.
- git push origin --tags
Steps run automatically by CI, with troubleshooting guide.
- "Kodi Addon-Submitter" in CI is in charge of:
- creating a GitHub release with version $MAJOR.$MINOR.$BUGFIX in https://github.com/thomas-ernest/plugin.video.arteplussept/releases
- submitting a new version to official Kodi repository
- One-commit change in matrix branch https://kodi.wiki/view/Submitting_Add-ons
- Open pull-request to official repo https://github.com/xbmc/repo-plugins/pulls
- if the action "Kodi Addon-Submitter" in CI fails, refresh the token value in action secret.
- In https://github.com/settings/tokens/ generate a corsed-grained token KODI_SUBMITTER_TOKEN_CLASSIC and copy its value
- set the token value in action secret KODI_SUBMITTER_TOKEN https://github.com/thomas-ernest/plugin.video.arteplussept/settings/secrets/actions
- Re-run the failing job "Kodi Addon-Submitter"
- Install dependencies:
pip install -r requirements-test.txt
- Run all tests:
In plugin root folder
PYTHONPATH="$PWD/plugin.video.arteplussept;$HOME/AppData/Roaming/Kodi/addons/script.module.xbmcswift2/lib" python -m pytest -vv tests/test_lib_mapper_arteliveitem.py
various docs and examples