Polish AppStream metainfo (follow-up to #3673) · Issue #3675 · aethersdr/AetherSDR · GitHub
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

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

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

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions