MobileModels keeps 44 brand files with codename coverage marked per file
A compilation of phone brands and models. Licensed under CC BY-NC-SA 4.0.
At a glance
- What is it?
- MobileModels is a Chinese-language index that maps phone model numbers to the marketing names brands print on the box, organised as one markdown file per brand and region. Its index table carries a codename column with 25 included, 11 partly included and 8 not-included marks, while the scope column is where the real caveats live: start years and regional cutoffs.
- Who is it for?
- Use MobileModels when you need to turn a marketing name into a model number, or a model number into the name a device was sold under, for the brands listed. Check the scope column first, because a start year of 2015 or 2017 quietly removes everything older, and regional rows only cover what was sold in that region.
- Can I use it commercially?
- Check first. The repository uses a licence we do not classify automatically, so read its LICENSE file before any commercial use.
- Is it still maintained?
- Yes. The repository last received commits 3 days ago.
- What is it written in?
- GitHub does not report a main language for this repository.
Answers come from the project's GitHub data, last synced on November 15, 2026, and from our analysis. They are not legal advice.
Star history
- KHwang9883/MobileModels4,348 ★ · +36
| Repository | 2026-09-23 | 2026-11-15 |
|---|---|---|
| KHwang9883/MobileModels | 4.3k | 4.3k |
36 Stars in the last 53 days, measured from the daily GitHub snapshot. Compare with other projects
Editorial analysis
A codename column with 44 not-included marks in it
The index table at the top of the page has six columns: name, brand, aggregation scope, codename, overseas models, and notes. Three marks are defined once at the top and then used throughout: a check for included, a square for partly included, and a cross for not included.
The codename column is uneven: 25 rows carry the check, 11 the partly-included mark and 8 the cross. The stated purpose of the project is to collect model numbers together with their marketing names.
Overseas models are marked full for rows such as the English Apple, ASUS, Black Shark, Meizu and OnePlus editions, Google, Nothing, Sony and the three Xiaomi phone rows, partial for the overseas Huawei, OPPO, Samsung and vivo rows, and absent for most rows whose scope is the Chinese market.
One brand can take up five rows and file names encode region and language
Brands are not listed once. Apple takes three rows: `apple_all` covering the full range including iPhone, iPad, iPod touch, Apple Watch, Apple TV, Apple Vision, AirPods, AirTag, HomePod and Macs on Apple Silicon, then `apple_all_en` as the English edition of the same, then `apple_cn` limited to models sold in China. Xiaomi takes the most: `xiaomi`, `xiaomi_cn` and `xiaomi_en` for phones and tablets, `xiaomi-wear` for watches, bands and TWS earbuds, plus `mitv_cn` and `mitv_global_en` for televisions, smart monitors and set-top boxes.
The naming pattern is systematic rather than arbitrary. A suffix of `_cn` means the file covers only models sold in the Chinese market, and its overseas column is a cross except for `xiaomi_cn`. A suffix of `_en` means the file is the English edition, which the notes column confirms by marking it 英文版. Files with neither suffix, such as `blackshark`, `google`, `meizu`, `oneplus`, `sony` and `xiaomi`, cover both markets.
One row breaks the brand grouping: `zhixuan` sits under Huawei smart selection rather than under a manufacturer, and collects the co-branded lines U-MAGIC, the China Telecom Maimang, NZONE, Hi nova, RayNeo FFALCON, TD Tech and WIKO. Those are separate brands on the shelf wearing a partner's name.
Eight rows link to a file that the table says is not included
Eight rows carry the not-included mark in the codename column. They are `360shouji` for all 360 and Qiku phones, `coolpad` for recent Coolpad smartphones, `letv` for all Letv phones with a note that television products are excluded, `zte_cn` for models launched from 2017, `nubia_cn` and `nubia_global_en`, and the two Xiaomi television rows.
The partial codename marks are easier to spot by brand. Honor, Huawei, OPPO, realme, the overseas vivo row, the Xiaomi wearables row and the Huawei co-branded row all carry the partial flag, and in several cases the reason sits in the same row: the Chinese Huawei row says it covers only models sold in China, the overseas Huawei row says only Mate, Pura, nova and Y series plus tablets, and the wearables row notes that third-party ODM TWS models are excluded and children's watches are not yet included.
Older models are pushed out to a separate directory rather than dropped. The Huawei row links to `misc/early-huawei-models.md` for early models, the Samsung row links to `misc/early-samsung-models.md` on the same pattern, and the history section shows a third addition to `misc/`: a summary of each brand's model naming rules added in December 2021.
Coverage start years are written into the scope column
The scope text is where the real limits are, and they are mostly dates. Lenovo covers models launched from 2017. Motorola from 2015. Nokia covers smartphones manufactured by HMD Global from 2017, which is a narrower claim than all Nokia phones. ZTE from 2017. Sony from 2015 in both its rows. OPPO and vivo are both limited to the new model naming scheme from 2018 for the Chinese rows, while the overseas vivo row starts at 2019 and the overseas nubia row at 2023. The overseas Samsung row covers Galaxy S, Note, A, Z and F series from 2019.
None of these rows say what happens to a 2014 device. The answer sits in the two files under `misc/`, one for Huawei and one for Samsung, which is the pattern: recent coverage in `brands/`, older coverage in a linked aside.
The scope column also mixes product categories in ways that matter for anyone automating a lookup. The Apple rows extend well past phones into watches, TVs, AirPods and Macs. The two Honor rows cover phones, tablets, laptops, smart screens and wearables for the Chinese market but only phones and tablets overseas. The Huawei row runs from Mate, Pura, nova, G, Maimang and Changxiang through tablets, MateBook laptops, smart screens and wearables.
The document edition was declared unmaintained in 2019 and the repository kept growing
The project history section records that the document edition stopped being maintained in July 2019. Before that, the compilation had begun in February 2016 and a Xiaomi model list had been posted to the Xiaomi community in March 2016, released publicly in July 2018 after that post went dead, synced to GitHub in November 2018, moved to a Chinese cloud drive in March 2019, and returned to GitHub direct downloads with an English edition added in April 2019.
Several things came after that cutoff. A summary of bootloader unlocking and kernel source availability across Android vendors was added in April 2022, and its own line marks it as discontinued. In March 2024 the CSV files and the scripts were moved out to a separate repository, MobileModels-csv, with GitHub Actions doing the automatic updates, which is why nothing in the tree here looks like code: two changelogs, a licence file, two READMEs, and the `brands/` and `misc/` directories.
The last push to the default branch `master` is dated 2026-11-01, and the repository publishes no releases at all, so there is no version to pin to and no changelog entry with a tag attached.
Two web surfaces, one of them Beta and on a separate domain
Two different web properties are linked from the front page. The first is GitHub Pages under the repository owner's own account, which is the homepage recorded for the project. The second is an online data browser labelled Beta, hosted on a separate domain, kevinh.wang.
That split matters for how the data is consumed. The browser is the only piece of the project marked Beta. The repository itself carries no release tags, so neither surface has a version number attached to it.
Maintenance is doubled by language. The front page is written in Chinese and links an English edition at `README_en.md`, and the tree carries `CHANGELOG_en.md` next to `CHANGELOG.md`. A correction to a model number therefore lands in two changelogs and, where the index table changes, in two READMEs as well.
Model numbers are cross-checked against certification databases
The reference section shows where the model numbers come from. Certification and regulatory bodies dominate the list: the China Telecom terminal equipment site, a product certification certificate lookup, the Ministry of Industry and Information Technology government service platform for device registration, the China Telecom terminal information platform, and a CMIIT identifier lookup.
Regulatory identifiers are then reconciled with vendor and community sources: Google Play supported devices, the Wi-Fi Alliance, Bluetooth Qualification Listings, Xiaomi Firmware Updater, the Huawei and HONOR open source release centres, ReaMEIZU, The Apple Wiki, ipsw.me, XDA Developers, a Huawei firmware database and an Android dumps site.
This is the practical reason the repository is worth keeping. Marketing name to model number is the mapping vendors print inconsistently, and the reference list shows the cross-checks behind it rather than asking a reader to trust a table.
The licence is stated in three places and the metadata field is empty
The licensing picture has three visible parts and one disagreement. The project description states that the repository is licensed under CC BY-NC-SA 4.0. The licence section of the front page names the same terms in Chinese as the Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International licence, with the badge linked. A `LICENSE.txt` file sits at the root of the tree.
The repository metadata reports the licence as NOASSERTION, which does not match any of the three statements above. Rather than guess which one is authoritative, note that the named terms are non-commercial and share-alike: reuse must carry attribution, must stay non-commercial, and derivatives have to be shared under the same terms.
Those conditions are worth weighing against what the data is. A table mapping model numbers to marketing names is the kind of content a retailer, a repair shop or a price comparison site would want to reuse, and each of those uses runs into the non-commercial clause. Clearing that up is a question for the maintainer through the issue tracker rather than something the files settle.
Editorial conclusion
Use MobileModels when you need to turn a marketing name into a model number, or a model number into the name a device was sold under, for the brands listed. Check the scope column first, because a start year of 2015 or 2017 quietly removes everything older, and regional rows only cover what was sold in that region. Two things deserve a second look before you build on it. The licensing is non-commercial share-alike, so a commercial use needs a separate permission, and the licence field reported for the repository is NOASSERTION even though a LICENSE.txt sits at the root. And the codename column is uneven: 25 rows are marked included, 11 partly and 8 not included, so check the row before relying on codenames.
Frequently asked questions
What does the MobileModels repository actually collect?
Phone model numbers together with the marketing names brands use for them, organised as 44 brand files covering Apple, Xiaomi, Samsung, Huawei, Honor, OPPO, vivo, realme, OnePlus, Sony, Google, Nothing and others. The project started as a compilation in February 2016, with a Xiaomi model list posted to the Xiaomi community in March 2016, and is now split into regional and language variants such as `samsung_cn` and `samsung_global_en`.
Does MobileModels include device codenames?
For some brands. The index table has a codename column: 25 of its 44 rows carry the included mark, 11 the partly-included mark and 8 the not-included mark. The main mapping is model number to marketing name.
What licence covers the MobileModels data, and can it be used commercially?
CC BY-NC-SA 4.0 by name in the project description and in the licence section, with a LICENSE.txt at the root, while the repository metadata reports NOASSERTION. The named terms require attribution, forbid commercial use, and require derivatives to be shared the same way.
Which brands have only partial codename coverage in MobileModels?
Eleven rows carry the partly-included mark in the codename column, covering Honor, Huawei, OPPO, realme, the overseas vivo row, the Xiaomi wearables row and the Huawei co-branded `zhixuan` line. Eight more rows carry the not-included codename mark, including 360shouji, coolpad, letv and zte_cn.
Where is the code behind the MobileModels data?
Not in this repository. In March 2024 the CSV files and the scripts were moved to a separate MobileModels-csv repository where GitHub Actions updates them automatically. What remains here is the brands directory, the misc directory, two changelogs and two READMEs.
Official sources
Add this badge to your README
If you maintain this project, the badge below links readers to this analysis and shows its maintenance status from the daily GitHub snapshot. Paste the markdown into your README; add ?metric=license or ?metric=stars to the image URL for a different field.
[](https://hysenlabs.com/projects/khwang9883-mobilemodels)Star history chart for your README
[](https://hysenlabs.com/projects/khwang9883-mobilemodels)Was this useful?