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!
Steps for repo.me setup and usage
1. APT-FTPArchive
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 if you use brew (downloaded and set perms automatically via updaterepo.sh) or by installing apt-utils from Procursus.
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 installed on macOS. The script will automatically check for homebrew / Procursus installation and dependencies, if not found,
don't worry, everything will be taken care of for you.
2. Download / Fork repo.me
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 sileo for example. So your repo URL would be https://username.github.io/sileo.
3. Personalization
Release File
Modify repo.conf in ./assets/repo by changing the labels pointed by <--:
APT {
FTPArchive {
Release {
Origin "ORIGIN_HERE"; <--
Label "LABEL_HERE"; <--
Suite stable;
Version 1.0;
Codename CODENAME_HERE; <--
Architectures iphoneos-arm;
Components main;
Description "DESCRIPTION_HERE"; <--
};
};
};
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/localdevice</url> # Feel free to swap your twitter in for this!
<iconclass>fa fa-twitter</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/localdevice/repo.me</url>
<iconclass>fa fa-thumbs-up</iconclass>
</link>
</footerlinks>
</repo>4. Almost ready.
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.
Depictions
1.1 Adding a simple depiction page (Web Folder / Cydia)
Go to the depictions folder and duplicate the folder faith.jasons.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 @localdevice for questions.
info.xml.
<package>
<id>faith.jasons.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>1.2 Adding a simple depiction page (Native Folder / Sileo)
Go to the /depictions/native/faith.jasons.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.)
Contact @localdevice for questions.
2. Link the depiction page in your tweak's control file
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=faith.jaons.oldpackage
For Native Depictions, add the SileoDepiction key alongside the Depiction in your control file before compiling it.
SileoDepiction: https://username.github.io/repo/depictions/native/faith.jaosns.samplepackage/depiction.json
3. Rebuilding the Packages file
With your updated control file, build your tweak and store the resulting debian into the /debians folder of your repo.
The Packages file is handled by updaterepo.sh. Windows users should be using WSL, Linux users should be checking for apt-ftparchive, and macOS (10.10+) users should be using Diatrus' recompiled version of apt-ftparchive (this is automatically downloaded and setup via updaterepo.sh). 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.
4. (Optional) Adding your GPG Key (Soon to be Integrated)
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!
5. Repository at last!
Push your changes and 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.
Sileo Extras
These are some extra things that can make your repository look even better on Sileo.
Featured Packages (sileo-featured.json)
Change The Following Lines:
"url": "https://raw.githubusercontent.com/localdevice/repo.me/master/assets/Banners/RepoHeader.png", <---- The Package Banner
"title": "Sample Package", <---- Your Package Name
"package": "faith.jasons.newpackage", <---- The Actual Package
Special Thanks and Credits to: Supermamon for Reposi3 (the base) & Diatrus for apt-ftparchive on macOS