Skip to content

Polish AppStream metainfo (follow-up to #3673) #3675

Description

@ten9876

Follow-up to #3673 (merged as a01a089), which added the initial AppStream metainfo at packaging/linux/io.github.aethersdr.aethersdr.metainfo.xml. The author (@dawkagaming, SP9SKA) intentionally kept it basic and noted it should be expanded. appstreamcli validate currently passes with only info/pedantic notices — these are the items to clean up. Beginner-friendly; all in one small XML file.

1. OARS content rating (highest priority — Flathub gate)

appstreamcli reports content-rating-missing. Flathub requires this. For a ham-radio app an all-none rating is correct:

<content_rating type="oars-1.1" />

2. <developer> element

appstreamcli reports developer-info-missing. Add:

<developer id="github.com/aethersdr">
  <name>The AetherSDR Project</name>
</developer>

3. <releases> element

Modern software centres show version history from this. Add at least the latest release, e.g.:

<releases>
  <release version="x.y.z" date="YYYY-MM-DD"/>
</releases>

(Could later be auto-generated from tags in CI.)

4. Screenshot polish

  • Add a <caption> (pedantic notice; required for some stores).
  • Consider width/height attributes on <image>.
  • The current URL points at refs/heads/main (a moving target — the screenshot can change/break under released metadata). Prefer a tagged/stable URL.
<screenshot type="default">
  <image>https://raw.githubusercontent.com/aethersdr/AetherSDR/<tag>/docs/assets/screenshot-current.png</image>
  <caption>Spectrum and waterfall panadapter</caption>
</screenshot>

5. Summary leading article (pedantic)

AppStream prefers summaries not start with an article and not end with a period:
A Linux-native client for FlexRadio Systems transceiversLinux-native client for FlexRadio Systems transceivers

Optional

  • Expand <description> with a short feature <ul> (panadapter, native SmartSDR protocol, audio DSP, etc.).

Acceptance

appstreamcli validate runs clean (0 info/pedantic ideally), and the file is Flathub-submittable.

🤖 Generated with Claude Code

Metadata

Metadata

Assignees

No one assigned

    Labels

    documentationImprovements or additions to documentationenhancementImprovement to existing featuregood first issueGood for newcomersmaintainer-reviewRequires maintainer review before any action is taken

    Type

    No type

    Fields

    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions