1. Application
  2. Download Links from your Website

Application

Download Links from your Website

Configure your application artifacts and link to them from your website

Build Artifacts

ToDesktop supports several application artifacts that you can share with your users. This includes artifacts that you can distribute directly to users, as well as artifacts you can publish to an app store. ToDesktop currently supports the following:

Platform Artifacts
Mac Apple Silicon, DMG, Zip, Universal Installer
Windows App Store, NSIS, NSIS Web, MSI
Linux AppImage, Debian, RPM, Snap Store

You can configure these artifacts in the web app interface, under Settings →Build and Deploy:

Toggle artifacts using the build and deploys interface

When linking to your desktop app, you can use our universal URL. The universal URL will:

  • Detect the operating system and deliver the correct installer:
    • Mac: Universal Mac Installer if enabled, otherwise it will fall back to DMG or ZIP.
    • Windows: NSIS if enabled, otherwise it will fall back to MSI, or AppX
    • Linux: AppImage if enabled, otherwise it will fall back to Debian, RPM, or Snap Store.
  • Always deliver the latest version of your desktop app. So if you publish a new version in the future, you don't need to update the link.

Your universal URL looks like this:

        https://dl.todesktop.com/[[your_app_id]]

      

Once an app has been released, you can access your universal URL from ToDesktop Builder under your platform’s download links:

Copy the download link for your target platform

If you want to use the URL for the Mac/Windows/Linux build, you can directly copy those URLs instead. Platform-specific download links have the following pattern:

  • Windows: https://dl.todesktop.com/[[your_app_id]]/windows
  • Mac: https://dl.todesktop.com/[[your_app_id]]/mac
  • Linux: https://dl.todesktop.com/[[your_app_id]]/linux

As an example, if you want to get the latest Mac build of your desktop app, then your download link should look something like this:

        https://dl.todesktop.com/190911i1k98bqno/mac

      

Moreover, you can specify URLs for specific artifacts that you have built using the following pattern: https://dl.todesktop.com/[[your_app_id]]/[[platform]]/[[artifact_name]]. A concrete URL may look like the following:

        https://dl.todesktop.com/190911i1k98bqno/mac/dmg

      

To pinpoint artifacts for a particular version you have built, include /versions/[[version]]/ after specifying the application ID. For example, I can retrieve the 1.0.0 version of my mac application if I specify:

        https://dl.todesktop.com/190911i1k98bqno/versions/1.0.0/mac

      

You can find a list of the different patterns below:

Description Pattern
Deliver the correct installer without specifying the platform https://dl.todesktop.com/[[your_app_id]]
Deliver the correct installer for a target platform https://dl.todesktop.com/[[your_app_id]]/[[platform]]
Deliver the correct installer for a target platform and artifact https://dl.todesktop.com/[[your_app_id]]/[[platform]]/[[artifact]]
Deliver the correct installer for a target version https://dl.todesktop.com/[[your_app_id]]/versions/[[version]]
Deliver the correct installer for a target version and platform https://dl.todesktop.com/[[your_app_id]]/versions/[[version]]/[[platform]]
Deliver the correct installer for a target version, platform, and artifact https://dl.todesktop.com/[[your_app_id]]/versions/[[version]]/[[platform]]/[[artifact]]

Sharing on Website

To add a simple download link to your website, use the following HTML:

        <!-- Detect user's operating system -->
<a href="https://dl.todesktop.com/190911i1k98bqno" download> Download our Desktop App </a>

<!-- Mac -->
<a href="https://dl.todesktop.com/190911i1k98bqno/mac" download> Download our Mac App </a>

<!-- Windows -->
<a href="https://dl.todesktop.com/190911i1k98bqno/windows" download> Download our Windows App </a>

<!-- Linux -->
<a href="https://dl.todesktop.com/190911i1k98bqno/linux" download> Download our Linux App </a>