Speed up downloads by combining multiple network connections in parallel
TypeScript bandwidth-aggregationcross-platformdesktop-appdownloaderdownloadmanagerlinuxmacosmulticonnectionparallel-downloadswindows
Ship a .tar.gz for Linux alongside the AppImage, .deb and .rpm (#140)
Arpit Khandelwal1a86b10d1adb
diff --git a/.github/workflows/release.yml b/.github/workflows/release.ymlindex 7dcd9d3..4130c6a 100644--- a/.github/workflows/release.yml+++ b/.github/workflows/release.yml@@ -95,6 +95,7 @@ jobs:dist/*.AppImagedist/*.debdist/*.rpm+ dist/*.tar.gzdist/*.ymldist/*.blockmapif-no-files-found: errordiff --git a/CONTRIBUTING.md b/CONTRIBUTING.mdindex e452398..c4c545b 100644--- a/CONTRIBUTING.md+++ b/CONTRIBUTING.md@@ -19,7 +19,7 @@ Run packaging commands on the corresponding operating system. Packages are writt- **macOS**: `npm run build:mac` creates Intel and Apple silicon `.dmg` and `.zip` packages. Unpacked apps are in `dist/mac/Plexo.app` and `dist/mac-arm64/Plexo.app`.- **Windows**: `npm run build:win` creates one installer for x64 and ARM64. `npm run build:unpack` creates an unpacked app for the current architecture; run `dist/win-unpacked/plexo.exe`.-- **Linux**: `npm run build:linux` creates AppImage, `.deb` and `.rpm` packages for x86_64 and ARM64. RPM packaging requires `rpmbuild`; the release workflow installs it through the `rpm` package.+- **Linux**: `npm run build:linux` creates AppImage, `.deb`, `.rpm` and `.tar.gz` packages for x86_64 and ARM64. RPM packaging requires `rpmbuild`; the release workflow installs it through the `rpm` package.Local builds are unsigned unless signing credentials are configured.@@ -80,7 +80,7 @@ Tests build the app first; set `PLEXO_E2E_SKIP_BUILD=1` when `out/` is already f## Releasing-A release ships Plexo for macOS (Apple silicon and Intel `.dmg`), Windows (one installer for x64 and ARM64) and Linux (AppImage, `.deb` and `.rpm`, x86_64 and ARM64). The download page (`docs/`, served by GitHub Pages) reads them from the latest GitHub Release and labels each one from its file name (`docs/downloads.js`), so keep the naming in `electron-builder.yml` intact.+A release ships Plexo for macOS (Apple silicon and Intel `.dmg`), Windows (one installer for x64 and ARM64) and Linux (AppImage, `.deb`, `.rpm` and `.tar.gz`, x86_64 and ARM64). The download page (`docs/`, served by GitHub Pages) reads them from the latest GitHub Release and labels each one from its file name (`docs/downloads.js`), so keep the naming in `electron-builder.yml` intact.First bump the version and add its entry at the top of `docs/changelog.js`, in one PR. The entry becomes the release notes, and a tag without one stops before building.diff --git a/README.md b/README.mdindex 81c3b62..3e7e2a3 100644--- a/README.md+++ b/README.md@@ -178,7 +178,7 @@ npm run dev| `npm run build:mac` | Creates macOS packages in `dist/` || `npm run build:win` | Creates the Windows installer in `dist/` || `npm run build:unpack` | Creates an unpacked app for the current platform in `dist/` |-| `npm run build:linux` | Creates AppImage, `.deb` and `.rpm` packages in `dist/` |+| `npm run build:linux` | Creates AppImage, `.deb`, `.rpm` and `.tar.gz` in `dist/` || `npm run build:extension` | Builds the Chrome and Firefox extensions in `extension/dist/` |Run platform packaging commands on the corresponding operating system. Local builds are unsigned unless signing credentials are configured. [CONTRIBUTING.md](CONTRIBUTING.md) covers packaging requirements, extension setup and testing.diff --git a/docs/downloads.js b/docs/downloads.jsindex 24441bb..46a9e44 100644--- a/docs/downloads.js+++ b/docs/downloads.js@@ -36,6 +36,7 @@'AppImage: `chmod +x plexo-*.AppImage`, then run it. Recent Ubuntu needs FUSE 2 first: `sudo apt install libfuse2t64` (older releases call it `libfuse2`) — or use the .deb, which needs nothing extra.','.deb: `sudo apt install ./plexo_*.deb`.','.rpm (Fedora / RHEL): `sudo dnf install ./plexo-*.rpm`.',+ '.tar.gz (Arch, or anywhere without FUSE): `tar xzf plexo-*.tar.gz`, then run `./plexo` inside the extracted folder.','Don’t open the AppImage with Disks (it isn’t a disk image — an “image is smaller than the target device” message means it was opened there). Make it executable and run it as above.','Using more than one network needs Linux kernel 5.7 or newer (any current distro); on older kernels Plexo can only use the default network.']@@ -91,6 +92,16 @@arch === 'arm64' ? 5 : 2)}+ if (/\.tar\.gz$/.test(n)) {+ return mk(+ 'linux',+ arch,+ 'tarball',+ 'Archive' + archSuffix(arch),+ '.tar.gz · extract and run, no FUSE',+ arch === 'arm64' ? 7 : 6+ )+ }return null}diff --git a/docs/landing.js b/docs/landing.jsindex ac20b9a..a2f754e 100644--- a/docs/landing.js+++ b/docs/landing.js@@ -96,6 +96,10 @@],['**Debian / Ubuntu:** install the .deb with apt.', 'sudo apt install ./plexo_*.deb'],['**Fedora / RHEL:** install the .rpm with dnf.', 'sudo dnf install ./plexo-*.rpm'],+ [+ '**Archive (.tar.gz):** extract it and run plexo from the extracted folder — no FUSE needed.',+ 'tar xzf plexo-*.tar.gz'+ ],['Using more than one network requires **Linux kernel 5.7 or newer**.']],fix: [@@ -191,7 +195,8 @@exe: 'Installer (.exe)',appimage: 'AppImage',deb: 'Debian / Ubuntu (.deb)',- rpm: 'Fedora / RHEL (.rpm)'+ rpm: 'Fedora / RHEL (.rpm)',+ tarball: 'Archive (.tar.gz)'}[kind] || kind)}diff --git a/e2e/releaseNotes.spec.ts b/e2e/releaseNotes.spec.tsindex 57a81a1..fbd166c 100644--- a/e2e/releaseNotes.spec.ts+++ b/e2e/releaseNotes.spec.ts@@ -11,6 +11,8 @@ const builds = (version: string): string[] => [`plexo-${version}-x86_64.AppImage`,`plexo-${version}.aarch64.rpm`,`plexo-${version}.x86_64.rpm`,+ `plexo-${version}-arm64.tar.gz`,+ `plexo-${version}-x64.tar.gz`,`plexo_${version}_amd64.deb`,`plexo_${version}_arm64.deb`]diff --git a/electron-builder.yml b/electron-builder.ymlindex 95f3cde..bce5ebd 100644--- a/electron-builder.yml+++ b/electron-builder.yml@@ -80,12 +80,24 @@ linux:arch: [x64, arm64]- target: rpmarch: [x64, arm64]+ # Plain archive for distros without FUSE or a native package (AUR packagers, NixOS, etc.):+ # extract and run ./plexo. Doesn't update itself, like the .deb and .rpm.+ - target: tar.gz+ arch: [x64, arm64]+ # Names the .tar.gz, which has no options of its own. Without it the x64 archive would carry no+ # architecture, and docs/downloads.js would read it as one file for every machine. The deb and+ # rpm sections below keep their usual names, since they'd otherwise inherit this one.+ artifactName: ${name}-${version}-${arch}.${ext}maintainer: electronjs.orgcategory: Utility# Offered for magnet links and .torrent files ("Open with"), not made their default.mimeTypes: [x-scheme-handler/magnet, application/x-bittorrent, x-scheme-handler/plexo]appImage:artifactName: ${name}-${version}-${arch}.${ext}+deb:+ artifactName: ${name}_${version}_${arch}.${ext}+rpm:+ artifactName: ${name}-${version}.${arch}.${ext}npmRebuild: false# Where the app looks for updates. Builds never publish themselves (--publish never): the release# workflow uploads them, with the latest*.yml files the updater reads.diff --git a/scripts/release-notes.mjs b/scripts/release-notes.mjsindex a0303aa..35fad2d 100644--- a/scripts/release-notes.mjs+++ b/scripts/release-notes.mjs@@ -46,7 +46,7 @@ if (arg === '--changelog') {const version = tag.slice(1)// RPM names use a dot before the architecture; other builds use a hyphen or underscore.const artifactName =- /^plexo[-_](.+)(?:[-_](?:setup|x64|x86_64|amd64|arm64)\.[^.]+|\.(?:x86_64|aarch64)\.rpm)$/+ /^plexo[-_](.+)(?:[-_](?:setup|x64|x86_64|amd64|arm64)\.(?:tar\.gz|[^.]+)|\.(?:x86_64|aarch64)\.rpm)$/const dist = fileURLToPath(new URL('../dist/', import.meta.url))const files = readdirSync(dist).filter((name) => name.match(artifactName)?.[1] === version && downloads.describe(name))