Margy Store: an app store for Android, open source apps and mods only
  • Kotlin 60.9%
  • JavaScript 18.9%
  • Python 12.1%
  • CSS 5.1%
  • HTML 2.8%
  • Other 0.2%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
2026-10-22 20:40:02 +03:00
app 2.2: big files come in six pieces at once, each taken up again where it stopped 2026-10-22 20:40:02 +03:00
art Store's home page, privacy policy and terms; logo 2026-10-19 20:20:46 +03:00
assets README in MargyT's manner: banner, download and site up top 2026-10-19 21:43:47 +03:00
server The maker answers reviews, and their like or dislike shows on them 2026-10-19 21:21:17 +03:00
site 2.1: its own package and key 2026-10-21 21:11:14 +03:00
.gitignore 2.1: its own package and key 2026-10-21 21:11:14 +03:00
LICENSE Languages, markdown, own buttons, review votes, Google in the browser, betas beside releases 2026-10-19 18:26:25 +03:00
README.md README in MargyT's manner: banner, download and site up top 2026-10-19 21:43:47 +03:00

Margy Store

An app store for Android, from the people behind MargyT. Open source apps and mods only. Mods are built right on the phone.

download site channel licence

Download the apk · Open the store on the web · All releases


Margy Store is what Margy Patcher grew into. It keeps the patcher's package name and its signing key, so it installs over Margy Patcher and keeps everything it had: no need to remove anything first. Android 8 and up. No root.

It opens on the Margy team's own apps — MargyT, MargyT Lite, MargyC — and the whole store is one tap away. Everything in it links to its source code: an app whose source cannot be read is not let in.

The same store is on the web at margy.narez.xyz, with the same accounts. A link to an app or a person there is a link to the same page in the app: with the store on the phone, it opens there.

What it does

Mods, made on the phone

A mod of somebody else's app cannot be handed out whole: the app is not ours to redistribute. So a mod here is a patch: the store fetches the original apk the patch is for, checks it by its hash, applies the patch, and hands Android the result to install. The original can come from a mirror the release names, or from a file already on the phone.

A new version of the mod can be built on a new version of the original app, and the store simply fetches the new original. Anything that is ours outright is handed out as a plain apk, and that is checked by its hash too.

Accounts: Telegram and Google

No passwords. Signing in goes through Telegram (the project's bot says who pressed Start) or through Google (in the browser, so it works on phones without Google's services). Either can be linked to the other afterwards, and the first time somebody signs in they choose their nick.

Whoever is in the supporters' group on Telegram gets the supporter's badge and early versions.

Reviews, as a store has them

One review each per app, and the stars belong to the review: a tap on a star only picks it, and nothing counts until the review is posted. A review can be changed or deleted, and its stars go with it.

Reviews can be liked and disliked and sorted by either. The app's author can answer one under it, and when the author likes or dislikes a review, that shows on it apart from everybody else's.

Badges

The same badges as in MargyT, with the same pictures painted in their own colours. They show next to a name everywhere: in reviews, on profiles, in messages.

Messages

Anybody can be written to from their profile, unless they turned that off. Somebody new gets three messages until the other side accepts the conversation, and an unaccepted request does not say it was read. Messages take reactions, can be copied, and a few emoji on their own are shown big, as in Telegram.

Publishing your own app

Anybody signed in can submit an app or a mod: a name, a package, a link to the source, a licence. Once it is reviewed the app has its page and its author uploads its releases, with an icon, a cover, a description in Markdown and in three languages, and buttons of their own (a link, or a window of text).

A request waiting for review can already be looked at by those who chose to: Settings → Show unreviewed apps asks once more and then adds a tab for them. Rejected requests are never shown.

How it is built

app/ the Android app: Kotlin and Compose, Material 3
app/core/ the patch format and the code that applies it, plain Kotlin
server/store.py the server: Python's standard library and one SQLite file
site/web/ the store on the web: one page, no framework
site/store/ the privacy policy and the terms
assets/ the banner, and the script that draws it
art/ the logo

The server runs behind nginx at https://margy.narez.xyz/store/api/ and serves the uploaded pictures and apks from /store/files/. The store reads its own newest version from /store/api/self and updates itself.

Building it yourself

sh app/build.sh

That builds a release with Gradle, shrinks it, and signs it into build/. It expects a JDK 17 and the Android SDK; the paths are at the top of the script. Your build is signed with your own key, so Android will not put it over the official one: remove that first.

Licence

GPL-3.0-or-later, in LICENSE. Fork it, change it, ship it, and keep it open.

The apps in the store are their authors', each under its own licence, named on its page.