Skip to content

Latest commit

 

History

History
263 lines (177 loc) · 5.06 KB

REPO-JSON.md

File metadata and controls

263 lines (177 loc) · 5.06 KB

repo.json documentation

The core of detailing modules in Googlers-Repo/magisk-modules-repo-util

Supported Repositories

Every repository that uses the GR Repo Format should support this feature.

Tip

Non-array- and non-objects can also placed inside the module.prop file!

To use this feature you need to create a file named common/repo.json in your module root folder

Supported file formats:

  • .json
  • .yaml (recommended when you target specific root solutions)

Note

To ensure that edited or newly added properties are visible in the repository, you need to increase your module's version code.

support

The URL to your project's support page, forum, or issue tracker where users can get help or report problems.

Example:

"support": "https://github.com/owner/project/issues"

donate

The URL to the donation page for your project, where users can financially support its development.

Example:

"donate": "https://example.com/donate"

cover

The URL to a cover image representing the project. This should typically be a featured graphic for the project.

Example:

"cover": "https://example.com/cover.png"

icon

The URL to the icon image of the project, which should be squared and no larger than 512x512 pixels.

Example:

"icon": "https://example.com/icon.png"

license

An SPDX identifier specifying the license for the project.

For SPDX identifiers, see the SPDX license list.

Example:

"license": "MIT"

readme

The URL to the project's README file, which typically contains information like a project description and setup instructions.

Example:

"readme": "https://github.com/owner/project#readme"

homepage

The URL to the homepage of the project.

Example:

"homepage": "https://example.com"

screenshots

An array of URLs to screenshots of the module.

Example:

"screenshots": [
"https://example.com/screenshot1.png",
"https://example.com/screenshot2.png"
]

category

Caution

This property is not supported in MMRL V4 and above

The category the module belongs to. This field is deprecated.

Example:

"category": "Utility"

categories

Important

Repository owners can set a whitelist to prevent spam and abuse

An array of categories the module belongs to.

Example:

"categories": ["Utility", "Tools"]

devices

(avaiable above v5.30.40)

Note

This property overrides the following properties in MMRL

  • manager.magisk.devices
  • manager.kernelsu.devices
  • manager.ksunext.devices
  • manager.apatch.devices

Once this property is set, the above will be ignored.

An array of device model ID's which the module should work on. Get your model ID with getprop ro.product.model

Example:

"devices": [
  "SM-A705FN" // will only work on the Samsung Galaxy A70
]

arch

(avaiable above v5.30.40)

Note

This property overrides the following properties in MMRL

  • manager.magisk.arch
  • manager.kernelsu.arch
  • manager.ksunext.arch
  • manager.apatch.arch

Once this property is set, the above will be ignored.

An array of device architectures which the module should work on. Get your supported archs with getprop ro.product.cpu.abilist

Example:

"arch": [
  "arm64-v8a"
]

require

Note

This property overrides the following properties in MMRL

  • manager.magisk.require
  • manager.kernelsu.require
  • manager.ksunext.require
  • manager.apatch.require

Once this property is set, the above will be ignored.

An array of module_ids this module depends on.

Example:

"require": [
  "com.example.module1",
  "com.example.module2"
]

note

Caution

The color property is not supported in MMRL V4 and above

An additional note for the module. This is an optional field, but if it's defined, the message field is required.

Example:

"note": {
  "title": "Important Update",
  "color": "red",
  "message": "This module requires Magisk version 24.0 or higher."
}

manager

(avaiable above v5.30.40)

For the use if your module requires different modules on different root providers.

Available namespaces for manager

  • magisk
  • kernelsu
  • ksunext
  • apatch

See also FILE>require, FILE>devices, FILE>arch

"manager": {
  "magisk": {
    "min": 25200,
    "devices": [].
    "arch": [],
    "require": []
  }
}

root

Caution

The root property is depcreated in v5.30.40 and above. Use manager.{}.min instead

Note

If you want to implant this into your app, you should follow the semver syntax

Defines the minimum version requirements for root solutions such as Magisk, KernelSU, or APatch.

Example:

"root": {
"kernelsu": ">= 1.0.0",
"magisk": ">= 24.0"
}