Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
12 changes: 6 additions & 6 deletions .github/CONTRIBUTING.md
Original file line number Diff line number Diff line change
Expand Up @@ -17,7 +17,7 @@ Everything lives in [`data/`](../data):
- `roms/` - one file per ROM, like `grapheneos.yml`, plus anything that's true on every device it runs on
- `devices/<brand>/` - one file per device, named after its codename, like `devices/google/tegu.yml`
- `upstream/` - generated from each ROM's own device list every week. Don't edit these
- `support/<codename>/` - one file per ROM, for what people have reported, like `support/tegu/lineageos.yml`
- `support/<brand>/<codename>/` - one file per ROM, for what people have reported, like `support/google/tegu/lineageos.yml`

`brands.yml` lists the brands and `features.yml` lists the features we track.

Expand All @@ -29,10 +29,10 @@ The files in `upstream/` get rewritten by a bot every Monday, so any change you

The [form](https://github.com/NotAFlightRisk/android-rom-compat/issues/new?template=report-feature.yml) is the easy way. Pick a device and ROM, set whatever you've tried, and a bot opens a pull request for you with your name on the commit. If something's missing or doesn't add up, it comments on the issue saying what - just edit the issue and it'll try again. The "Report what works" button on each ROM on a device page fills in the device, the ROM and its Android version for you.

Rather do it by hand? Add a `features` section to `data/support/<codename>/<rom>.yml`, making the file if it's not there yet. Anything you leave out shows as unknown, which is fine.
Rather do it by hand? Add a `features` section to `data/support/<brand>/<codename>/<rom>.yml`, making the file if it's not there yet. Anything you leave out shows as unknown, which is fine.

```yaml
# yaml-language-server: $schema=../../../schema/support.json
# yaml-language-server: $schema=../../../../schema/support.json
features:
nfc: { status: working, android: 16, build: '2026091000', checked: 2026-09-17, source: tested }
camera: { status: partial, note: No 48MP mode, android: 16, checked: 2026-09-17, source: tested }
Expand Down Expand Up @@ -97,10 +97,10 @@ stay unknown.

## Adding support for a ROM

If the ROM has a file in `data/upstream/`, its device list comes from there and you can't add rows by hand - the ROM's own site is the place to fix it. For a ROM without an importer, make `data/support/<codename>/<rom>.yml` with the whole row:
If the ROM has a file in `data/upstream/`, its device list comes from there and you can't add rows by hand - the ROM's own site is the place to fix it. For a ROM without an importer, make `data/support/<brand>/<codename>/<rom>.yml` with the whole row:

```yaml
# yaml-language-server: $schema=../../../schema/support.json
# yaml-language-server: $schema=../../../../schema/support.json
status: active
android: 16
maintainer: someone
Expand Down Expand Up @@ -139,7 +139,7 @@ On GitHub, just open the pull request - the checks run automatically, and any pr
Working locally? Run `npm i` once, then `npm run validate`. It lists every problem it finds, like this:

```
✗ data/support/tegu/lineageos.yml
✗ data/support/google/tegu/lineageos.yml
android: comes from data/upstream/lineageos.yml, so only features go here
features.esim: "partial" needs a note, e.g. { status: partial, note: ... }
✗ data/devices/google/tegu.yml
Expand Down
2 changes: 1 addition & 1 deletion data/devices/oneplus/oscaro.yml
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# yaml-language-server: $schema=../../../schema/device.json
name: Nord CE 2 Lite 5G
codenames: [oscaro]
codenames: [oscaro, oscar]
aliases: [CPH2381, CPH2409]
released: 2022
soc: Qualcomm SM6375 Snapdragon 695
Expand Down
2 changes: 1 addition & 1 deletion data/devices/xiaomi/twolip.yml
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# yaml-language-server: $schema=../../../schema/device.json
name: Redmi Note 6 Pro
codenames: [twolip]
codenames: [twolip, tulip]
released: 2018
soc: Qualcomm SDM636 Snapdragon 636
hardware: [cellular, fingerprint]
Expand Down
2 changes: 1 addition & 1 deletion data/devices/xiaomi/xmsirius.yml
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# yaml-language-server: $schema=../../../schema/device.json
name: Mi 8 SE
codenames: [xmsirius]
codenames: [xmsirius, sirius]
aliases: [M1805E2A]
released: 2018
soc: Qualcomm SDM710 Snapdragon 710
Expand Down
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
# yaml-language-server: $schema=../../../schema/support.json
# yaml-language-server: $schema=../../../../schema/support.json
features:
volte: { status: working, note: If your carrier supports it, android: 13, checked: 2026-01-02, source: https://web.archive.org/web/20260105053757/https://murena.com/shop/smartphones/brand-new/murena-fairphone-4-eu/ }
vowifi: { status: working, note: If your carrier supports it, android: 13, checked: 2026-01-02, source: https://web.archive.org/web/20260105053757/https://murena.com/shop/smartphones/brand-new/murena-fairphone-4-eu/ }
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
# yaml-language-server: $schema=../../../schema/support.json
# yaml-language-server: $schema=../../../../schema/support.json
features:
volte: { status: working, note: If your carrier supports it, android: 14, checked: 2026-03-06, source: https://web.archive.org/web/20260308090540/https://murena.com/shop/smartphones/brand-new/murena-fairphone-5/ }
vowifi: { status: working, note: If your carrier supports it, android: 14, checked: 2026-03-06, source: https://web.archive.org/web/20260308090540/https://murena.com/shop/smartphones/brand-new/murena-fairphone-5/ }
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
# yaml-language-server: $schema=../../../schema/support.json
# yaml-language-server: $schema=../../../../schema/support.json
features:
volte: { status: working, note: If your carrier supports it, android: 16, checked: 2026-10-14, source: https://murena.com/shop/smartphones/brand-new/murena-fairphone-6/ }
vowifi: { status: working, note: If your carrier supports it, android: 16, checked: 2026-10-14, source: https://murena.com/shop/smartphones/brand-new/murena-fairphone-6/ }
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
# yaml-language-server: $schema=../../../schema/support.json
# yaml-language-server: $schema=../../../../schema/support.json
features:
volte: { status: working, android: 16, checked: 2026-10-17, source: https://murena.com/shop/smartphones/brand-new/murena-gs6/ }
vowifi: { status: working, android: 16, checked: 2026-10-17, source: https://murena.com/shop/smartphones/brand-new/murena-gs6/ }
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
# yaml-language-server: $schema=../../../schema/support.json
# yaml-language-server: $schema=../../../../schema/support.json
features:
volte: { status: working, note: If your carrier supports it, android: 13, checked: 2026-10-02, source: https://murena.com/shop/smartphones/premium-refurbished/murena-pixel-7-refurbished/ }
vowifi: { status: working, note: If your carrier supports it, android: 13, checked: 2026-10-02, source: https://murena.com/shop/smartphones/premium-refurbished/murena-pixel-7-refurbished/ }
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
# yaml-language-server: $schema=../../../schema/support.json
# yaml-language-server: $schema=../../../../schema/support.json
features:
volte: { status: working, note: If your carrier supports it, android: 12, checked: 2025-10-07, source: https://web.archive.org/web/20251007121920/https://murena.com/america/shop/smartphones/premium-refurbished/pixel-5/ }
vowifi: { status: working, note: If your carrier supports it, android: 12, checked: 2025-10-07, source: https://web.archive.org/web/20251007121920/https://murena.com/america/shop/smartphones/premium-refurbished/pixel-5/ }
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
# yaml-language-server: $schema=../../../schema/support.json
# yaml-language-server: $schema=../../../../schema/support.json
features:
volte: { status: working, note: If your carrier supports it, android: 16, checked: 2026-10-16, source: https://murena.com/shop/smartphones/premium-refurbished/murena-pixel-8-refurbished/ }
vowifi: { status: working, note: If your carrier supports it, android: 16, checked: 2026-10-16, source: https://murena.com/shop/smartphones/premium-refurbished/murena-pixel-8-refurbished/ }
Original file line number Diff line number Diff line change
@@ -1,3 +1,3 @@
# yaml-language-server: $schema=../../../schema/support.json
# yaml-language-server: $schema=../../../../schema/support.json
features:
android_auto: { status: broken, inferred: true, note: The Wi-Fi tablet builds leave Android Auto out, android: 16, checked: 2026-07-29, source: https://github.com/Evolution-X/vendor_gms/blob/bka/gms_full_tablet_wifionly.mk }
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
# yaml-language-server: $schema=../../../schema/support.json
# yaml-language-server: $schema=../../../../schema/support.json
features:
volte: { status: working, note: If your carrier supports it, android: 11, checked: 2024-10-01, source: https://web.archive.org/web/20241006063013/https://murena.com/shop/smartphones/brand-new/murena-one/ }
vowifi: { status: working, note: If your carrier supports it, android: 11, checked: 2024-10-01, source: https://web.archive.org/web/20241006063013/https://murena.com/shop/smartphones/brand-new/murena-one/ }
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
# yaml-language-server: $schema=../../../schema/support.json
# yaml-language-server: $schema=../../../../schema/support.json
features:
volte: { status: working, note: If your carrier supports it, android: 13, checked: 2024-04-04, source: https://web.archive.org/web/20240524073408/https://murena.com/shop/smartphones/brand-new/murena-2/ }
vowifi: { status: working, note: If your carrier supports it, android: 13, checked: 2024-04-04, source: https://web.archive.org/web/20240524073408/https://murena.com/shop/smartphones/brand-new/murena-2/ }
Original file line number Diff line number Diff line change
@@ -1,3 +1,3 @@
# yaml-language-server: $schema=../../../schema/support.json
# yaml-language-server: $schema=../../../../schema/support.json
features:
android_auto: { status: broken, inferred: true, note: The Wi-Fi tablet builds leave Android Auto out, android: 15, checked: 2026-07-29, source: https://github.com/Evolution-X/vendor_gms/blob/vic/gms_full_tablet_wifionly.mk }
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
# yaml-language-server: $schema=../../../schema/support.json
# yaml-language-server: $schema=../../../../schema/support.json
features:
volte: { status: broken, note: Not supported on this phone yet, android: 10, checked: 2023-03-23, source: https://web.archive.org/web/20230328044320/https://murena.com/shop/smartphones/premium-refurbished/murena-galaxy-s9-plus-refurbished/ }
vowifi: { status: broken, note: Not supported on this phone yet, android: 10, checked: 2023-03-23, source: https://web.archive.org/web/20230328044320/https://murena.com/shop/smartphones/premium-refurbished/murena-galaxy-s9-plus-refurbished/ }
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
# yaml-language-server: $schema=../../../schema/support.json
# yaml-language-server: $schema=../../../../schema/support.json
features:
volte: { status: broken, note: Not supported on this phone yet, android: 10, checked: 2023-04-28, source: https://web.archive.org/web/20230430163616/https://murena.com/shop/smartphones/premium-refurbished/murena-galaxy-s9-refurbished/ }
vowifi: { status: broken, note: Not supported on this phone yet, android: 10, checked: 2023-04-28, source: https://web.archive.org/web/20230430163616/https://murena.com/shop/smartphones/premium-refurbished/murena-galaxy-s9-refurbished/ }
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
# yaml-language-server: $schema=../../../schema/support.json
# yaml-language-server: $schema=../../../../schema/support.json
features:
volte: { status: working, note: If your carrier supports it, android: 11, checked: 2025-01-06, source: https://web.archive.org/web/20250117040332/https://murena.com/shop/smartphones/brand-new/murena-teracube-2e-emerald-eu/ }
vowifi: { status: broken, note: Not supported on this phone, android: 11, checked: 2025-01-06, source: https://web.archive.org/web/20250117040332/https://murena.com/shop/smartphones/brand-new/murena-teracube-2e-emerald-eu/ }
Loading
Loading