@@ -2,12 +2,48 @@

 Print [Linux][] [distro][] [image][] [URL][]s.

+Note that the latest versions are hard coded, which means they will need to be

+manually updated, which means they may be out of date.

+

 [`distro-url`]: https://git.rcrnstn.net/rcrnstn/distro-url

 [Linux]: https://en.wikipedia.org/wiki/Linux

 [distro]: https://en.wikipedia.org/wiki/Linux_distribution

 [image]: https://en.wikipedia.org/wiki/Optical_disc_image

 [URL]: https://en.wikipedia.org/wiki/URL

+## Usage

+

+```

+distro-url [<distro> [<variant> [<arch> [<codename> [<version> [<mirror>]]]]]]

+```

+

+-   `<distro>`: The [distro][] to print the [URL][] for.

+-   `<variant>`, `<arch>`, `<codename>`, `<version>`: Optional parameters to

+    select a different [image][] than the default.

+-   `<mirror>`: Optional override of the default [mirror][].

+

+[mirror]: https://en.wikipedia.org/wiki/Mirror_site

+

+## Dependencies

+

+-   [POSIX][] [shell][].

+

+[POSIX]: https://en.wikipedia.org/wiki/POSIX

+[shell]: https://en.wikipedia.org/wiki/Unix_shell

+

+## Examples

+

+```sh

+$ distro-url debian

+https://cdimage.debian.org/debian-cd/13.5.0-live/amd64/iso-hybrid/debian-live-13.5.0-amd64-gnome.iso

+

+$ distro-url debian netinst

+https://cdimage.debian.org/debian-cd/13.5.0/amd64/iso-cd/debian-13.5.0-amd64-netinst.iso

+

+$ distro-url debian inst arm64 unknown 99.0.0

+https://cdimage.debian.org/debian-cd/99.0.0/arm64/iso-dvd/debian-99.0.0-arm64-DVD-1.iso

+```

+

 ## License

 Licensed under the [ISC License][] unless otherwise noted, see the

new file mode 100755

@@ -0,0 +1,121 @@

+#!/bin/sh

+set -euC

+

+# usage: distro-url [<distro> [<variant> [<arch> [<codename> [<version> [<mirror>]]]]]]

+

+main()

+{

+  guess "$@"

+}

+

+guess()

+(

+  distro="${1:-}"

+  variant="${2:-}"

+  arch="${3:-}"

+  codename="${4:-}"

+  version="${5:-}"

+  lower() { printf '%s\n' "$1" | tr 'A-Z' 'a-z'; }

+  upper() { printf '%s\n' "$1" | tr 'a-z' 'A-Z'; }

+  case "$distro/$variant" in

+    *raspi*) : ${arch:="arm64"}; ext='img.xz'; ;;

+    *)       : ${arch:="amd64"}; ext='iso';    ;;

+  esac

+  case "$distro" in

+    debian)

+      : ${variant:="gnome"}

+      : ${codename:="trixie"}

+      : ${version:="13.5.0"}

+      case "$variant" in

+        raspi)

+          # : ${mirror:="https://get.debian.org/images/cloud"}

+          # : ${mirror:="https://cdimage.debian.org/images/cloud"}

+          : ${mirror:="https://cloud.debian.org/images/cloud"}

+          major="${version%%.*}"

+          ext='tar.xz'

+          # dir="$codename/latest"

+          # echo "$mirror/$dir/$distro-$major-$variant-$arch.$ext"

+          dir="$codename/daily/latest"

+          echo "$mirror/$dir/$distro-$major-$variant-$arch-daily.$ext"

+          ;;

+        *)

+          # : ${mirror:="https://get.debian.org/images/release"}

+          # : ${mirror:="https://cdimage.debian.org/images/release"}

+          # : ${mirror:="https://cloud.debian.org/images/release"}

+          : ${mirror:="https://cdimage.debian.org/debian-cd"}

+          case "$variant" in

+            netinst) media='iso-cd';     suffix='';                       ;;

+            inst)    media='iso-dvd';    suffix='';      variant='DVD-1'; ;;

+            *)       media='iso-hybrid'; suffix='-live';                  ;;

+          esac

+          dir="$version$suffix/$arch/$media"

+          echo "$mirror/$dir/$distro$suffix-$version-$arch-$variant.$ext"

+          ;;

+      esac

+      ;;

+    raspios)

+      : ${variant:="default"}

+      : ${codename:="trixie"}

+      : ${version:="2026-04-21"}

+      : ${mirror:="https://downloads.raspberrypi.com"}

+      case "$variant" in

+        default) name="${distro}_${arch}";            suffix='';          ;;

+        *)       name="${distro}_${variant}_${arch}"; suffix="-$variant"; ;;

+      esac

+      dir="$name/images/$name-$version"

+      echo "$mirror/$dir/$version-$distro-$codename-$arch$suffix.$ext"

+      ;;

+    ubuntu|\

+    edubuntu|\

+    kubuntu|lubuntu|xubuntu|\

+    ubuntucinnamon|ubuntu-mate|ubuntu-budgie|ubuntu-unity|\

+    ubuntustudio|ubuntukylin)

+      : ${variant:="desktop"}

+      : ${codename:="resolute"}

+      : ${version:="26.04"}

+      if [ "$distro/$arch" = 'ubuntu/amd64' ]

+      then : ${mirror:="https://releases.ubuntu.com"};                 dir="$codename";

+      else : ${mirror:="https://cdimage.ubuntu.com/$distro/releases"}; dir="$codename/release";

+      fi

+      case "$variant" in

+        server)  suffix='-live'; ;;

+        *-raspi) suffix='-preinstalled'; variant="${variant%%-raspi}"; arch="$arch+raspi"; ;;

+        *) suffix=''; ;;

+      esac

+      echo "$mirror/$dir/$distro-$version$suffix-$variant-$arch.$ext"

+      ;;

+    linuxmint)

+      : ${variant:="cinnamon"}

+      : ${codename:="zena"}

+      : ${version:="22.3"}

+      : ${mirror:="https://pub.linuxmint.io"}

+      case "$arch" in

+        amd64) arch='64bit' ;;

+      esac

+      dir="stable/$version"

+      echo "$mirror/$dir/$distro-$version-$variant-$arch.$ext"

+      ;;

+    opensuse)

+      : ${variant:="gnome"}

+      : ${codename:="tumbleweed"}

+      : ${version:="-"}

+      : ${mirror:="https://download.opensuse.org"}

+      distro='openSUSE'

+      case "$codename" in

+        tumbleweed) codename='Tumbleweed' ;;

+      esac

+      case "$variant" in

+        inst)    suffix='';      variant='DVD';                 ;;

+        netinst) suffix='';      variant='NET';                 ;;

+        *)       suffix='-Live'; variant="$(upper "$variant")"; ;;

+      esac

+      case "$arch" in

+        amd64) arch='x86_64'

+      esac

+      dir="$codename/iso"; dir="$(lower "$dir")";

+      echo "$mirror/$dir/$distro-$codename-$variant$suffix-$arch-Current.$ext"

+      ;;

+  esac

+)

+

+main "$@"