Add miniserve_gui

[probonopd]

Repository: https://github.com/ISuuuu/miniserve-gui

miniserve gui

• Stars: 23
• Release with the AppImage: v0.8.0 (2026-07-16T14:48:09Z)
• AppImage asset: miniserve-gui_0.8.0_amd64.AppImage
• License: MIT

Found by .github/workflows/discover-apps.yml, which looks for GitHub
repositories that publish AppImages but are not in the catalog yet. This
entry was not tested by a human; please review it before merging.

[github-actions]

@ISuuuu

🌏 An invitation / 邀请

你好！非常感谢你制作了这个 AppImage！👋

我们注意到这个应用的界面或说明文档主要是中文的。AppImage 目录面向全球用户，默认以英文显示界面的应用可以被收录，并有机会触达世界各地更多的用户。

想请教一下：这个应用是否也可能对国际用户有帮助？如果是的话，作者是否愿意考虑把英文设为默认语言呢（例如根据系统语言环境 LANG / LC_* 自动选择，在非中文环境下回退到英文）？这样它就能被收录到目录中，让更多国际用户发现并使用它。

当然，在中文环境下依然可以默认显示中文——我们只是希望在其他语言环境下能有英文界面。🙏

---

Hi there, and thank you for making this AppImage! 👋

We noticed that this application's interface or documentation appears to be predominantly in Chinese. The catalog serves a worldwide audience, and applications that show an English interface by default can be included and reach many more users internationally.

Might this application also be of interest to users outside China? If so, would you consider making English the default — for example by following the system locale (LANG / LC_*) and falling back to English outside a Chinese locale? That would let us include it in the catalog so that many more people around the world can discover and enjoy it.

Chinese can of course remain the default in a Chinese locale — we would simply love an English fallback elsewhere. Thank you so much, and we look forward to your thoughts! 🙏

Commit f6c3298. Full log

[ISuuuu]

Hi there! Thank you so much for the kind invitation and for maintaining the AppImage catalog! 👋

We have added full internationalization (i18n) support in our latest release (v0.8.1):

• Automatic Locale Detection: The app now checks the system locale (LC_ALL / LC_MESSAGES / LANG and system language) and defaults to English automatically on all non-Chinese environments (while keeping Chinese as the default for zh* locales).
• Manual Language Switch: Users can also manually switch between English and Simplified Chinese anytime in the app settings (including the system tray menu).
• English Documentation: The main README.md is now in English by default (with a link to README_zh.md for Chinese users).

We would be thrilled to have miniserve-gui included in the AppImage catalog! Please let us know if anything else is needed. 🙏

---

你好！非常感谢你们的邀请与支持！👋

我们在最新发布的 v0.8.1 版本中已经完成了国际化（i18n）支持：

• 自动识别系统语言：应用会自动检测系统语言环境（支持 LC_ALL / LC_MESSAGES / LANG 等），在非中文环境下默认显示英文界面，在中文环境下默认显示中文。
• 支持手动切换：用户也可以在界面顶部随时手动切换英文 / 简体中文（系统托盘菜单也会同步切换）。
• 英文说明文档：仓库主页默认的 README.md 也已更新为英文说明（并保留了中文文档链接）。

非常荣幸能被收录到 AppImage 目录中！如果还有其他需要调整的地方，欢迎随时告知。🙏

[probonopd]

/retest

[github-actions]

❌ Test failure

• The AppImage is missing a required file (see below). See https://docs.appimage.org/reference/appdir.html for what an AppImage must contain.

First error in the log:

FATAL: .DirIcon is missing in /tmp/.mount_runtimMcljdL

What next: once the AppImage is fixed (e.g. in a new release), comment /retest here to test it again. If it should not be in the catalog after all, close this pull request; an app that is already in the catalog can be removed by a maintainer with /remove.

Commit f6c3298. Full log

[ISuuuu]

/retest

[github-actions]

✅ Test passed

Please check that the screenshot shows the application's main window.

miniserve_gui

Compatibility: not self-contained: uses the C library of the system; references glibc 2.35

Warnings:

• The AppImage contains no update information, so users cannot update it with AppImageUpdate or similar tools. Please consider embedding it when building the AppImage (e.g., appimagetool -u) and publishing the .zsync file next to the AppImage; see https://docs.appimage.org/packaging-guide/optional/updates.html

Commit f6c3298. Full log

[ISuuuu]

Hi @probonopd, I noticed that the screenshot shown on the miniserve-gui AppImage page is cropped and doesn't show the complete application interface:

https://appimage.github.io/miniserve_gui/

Could you please adjust or replace the screenshot so that the full application window is visible? I can provide a suitable screenshot if needed. Thanks!

[probonopd]

/appstream

[github-actions]

How to add AppStream metadata (and your own screenshots)

The catalog page of an application can show a description, a summary, links and, above all, screenshots of your choice. They come from an AppStream metainfo file inside the AppImage.

1. Write the file. Save it as usr/share/metainfo/<id>.metainfo.xml inside the AppDir (the directory the AppImage is made from), where <id> is the <id> of the file, e.g. io.github.yourname.YourApp:

<?xml version="1.0" encoding="UTF-8"?>
<component type="desktop-application">
  <id>io.github.yourname.YourApp</id>
  <name>YourApp</name>
  <summary>One line saying what it does</summary>
  <metadata_license>CC0-1.0</metadata_license>
  <project_license>MIT</project_license>
  <description>
    <p>A few sentences about the application.</p>
  </description>
  <launchable type="desktop-id">yourapp.desktop</launchable>
  <url type="homepage">https://github.com/yourname/YourApp</url>
  <screenshots>
    <screenshot type="default">
      <caption>The main window</caption>
      <image>https://raw.githubusercontent.com/yourname/YourApp/main/screenshots/main.png</image>
    </screenshot>
  </screenshots>
  <releases>
    <release version="1.0.0" date="2024-01-31"/>
  </releases>
</component>

• <launchable> names the .desktop file of the AppImage.
• The screenshot is a web address (https://…) of a PNG image that stays there, e.g. a file in your repository. The file itself does not go into the AppImage.
• <project_license> is the license of the application, as an SPDX identifier.

2. Check it: appstreamcli validate --no-net usr/share/metainfo/<id>.metainfo.xml (from the appstream package of your distribution).

3. Put it into the AppImage.

• appimagetool, linuxdeploy, and other tools that build from an AppDir: copy the file to AppDir/usr/share/metainfo/ before building. appimagetool checks it while building.
• electron-builder: add it to the AppImage with extraFiles, e.g. in package.json: "linux": { "extraFiles": [ { "from": "build/<id>.metainfo.xml", "to": "usr/share/metainfo/<id>.metainfo.xml" } ] }.
• Other tools: see https://docs.appimage.org/packaging-guide/optional/appstream.html

4. Publish a new release with the new AppImage, then comment /retest on the pull request.

Note about screenshots: the automated test still runs the application and takes a screenshot of its own. The test needs it to check that the application starts and shows a window, so the test has to pass as before. But if the AppStream metadata names a screenshot, the catalog page shows that screenshot (the one marked type="default", else the first) instead of the automated one.

[ISuuuu]

/retest

[github-actions]

This pull request is merged, so its entries are tested again in a new pull request: #9685. Please follow the test there (comment /retest there to test again); this conversation is locked now.