Help us achieve self-maintaining App Listings by adding AppStream Metadata!
Posted December 24, 2022 by 1peter10 ‐ 4 min read
With the festive season upon us, and the end of 2022 approaching, we have a big ask: Help us keep app listings up to date by working with upstream projects!
In the past months, not many apps were evaluated or added to LinuxPhoneApps.org. But still, things were done: The technical stack was much improved. While most of this work is not directly user-facing, as it's about restructuring the underlying .csv files and adding more and more automatic content checkers, we've now arrived at a stage where we can update listings without a lot of the time-intense churn this was.
As the main contributor of these efforts1 put it in the Matrix group:
Help wanted: upstreaming metadata
The last weeks, I created a script which allows us to automatically update outdated information in the apps.csv file based on AppStream metadata: https://framagit.org/linmobapps/linmobapps.frama.io/-/blob/master/check_via_appstream.py.
This massively decreases manual maintenance overhead and allows us to instead focus on adding additional value like testing the apps, storing mobile compatibility scores and so on.
In order for that workflow to work out, we need your help:
- Make sure each repository has an AppStream metadata file. This job will list you the missing ones.
- Add missing values: This job will show you where we have more information that reported upstream -> just earch for "missing in upstream AppStream file. Consider contributing it upstream"
See this issue for further info. You can also comment links to upstream issues and merge requests there.
Want to help? Great! Please be polite and helpful to upstream!
As always: Please don't bomb upstream here, be polite, don't just go around and create a ton of issues on upstrean projects!
Try to be helpful instead: If you've ever dealt with HTML or other XML things, you'll be able to understand AppStream files well enough without much effort to create a Merge Request (MR) or Pull Request (PR), to take the initial load of this task from the individual developer. Be kind in the description of your PR or MR, after all it's a request you are making and politeness does not cost you money.
In order to reduce duplicate effort, make sure to briefly mention your MR or issue to the issue that tracks progress. If you don't want to sign up with Framagit for that purpose, sending an email to upstream-appstream@linuxphoneapps.org will do the same once I (linmob) get to it.
More on AppStream Metadata
If this is the first time you've heard of AppStream Metadata, you may wonder: Ok, what is this good for? Is all this XML not a little much just to support this dumb LinuxPhoneApps.org website? Yes, it would be, you're not mistaken. But this is a well established specification, it makes listings in GNOME Software, KDE's Discover and other 'app store'-ish apps.look have nice content.
Still not convinced? Well, it also provides the data for websites like
If you don't like XML, here are other ways to help
Pretty cool, huh? If you still don't think so, and don't want to help us this way, you can help in other ways:
- Submitting apps by email,
- Submit apps on GitLab,
- or just by writing a nice 'Thank you' mail/toot/tweet to the developers of your favorite apps!
And if you don't want to help at all, that's fine too. ;-) And even if we are a day late: Happy Festivus!
Who doea not even want to be named - still: Thank you so much for your work on LinuxPhoneApps, and thanks for putting up with me (linmob) being difficult!