Skip to content

Releases: ivan-hc/AM

"AM" 9.4.1

24 Dec 20:09
b6ab149
Compare
Choose a tag to compare

Customize/change the database by exporting variables

One thing I care a lot about is continuity, and as I have seen over the years, not all open source developers are able to maintain a project. This could happen to me in the future. I don't want it to be that way.

Because of this, I have made some essential variables "customizable":

it is enough to export the variables above and respect the destination file format (follow the URLs in parentheses) in case you decide to open a new community-driven database that can make up for the lack of support in this repository.


Motivation

I did this to not tie users to this database and to allow them to use AM and all its features if I, Ivan, am unable to intervene for any reason.

There are many discontinuous projects. Should this become one too, it will not be obsolete.

PS: consider this my Christmas present


What's Changed

Full Changelog: 9.4...9.4.1

"AM" 9.4

16 Dec 20:04
69c889a
Compare
Choose a tag to compare

Initial support for *BSD

This version of "AM" brings with it a refactoring that allows it to run on freeBSD and derivatives.

Istantanea_2024-12-16_17-34-23

Please note that at the moment, "AM" supports the installation of portable applications for GNU/Linux only.

On BSD-based systems, it is necessary to perform the necessary configurations to allow both binary programs and AppImages to be executed, by installing the appropriate Linux compatibility layout.

There are several guides on this subject, the main one is https://docs.freebsd.org/en/books/handbook/linuxemu/

A simplification of the above guide, oriented to the use of debootstrap is also available here. Thanks to it, I was able to run some test AppImages on GhostBSD

Istantanea_2024-12-16_18-37-37 Istantanea_2024-12-16_18-44-06 Istantanea_2024-12-16_18-38-22
google-chrome AppImage brave AppImage lxtask AppImage

Note that Chromium-based AppImages require the --no-sandbox flag.


All that glitters is not gold

Please note that "AM" is not responsible for the failure of programs, whether they are on Linux or BSD, and that all "AM" does is download and integrate/install programs into the system, taking them from the source.

In fact, this release allows you to use all aspects of "AM" on BSD, but the failure to run programs has nothing to do with "AM".

BSD systems require additional configuration to run programs written for Linux. In my experiments in virtual machines, I can't help but show failures. For example, running "Archimages" (Arch Linux containers inside Appimages) as in the screenshot below, with gimp and bottles

Istantanea_2024-12-16_18-50-20

It's just a matter of configuring the right settings, following the guides.


Toolpacks on BSD

Several programs from the Toolpacks database appear to be BSD-compatible, as they are static binaries. To see a list and install them, see the --toolpack flag reference (command am -h for more information).


Future

This release is just an introduction to BSD support. Experts are encouraged to participate in improving this support on "AM".

There are two possible ways:

  • add a directory to this database that contains only installation scripts for BSD-compatible programs. You can also select those that work in tests. At the moment, "AM" only has installation scripts for x86_64, aarch64 and i686 architectures on Linux. It would be nice to add another one that works for BSD https://github.com/ivan-hc/AM/tree/main/programs
  • add a script that can automate the creation of a compatibility layout for Linux, based on the official guides, so as to allow, in a single command, the addition or removal of this support, a guide is available here https://github.com/ivan-hc/AM/blob/main/docs/guides-and-tutorials/bsd.md

Other changes

  • less is now an "optional" dependency (but suggested in -h and -l) by @Samueru-sama
  • fixed several bugs related to versioning
  • removed other basic dependencies, such as strings by @Samueru-sama
  • improved table generation speed in -f by @Samueru-sama
  • better versioning for self-updating applications, through permission levels
  • ported a good part of the code to POSIX by @Samueru-sama
  • new functions to use and switch between sed on a per-implementation basis (default is GNU) by @Samueru-sama

What's Changed

Full Changelog: 9.3...9.4

"AM" 9.3

04 Dec 16:34
143a40e
Compare
Choose a tag to compare

Install AppImages and Sandbox them... in one go!

This release allows sandboxing of AppImage packages while installing them via a flag for -i and -ia or a dedicated option.


Option -i or install, with flag --sandbox

The new flag is --sandbox, using it in combination with -i or install allows you to install also AppImage packages from local scripts, if you have created your own and also from your custom database or a third-party repo you use near the "AM" database (see the "AM" documentation for more information)

am -i --sandbox {PROGRAM}

or localy

am -i --user --sandbox {PROGRAM}
appman -i --sandbox {PROGRAM}

Option -ia or install-appimage, with flag --sandbox...

...while in combination with the -ia or install-appimage command it allows you to select and install only the AppImages present in the "AM" database (which as I write, are 2123, see portable-linux-apps.github.io/appimages)

am -ia --sandbox {PROGRAM}

or localy

am -ia --user --sandbox {PROGRAM}
appman -ia --sandbox {PROGRAM}

...and the new variant of -ia: the -ias option!

But to simplify things, you can replace -ia --sandbox with the new option -ias (aka Install AppImage & Sandbox)

am -ias {PROGRAM}

or localy

am -ias --user {PROGRAM}
appman -ias {PROGRAM}

See it in action!

simplescreenrecorder-2024-12-04_16.44.11.mkv.mp4

You will find all the documentation on how sandboxing works in the related guide.


Option --sandbox

As you may have guessed from the video above, from now on, AM users will be able to choose whether to install "Aisap" locally or system-wide.

Istantanea_2024-12-04_17-18-49

Of course, make sure you already have an "appman-config" configuration file. If you don't have one, start any installation using the --user flag or start AM in "AppMan Mode" using the option --user. For more information, see am -h.


Option -f or files

The message indicating whether the AppImages are in a sandbox will only be displayed in tables that have the 🔒 symbol

Istantanea_2024-12-04_16-28-53

...the aisap command will be checked first, regardless of whether it is present system-wide or locally.

Learn more about "Aisap" https://github.com/mgord9518/aisap


What's Changed

Full Changelog: 9.2...9.3

"AM" 9.2

01 Dec 08:15
f5a1ced
Compare
Choose a tag to compare

Update and list portable AppImages scattered in your system!

This release introduces support for AppImage packages integrated with the --launcher option, and allows listing them with the -f option... but let's proceed in order.

Option -f or files

From today, AppImage packages integrated with the --launcher option will be visible in the list

Istantanea_2024-12-01_07-14-31

They will be listed with the file name (in the screenshot above I renamed my AppImage of the game "0AD" (available at https://github.com/0ad-matters/0ad-appimage) to 0ad. The file path and its size are also shown.

The detection is done on the fly, so if, like me, you have an AppImage on an external partition that is not mounted, the size will not be calculated, and -f will detect that the path is not accessible.

I advise you to give a nice name to your AppImage... or you will end up like this

Istantanea_2024-12-01_08-21-57

But that's not all I'm saying... what if you were to upgrade to a later version? The file name would still be the same, even though it's updated.

And speaking of updates... I know that's what you're here for, right? See below.


Option -u or update and option/flag --launcher

Added support for appimageupdatetool, which allows updating AppImage packages that include the information needed to update themselves via binary deltas.

Since people who normally use --launcher or AppImageLauncher or GearLever... or none of these tools except for the sole purpose of integrating them into the application menu... tend to keep multiple versions of an application... I thought it was not the case to integrate it directly into -u, so you can do it optionally

am -u --launcher

or

am --launcher -u

instead of -u you can use update... it depends on what suits you.

It is important that you install appimageupdatetool for this option to work.

simplescreenrecorder-2024-12-01_08.36.22.mkv.mp4

NOTE, I remind you that about 10% of AppImages support delta updates, so if you want to be sure to always have the latest version of all AppImages, rely on the installation options -ia or install-appimage and -e or extra... in addition to -i or install, which is for all portable programs, not just AppImages.


Various fixes

  • the installation process checks if there is a "dead" symlink in $HOME/.local/bin with the same name as the topic you are installing, and removes it (since classic installations have the priority over --launcher)
  • the detection of "dead" symlinks is more detailed and repetitive, and takes into account whether it is actually the case to remove them
  • obsolete launchers and symlinks are re-detected both while running -c and with -f and -u...and with --launcher itself, while you start it... so you have more opportunities to clean them
  • the --launcher option detects if a dead symlink or a command in $HOME/.local/bin already exists, and asks you if you want to overwrite it
  • the "install.am" installation module has been revamped, preparing for new features planned for the next months
  • the -u option has undergone a more thorough code cleanup and precise, new BASH functions have been added to improve interaction, depending on the commands in use
  • the messages of end of installation or end of update are also visible if no app as been installed or only apps have been updated (command am -u --apps)
  • many commands have been converted to POSIX

Conclusions

The --launcher option is a niche option, that I wrote inspired by any traditional AppImage package manager... and that I ended up using with really large packages that need to be kept on a dedicated partition.

Introducing this feature made me realize that AM can always go further. It all started with an issue, and in less than 24 hours this release came out. I wouldn't have expected it, at this time... if someone hadn't suggested it to me.

I'll continue to use AM as I intended, like APT or PacMan. There are options I've created that I like more or less... and I stress "even though I'm the creator"... and --launcher is one of my least favorites, because it reminds me of the early days, when none of the existing solutions satisfied me... but... damn. I really enjoyed working on it today.


What's Changed

  • Update install.am, code refactoring by @ivan-hc in #1168
  • Convert option "-ia"/"install-appimage" to a function under "-i" by @ivan-hc in #1169
  • Update modules by @ivan-hc in #1170
  • "AM" 9.2, improve support to local AppImages giving them updates support (appimageupdatetool) and a dedicated table in -f by @ivan-hc in #1172

Full Changelog: 9.1.3...9.2

"AM" 9.1.3

27 Nov 18:12
c86b2e4
Compare
Choose a tag to compare

Full support for AppBundles from AppBundleHUB

This release sees the addition of a new database of third-party applications to the "AM" database: AppBundleHUB, and more precisely the programs in AppBundle format (see https://github.com/xplshn/pelf).


Programs in lists

Programs in lists will be listed with the extension ".dwfs.appbundle". For example, "ristretto.dwfs.appbundle" or "chromium-web-browser.dwfs.appbundle"


Option -l or list

As an exception, the list will be accessible using the existing --toolpack and --all flags. Here is the output with the --toolpack flag

Istantanea_2024-11-27_18-28-38 png

...this is the only case where you will need to use a flag.

Since the list is still small, I preferred to merge them into a single list. The programs in AppBundle format (so with the extension ".dwfs.appbundle") will all come from AppBundleHUB.


Option -q or query

Unlike -l, programs in AppBundle format will be searchable normally (i.e. without flags) with the -q option, therefore alongside the applications in the "AM" database

Istantanea_2024-11-27_17-16-41

...note the programs with the extension ".dwfs.appbundle", this will serve to distinguish them from those in the "AM" database.


Completion

The reason for adding these extensions is not only to distinguish them, but also to quickly list them using BASH/ZSH completion

simplescreenrecorder-2024-11-27_18.36.09.mkv.mp4

...you won't have to work too hard to distinguish them from the lists.

The listing is the only reason they have the extension... but the installation is a different thing. See the next paragraph.


-i or install option

No flag is needed, AppBundles will be installed only if followed by the extension ".dwfs.appbundle", and they will be installed WITHOUT EXTENSION

Istantanea_2024-11-27_17-22-20

...and yes, the information in -a will also be reported in more detail. See next paragraph.


-a or about option

AppBundles will have the privilege to also show the "real" package name, whether they are installed or not

Istantanea_2024-11-27_16-54-46

As with Toolpacks, apps from AppBundleHUB will see pages created on the fly, using the list provided by the owner of that database. Thanks @xplshn

A small aside, the -a option in general has also undergone major structural changes. Now the information will be displayed in a clearer and more pleasant way... assuming that the pages in use are up to date (I'm talking about the "AM" database, I need a hand with my catalog).


Option -f or files

Of course, the list of installed apps will also show that the apps come from a different database ("DB" column) and a new file type called "dwarfs-appbundle"

Istantanea_2024-11-27_19-50-59

For those who don't know, AppBundles are POSIX scripts compressed with "DWARFS" and that contain the entire application. With a powerful enough text reader, you can read their content. They literally represent the statement "one application = one file".

To learn more about this topic, I invite you to visit the "Pelf" repository, at https://github.com/xplshn/pelf , a tool that can create this fantastic packaging format.


Conclusions

Portable programs are always welcome in "AM", no matter how many formats they are. As long as there is "AM" to distribute them, you will have no reason to complain about too many packaging formats.

Flatpak only supports .flatpak, Snap only supports .snap, APT only supports .deb... etc. etc.

"AM" is more inclusive. It accepts these diversities that are not tied to a package manager. An AUR helper does the same thing, but only for Arch Linux. Here instead we want to allow all GNU/Linux distributions to use the same programs according to their efficiency.

What does AppBundle have more than others? I know that it also works on Musl distributions, while many programs, and probably most of them... are written to work with GLIBC. And if you are an AppImage user, how many times have you tried to start a program that is not compatible with your version of GLIBC? Many of you will have surely received this type of error in the past.

Don't get me wrong, I love AppImages. I have 70 of them in my repositories.

With Archimages and similar I have tried to use Arch Linux containers inside AppImages, to provide recent programs that also work on old Linux systems, and precisely because they are portable containers. AppImage is also solving a lot of problems recently, and I invite you again to follow its developments, they are doing fantastic things recently. AppBundle instead was born already like this. It is still not very popular, but I firmly believe that it, like many other emerging realities, deserves due attention.

Let's give everyone a chance.

The beauty of Linux is precisely this: diversity!


What's Changed

Full Changelog: 9.1.2...9.1.3

"AM" 9.1.2

20 Nov 15:28
734a61e
Compare
Choose a tag to compare

"Transparent" updates

For aesthetics, the output of the update process for applications is hidden and runs in the background... but from this release it is possible to extend the am -u command using the "--debug" flag, which will ensure that the messages are displayed.

USAGE

            am -u
            am -u --apps
            am -u --debug
            am -u --apps --debug
            am -u {PROGRAM}
            am -u --debug {PROGRAM}

The new --debug flag can then be used to update individual apps, just apps, or updating everything

simplescreenrecorder-2024-11-20_13.33.15.mkv.mp4

...you will be able to see how the applications are updated, and you will notice different systems, depending on the application installed.

Here is an example with appimageupdatetool installed, even though it has the same apps as the previous video

simplescreenrecorder-2024-11-20_07.28.34.mkv.mp4

As you may notice, the messages change, as some applications have update scripts that support multiple update standards, and which can override each other depending on the situation (for example, if the metadata is not present in the application, the classic version comparison update will be performed).

With this release, updates are no longer mysterious!

NOTE, Topgrade users will get the regular output as usual, without flags.


Among other changes

  • -c option, improved cleaning of installed items via the --launcher option
  • --launcher option, now applies the method used in the installation scripts to integrate launchers and icons from the AppImages you have scattered in the system, thanks @Samueru-sama for the tip
  • fixed a bug in the -t option, where, having a Github key, if you created the installation scripts, it was written in the script, thanks @nazdridoy for reporting this

What's Changed

Full Changelog: 9.1.1...9.1.2

"AM" 9.1.1

13 Nov 21:03
37d8edd
Compare
Choose a tag to compare

More and more programs

The -l or list option will show the total number of installable programs in the header!

By default, the am -l command will only show the applications available in the "AM" database, but with the addition of a message that will suggest you to run the command with the --all flag, to show them all, from all supported databases (for now only "AM" and "Toolpacks").

Istantanea_2024-11-13_21-25-38 png

The update speed of the program list from the Toolpacks database has also been improved, reducing it by 3/4 of the time it took in the previous version.

The Toolpack and AppImage list files can now be consulted offline.


New step in "synchronization"

Added an additional step during synchronization (option -s or sync) and consequently, at the end of the update (option -u or update) during which the Toolpack and AppImage lists will be created and updated.

simplescreenrecorder-2024-11-13_21.31.23.mkv.mp4

You will be able to view it from the first update you do after getting this release.


AppBundle Support

A new template is now available, made by @xplshn , creator of dbin and AppBundle. The new script will better integrate this new portable application format for GNU/Linux.

For more information, go to the repositories of the projects involved:

Last but not least... AppImage packages are all from the "AM" database. The Toolpack repository also distributes them, but I decided not to list theirs to avoid duplicating existing apps that have their own dedicated script. I want to list as many unique apps as possible and in different portable formats. And AppBundle or FlatImage (see https://github.com/ruanformigoni/flatimage) are some of the new ones.


Terms for BASH/ZSH completion in Toolpack apps

Terminal completion of search terms for programs from the Toolpacks repository will all have the ".toolpack" extension, to improve speed in researching (option -a or about) and especially in installing programs, and without having to resort to the --toolpack flag (option -i or install).

Istantanea_2024-11-13_22-01-16 png


Bug Fixes

Fixed several bugs regarding updating (-u or update) and cleaning (-c or clean) on systems with many applications installed, either from the "AM" database or the "Toolpacks" database. See #1109


Conclusions

The introduction of Toolpacks support has brought many new features, thousands of more applications (suddenly) and many small details to fix to make "AM" an ever better CLI, to manage all portable programs for GNU/Linux.

I invite you to deepen your knowledge on the new support database, "Toolpacks", at https://github.com/Azathothas/Toolpacks, and I invite you to contribute as much as possible to these projects, parallel, but increasingly part of this project of mine called "AM".

New, very interesting portable formats are emerging, and "AM" wants to be a springboard for these applications.

Also take a look at dbin, by our friend @xplshn , who with this release puts his signature among the contributors to this project.

Thanks to everyone!

What's Changed

New Contributors

Full Changelog: 9.1...9.1.1

"AM" 9.1

10 Nov 16:02
322a545
Compare
Choose a tag to compare

Unity is strength!

This release sees the addition of support for programs from a third-party repository, which DOUBLES the number of installable programs!

I'm talking about "Toolpacks" https://github.com/Azathothas/Toolpacks

To show you how the number of applications grows, I added to -l or list the ability to see the total apps available in each database, or overall... when you exit the list.

meno l total

But let's proceed in order. Here's how the functioning of "AM" changes thanks to "Toolpacks".


The --toolpack flag

The new --toolpack flag will be usable in the -i (installs), -l (lists) and -q (searches) options. Here is how the syntax should look like.

            am -i --toolpack {PROGRAM}
            am -i --toolpack --user {PROGRAM}
            am -l --toolpack
            am -q --toolpack {KEYWORD}

...you can see more details by starting the help message with the command am -h.


Install applications

You can install programs from the Toolpack repository by adding the --toolpack flag, this way items from that repository will have priority over those available in the "AM" repository

install.mp4

...and not only that, you can also use the .toolpack extension to the program you are interested in, and without using the flag. Here is a short demonstration, locally I will install steam.appimage, which is equivalent to the Steam AppImage (steam package) already present in the "AM" repository... and available as a fallback on Toolpacks, in case of problems with github.com

install.steam.mp4

This is just a demonstration.

Of course, Toolpacks is more oriented to installing static binaries, including AppBundle and Flatimage formats.

For AppImages, regular installation from the "AM" database is recommended!

PS: As you may have noticed from the video, the -a and -f options have also undergone some changes. Let me tell you about them.


-f or files option to list installed apps: what's changed?

A new column "DB" (or "database") has been added to the table listing installed programs. From there it will be possible to recognize which programs were installed from the "AM" database (am), which from "Toolpacks" (toolpacks)... and also which were installed from external sources, for example, with the -e or extra (none or unknown) option.

files

In the future, on request, new databases could be implemented in the same way.


Option -a or about

Application installed by Toolpacks will appear with the package name with the extension .toolpack, but installed with the actual program name as listed. No flags are needed here.

about.mp4

...note that the page loading times are slower, this is due to the "on the fly" creation of the page to be displayed, these being not "real" pages like the ones we have in our catalog.

...by the way. And the lists? Here's what happened.


-l and -q options, use of new --toolpack and --all flags

The --toolpack flag is not the only one that has been introduced. The -l or list and -q or query options have a new additional flag: --all

As you may have guessed, it allows you to display all the applications present in all the databases, together...

list.mp4

...and to perform searches in them

query.mp4

so the new syntaxes are as follows, for the lists

                am -l
                am -l --all
                am -l --appimages
                am -l --toolpack

...and for the queries

                am -q {KEYWORD}
                am -q --all {KEYWORD}
                am -q --appimages {KEYWORD}
                am -q --pkg {PROGRAM1} {PROGRAM2}
                am -q --toolpacks {KEYWORD}

The flags are pretty intuitive and will tell you what they do.


Conclusions

Thanks to the creators of Toolpacks and Dbin for their support. Thanks to all the contributors of the issue that started it all.

I invite you to visit their repositories and everything they have to offer!

Since the applications available in the "AM" database began to exceed a thousand, I have done everything to make my project as extensible as possible, allowing the use of custom repositories (see newrepo option). The fact is that I do not know how long I will have the possibility to continue dedicating myself to this project... so, in my absence, the addition of Toolpacks will contribute to exponentially grow the number of programs available, even in my absence.

Thanks to everyone who wants to support my project! Thanks to everyone!


What's Changed

Full Changelog: 9.0.2...9.1

"AM" 9.0.2

07 Nov 15:57
bb681f6
Compare
Choose a tag to compare

Allow to use icon theme immediately after installation

Normally in "AM", an installation would patch the .desktop file to use a well-defined path for icons, i.e. /opt/{PROGRAM}/icons, and then to use an icon theme it was enough to run am --icons {PROGRAM}.

From now on the --icons option can be used as a flag for the -i or install and -ia or install-appimage installation options, like this:

am -i --icons {PROGRAM}

or

am -ia --icons {PROGRAM}

and works with the pre-existing --debug, --force-latest and --user flags.

Changes will only be made to apps installed when the above commands are run.

As in am --icons, icons for other installed apps will be symlinked to ~/.local/share/icons/hicolor/scalable/apps, but launchers will remain intact.

NOTE, if you use the --user flag together with --icons, only local apps will be considered. Use am --user if you also want to use icons of apps installed at system level.


PS: this is the second release in thwo hours, please don't miss the other one https://github.com/ivan-hc/AM/releases/tag/9.0.1

"AM" 9.0.1

07 Nov 13:04
4a6e97c
Compare
Choose a tag to compare

Shut up! I "AM" updating!

New options to disable/enable notifications when updating apps.


--disable-notifications

	am --disable-notifications

Description:

Disable notifications during apps update.


--enable-notifications

	am --enable-notifications

Description:

Eable notifications during apps update (nulls "--disable-notifications").


All they do is comment/uncomment lines containing notify-send in the AM-updater files of installed apps.

simplescreenrecorder-2024-11-07_13.58.26.mkv.mp4

NOTE, if you really hate notifications, run the command after every install or new apps will not be patched.

NOTE2, apps that use zsync to update will rely on version comparison or appimageupdatetool if installed and supported by the app.