{"id":19211679,"url":"https://github.com/robweber/kodi-shield","last_synced_at":"2025-07-30T05:07:34.531Z","repository":{"id":146059398,"uuid":"214015391","full_name":"robweber/kodi-shield","owner":"robweber","description":"PHP script to create a shields.io badge for your Kodi addon project","archived":false,"fork":false,"pushed_at":"2023-11-07T15:39:45.000Z","size":40,"stargazers_count":4,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-05-12T20:29:01.218Z","etag":null,"topics":["kodi","php7"],"latest_commit_sha":null,"homepage":null,"language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/robweber.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2019-10-09T20:18:02.000Z","updated_at":"2022-02-12T19:20:12.000Z","dependencies_parsed_at":"2024-11-09T13:44:40.464Z","dependency_job_id":"49c45b9a-7a8b-4343-9ed4-d3e917895c3e","html_url":"https://github.com/robweber/kodi-shield","commit_stats":null,"previous_names":[],"tags_count":4,"template":false,"template_full_name":null,"purl":"pkg:github/robweber/kodi-shield","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/robweber%2Fkodi-shield","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/robweber%2Fkodi-shield/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/robweber%2Fkodi-shield/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/robweber%2Fkodi-shield/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/robweber","download_url":"https://codeload.github.com/robweber/kodi-shield/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/robweber%2Fkodi-shield/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":267814769,"owners_count":24148329,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-07-30T02:00:09.044Z","response_time":70,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["kodi","php7"],"created_at":"2024-11-09T13:44:27.130Z","updated_at":"2025-07-30T05:07:34.494Z","avatar_url":"https://github.com/robweber.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"\n# Kodi Shield [![License](https://img.shields.io/github/license/robweber/kodi-shield)](https://github.com/robweber/kodi-shield/blob/master/LICENSE) \n\nThis is a PHP application that can be used to generate a badge for your Kodi addon using the [Shields.io JSON endpoint](https://shields.io/endpoint) syntax. The result is badge you can include with your Kodi addon so people know at a glance what versions of Kodi your addon will run on. \n\n\n## How It Works\n\nWhen queried the application will pull the ```addon.xml``` file of your addon from it's repository and calculate the compatible Kodi versions based on the official [Kodi compatibility matrix](https://kodi.wiki/view/Addon.xml#Dependency_versions). \n\n__Please note: this script assumes your project is hosted on Github and is the only project in a given repo, with the addon.xml file in the root of the project folder. I've noticed this is the setup for most Kodi addons__ \n\n## Install\nYou can install this script on any webserver that runs PHP using composer. It does use the Simple XML library for reading in the ```addon.xml``` file of your project so the correct Kodi version can be determined. A sample Apache ```.htaccess``` file using mod_rewrite is given, for other server configurations [PRs are accepted](https://github.com/robweber/kodi-shield/pulls)!\n\nIn the ```src/index.php``` file the following variables needed to be modified to fit your server setup: \n\n```\n\n//MODIFY THESE TO MATCH YOUR SITUATION\n$domainPath = 'http://yourdomain.com' //set this to the full path of your server, can be an IP address if no domain name\n$basePath = '/kodi-shield'; //set this to the base path on your server\n\n```\n\n## Usage\nThis script uses the [Shields.io JSON endpoint](https://shields.io/endpoint) to return the JSON needed to generate the badge. Read the information on the Shields.io website for more information on how this works. An example of using the badge within the markdown file of your project could be: \n\n```\n![Kodi Version](https://img.shields.io/endpoint?url=https%3A%2F%2Fdomain.com%2Fkodi-shield%2Frobweber%2Fxbmcbackup)\n```\n\nYou can generate a URL of your own using the URL generator on the [Shields.io website](https://shields.io/endpoint) (scroll to the bottom of the page). The script takes the following URL parameters in the following order (some are optional):\n\n```\n/kodi-shield/:username/:repo/:branch/:shownames/:currentonly\n```\n\n* username __required__ - your Github username\n* repo __required__ - the name of the repository for your addon\n* branch - the branch name, master is assumed by default\n* shownames - a true/false value on if the codenames for each Kodi version should also be shown\n* currentonly - another true/false value. By default all compatible Kodi versions are shown, this shows only the most current supported version. \n\n## Examples\n\n### Default Badge: \n\n```\n![Kodi Version](https://img.shields.io/endpoint?url=https%3A%2F%2Fdomain.com%2Fkodi-shield%2Frobweber%2Fxbmcbackup)\n```\n\n![Kodi Version](https://img.shields.io/endpoint?url=https%3A%2F%2Fweberjr.com%2Fkodi-shield%2Frobweber%2Fxbmcbackup)\n\n### Badge with code names:\n```\n![Kodi Version](https://img.shields.io/endpoint?url=https%3A%2F%2Fdomain.com%2Fkodi-shield%2Frobweber%2Fxbmcbackup%2Fmaster%2Ftrue)\n```\n![Kodi Version](https://img.shields.io/endpoint?url=https%3A%2F%2Fweberjr.com%2Fkodi-shield%2Frobweber%2Fxbmcbackup%2Fmaster%2Ftrue)\n\n\n\n### Badge with only the most current version: \n\n```\n![Kodi Version](https://img.shields.io/endpoint?url=https%3A%2F%2Fdomain.com%2Fkodi-shield%2Frobweber%2Fxbmcbackup%2Fmaster%2Ftrue%2Ftrue)\n```\n\n![Kodi Version](https://img.shields.io/endpoint?url=https%3A%2F%2Fweberjr.com%2Fkodi-shield%2Frobweber%2Fxbmcbackup%2Fmaster%2Ftrue%2Ftrue)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frobweber%2Fkodi-shield","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frobweber%2Fkodi-shield","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frobweber%2Fkodi-shield/lists"}