Skip to content

Conversation

@sameoldlab
Copy link
Collaborator

Add metadata files required for inclusion on fdroid.

This is a simple structure with some text files and pictures and should always be added before inclusion.

This is the expected structure for the folder. Although not all entries are required. I've included stub files for the ones which are.

├── en-US                       (en-US is the F-Droid fallback language)
│   ├── short_description.txt   (short description, max 80 chars, mandatory)
│   ├── full_description.txt    (full app description, max 4000 chars, mandatory)
│   ├── title.txt               (app name, max 50 chars)
│   ├── video.txt               (URL to a video introducing the app)
│   ├── images
│   │   ├── icon.png            (app icon)
│   │   ├── featureGraphic.png  (promo banner, shown on top of the app desc in F-Droid client; landscape)
│   │   ├── tvBanner.png        ("icon" for TV devices, currently not used)
│   │   ├── phoneScreenshots
│   │   │   ├── 1.png
│   │   │   ├── 2.png
│   │   │   ...
│   │   ├── sevenInchScreenshots/
│   │   ├── tenInchScreenshots/ (you may add different screenshots for different screen sizes)
│   │   ├── tvScreenshots/
│   │   └── wearScreenshots/
│   └── changelogs
│       ├── 100000.txt          (must correspond to versionCode, literally, no padding)
│       ├── 100100.txt          (if the version code was set to 100100)
│       └── 100101.txt          (max 500 chars)
└── ru                          (other locale codes)
   ...                         (localized metadata is always preferred by the client)
   └── changelogs
       └── 100100.txt

@sameoldlab
Copy link
Collaborator Author

Fdroid docs say this should be at the root of the repository, but can't find any details regarding mono repos. Will try joining they're matrix to see if I need to move it.

@sameoldlab
Copy link
Collaborator Author

Tagging @erlend-sh for input on short_decription and full_description.
And @michaelwschultz mentioned having something for the app screenshots.

@erlend-sh
Copy link
Contributor

erlend-sh commented May 23, 2025

Short description: Make space; cultivate knowledge

Full description:

Roomy is a communications playground – there's only one rule in the freeform game we're all playing together: Communicate, to the best of your ability. Roomy's job as a digital community platform is to make effective communication (mindful communing) effortless, that way everyone wins.

It might look like regular old group chat with a hint of even older internet fora mixed in, but that's just the default entry-point for group coordination. Roomy expands far beyond these familiar archetypes. How? That's better experienced than explained; go make some space to find out.

@sameoldlab
Copy link
Collaborator Author

Thanks!

Are links supported?

From what I can tell they are allowed, but might be removed or show up as plain text in certain places.

@sameoldlab
Copy link
Collaborator Author

Sorry, I should have come back to this much earlier. Will get it done this week.

@sameoldlab sameoldlab marked this pull request as ready for review October 29, 2025 20:57
@sameoldlab sameoldlab marked this pull request as draft October 29, 2025 20:58
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants