├── .github └── ISSUE_TEMPLATE │ ├── broken_addon.md │ ├── config.yml │ └── violating_addon.md ├── .mention-bot ├── CONTRIBUTING.md ├── PULL_REQUEST_TEMPLATE.md ├── README.md └── info.txt /.github/ISSUE_TEMPLATE/broken_addon.md: -------------------------------------------------------------------------------- 1 | --- 2 | name: Report a broken add-on 3 | about: Report an add-on that is currently broken within Kodi. 4 | title: '' 5 | labels: 'Broken-Addon' 6 | assignees: '' 7 | 8 | --- 9 | 10 | 11 | ### Add-on details: 12 | 13 | - Add-on name: 14 | - Add-on ID: 15 | - Version number: 16 | - Kodi/repository version: 17 | 18 | ### Ownership 19 | - [ ] I am the owner of this add-on 20 | 21 | 27 | 28 | ### Broken because: 29 | 30 | 31 | -------------------------------------------------------------------------------- /.github/ISSUE_TEMPLATE/config.yml: -------------------------------------------------------------------------------- 1 | blank_issues_enabled: false 2 | contact_links: 3 | - name: Kodi forums, add-ons section 4 | url: https://forum.kodi.tv/forumdisplay.php?fid=27 5 | about: Please ask and answer questions here. 6 | - name: Pull requests 7 | url: https://github.com/xbmc/repo-plugins/pulls 8 | about: When you want to submit a new or updated add-on, please open a pull request here. -------------------------------------------------------------------------------- /.github/ISSUE_TEMPLATE/violating_addon.md: -------------------------------------------------------------------------------- 1 | --- 2 | name: Report a violating add-on 3 | about: Report an add-on that violates the Kodi add-on rules. 4 | title: '' 5 | labels: 'violation' 6 | assignees: '' 7 | 8 | --- 9 | 10 | 11 | 12 | 13 | 14 | ### Add-on details: 15 | 16 | - Add-on name: 17 | - Add-on ID: 18 | - Version number: 19 | - Kodi/repository version: 20 | 21 | 27 | 28 | ### Rules that have been violated by the add-on: 29 | 30 | 31 | 32 | ### Explain why the add-on is violating these rules: 33 | 34 | 35 | -------------------------------------------------------------------------------- /.mention-bot: -------------------------------------------------------------------------------- 1 | { 2 | "maxReviewers": 3, // Maximum number of people to ping in the PR message, default is 3 3 | "numFilesToCheck": 10, // Number of files to check against, default is 5 4 | "message": "@pullRequester, thank you for submitting your add-on to the official Kodi repository. Please give us some time to review your add-on code to make sure it's following our guideliness according to http://kodi.wiki/view/Add-on_rules Should you make any changes to the pull-request always squash the commits and force push to your branch.", 5 | "findPotentialReviewers": false, // mention-bot will try to find potential reviewers based on files history, if disabled, `alwaysNotifyForPaths` is used instead 6 | "userBlacklist": ["FernetMenta"], // Users in this list will never be mentioned by mention-bot 7 | "actions": ["opened"], // List of PR actions that mention-bot will listen to, default is "opened" 8 | "createComment": true, // mention-bot creates a comment mentioning the reviewers for the PR 9 | } 10 | -------------------------------------------------------------------------------- /CONTRIBUTING.md: -------------------------------------------------------------------------------- 1 | ### Introduction 2 | 3 | **Kodi** uses Github for development only, i.e. for *pull requests* and the review of such code. 4 | **Do not open** an issue on Github for your questions or bug reports. 5 | **Do not comment** on a *pull request* unless you are involved in the testing of such or have something meaningful to contribute. 6 | Not familiar with git? Start by looking at Github's [collaborating pages](https://help.github.com/categories/collaborating/). 7 | 8 | #### Questions about Kodi? 9 | 10 | To get your questions answered, please ask in the [Kodi community forum's](http://forum.kodi.tv/) or on **IRC:** [#kodi](http://webchat.freenode.net?nick=kodi-contrib&channels=%23kodi&prompt=1&uio=OT10cnVlde) on freenode.net 11 | 12 | #### Issue or bug reports and discussions 13 | 14 | Issue or bug reports must be send towards the add-on creator which can be found in each [addon.xml] (http://kodi.wiki/view/Addon.xml) file. 15 | 16 | If you can, we encourage you to investigate the issue yourself and create a [pull request](https://help.github.com/articles/creating-a-pull-request/) towards the original source of the code. We try to ask each add-on aythor to include this in the [addon.xml] (http://kodi.wiki/view/Addon.xml) file. Should this not be present then we advise you to find the dedicated add-on thread on the forum and ask there. 17 | 18 | For bug reports and related discussions, feature requests and all other support, please go to [Kodi community forum's](http://forum.kodi.tv/) and find the dedicated add-on thread. 19 | 20 | #### Pull Requests 21 | 22 | Before [creating a pull request](https://help.github.com/articles/creating-a-pull-request/), please read our general code guidelines that can be found at: 23 | 24 | - [Kodi add-on development](http://kodi.wiki/view/Add-on_development) 25 | 26 | ###### General guidelines for creating pull requests: 27 | - **Create separate branches**. Don't ask us to pull from your master branch. 28 | - **One pull request per add-on**. If you want to do more than one, send multiple *pull requests*. 29 | - **Do not send us multiple commits**. Make sure each add-on only consists of a single commit in your *pull 30 | request*. 31 | If you had to make multiple intermediate commits while developing, please squash them before sending them to us. 32 | In the end before merging you may be asked to squash your commit even some more. 33 | 34 | ###### Please follow these guidelines; it's the best way to get your work included in the repository! 35 | 36 | - [Click here](https://github.com/xbmc/repo-plugins/fork/) to fork the Kodi script repository, 37 | and [configure the remote](https://help.github.com/articles/configuring-a-remote-for-a-fork/): 38 | 39 | ```bash 40 | # Clone your fork of kodi's repo into the current directory in terminal 41 | git clone git@github.com:/repo-plugins.git repo-plugins 42 | # Navigate to the newly cloned directory 43 | cd repo-plugins 44 | # Assign the original repo to a remote called "upstream" 45 | git remote add upstream https://github.com/xbmc/repo-plugins.git 46 | ``` 47 | 48 | - If you cloned a while ago, get the latest changes from upstream: 49 | 50 | ```bash 51 | # Fetch upstream changes 52 | git fetch upstream 53 | # Make sure you are on your 'master' branch 54 | git checkout master 55 | # Merge upstream changes 56 | git merge upstream/master 57 | ``` 58 | 'master' is only used as example here. Please replace it with the correct branch you want to submit your add-on towards. 59 | 60 | - Create a new branch to contain your new add-on or subsequent update: 61 | 62 | ```bash 63 | git checkout -b 64 | ``` 65 | 66 | The branch name isn't really relevant however a good suggestion is to name it like the addon ID. 67 | 68 | - Commit your changes in a single commit, or your *[pull request](https://help.github.com/articles/using-pull-requests)* is unlikely to be merged into the main repository. 69 | Use git's [interactive rebase](https://help.github.com/articles/interactive-rebase) 70 | feature to tidy up your commits before making them public. 71 | The commit for your add-on should have the following naming convention as the following example: 72 | 73 | ```bash 74 | [metadata.themoviedb.org] 3.0.0 75 | ``` 76 | 77 | Your addon ID between brackets followed by the version number. 78 | 79 | - Push your topic branch up to your fork: 80 | 81 | ```bash 82 | git push origin 83 | ``` 84 | 85 | - Open a [pull request](https://help.github.com/articles/using-pull-requests) with a 86 | clear title and description. 87 | 88 | - Updating your [pull request](https://help.github.com/articles/using-pull-requests) can be done by applying your changes and squashing them in the already present commit. Afterwards you can force push these change and your pull request will be updated. 89 | 90 | ```bash 91 | git push --force origin 92 | ``` 93 | 94 | These examples use git command line. There are also git tools available that have a graphic interface and the steps above should be done in a similar way. Please consult the manual of those programs. 95 | 96 | -------------------------------------------------------------------------------- /PULL_REQUEST_TEMPLATE.md: -------------------------------------------------------------------------------- 1 | ### Description 2 | 3 | 4 | 5 | ### Checklist: 6 | 7 | 8 | - [ ] My code follows the [add-on rules](http://kodi.wiki/view/Add-on_rules) and [piracy stance](http://kodi.wiki/view/Official:Forum_rules#Piracy_Policy) of this project. 9 | - [ ] I have read the [CONTRIBUTING](https://github.com/xbmc/repo-plugins/blob/master/CONTRIBUTING.md) document 10 | - [ ] Each add-on submission should be a single commit with using the following style: [plugin.video.foo] v1.0.0 11 | 12 | Additional information : 13 | - Submitting your add-on to this specific branch makes it available to any Kodi version equal or higher than the branch name with the applicable Kodi dependencies limits. 14 | - [add-on development](http://kodi.wiki/view/Add-on_development) wiki page. 15 | - Kodi [pydocs](http://kodi.wiki/view/PyDocs) provide information about the Python API 16 | - [PEP8](https://www.python.org/dev/peps/pep-0008/) codingstyle which is considered best practice but not mandatory. 17 | - This add-on repository has automated code guideline check which could help you improve your coding. You can find the results of these check at [Codacy](https://www.codacy.com/app/Kodi/repo-plugins/dashboard). You can create your own account as well to continuously monitor your python coding before submitting to repo. 18 | - Development questions can be asked in the [add-on development](http://forum.kodi.tv/forumdisplay.php?fid=26) section on the Kodi forum. 19 | - If you see no activity on your PR after a week (so at least one weekend has passed) then please go to the #kodi-dev freenode IRC channel to reach out to the team 20 | -------------------------------------------------------------------------------- /README.md: -------------------------------------------------------------------------------- 1 | ![Kodi logo](https://raw.githubusercontent.com/xbmc/xbmc/master/media/banner.png) 2 | # Kodi Home Theater Software 3 | 4 | 5 | ## Contents 6 | 7 | This branch is not used for public. Please use one of the other branches available for submitting add-ons. 8 | 9 | ## Quick Kodi development links 10 | 11 | * [Add-on rules](https://github.com/xbmc/repo-plugins/blob/master/CONTRIBUTING.md) 12 | * [Submitting an add-on details](https://kodi.wiki/view/Submitting_Add-ons) 13 | * [Code guidelines](https://kodi.wiki/view/Official:Code_guidelines_and_formatting_conventions) 14 | * [Kodi development](https://kodi.wiki/view/Development) 15 | * [Kodi Addon checker](https://pypi.org/project/kodi-addon-checker/) 16 | 17 | ## Other useful links 18 | 19 | * [Kodi wiki](https://kodi.wiki/) 20 | * [Kodi issue tracker](https://github.com/xbmc/xbmc/issues) 21 | * [Kodi community forums](https://forum.kodi.tv/) 22 | * [Kodi website](https://kodi.tv/) 23 | 24 | **Enjoy Kodi and help us improve it today. :)** 25 | -------------------------------------------------------------------------------- /info.txt: -------------------------------------------------------------------------------- 1 | use branches instead. 2 | --------------------------------------------------------------------------------