dl-fedora: Fedora image download tool

This is a package candidate release! Here you can preview how this package release will appear once published to the main package index (which can be accomplished via the 'maintain' link below). Please note that once a package has been published to the main package index it cannot be undone! Please consult the package uploading documentation for more information.

[maintain] [Publish]

Warnings:

These packages miss upper bounds: - ansi-wl-pprint - bytestring - directory - extra - filepath - http-client - http-client-tls - http-directory - http-types - optparse-applicative - regex-posix - semigroups - simple-cmd - simple-cmd-args - text - time - unix - xdg-userdirs Please add them, using `cabal gen-bounds` for suggestions. For more information see: https://pvp.haskell.org/

Tool to download Fedora and Centos Stream iso and image files.

[Skip to Readme]

Properties

Versions	0.5, 0.6, 0.7, 0.7.1, 0.7.2, 0.7.3, 0.7.4, 0.7.5, 0.7.6, 0.7.7, 0.8, 0.9, 0.9.1, 0.9.2, 0.9.3, 0.9.4, 0.9.5, 0.9.5.1, 0.9.6, 0.9.6, 1.0, 1.1, 1.2, 1.2.1
Change log	CHANGELOG.md
Dependencies	ansi-wl-pprint, base (<5), bytestring, directory (>=1.2.5), extra, filepath, http-client, http-client-tls, http-directory (>=0.1.10), http-types, optparse-applicative, regex-posix, semigroups, simple-cmd (>=0.2.0), simple-cmd-args (>=0.1.8), text, time, unix, xdg-userdirs [details]
License	GPL-3.0-only
Copyright	2019-2023 Jens Petersen
Author	Jens Petersen
Maintainer	juhpetersen@gmail.com
Category	Utility
Home page	https://github.com/juhp/dl-fedora
Bug tracker	https://github.com/juhp/dl-fedora/issues
Source repo	head: git clone https://github.com/juhp/dl-fedora.git
Uploaded	by JensPetersen at 2023-08-18T13:46:48Z

Downloads

dl-fedora-0.9.6.tar.gz [browse] (Cabal source package)
Package description (as included in the package)

Maintainer's Corner

Package maintainers

JensPetersen

For package maintainers and hackage trustees

edit package information

Readme for dl-fedora-0.9.6

[back to package description]

dl-fedora

A tool for downloading Fedora, ELN, and Centos Stream images. By default it targets the Workstation edition of Fedora.

Usage examples:

dl-fedora rawhide : downloads the latest Fedora Rawhide Workstation Live iso

dl-fedora 39 silverblue : downloads the Fedora Silverblue iso

dl-fedora respin kde : downloads the latest KDE Live respin

dl-fedora 38 server --arch aarch64 : will download the Server iso for armv8

dl-fedora --run 39 : will download Fedora Workstation and boot the Live image with qemu-kvm.

dl-fedora --local rawhide : shows the current locally available image (as well as the latest one). With --dryrun it doesn't check for newest iso.

dl-fedora c9s : downloads a Centos Stream 9 net installer.

By default dl-fedora downloads to ~/Downloads/ (correctly the XDG user "DOWNLOADS" directory), but if you create an iso subdirectory there (~/Downloads/iso/) it will use that directory instead.

dl-fedora downloads the latest image redirected from download.fedoraproject.org by default, after checking for the latest image at dl.fedoraproject.org. However if the mirror is not synced yet it will download from dl.fedoraproject.org instead. You can use --no-dl to avoid checking and downloading from the main dl.fedoraproject.org mirror (in this case a nightly image might not be the very latest).

If the image is already found to be downloaded it will not be re-downloaded of course. Curl is used to do the downloading: partial downloads will continue.

A symlink to the latest iso is also created: eg for rawhide it might be "Fedora-Workstation-Live-x86_64-Rawhide-latest.iso".

It also tries to check the iso checksum and its gpg signature.

Usage

$ dl-fedora --version
0.9.6
$ dl-fedora --help
Fedora iso downloader

Usage: dl-fedora [--version] [-g|--gpg-keys]
                 [(-C|--no-checksum) | (-c|--checksum)] [-n|--dry-run] [--debug]
                 [-T|--no-http-timeout] [-l|--local] [-r|--run] [-R|--replace]
                 [(-d|--dl) | (-D|--no-dl) | (-k|--koji) | (-m|--mirror URL)]
                 [--cs-devel | --cs-test] [-a|--arch ARCH] RELEASE [EDITION]

  Tool for downloading Fedora iso file images.
  RELEASE = release number, respin, rawhide, test (Beta), stage (RC), eln, c8s, c9s
  EDITION = {cloud,container,everything,server,workstation,silverblue,kinoite,
             sericea,budgie,cinnamon,i3,kde,lxde,lxqt,mate,soas,sway,
             xfce} [default: workstation]

  See <https://fedoraproject.org/wiki/Infrastructure/MirrorManager>
  and also <https://fedoramagazine.org/verify-fedora-iso-file>.

Available options:
  -h,--help                Show this help text
  --version                Show version
  -g,--gpg-keys            Import Fedora GPG keys for verifying checksum file
  -C,--no-checksum         Do not check checksum
  -c,--checksum            Do checksum even if already downloaded
  -n,--dry-run             Don't actually download anything
  --debug                  Debug output
  -T,--no-http-timeout     Do not timeout for http response
  -l,--local               Show current local image via symlink
  -r,--run                 Boot image in Qemu
  -R,--replace             Delete previous snapshot image after downloading
                           latest one
  -d,--dl                  Use dl.fedoraproject.org (dl.fp.o)
  -D,--no-dl               Do not use dl.fp.o (even if newer)
  -k,--koji                Use koji.fedoraproject.org
  -m,--mirror URL          Mirror url for /pub [default
                           https://download.fedoraproject.org/pub]
  --cs-devel               Use centos-stream development compose
  --cs-test                Use centos-stream test compose (default is
                           production)
  -a,--arch ARCH           Specify arch [default: x86_64]

Contribution

dl-fedora is distributed under the GPL 3 license or later.

Please report issues or pull requests at https://github.com/juhp/dl-fedora.