Add moon-lander

[andy5995]

How do you make the scripts for AM to install this? Do you have a tool or create them manually? How do you add this to games.md? I was going to do it manually but I thought I'd ask you first about things. ;)

[ivan-hc]

@andy5995 thanks for this addition. This catalogue depends on the AM package manager. If an app is not in the database, the workflow will remove the page. You need to create the script first.

How to submit an app to AM

To create an installation script, you need to use the option -t, In the video below I'll show you how much is easy to create a script:

simplescreenrecorder-2026-03-19_13.27.54.mp4

I wanted to do it in real time, but I noticed that the description was not suitable, so I added the one from this PR

I have to do so because github can't upload videos bigger than 10 MB.

As you have seen in the previous video, I switched to English to show you the instructions on screen (I use AM in Italian).

First I wrote

am -t https://github.com/andy5995/moon-lander-appimage

the option is set to extract only moon-lander from this URL, but the best practice would be to do

am -t moon-lander

In first it asks you if you for what kind of app you want to create the script, and 0 is the default, for AppImages, write 0 or press ENTER directly.

Add the URL to the site or repository. If it is a github repo, is better, so it can automatically recognize the releases section.

Is recommended to leave defaults, so do not set "latest", sometime developers may not add an app in "latest". Its not your case, but to leave defaults assures at least an artifact from a release.

The prompt also shows a preview of the download URL. If the URL is OK (like in your case), you can leave defaults, press ENTER. If not, you can add keywords to include (1) or exclude (2) in a grep search. It uses grep -i and grep -vi respectively.

The option is set to search artifacts for x86_64 only. If it exists, then searches for aarch65 ones.

In the end It creates the scripts in the $ARCH directory (in your case x86_64 and aarch64, because you have both), and a file "list" with instructions on how to use it.

I have lost time in the video by searching a suitable description, as I already said.

I added the line on top of bot the $ARCH-apps lists, and saved the changes.

Finally I removed the file "list".

Now that all is ready, you can drag/drop all stuff to the /programs directory of your fork of AM.

See here:

simplescreenrecorder-2026-03-19_13.45.43.mp4

The workflow will sort the app for you, and also adds the app in the $ARCH-appimages lists.

All this require 2 minutes or less.

[ivan-hc]

Now that the page and the icon are added, you must wait. There is a workflow in this site that runs every hour

https://github.com/Portable-Linux-Apps/Portable-Linux-Apps.github.io/actions/workflows/sync-with-AM.yml

It downloads/updates and runs the following script from the AM repository

https://github.com/ivan-hc/AM/blob/main/tools/am2pla-site

The above is responsible of pages creations. On the base of the description of each app, it creates the entry to the related category/categories.

These are keywords for "game"

https://github.com/ivan-hc/AM/blob/f71bf751f046d05b0ed834c8825f28bcf56bda76/tools/am2pla-site#L293-L294

This description is taken from the x86_64-apps list of AM (not from aarch64-apps or any other $ARCH-apps list, just the x86_64 one).

If you add a app to AM without creating a page in this catalogue after, this workflow will create it for you, using the description you provided in the x86_64-apps list.

The URL reference come from the "SITE=" reference of the script. In your case it is

SITE="andy5995/moon-lander-appimage"

The workflow recognizes that it is a github repository, so it completes the reference to https://github.com/andy5995/moon-lander-appimage

Also, a generic dumb icon is used as a fallback.

The above is explained here

https://github.com/Portable-Linux-Apps/Portable-Linux-Apps.github.io/blob/main/CONTRIBUTING.md

You have already added the page and the icon. But you can edit the page and change the icon always.

[ivan-hc]

Finally, if an app is removed from AM, the workflow will remove the page from this catalogue and from any category.

[ivan-hc]

This is all you need to know @andy5995

I'm glad to see you again, after our 0ad-appimage has been archived.

[ivan-hc]

This commit have just added your app to the lists and also another one added in the same hour by another user

f9a76e8#diff-0a3574de1df6c9f4e05cd0394e585a7820f62d81c8fdc81f664e598975032438

All this have been done by the workflow.

See how it have created a page and an icon for omniroute.

EDIT: and your moon-lander has been added to Games category as well :)