# electron-packager
> Customize and package your Electron app with OS-specific bundles (.app, .exe, etc.) via JS or CLI
Latest version **17.1.2** (published 2023-08-18) · BSD-2-Clause license · 0 weekly downloads
> **Deprecated.** This package is deprecated.
## Install
```sh
npm install electron-packager
pnpm add electron-packager
yarn add electron-packager
bun add electron-packager
```
Provides the command `electron-packager`.
## Health
**Score 10/100 (F)** — status: deprecated.
Negative: deprecated.
## Facts
| | |
|---|---|
| Version | 17.1.2 |
| Published | 2023-08-18 |
| First published | 2015-04-27 |
| Weekly downloads | 0 |
| License | BSD-2-Clause |
| TypeScript types | bundled |
| Module format | CommonJS |
| Node | >= 14.17.5 |
| Dependencies | 19 |
| Unpacked size | 141.8 KB |
| Known vulnerabilities | 0 (+2 in 1 direct dependencies) |
| Install scripts | no |
| GitHub stars | 302 |
| Author | Mark Lee |
| Maintainers | georgexu99, vertedinde, erickzhao, marshallofsound, malept |
| Keywords | electron, packager, bundler, app |
## Links
- npm: https://www.npmjs.com/package/electron-packager
- Repository: https://github.com/electron/electron-packager
- Issues: https://github.com/electron/electron-packager/issues
- Funding: https://github.com/electron/electron-packager?sponsor=1
- npm.io page: https://npm.io/package/electron-packager
## Dependencies (19)
- [junk](https://npm.io/package/junk.md) ^3.1.0
- [debug](https://npm.io/package/debug.md) ^4.0.1
- [plist](https://npm.io/package/plist.md) ^3.0.0
- [rcedit](https://npm.io/package/rcedit.md) ^3.0.1
- [semver](https://npm.io/package/semver.md) ^7.1.3
- [resolve](https://npm.io/package/resolve.md) ^1.1.6
- [fs-extra](https://npm.io/package/fs-extra.md) ^11.1.0
- [galactus](https://npm.io/package/galactus.md) ^1.0.0
- [filenamify](https://npm.io/package/filenamify.md) ^4.1.0
- [extract-zip](https://npm.io/package/extract-zip.md) ^2.0.0
- [parse-author](https://npm.io/package/parse-author.md) ^2.0.0
- [yargs-parser](https://npm.io/package/yargs-parser.md) ^21.1.1
- [@electron/get](https://npm.io/package/@electron/get.md) ^2.0.0
- [@electron/asar](https://npm.io/package/@electron/asar.md) ^3.2.1
- [get-package-info](https://npm.io/package/get-package-info.md) ^1.0.0
- [@electron/notarize](https://npm.io/package/@electron/notarize.md) ^1.2.3
- [@electron/osx-sign](https://npm.io/package/@electron/osx-sign.md) ^1.0.5
- [@electron/universal](https://npm.io/package/@electron/universal.md) ^1.3.2
- [cross-spawn-windows-exe](https://npm.io/package/cross-spawn-windows-exe.md) ^1.2.0
## Alternatives
- [raw-loader](https://npm.io/package/raw-loader.md) — 4.3M weekly downloads
- [plop](https://npm.io/package/plop.md) — 1.4M weekly downloads
- [webpack-deadcode-plugin](https://npm.io/package/webpack-deadcode-plugin.md) — 80.3K weekly downloads
- [@storybook/preact-vite](https://npm.io/package/@storybook/preact-vite.md) — 54.2K weekly downloads
- [vite-plugin-transform](https://npm.io/package/vite-plugin-transform.md) — 2.4K weekly downloads
## Recent versions
- 17.1.2 (latest) — 2023-08-18
- 17.1.1 — 2022-11-01
- 17.1.0 — 2022-10-31
- 17.0.0 — 2022-10-19
- 16.0.0 — 2022-08-23
- 15.5.2 — 2022-08-23
- 15.5.1 — 2022-04-20
- 15.5.0 — 2022-04-19
- 15.4.0 — 2021-09-10
- 15.3.0 — 2021-07-18
- 15.2.0 — 2020-12-04
- 15.1.0 — 2020-08-21
- 15.0.0 — 2020-06-27
- 14.2.1 — 2020-02-07
- 14.2.0 — 2020-01-13
- … 81 more at https://npm.io/package/electron-packager/versions
## README
# Electron Packager
Package your [Electron](https://electronjs.org) app into OS-specific bundles (`.app`, `.exe`, etc.) via JavaScript or the command line.
[](https://circleci.com/gh/electron/electron-packager/tree/main)
[](https://github.com/electron/electron-packager/actions/workflows/canary.yml)
[](https://codecov.io/gh/electron/electron-packager)
[](https://npm.im/electron-packager)
[](https://discord.com/invite/APGC3k5yaH)
[Supported Platforms](#supported-platforms) |
[Installation](#installation) |
[Usage](#usage) |
[API](https://electron.github.io/electron-packager/main/) |
[Contributing](https://github.com/electron/electron-packager/blob/main/CONTRIBUTING.md) |
[Support](https://github.com/electron/electron-packager/blob/main/SUPPORT.md) |
[Related Apps/Libraries](#related) |
[FAQ](https://github.com/electron/electron-packager/blob/main/docs/faq.md) |
[Release Notes](https://github.com/electron/electron-packager/blob/main/NEWS.md)
----
## About
Electron Packager is a command line tool and Node.js library that bundles Electron-based application
source code with a renamed Electron executable and supporting files into folders ready for distribution.
For creating distributables like installers and Linux packages, consider using either [Electron
Forge](https://github.com/electron/forge) (which uses Electron Packager
internally), or one of the [related Electron tools](#distributable-creators), which utilizes
Electron Packager-created folders as a basis.
Note that packaged Electron applications can be relatively large. A zipped, minimal Electron
application is approximately the same size as the zipped prebuilt binary for a given target
platform, target arch, and [Electron version](https://github.com/electron/electron/releases)
_(files named `electron-v${version}-${platform}-${arch}.zip`)_.
## Supported Platforms
Electron Packager is known to run on the following **host** platforms:
* Windows (32/64 bit)
* macOS (formerly known as OS X)
* Linux (x86/x86_64)
It generates executables/bundles for the following **target** platforms:
* Windows (also known as `win32`, for x86, x86_64, and arm64 architectures)
* macOS (also known as `darwin`) / [Mac App Store](https://electronjs.org/docs/tutorial/mac-app-store-submission-guide/) (also known as `mas`)* (for x86_64, arm64, and universal architectures)
* Linux (for x86, x86_64, armv7l, arm64, and mips64el architectures)
* *Note for macOS / Mac App Store target bundles: the `.app` bundle can only be signed when building on a host macOS platform.*
## Installation
This module requires Node.js 14.17.5 or higher to run.
```sh
npm install --save-dev electron-packager
```
It is **not** recommended to install `electron-packager` globally.
### Building Windows apps from non-Windows platforms
Building an Electron app for the Windows target platform requires editing the `Electron.exe` file.
Currently, Electron Packager uses [`node-rcedit`](https://github.com/electron/node-rcedit) to accomplish
this. A Windows executable is bundled in that Node package and needs to be run in order for this
functionality to work, so on non-Windows host platforms (not including WSL),
[Wine](https://www.winehq.org/) 1.6 or later needs to be installed. On macOS, it is installable
via [Homebrew](https://brew.sh/).
## Usage
### Via JavaScript
JavaScript API usage can be found in the [API documentation](https://electron.github.io/electron-packager/main/modules/electronpackager.html).
### From the command line
Running Electron Packager from the command line has this basic form:
```
npx electron-packager --platform= --arch= [optional flags...]
```
> **Note**:
> `npx` can be substituted for `yarn` or `npm exec` depending on what package manager and
> the version you have installed.
This will:
* Find or download the correct release of Electron
* Use that version of Electron to create an app in `/--` *(this can be customized via an optional flag)*
`--platform` and `--arch` can be omitted, in two cases:
* If you specify `--all` instead, bundles for all valid combinations of target
platforms/architectures will be created.
* Otherwise, a single bundle for the host platform/architecture will be created.
For an overview of the other optional flags, run `electron-packager --help` or see
[usage.txt](https://github.com/electron/electron-packager/blob/main/usage.txt). For
detailed descriptions, see the [API documentation](https://electron.github.io/electron-packager/main/modules/electronpackager.html).
For flags that are structured as objects, you can pass each option as via dot notation as such:
```sh
npx electron-packager --flag.foo="bar"
# will pass in { flag: { foo: "bar"} } as an option to the Electron Packager API
```
If `appname` is omitted, this will use the name specified by "productName" or "name" in the nearest package.json.
**Characters in the Electron app name which are not allowed in all target platforms' filenames
(e.g., `/`), will be replaced by hyphens (`-`).**
You should be able to launch the app on the platform you built for. If not, check your settings and try again.
**Be careful** not to include `node_modules` you don't want into your final app. If you put them in
the `devDependencies` section of `package.json`, by default none of the modules related to those
dependencies will be copied in the app bundles. (This behavior can be turned off with the
`prune: false` API option or `--no-prune` CLI flag.) In addition, folders like `.git` and
`node_modules/.bin` will be ignored by default. You can use `--ignore` to ignore files and folders
via a regular expression (*not* a [glob pattern](https://en.wikipedia.org/wiki/Glob_%28programming%29)).
Examples include `--ignore=\.gitignore` or `--ignore="\.git(ignore|modules)"`.
#### Example
Let's assume that you have made an app based on the [electron-quick-start](https://github.com/electron/electron-quick-start) repository on a macOS host platform with the following file structure:
```
foobar
├── package.json
├── index.html
├── […other files, like the app's LICENSE…]
└── script.js
```
…and that the following is true:
* `electron-packager` is installed locally
* `productName` in `package.json` has been set to `Foo Bar`
* The `electron` module is in the `devDependencies` section of `package.json`, and set to the exact version of `1.4.15`.
* `npm install` for the `Foo Bar` app has been run at least once
When one runs the following command for the first time in the `foobar` directory:
```
npx electron-packager .
```
`electron-packager` will do the following:
* Use the current directory for the `sourcedir`
* Infer the `appname` from the `productName` in `package.json`
* Infer the `appVersion` from the `version` in `package.json`
* Infer the `platform` and `arch` from the host, in this example, `darwin` platform and `x64` arch.
* Download the darwin x64 build of Electron 1.4.15 (and cache the downloads in `~/.electron`)
* Build the macOS `Foo Bar.app`
* Place `Foo Bar.app` in `foobar/Foo Bar-darwin-x64/` (since an `out` directory was not specified, it used the current working directory)
The file structure now looks like:
```
foobar
├── Foo Bar-darwin-x64
│ ├── Foo Bar.app
│ │ └── […Mac app contents…]
│ ├── LICENSE [the Electron license]
│ └── version
├── […other application bundles, like "Foo Bar-win32-x64" (sans quotes)…]
├── package.json
├── index.html
├── […other files, like the app's LICENSE…]
└── script.js
```
The `Foo Bar.app` folder generated can be executed by a system running macOS, which will start the packaged Electron app. This is also true of the Windows x64 build on a system running a new enough version of Windows for a 64-bit system (via `Foo Bar-win32-x64/Foo Bar.exe`), and so on.
## Related
- [Electron Forge](https://github.com/electron/forge) - creates, builds, and distributes modern Electron applications
- [electron-packager-interactive](https://github.com/Urucas/electron-packager-interactive) - an interactive CLI for electron-packager
- [grunt-electron](https://github.com/sindresorhus/grunt-electron) - grunt plugin for electron-packager
### Distributable Creators
* [electron-installer-zip](https://github.com/electron-userland/electron-installer-zip) - creates symlink-compatible ZIP files
Windows:
* [electron-winstaller](https://github.com/electron/windows-installer) - Squirrel.Windows-based installer from the Electron maintainers group
* [electron-windows-store](https://github.com/felixrieseberg/electron-windows-store) - creates an AppX package for the Windows Store
* [electron-wix-msi](https://github.com/felixrieseberg/electron-wix-msi) - creates traditional MSI installers
* [electron-installer-windows](https://github.com/electron-userland/electron-installer-windows) - alternative Squirrel.Windows-based installer
macOS:
* [electron-installer-dmg](https://github.com/electron-userland/electron-installer-dmg) - creates a DMG
Linux:
* [electron-installer-debian](https://github.com/electron-userland/electron-installer-debian) - creates a DEB file
* [electron-installer-redhat](https://github.com/electron-userland/electron-installer-redhat) - creates an RPM
* [electron-installer-flatpak](https://github.com/endlessm/electron-installer-flatpak) - creates a Flatpak file
* [electron-installer-snap](https://github.com/electron-userland/electron-installer-snap) - creates a Snap file
### Plugins
These Node modules utilize Electron Packager API hooks:
- [electron-packager-languages](https://npm.im/electron-packager-languages) - sets the locales
available to Electron when packaged, which is used by the Mac App Store, among other places
- [electron-packager-plugin-non-proprietary-codecs-ffmpeg](https://www.npmjs.com/package/electron-packager-plugin-non-proprietary-codecs-ffmpeg) - replaces the normal version of FFmpeg in Electron with a version without proprietary codecs
- [@electron/rebuild](https://github.com/electron/rebuild) - rebuilds native Node.js modules
against the packaged Electron version
---
_Source: https://npm.io/package/electron-packager · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._