Skip to content

Simplify, add more direct links, etc #21

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
scrubbbbs wants to merge 1 commit into
base: main
Choose a base branch
from
Open

Simplify, add more direct links, etc #21

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
62 changes: 22 additions & 40 deletions content/docs/getting-started/installation.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -14,52 +14,34 @@ toc = true
top = false
+++

nomacs – Image Lounge is licensed under the GNU General Public License v3
© Markus Diem, Stefan Fiel, and Florian Kleber, 2011 – 2020
nomacs – Image Lounge is licensed under the **GNU General Public License v3**
- © Markus Diem, Stefan Fiel, and Florian Kleber, 2011 – 2020
- © Nomacs Contributors, 2020 - 2026

## 64-bit Windows
# Latest Stable Release

- [Installer](https://github.com/nomacs/nomacs/releases/latest/download/nomacs-setup-x64.msi)
- [Portable package](https://github.com/nomacs/nomacs/releases/latest/download/nomacs-portable-win.zip)
See [GitHub Release Page](https://github.com/nomacs/nomacs/releases/latest) for additional downloads and release notes.

## Linux
Direct Downloads:
- [Windows 11 x64 Installer](https://github.com/nomacs/nomacs/releases/latest/download/nomacs-setup-x64.msi)
- [Windows 11 x64 Portable](https://github.com/nomacs/nomacs/releases/latest/download/nomacs-portable-win.zip)
- [Linux x64 AppImage](https://github.com/nomacs/nomacs/releases/latest/download/nomacs-linux-x86_64.AppImage)
- [Linux aarch64 AppImage](https://github.com/nomacs/nomacs/releases/latest/download/nomacs-linux-aarch64.AppImage)
- [macOS x64](https://github.com/nomacs/nomacs/releases/latest/download/nomacs-macOS-x86_64.dmg)
- [macOS arm64](https://github.com/nomacs/nomacs/releases/latest/download/nomacs-macOS-arm64.dmg)

### Repositories
Build from Source:
- [Source Code Archive](https://github.com/nomacs/nomacs/releases/latest)
- [Build Instructions](https://github.com/nomacs/nomacs/#get-the-source) for Windows, macOS, Debian/Ubuntu, Arch, RedHat/CentOS/Fedora, FreeBSD, Haiku

- [AUR](https://aur.archlinux.org/packages/nomacs)
- [Fedora](https://packages.fedoraproject.org/pkgs/nomacs/nomacs/index.html)
- [openSUSE](https://software.opensuse.org/package/nomacs)
- [Debian](https://packages.debian.org/search?searchon=names&keywords=nomacs)
# Latest Beta Release

Translations can be installed from the package `nomacs-l10n`.
- [GitHub Release Page](https://github.com/nomacs/nomacs/releases)
- [Linux FlatPak](https://flathub.org/apps/details/org.nomacs.ImageLounge) (Usually beta release)

- [Ubuntu](https://packages.ubuntu.com/search?keywords=nomacs&searchon=names)
## Third-Party Linux/Unix Packages

Translations can be installed from the package `nomacs-l10n`.
nomacs is available on practically everything by this point, but beware of old versions and bleeding-edge beta releases. If you must have a full-featured stable release, we recommend the official AppImage or FlatPak as beta releases will be testing new features.

@leejuyuu leejuyuu Aug 29, 2026

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

nomacs is available on practically everything by this point

I would avoid using this kind of statement.

but beware of old versions and bleeding-edge beta releases. If you must have a full-featured stable release, we recommend the official AppImage or FlatPak as beta releases will be testing new features.

This isn't clear because a new reader would have no clue for what is beta and what is not. I think we need to document our version system. I remember there was a discussion to move away from the odd number and even number scheme at some point, but it seems to no longer be the case.

@scrubbbbs scrubbbbs Aug 29, 2026

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

It seems we have been roughly using the even/odd convention since 3.16 at least which is the oldest version floating around in repos. I don't think the release cadence is frequent enough for SemVer, it might confuse existing users and package maintainers.

How about:

You will most likely find nomacs in your current distribution's package manager. But beware of old versions, sometimes they lag behind by several years. In these cases we recommend the current AppImage or FlatPak.


### Distro agnostic

- [Flatpak](https://flathub.org/apps/details/org.nomacs.ImageLounge)
- [AppImage](https://github.com/nomacs/nomacs/releases/download/3.22.0/nomacs-3.22.0-linux-24.04-x86_64-AppImage.zip)

## MacOS

- [arm64](https://github.com/nomacs/nomacs/releases/download/3.22.0/nomacs-3.22.0-macOS-arm64.zip)
- [x86_64](https://github.com/nomacs/nomacs/releases/download/3.22.0/nomacs-3.22.0-macOS-x86_64.zip)

## FreeBSD

- Update your FreeBSD repository and change directory to `/usr/ports/graphics/nomacs`
(if your repository directory is the default, otherwise change to the particular directory)
- Build and install nomacs by typing:

```shell
make install clean
```

## Build from source

Get the source code from [the latest release tarball](https://github.com/nomacs/nomacs/archive/refs/tags/3.22.0.tar.gz)
or clone from the [Git repository](https://github.com/nomacs/nomacs).

Follow the build instruction in the README.md.
- [Check Available Distributions (pkgs.org)](https://pkgs.org/search/?q=nomacs)
- [PkgForge AppImage Hub](https://docs.pkgforge.dev/) may offer additional architectures.
Comment on lines +46 to +47

@leejuyuu leejuyuu Aug 29, 2026

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I don't think we should replace links to official distro-specific pages with pkgs.org or docs.pkgforge.dev. I can trust official package sources, but I can't say the same with sufficient confidence about these two third-party sites. For that reason, I don't think it is appropriate for us to direct visitors there to download or install software.

Loading