[Tutorial] Maak Een Kodi GitHub Repository Inclusief GitHub Repo URL

TGR6.6.6

VIP
12 aug 2017
419
254
Hell
In deze tutorial laat ik zien hoe je met behulp van github je eigen repo kan hosten

Ik heb een voorbeeld repo gemaakt op github en de stappen hieronder beschreven en toegelicht met screenshots.
Deze repository laat ik staan zodat je altijd wat hebt om op terug te vallen en te vergelijken mocht het niet helemaal lukken. ( )

De volgende sites en software worden in deze tutorial gebruikt:


Laten we beginnen:

Download de repo_en_files zip en pak deze uit:
In deze map vind je 3 mappen, "files", "repository.mijnrepo" en "plugin.video.youtube"

In de map "files" vind je wat losse bestanden die we straks aan gaan passen. De "addons.xml , "addons.xml.md" en een "index.html"

De "repository.mijnrepo" map word straks je repo zip die binnen Kodi kan worden geinstaleerd. Los als zip of via een repo url.

En de youtube addon die we als voorbeeld gaan gebruiken om in de repo te zetten. Deze hoeven we straks alleen maar te uploaden naar github.

let op, in de tutorial word gesproken over de "addons.xml" en de "addon.xml"
verschil zit hem in 1 letter dus goed opletten 😉


email adres nodig voor de volgende stap? probeer protonmail eens, gratis en anoniem!
Ga naar en sluit een gratis account af en doorloop het aanmeld proces en bevestig de link die je in je email krijgt.
Ga deze stap hier niet uitschrijven, ga er vanuit dat iedereen wel een account kan afsluiten.
Na het klikken op de bevestiging link word je doorgestuurd naar de begin pagina van je github account en klik daar op "Start a project" (zie screenshot hieronder)

You must be registered for see images attach





We gaan nu een repository op github opzetten:
*Geef je repository een naam, ik noem hem hier plugins maar je kan hem bijvoorbeeld ook zips noemen. In deze map komen straks alle plugins te staan die je in je kodi wil kunnen installeren.
*Je kan er een beschrijving aan toe voegen maar is niet verplicht
*Laat het vinkje op Public staan dus niet op private zetten
*Vink het vakje aan voor "Initialize this repository with a README"
*Kies "Pyhon" bij "Add.gitinore:" en kies "GNU General Public License v3.0" bij "Add a license"
*Klik op "Create repository" (zie screenshot hieronder)

You must be registered for see images attach





Je komt daarna uit in je repository "plugins" (als je dezelfde naam hebt gebruikt uiteraard) Klik daar op "Upload files" (zie screenshot hieronder)

You must be registered for see images attach





Laat nu de pagina open staan en zoek in map die je eerder hebt uitgepakt naar de "addons.xml"en de "addons.xml.md5" (repo_en_files/files)
en sleep deze naar het midden van de webpagina (Of klik op "choose your files" en zoek en selecteer de bestanden) en klik op "Commit changes" onderaan
(zie screenshot hieronder)

You must be registered for see images attach





Laat je pagina nu weer even open staan, we gaan nu eerst de repo zip maken.
In de map die je eerder hebt gedownload en uitgepakt hebt staat een map genaamd "repository.mijnrepo" Hierin vind je een bestand genaamd "addon.xml"
Selecteer het bestand en dan rechtse muisklik op dit bestand en kies nu "Edit with Notepad++"
Hier gaan we het 1 en ander aanpassen:

Regel 2: <addon id="repository.mijnrepo" name="Mijn Repository" version="1.0.0" provider-name="Mijn Naam">
in deze regel kan je een naam geven aan de repo versie nummer en je eigen provider-name.
"mijnrepo" vervangen door een zelf gekozen naam voor je repo
"Mijn Repository" vervangen door een zelf gekozen naam voor je repo, deze zal zichtbaar zijn binnen Kodi

Regel 3: <extension point="xbmc.addon.repository" name="Mijn Repository">
"Mijn Repository" vervangen voor dezelfde als die je in regel 2 hebt ingegeven
"Mijn Naam" vervangen door je eigen naam of nickname

Regel 11: <summary lang="en">Voorbeeld Repo</summary>
Korte omschrijving van je repo


Regel 12: <description lang="en">Dit is een voorbeeld repo met de youtube addon voor Kodi</description>
Uitgebreide omschrijving van je repo

Nu moeten we alleen moeten nog regel 5, 6 en 7 aanpassen.
Ga nu terug naar de github in je browser en klik op de addons.xml die we eerder hebben geupload en klik daarna op "raw" (zie screenshot hieronder)

You must be registered for see images attach


Dan kopieer de url in je adres balk (in dit voorbeeld dus , zie screenshot hieronder)


You must be registered for see images attach



En vervang in regel 5 "mijn.githublink/addons.xml" door de url (zie screenshot hieronder)


You must be registered for see images attach



Ga nu weer terug naar de github in je browser en klik op de addons.xml.md5 die we eerder hebben geupload en klik op "raw"
Dan kopieer de url in je adres balk

Regel 6: Vervang "mijn.githublink/addons.xml.md5" door de url

Regel 7: Vervang "mijn.githublink" door de zelfde url maar dan zonder de "addons.xml.md5" op het eind (zie screenshot hieronder)

You must be registered for see images attach



Je addon.xml is nu klaar van je repository. Klik op opslaan vanuit het menu of gebruik ctrl+s

Let op het versie nummer (in dit geval 1.0.0) en onthoud dit
Ga naar de repo_en_filesmap en zip de "repository.mijnrepo"
Dan pas de naam aan naar "repository.mijnrepo-1.0.0" (waarbij "mijnrepo" de naam word die je zelf had verzonnen voor je repo en dus inclusief het versie nummer)
Verplaatst de zip naar de map "repository.mijnrepo" dus bij de icon.png, fanart.jpg en changelog.txt in de map
Nu open vanuit de map "files" de "addon.xml.md5" en de "addons.xml"
Vanuit de map "repository.mijnrepo" de addon.xml en vanuit de map "plugin.video.youtube" de addon.xml
Kopieer nu vanuit de addon.xml van je repo alles vanaf regel 2 tot en met de laatste lijn. Dus regel 1 niet! (zie screenshot hieronder)

You must be registered for see images attach



Plak dit nu in de addons.xml tussen de <addons> </addons> tags (zie screenshot hieronder)

You must be registered for see images attach



Herhaal ditzelfde nu met de addon.xml uit de "plugin.video.youtube" map. Kopieer de addon.xml en plak dit onder je repo maar nog steeds tussen <addons> </addons> tags.
Dus op regel 1 de <addons> dan daaronder je repo en YouTube en op de laatste regel helemaal onderaan de </addons> tag

Sluit de addon.xml van je repo en de addon.xml van de youtube addon.
Selcteer nu alles in je addons.xml van de eerste tot en met de laatste <addons> </addons> en alles er tussenin en kopieer (ctrl+c) en ga nu naar
de website en plak daar alles in het kader om je md5 hash te verkrijgen (zie screenshot hieronder)

You must be registered for see images attach


kopieer de MD5 Hash (lange reeks van letters en getallen) en plak deze nu in je "addons.xml.md5"
Sla nu alle documenten op en sluit ze af.

*Ga nu terug naar je github en in plugins repository kun je nu opnieuw je "addons.xml" en je "addon.xml.md5" uploaden. De oude van eerder zullen worden overschreven
*Upload nu de hele map "repository.mijnrepo"
*Upload daarna de hele map "plugin.video.youtube" ook naar plugins
Hierna zou je moeten eindigen met de volgende opzet:

Je repo is nu klaar en als je de zip installeert in Kodi zal je nu vanuit je repo de youtube addon kunnen downloaden (zie screenshots)

You must be registered for see images attach



You must be registered for see images attach


You must be registered for see images attach



=========================================================================================

En dan gaan we nu een repo url opzetten om te gebruiken in Kodi


Om te beginnen begin je weer met "start a project" (zie screenshot)

You must be registered for see images attach




*De naam van deze repository word bepaald door je username!!
Dus bij naam van je repository moet je dus invullen: username.github.io Deze naam zal straks ook je url zijn voor gebruik in Kodi. In mijn geval is mijn username tgr63 dus mijn
repo url word dus straks
*Je kan er een beschrijving aan toe voegen maar is niet verplicht
*Laat het vinkje op Public staan dus niet op private zetten
*Vink het vakje aan voor "Initialize this repository with a README"
*Kies "None" bij "Add.gitinore:" en kies "GNU General Public License v3.0" bij "Add a license"
*Klik op "Create repository" (zie screenshot hieronder)

You must be registered for see images attach



Laat je browser openstaan en in de map files die je eerder gedownload hebt staat een file "index.html" Rechtste muisklik op de html file en "Edit with Notepad++"

In deze html zie je 2x repository.mijnrepo-1.0.0.zip staan. Verander deze beide in de naam van je eigen repo en sla deze op (ctrl+s)

Ga nu terug naar je browser en klik op "Upload Files" ( zie screenshot hieronder)

You must be registered for see images attach




Upload nu de "index.html" en je repo zip die je eerder hebt gemaakt door ze weer naar het midden te slepen of te selecteren en klik daarna onderaan op "Commit changes"
(zie screenshot hieronder)

You must be registered for see images attach



Nu word je weer terug gestuurd naar je repo en zou alles moeten werken. De repo url is nu dus waarbij "tgr63" je eigen username zal zijn.


=======================================================================================

Mocht je tegen problemen aanlopen of vragen hebben dan kan ik altijd even mee kijken door je github pagina door te geven.
 

Bijlagen

Laatst bewerkt:

TGR6.6.6

VIP
12 aug 2017
419
254
Hell
Dank jullie wel, komen er nog 2 aan. Daarin zal ik ook nog laten zien hoe je een repo opzet bij github met de github desktop en welke stappen je moet doen om een addon en/of repo te updaten naar een hoger versie nummer of om meer addons in je repo op te nemen.
 
  • Like
Reacties: Spinix