diff --git a/.github/workflows/pages.yml b/.github/workflows/pages.yml new file mode 100644 index 0000000..29a4406 --- /dev/null +++ b/.github/workflows/pages.yml @@ -0,0 +1,49 @@ +name: Pages + +# Publishes the landing page (site/) plus the screenshots and icon from assets/ to GitHub Pages. +on: + push: + branches: [main] + paths: + - "site/**" + - "assets/screenshots/*.png" + - "assets/icon.png" + - ".github/workflows/pages.yml" + workflow_dispatch: + +permissions: + contents: read + +concurrency: + group: pages + cancel-in-progress: false + +jobs: + build: + runs-on: ubuntu-24.04 + steps: + - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1 + with: + persist-credentials: false + - name: Assemble site + run: | + mkdir -p _site/img + cp -r site/. _site/ + cp assets/screenshots/*.png assets/icon.png _site/img/ + - uses: actions/configure-pages@45bfe0192ca1faeb007ade9deae92b16b8254a0d # v6.0.0 + - uses: actions/upload-pages-artifact@fc324d3547104276b827a68afc52ff2a11cc49c9 # v5.0.0 + with: + path: _site + + deploy: + needs: build + runs-on: ubuntu-24.04 + permissions: + pages: write + id-token: write + environment: + name: github-pages + url: ${{ steps.deployment.outputs.page_url }} + steps: + - id: deployment + uses: actions/deploy-pages@368f82528645a54fb793d4d04e342629a3f51346 # v5.0.1 diff --git a/README.md b/README.md index 46245db..428cf8e 100644 --- a/README.md +++ b/README.md @@ -12,7 +12,9 @@ then adds the operating systems and tools you pick, each one downloaded from its and verified against that project's published SHA-256. Runs on **Windows 10/11** and **Linux** (Ubuntu, Debian, Fedora, Linux Mint, Arch and other -mainstream desktops). +mainstream desktops). Website: **[skippynet.github.io/usb-forge](https://skippynet.github.io/usb-forge/)** + +

USB Forge: choose a USB drive, format options, and the list of operating systems and tools

## Download @@ -81,6 +83,10 @@ power-on) and a USB Forge menu lists every ISO on the drive. Pick one and press more later, copy any ISO onto the drive in Explorer or your file manager; it appears in the menu on the next boot. +

Preview of the USB Forge boot menu listing the ISOs on the drive

+ +The image is a preview rendered from the theme files (`assets/screenshots/make-boot-preview.ps1`). + ## Saved downloads Every ISO is kept in a local downloads folder (`%LOCALAPPDATA%\UsbForge\cache` on Windows, diff --git a/assets/screenshots/app-rescue.png b/assets/screenshots/app-rescue.png new file mode 100644 index 0000000..3b4a018 Binary files /dev/null and b/assets/screenshots/app-rescue.png differ diff --git a/assets/screenshots/app.png b/assets/screenshots/app.png new file mode 100644 index 0000000..5a3731b Binary files /dev/null and b/assets/screenshots/app.png differ diff --git a/assets/screenshots/boot-menu.png b/assets/screenshots/boot-menu.png new file mode 100644 index 0000000..9d43ba7 Binary files /dev/null and b/assets/screenshots/boot-menu.png differ diff --git a/site/index.html b/site/index.html new file mode 100644 index 0000000..8c71827 --- /dev/null +++ b/site/index.html @@ -0,0 +1,251 @@ + + + + + +USB Forge: build a verified multi-boot USB drive + + + + + + + + + + +
+ + +
+

One USB stick.
Every tool you need, verified.

+

USB Forge builds a multi-boot USB drive with the latest Linux installers and rescue tools. + Each one is downloaded from its official project and checked against the SHA-256 that project publishes.

+ +

Free and open source (MIT) · Release notes & checksums

+
USB Forge: choose a USB drive, format options, and a list of operating systems and tools to add
+
+ +
+

Three steps, no ISO hunting

+

No more visiting ten websites, guessing which version is current and skipping the checksum check.

+
+

Pick a USB drive

Only USB disks are listed. The disk your system runs from is always hidden.

+

Tick what you want

Installers, rescue and backup tools. USB Forge looks up the latest release of each.

+

Build

Everything is downloaded and verified first. Only then is the drive formatted and filled.

+
+
+ +
+

Built so you can trust what boots

+

A rescue stick is only useful if what's on it is genuine and the right disk got erased.

+
+

✔Every ISO verified

+

Each download is checked against the SHA-256 published by its own project, then hashed again after it's copied to the drive.

+

↻Always the latest

+

USB Forge asks each project for its current release, so your stick is never stale. Rebuild it any time.

+

⛨Hard to wipe the wrong disk

+

System and internal disks are hidden, the target is re-checked right before formatting, and you type ERASE to confirm.

+

✎Signed updates

+

The app updates itself only when a release's Ed25519 signature matches the key compiled into it.

+

⇣Saved downloads

+

ISOs are cached and re-verified before reuse, and interrupted downloads resume. Refreshing a stick only fetches what changed.

+

⌂Least privilege on Linux

+

Runs as your normal user and asks for your password (polkit) only for the format step.

+
+
+ +
+

What goes on the stick

+

Every item comes from its official project, pinned to a checksum that project publishes. + Want something else? Suggest it.

+
+ + + + + + + + + + + + + + +
SoftwareChecksum source
Ubuntu Desktop & Server LTS or latestreleases.ubuntu.com SHA256SUMS
Fedora Workstationfedoraproject.org releases.json
Linux Mint Cinnamonkernel.org mirror sha256sum.txt
Debian netinstcdimage.debian.org SHA256SUMS
Hiren's BootCD PE rescuehirensbootcd.org download page
SystemRescue rescuesystem-rescue.org .sha256
Rescuezilla backupGitHub release SHA256SUM
Clonezilla Live backupclonezilla.org CHECKSUMS.TXT
GParted Live partitioninggparted.org CHECKSUMS.TXT
Memtest86+ diagnosticsmemtest.org sha256sum.txt
+
+
+ +
+
+
+

A boot menu that's yours

+

Boot any PC from the stick (usually F12, F11, F9 or Esc at power-on) and pick from every + ISO on the drive. Works on UEFI and legacy BIOS.

+

Need something extra? Copy any ISO onto the drive in your file manager. It shows up in the menu + next time. The rest of the drive still works for ordinary files.

+
+ Preview of the USB Forge boot menu listing ISO files +
+
+ +
+

Get started

+
+
+

Windows 10/11

+

Run usb-forge-windows-x86_64.exe and click Restart as administrator when you're + ready to format. If SmartScreen says "Windows protected your PC", choose More info → Run anyway.

+
+
+

Linux

+
chmod +x usb-forge-linux-x86_64
+./usb-forge-linux-x86_64
+

Works on Ubuntu, Debian, Fedora, Linux Mint, Arch and other mainstream desktops + (needs udisks2 and polkit, installed by default).

+
+
+
+ +
+

Questions

+
Is it really free? +

Yes. USB Forge is MIT-licensed, has no ads and sends no telemetry. It only contacts the catalog projects' sites and official mirrors, and GitHub to check for updates.

+
Does it work with Secure Boot? +

The app tells you when Secure Boot is on. Some tools only start with it turned off; the + vendor guide shows how for common PCs.

+
My USB drive isn't listed. +

Only USB disks the system isn't using are shown. Run usb-forge --list-disks to see every disk and why it was hidden.

+
How do I check a download myself? +

Each release lists SHA-256 checksums in SHA256SUMS.txt and Ed25519 signatures next to the binaries. See + SECURITY.md.

+
+ + +
+ + +