listing: one store listing per app, and the banner drawn the same way for every app

The README sets out the listing each app keeps in its own repository, in the layout Google Play's tools read and
F-Droid accepts as it is: name, short and full description, icon, banner and phone screenshots, per language.

listing/banner.py draws an app's banner, the feature graphic Google Play asks for and the picture at the top of an
app's page in F-Droid: the app's mark in a round seal, its name and its address between two hairlines, on paper in
its own colours and typeface, 1024 by 500 pixels without transparency. banners.json holds the portal, "me-web?",
SimpleSchool and Passolo; the fonts are open-licence copies, listed in fonts/NOTICE.md.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01W4YtEKqxKjKyHkFzuRVMNA
This commit is contained in:
thepraandClaude Opus 5.5 committed 2026-11-08 20:37:39 +01:00
1 parent 5ced47c2b9
commit 82ba525999
13 files changed
+253

No files matched your search

+29
View File
@@ -209,6 +209,35 @@ One file per language, the file name being the code: Google uses language and re
its own list (`en-US`, `it`, `de-DE`). Empty files are skipped. Apple takes no release notes for an app's first its own list (`en-US`, `it`, `de-DE`). Empty files are skipped. Apple takes no release notes for an app's first
version; the action leaves them out and says so. version; the action leaves them out and says so.
## Store listing
Each app keeps its listing in its own repository, in the layout Google Play's tools read, so the same files serve
Google Play and F-Droid (`thepra/packages.arasaka.software` copies them into its F-Droid repository, mapping `it-IT`
to F-Droid's `it`):
```
fastlane/metadata/android/
en-US/
title.txt the name, up to 30 characters
short_description.txt up to 80 characters
full_description.txt up to 4,000 characters, plain text, "• " for a list
images/icon.png 512×512
images/featureGraphic.png 1024×500, no alpha
images/phoneScreenshots/ 1.png …, 1080×1920, no alpha, in the order shown
it-IT/ the same; a missing image falls back to en-US
```
`listing/banner.py <app> <target>` draws the banner (Google's feature graphic, the header of F-Droid's app page) for
an app named in `listing/banners.json`: its mark in a round seal, its name and its address between two hairlines,
in its own colours and typeface, at 1024×500 without alpha. Everything that matters sits in the middle, because
F-Droid trims a little off the top and bottom and puts its buttons over the top corners. It needs Python with Pillow and Chromium.
The marks are in `listing/marks/` (a mark may use `var(--accent)`, `var(--ink)` and `var(--well)`), the fonts in
`listing/fonts/`, each under the SIL Open Font License (`fonts/NOTICE.md`).
```bash
python3 listing/banner.py meweb ../MeWeb/fastlane/metadata/android/en-US/images/featureGraphic.png
```
## Versions ## Versions
`v1` moves forward with every change that keeps the inputs working; a change that breaks them becomes `v2`. Pin a `v1` moves forward with every change that keeps the inputs working; a change that breaks them becomes `v2`. Pin a
+78
View File
@@ -0,0 +1,78 @@
#!/usr/bin/env python3
import argparse
import html
import json
import re
import shutil
import subprocess
import sys
import tempfile
from pathlib import Path
HERE = Path(__file__).resolve().parent
WIDTH, HEIGHT = 1024, 500
BROWSERS = ("chromium-browser", "chromium", "google-chrome", "google-chrome-stable")
PAGE = """<!doctype html><meta charset="utf-8"><style>
@font-face{{font-family:Name;src:url('{font}')}}
@font-face{{font-family:Line;src:url('{mono}')}}
*{{margin:0;padding:0;box-sizing:border-box}}
html,body{{width:{width}px;height:{height}px;overflow:hidden}}
body{{background:{paper};color:{ink};--ink:{ink};--accent:{accent};--well:{well};position:relative}}
.rule{{position:absolute;left:0;right:0;height:1px;background:{rule}}}
.wrap{{position:absolute;inset:0;display:flex;align-items:center;justify-content:center;gap:56px}}
.seal{{flex:none;width:236px;height:236px;border-radius:50%;background:{seal};display:grid;place-items:center;box-shadow:inset 0 0 0 1px {rule}}}
.seal svg{{width:{mark_size}px;height:{mark_size}px;display:block}}
.name{{font-family:Name;font-size:{size}px;letter-spacing:{tracking};line-height:1.05;white-space:nowrap}}
.line{{margin-top:22px;display:flex;align-items:center;gap:18px;font-family:Line;font-size:20px;letter-spacing:.14em;text-transform:uppercase;color:{accent}}}
.key{{width:72px;height:4px;background:{key}}}
</style>
<div class="rule" style="top:64px"></div><div class="rule" style="bottom:64px"></div>
<div class="wrap"><div class="seal">{mark}</div><div><div class="name">{name}</div><div class="line"><span class="key"></span>{line}</div></div></div>
"""
def browser():
for name in BROWSERS:
found = shutil.which(name)
if found:
return found
sys.exit(f"none of {', '.join(BROWSERS)} is installed")
def page(spec):
mark = (HERE / spec["mark"]).read_text(encoding="utf-8")
mark = re.sub(r"^.*?(?=<svg)", "", mark, flags=re.S)
return PAGE.format(
width=WIDTH, height=HEIGHT, font=(HERE / spec["font"]).as_uri(), mono=(HERE / "fonts/FiraCode-Regular-ascii.woff2").as_uri(),
mark=mark, mark_size=spec["mark-size"], size=spec["size"], tracking=spec["tracking"],
name=html.escape(spec["name"]), line=html.escape(spec["line"]), **spec["colours"])
def render(spec, target):
from PIL import Image
with tempfile.TemporaryDirectory() as work:
source, shot = Path(work) / "banner.html", Path(work) / "banner.png"
source.write_text(page(spec), encoding="utf-8")
subprocess.run([browser(), "--headless", "--disable-gpu", "--no-sandbox", "--hide-scrollbars", "--force-device-scale-factor=1",
f"--window-size={WIDTH},{HEIGHT}", "--virtual-time-budget=5000", f"--screenshot={shot}", source.as_uri()],
check=True, capture_output=True)
with Image.open(shot) as image:
if image.size != (WIDTH, HEIGHT):
sys.exit(f"the browser drew {image.size[0]}x{image.size[1]}, not {WIDTH}x{HEIGHT}")
target.parent.mkdir(parents=True, exist_ok=True)
image.convert("RGB").save(target, "PNG", optimize=True)
def main():
specs = json.loads((HERE / "banners.json").read_text(encoding="utf-8"))
parser = argparse.ArgumentParser(description="Draw an app's store banner (Google Play's feature graphic, F-Droid's header), 1024x500, no alpha.")
parser.add_argument("app", choices=sorted(specs), help="the app, as named in banners.json")
parser.add_argument("target", type=Path, help="where to write it, normally fastlane/metadata/android/en-US/images/featureGraphic.png")
args = parser.parse_args()
render(specs[args.app], args.target)
print(args.target)
if __name__ == "__main__":
main()
+22
View File
@@ -0,0 +1,22 @@
{
"arasaka-portal": {
"name": "Arasaka portal", "line": "app.arasaka.software", "mark": "marks/arasaka-portal.svg", "mark-size": 200,
"font": "fonts/KellySlab-Regular.woff2", "size": 76, "tracking": "0.01em",
"colours": {"paper": "#f9f5f0", "ink": "#26201c", "accent": "#933332", "key": "#933332", "seal": "#efe8e0", "well": "#e4dbd0", "rule": "#d6d0c9"}
},
"meweb": {
"name": "me-web?", "line": "meweb.arasaka.software", "mark": "marks/meweb.svg", "mark-size": 178,
"font": "fonts/KellySlab-Regular.woff2", "size": 84, "tracking": "0.01em",
"colours": {"paper": "#f9f5f0", "ink": "#26201c", "accent": "#933332", "key": "#933332", "seal": "#efe8e0", "well": "#e4dbd0", "rule": "#d6d0c9"}
},
"simpleschool": {
"name": "SimpleSchool", "line": "app.scuolacinese.org", "mark": "marks/simpleschool.svg", "mark-size": 156,
"font": "fonts/Inter-SemiBold.woff2", "size": 74, "tracking": "-0.01em",
"colours": {"paper": "#f7f9fc", "ink": "#1d2a3a", "accent": "#2e5886", "key": "#4599d7", "seal": "#e9f0f8", "well": "#e9f0f8", "rule": "#d3dce8"}
},
"passolo": {
"name": "Passolo", "line": "passolo.scuolacinese.org", "mark": "marks/passolo.svg", "mark-size": 196,
"font": "fonts/NotoSerif-SemiBold.ttf", "size": 84, "tracking": "0",
"colours": {"paper": "#fdfaef", "ink": "#2b1d16", "accent": "#c8102e", "key": "#d4af37", "seal": "#c8102e", "well": "#c8102e", "rule": "#e6dcc2"}
}
}
Binary file not shown.
Binary file not shown.
Binary file not shown.
+10
View File
@@ -0,0 +1,10 @@
# Fonts
Each font here is licensed under the SIL Open Font License 1.1, whose text is `OFL.txt`.
| File | Font | Copyright |
|---|---|---|
| `KellySlab-Regular.woff2` | Kelly Slab | Copyright (c) 2011, Denis Masharov, with Reserved Font Names "Kelly", "Kelly Slab" |
| `FiraCode-Regular-ascii.woff2` | Fira Code, printable ASCII only | Copyright (c) 2014, The Fira Code Project Authors |
| `Inter-SemiBold.woff2` | Inter | Copyright (c) 2016, The Inter Project Authors |
| `NotoSerif-SemiBold.ttf` | Noto Serif | Copyright 2022 The Noto Project Authors |
Binary file not shown.
+86
View File
@@ -0,0 +1,86 @@
-----------------------------------------------------------
SIL OPEN FONT LICENSE Version 1.1 - 26 February 2007
-----------------------------------------------------------
PREAMBLE
The goals of the Open Font License (OFL) are to stimulate worldwide
development of collaborative font projects, to support the font creation
efforts of academic and linguistic communities, and to provide a free and
open framework in which fonts may be shared and improved in partnership
with others.
The OFL allows the licensed fonts to be used, studied, modified and
redistributed freely as long as they are not sold by themselves. The
fonts, including any derivative works, can be bundled, embedded,
redistributed and/or sold with any software provided that any reserved
names are not used by derivative works. The fonts and derivatives,
however, cannot be released under any other type of license. The
requirement for fonts to remain under this license does not apply
to any document created using the fonts or their derivatives.
DEFINITIONS
"Font Software" refers to the set of files released by the Copyright
Holder(s) under this license and clearly marked as such. This may
include source files, build scripts and documentation.
"Reserved Font Name" refers to any names specified as such after the
copyright statement(s).
"Original Version" refers to the collection of Font Software components as
distributed by the Copyright Holder(s).
"Modified Version" refers to any derivative made by adding to, deleting,
or substituting -- in part or in whole -- any of the components of the
Original Version, by changing formats or by porting the Font Software to a
new environment.
"Author" refers to any designer, engineer, programmer, technical
writer or other person who contributed to the Font Software.
PERMISSION & CONDITIONS
Permission is hereby granted, free of charge, to any person obtaining
a copy of the Font Software, to use, study, copy, merge, embed, modify,
redistribute, and sell modified and unmodified copies of the Font
Software, subject to the following conditions:
1) Neither the Font Software nor any of its individual components,
in Original or Modified Versions, may be sold by itself.
2) Original or Modified Versions of the Font Software may be bundled,
redistributed and/or sold with any software, provided that each copy
contains the above copyright notice and this license. These can be
included either as stand-alone text files, human-readable headers or
in the appropriate machine-readable metadata fields within text or
binary files as long as those fields can be easily viewed by the user.
3) No Modified Version of the Font Software may use the Reserved Font
Name(s) unless explicit written permission is granted by the corresponding
Copyright Holder. This restriction only applies to the primary font name as
presented to the users.
4) The name(s) of the Copyright Holder(s) or the Author(s) of the Font
Software shall not be used to promote, endorse or advertise any
Modified Version, except to acknowledge the contribution(s) of the
Copyright Holder(s) and the Author(s) or with their explicit written
permission.
5) The Font Software, modified or unmodified, in part or in whole,
must be distributed entirely under this license, and must not be
distributed under any other license. The requirement for fonts to
remain under this license does not apply to any document created
using the Font Software.
TERMINATION
This license becomes null and void if any of the above conditions are
not met.
DISCLAIMER
THE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF
MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT
OF COPYRIGHT, PATENT, TRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL THE
COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
INCLUDING ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL
DAMAGES, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
FROM, OUT OF THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM
OTHER DEALINGS IN THE FONT SOFTWARE.
+1
View File
@@ -0,0 +1 @@
<svg xmlns="http://www.w3.org/2000/svg" viewBox="71.743 22 306 306"><g fill="var(--accent)" fill-rule="evenodd"><path d="M224.743,275.146c-55.31,0 -100.147,-44.837 -100.147,-100.147c-0,-55.31 44.837,-100.145 100.147,-100.145c55.31,-0 100.147,44.835 100.147,100.145c-0,55.31 -44.837,100.147 -100.147,100.147Zm-0,-216.423c-64.218,0 -116.278,52.058 -116.278,116.276c0,64.22 52.06,116.278 116.278,116.278c64.218,-0 116.278,-52.058 116.278,-116.278c-0,-64.218 -52.06,-116.276 -116.278,-116.276Z"/><path d="M215.756,128.707l-19.249,19.251c3.276,5.474 5.165,11.875 5.165,18.719c-0,20.167 -16.349,36.516 -36.518,36.516c-20.165,-0 -36.513,-16.349 -36.513,-36.516c-0,-20.167 16.348,-36.515 36.513,-36.515c6.806,0 13.171,1.867 18.625,5.108l31.977,-31.979"/><path d="M215.795,215.432l-11.77,11.77c2.004,3.347 3.158,7.262 3.158,11.446c0,12.331 -9.996,22.328 -22.328,22.328c-12.33,-0 -22.326,-9.997 -22.326,-22.328c-0,-12.331 9.996,-22.327 22.326,-22.327c4.161,0 8.053,1.142 11.388,3.124l19.552,-19.554"/><path d="M215.756,229.028l0,42.21c2.961,0.263 5.958,0.405 8.987,0.405c3.029,0 6.026,-0.142 8.987,-0.405l-0,-42.287l31.929,-31.928c5.463,3.257 11.848,5.135 18.672,5.135c20.166,-0 36.514,-16.349 36.514,-36.516c-0,-20.167 -16.348,-36.515 -36.514,-36.515c-20.168,-0 -36.517,16.348 -36.517,36.515c0,6.825 1.878,13.207 5.137,18.672l-19.221,19.221l-0,-52.786c15.82,-4.005 27.528,-18.334 27.528,-35.398c0,-20.167 -16.348,-36.515 -36.515,-36.515c-20.167,-0 -36.516,16.348 -36.516,36.515c0,17.064 11.709,31.393 27.529,35.398l0,52.863"/></g></svg>

After

Width:  |  Height:  |  Size: 1.5 KiB

+7
View File
@@ -0,0 +1,7 @@
<svg xmlns="http://www.w3.org/2000/svg" viewBox="92 70 380 380">
<path d="M110 300 L230 196 L350 300 L350 404 L110 404 Z" fill="var(--well)" stroke="var(--ink)" stroke-width="18" stroke-linejoin="round"/>
<rect x="200" y="320" width="60" height="84" rx="8" fill="var(--accent)"/>
<path d="M330 170 A70 70 0 0 1 400 240" fill="none" stroke="var(--accent)" stroke-width="18" stroke-linecap="round"/>
<path d="M330 116 A124 124 0 0 1 454 240" fill="none" stroke="var(--accent)" stroke-width="18" stroke-linecap="round" opacity="0.7"/>
<circle cx="330" cy="240" r="18" fill="var(--accent)"/>
</svg>

After

Width:  |  Height:  |  Size: 605 B

+7
View File
@@ -0,0 +1,7 @@
<svg xmlns="http://www.w3.org/2000/svg" viewBox="110 116 260 260">
<g fill="none" stroke-width="22" stroke-linecap="round" stroke-linejoin="round">
<path stroke="#FDFAEF" d="M150 170 h156 a24 24 0 0 1 24 24 v70 a24 24 0 0 1 -24 24 h-86 l-40 34 v-34 h-30 a24 24 0 0 1 -24 -24 v-70 a24 24 0 0 1 24 -24 z"/>
<path stroke="#FDFAEF" d="M180 212 h96"/>
<path stroke="#D4AF37" d="M180 246 h64"/>
</g>
</svg>

After

Width:  |  Height:  |  Size: 417 B

+13
View File
@@ -0,0 +1,13 @@
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 256 194">
<title>Scuola di lingua Cinese</title>
<g id="leaves">
<path fill="#2E5886" d="M1.5 29 L23.5 50 L23.5 170 C83.9 171.8 95.3 182.3 111.5 190 C92.4 185.7 65.7 181.4 1.5 180 Z"/>
<path fill="#2779B8" d="M36.5 11 L60.5 32 L60.5 154 C94.1 161.5 107.6 168.4 126.5 188 C104.2 177.5 66.7 164.8 36.5 162 Z"/>
<path fill="#4599D7" d="M74.5 3 A52 53 0 0 1 126.5 56 L126.5 180 C115.1 166 99.2 148.8 74.5 145 Z"/>
</g>
<g transform="translate(256,0) scale(-1,1)">
<path fill="#2E5886" d="M1.5 29 L23.5 50 L23.5 170 C83.9 171.8 95.3 182.3 111.5 190 C92.4 185.7 65.7 181.4 1.5 180 Z"/>
<path fill="#2779B8" d="M36.5 11 L60.5 32 L60.5 154 C94.1 161.5 107.6 168.4 126.5 188 C104.2 177.5 66.7 164.8 36.5 162 Z"/>
<path fill="#4599D7" d="M74.5 3 A52 53 0 0 1 126.5 56 L126.5 180 C115.1 166 99.2 148.8 74.5 145 Z"/>
</g>
</svg>

After

Width:  |  Height:  |  Size: 904 B