Skip to content
aayusbhat26Public

About

A local-first Windows download manager, built as an alternative to IDM.

Resources

Stars

1 star

Watchers

0 watching

Forks

Repository files navigation

Cascade

A careful, original Windows download manager with segmented transfers, resume, queueing, a scheduler, clipboard capture, and a Chromium browser bridge. Cascade is not a reverse-engineered clone of IDM and contains none of its code or assets.

Current version: 1.2.2 · Browser bridge: 1.2.0

Install (Windows)

Download the latest setup installer from GitHub Releases:

  • Cascade-<version>-setup-x64.exe for 64-bit Windows
  • Cascade-<version>-setup-ia32.exe for 32-bit Windows

The installer is per-user, creates a CASCADE Start Menu shortcut, and ships an uninstaller. Portable builds are not published.

The installers are not code-signed yet, so Windows SmartScreen may show a warning. Sign the setup executable with a Windows code-signing certificate before a public release if you want a warning-free install.

Supported systems: Windows 7 SP1 through 11. Windows 7 support relies on the end-of-life Electron 22 runtime (Chromium 108), which no longer receives security updates. Windows 10/11 is recommended.

Browser companion

Automatic browser takeover is provided by the separate Cascade Bridge extension. Chrome and Edge do not allow a desktop installer to silently install an extension, so it is installed once from a browser store (or unpacked during development). The app cannot bypass that browser security boundary.

The store listings are not live yet. Until they are, the extension has to be loaded unpacked from the extension repository; see its README. Publishing the extension to the Chrome Web Store and Edge Add-ons is required for a normal consumer install.

Features

  • HTTP/HTTPS downloads with up to 32 parallel byte-range connections
  • Pause/resume with ETag and Last-Modified validation, retries, redirects, single-stream fallback, collision-safe filenames, and atomic completion
  • Queue with concurrency, global throughput display, and a scheduled download window
  • Browser download takeover with pre-click link interception, so direct links do not open the browser's Save As dialog
  • Page-media detection with an in-page Cascade chip and toolbar media list
  • Clipboard URL intake, batch links, referer/cookie support
  • Archive with open, reveal, remove, and delete actions
  • Local-only design: no telemetry, accounts, or remote services

Build from source

Requirements: Node.js 20+ and Windows.

git clone --recurse-submodules https://github.com/aayusbhat26/cascade.git
cd cascade
npm ci
npm run dev

The extension directory is a Git submodule. If you cloned without submodules:

git submodule update --init --recursive

Build the app and an NSIS installer:

npm run build
npm run dist        # x64 setup
npm run dist:ia32   # ia32 setup

Only the NSIS setup is published. Portable targets are intentionally not part of the project.

Release workflow

Pushing a tag such as v1.2.2 runs .github/workflows/release.yml, tests the project, builds the x64 and ia32 NSIS installers on Windows, and attaches only the setup executables to the GitHub Release. The workflow checks out the browser-extension submodule automatically.

To sign release builds, add a base64 Windows code-signing certificate as the repository secret CSC_LINK and its password as CSC_KEY_PASSWORD, then add those secrets to the workflow's build step. Without them, the installers are unsigned.

Architecture

  • Electron 22 main process, sandboxed preload, React renderer
  • Node download engine with per-range workers and persisted resume state
  • Local-only WebSocket bridge bound to 127.0.0.1
  • MV3 browser extension in a separate repository, pinned as a submodule

App state lives in %APPDATA%\Cascade. Uninstalling the app leaves downloads, settings, the pairing token, and the browser-extension copy in that folder.

Limitations

  • Direct HTTP/HTTPS only: no FTP, torrents, HLS/DASH merging, DRM, or proxy integration
  • Files with server-side encryption/protection cannot be reconstructed
  • Page-initiated save pickers (File System Access) cannot be intercepted by an extension
  • No automatic updates yet; install a newer setup manually
  • Unsigned builds show SmartScreen warnings

Cascade is an independent project and is not affiliated with Internet Download Manager. Licensed under MIT.

About

A local-first Windows download manager, built as an alternative to IDM.

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages