repo.me is denoted to be a community colloborated standard for incipient tweak developers. To provide ease on maintaining a personal repository and show your developments to the community.
This template contains samples on how you can easily make depiction pages without replicating your HTML pages.
The Cydia pages are styled using Bootstrap, and the Sileo pages are styled using JavaScript Object Notation (JSON).
If you use web depictions / Reposi3, Sileo now converts web depictions to native depictions in realtime.
This guide does NOT cover creating .deb files, but will briefly cover assiging depictions, please do not ask about debian files, that is for development. This is simply here to get you started on making a base apt repository.
Found something that can be improved? Found a mistake? Please do make a pull request!
You must have apt-ftparchive on your operating system to utilize repo.me. This can be solved on Windows via WSL. My subsystem OS is Debian, which I know does contain apt-ftparchive. This can be solved on macOS via Diatrus' precompiled version (downloaded automatically via updaterepo.sh, and perms will be set automatically as well). For iOS / iPadOS, you'll need apt-utils on the Procursus repository (Elucubratus support is unknown as of now).
You must have wget, zstd, xz, bzip2, & gzip installed on macOS. Don't worry, the script will automatically check for homebrew installation and dependencies, if not found,
installation for all of the dependencies and homebrew will start.
If you are not hosting your repo on GitHub Pages, you can download the zip file here and extract to a subfolder on your website.
There are 2 options for those using GitHub Pages.
A. If you want to use your root username.github.io as your repo, fork this repo and rename it to username.github.io. So when adding it in your Package Manager of choice, use https://username.github.io.
B. If you want to use a subfolder for your existing username.github.io as your repo (example username.github.io/repo), fork this repo and rename it to repo. So when adding it in your Package Manager of choice, use https://username.github.io/repo.
You can change repo to anything you want, like cydia for example. So your repo URL would be https://username.github.io/cydia.
Release File
Modify repo.conf in ./assets/repo by changing the labels:
ORIGIN_HERE, LABEL_HERE, CODENAME_HERE, and DESCRIPTION_HERE
updaterepo.sh will take care of the Release file after modifying the config. So you're now finished regarding Release.
Branding
Please check index.html for what lines need to be changed! Note: You do not need to use the included index.html
Add a "CydiaIcon.png" for your APT Repository Logo. This is not a design tutorial, it should be relatively self-explanatory.
Page Footers
The data below are the links that appear at the bottom of every Webview / Cydia Depiction. The data is stored in repo.xml at the root folder of your repo.
<repo>
<footerlinks>
<link>
<name>Follow me on Twitter</name>
<url>https://twitter.com/truesyns</url> # Feel free to swap your twitter in for this!
<iconclass>glyphicon glyphicon-user</iconclass>
</link>
<link> # You can remove this if you wish, however if I may, please do not do so! It will allow others to find repo.me such as you have!
<name>I want this depiction template</name>
<url>https://github.com/syns/repo.me</url>
<iconclass>glyphicon glyphicon-thumbs-up</iconclass>
</link>
</footerlinks>
</repo>At this point your repo is basically ready to be added into your Package Manager of choice.
You can visit your repo's homepage by going to https://username.github.io/repo/.
Next guide will show you how to assign and customize your depiction pages.
Go to the depictions folder and duplicate the folder me.syns.oldpackage.
Rename the duplicate with the same name as your package name.
There are 2 files inside the folder - info.xml and changelog.xml.
Update the 2 files with information regading your package.
The tags are pretty much self-explanatory.
Contact @truesyns for questions.
info.xml.
<package>
<id>me.syns.oldpackage</id>
<name>Old Package</name>
<version>1.0.0-1</version>
<compatibility>
<firmware>
<miniOS>5.0</miniOS>
<maxiOS>7.0</maxiOS>
<otherVersions>unsupported</otherVersions>
<!--
for otherVersions, you can put either unsupported or unconfirmed
-->
</firmware>
</compatibility>
<dependencies></dependencies>
<descriptionlist>
<description>This is an old package. Requires iOS 7 and below..</description>
</descriptionlist>
<screenshots></screenshots>
<changelog>
<change>Initial release</change>
</changelog>
<links></links>
</package>changelog.xml.
<changelog>
<changes>
<version>1.0.0-1</version>
<change>Initial release</change>
</changes>
</changelog>Go to the /depictions/native/me.syns.samplepackage and copy the file depiction.json.
Move into a folder labeled as your package name.
Edit The Labeled Parts (i.e. VERSION_NUMBER, TWEAK_NAME, etc.) or use the Sileo Depiction Generator by @M4cs: SileoGen.
Contact @truesyns for questions.
You can add the depictions url at the end of your package's control file before compiling it.
The depiction line should look like this:
Depiction: https://username.github.io/repo/depictions/web/?p=[idhere]
Replace [idhere] with your actual package name.
Depiction: https://username.github.io/repo/depictions/web/?p=me.syns.oldpackage
For Sileo Depictions, add the SileoDepiction key alongside the Depiction in your control file before compiling it.
SileoDepiction: https://username.github.io/repo/depictions/native/me.syns.samplepackage/depiction.json
The Packages file is handled by updaterepo.sh. Windows users should be using WSL (I use Debian), Linux users should be
checking for apt-ftparchive, and macOS (10.10+) users should be using Diatrus' recompiled version of apt-ftparchive (this is now automatically downloaded via updaterepo.sh and perms will automatically be set for apt-ftparchive to work on macOS). macOS users will be asked for their password when running this, this is due to sudo, the perms are transmuted after apt-ftparchive is automatically pulled via wget, but not without you entering your password.
In order to add your GPG key, you're going to need gnupg (I'm unaware as of 8/2/2020, if this is available via Homebrew). Afterwards, open a Terminal and type the following: gpg --gen-key (if it asks you what kind of key you want, select 4 rsa sign only 4096 instead of 3072, let it do its thing). REMEMBER YOUR PASSWORD. Make sure you're in the directory of your repo and type sudo gpg --output keyFile --armor --export Last8Lettersofyourkeyfingerprint.
If you cant find your key fingerprint type gpg --list-keys and copy and paste the last 8 letters of the text under pub.
Now run update-repo.sh and then type gpg -abs -o Release.gpg Release and enter your password from your gpg key from earlier and then you should be good to go. Now in order for users to add the key they must go into a terminal and type wget -O - https://yourreponame.com/keyfile | sudo apt-key add - then apt-get update and you're good to go!
If you haven't done yet, go ahead and add your repo to your package manager.
You should now be able to install your tweak from your own repo.
These are some extra things that can make your repository look even better on Sileo.
Change The Following Lines:
"url": "https://raw.githubusercontent.com/syns/repo.me/master/assets/Banners/RepoHeader.png", <---- The Package Banner
"title": "Sample Package", <---- Your Package Name
"package": "me.syns.newpackage", <---- The Actual Package
Special Thanks and Credits to: Supermamon for Reposi3 (the base) & Diatrus for apt-ftparchive on macOS. And last but not least, biggest thanks to everyone who made a pull request to make repo.me better!