- Notifications
You must be signed in to change notification settings - Fork97
a modern apt repository template built by the community
License
uchks/repo.me
Folders and files
Name | Name | Last commit message | Last commit date | |
---|---|---|---|---|
Repository files navigation
Note
I'm actively looking for contributors! I no longer keep up with the jailbreak scene.
Already have a repository? Looking to share a repository?
Check outjbredir, a website I made.
repo.me was created to help new tweak developers. The goal was to make it easy to maintain a personal repository and show their work to the community. Unfortunately, it didn't gain much traction, for contributing that is. Only two people contributed, and that was a long time ago. Since then, it has been inactive while the jailbreaking community moved on. Now, it's just a side project for me, still meant to help new developers and keep community standards.
This template shows how you can easily make depiction pages without copying your HTML pages.The Cydia pages useBootstrap, and the Sileo pages use JSON.If you use web depictions, Sileo now converts web depictions to native depictions in real-time.
This guide doesNOT cover creating .deb files but will briefly cover assigning depictions. It is just to help you start making a base APT repository.
Found something that can be improved? Found a mistake? Please make a pull request!
apt-ftparchive
Required to generate the Packages file:- Windows: It will be automatically downloaded.
- macOS: Install via Procursus
apt-utils
; otherwise, it will be automatically downloaded. - iOS / iPadOS: install via Procursus
apt-utils
(Elucubratus users, this is not verified).
wget, zstd, xz, lz4, & gpg
updaterepo.sh
will automatically install these if Homebrew or Procursus is available.
If you arenot hosting your repository onGitHub Pages, you can download the zip filehere and extract it to a subfolder on your website.
There are two options for those usingGitHub Pages:
A. If you want to use your rootusername.github.io
as your repo, fork this repo and rename it tousername.github.io
. Then, when adding it to your Package Manager of choice, usehttps://username.github.io
.
B. If you want to use a subfolder for your existingusername.github.io
as your repo (e.g.,username.github.io/repo
), fork this repo and rename it torepo
. Then, when adding it to your Package Manager of choice, usehttps://username.github.io/repo
.
Branding
I, uchks, do not do frontend. Provided to you is Reposi3's frontend. You don't need to use it if you know what you're doing. Otherwise, checkindex.html
for the lines that need to be changed!
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 everyWebview / Cydia Depiction. The data is stored inrepo.xml
at the root folder of your repository.
<repo> <footerlinks> <link> <name>Follow me on X</name> <url>https://x.com/uchkence</url> # Feel free to swap your X in for this! <iconclass>fa-brands fa-x-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/uchks/repo.me</url> <iconclass>fa-solid fa-thumbs-up</iconclass> </link> </footerlinks></repo>
Depictions
Go to the depictions folder and duplicate the foldercom.example.sample
.Rename the duplicate with the same name as your package name.There are two files inside the folder -info.xml
andchangelog.xml
.Update the two files with information regarding your package.The tags are pretty much self-explanatory.Contacthi@air.rip for questions.
info.xml
<package> <id>com.example.sample</id> <name>Sample</name> <version>1.0.0</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</version> <change>Initial release</change> </changes></changelog>
Go to the/depictions/native/com.example.sample
folder and copy the filedepiction.json
.Move it into a folder labeled as your package name.Edit the labeled parts (i.e., VERSION_NUMBER, TWEAK_NAME, etc.).Contacthi@air.rip for questions.
You can add the depictions URL at the end of your package'scontrol
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=com.example.sample
For native depictions, add theSileoDepiction
key alongside theDepiction
in yourcontrol
file before compiling it.
SileoDepiction: https://username.github.io/repo/depictions/native/com.example.sample/depiction.json
With your updatedcontrol
file, build your tweak and store the resulting debian into the/debians
folder of your repository.
ThePackages
file is handled byupdaterepo.sh
. macOS users will be asked for their password when running this due tosudo
; the permissions are transmuted afterapt-ftparchive
is automatically pulled via wget, but not without you entering your password.
Push your changes and, if you haven't done so yet, go ahead and add your repository to your package manager.You should now be able to install your tweak from your repository.
Featured Packages (sileo-featured.json
)
Change the following lines:
"url":"https://raw.githubusercontent.com/uchks/repo.me/master/assets/Banners/RepoHeader.png",// The Package Banner"title":"Sample Package",// Your Package Name"package":"com.example.sample"// The Actual Package
Special thanks and credits to:Supermamon forReposi3 (the base) &Diatrus forapt-ftparchive
on macOS.