* Many packager improvements; Windows signing! * Windows signing works now! (Certs are on an external USB stick that must be plugged into the build machine during build. We can't do the same for OS X because certs need to exist in the login Keychain to be found.) Fixes #219 * Signing is now optional (so OS X and Windows contributors can run `npm run package` without errors) * zip, dmg, and deb arguments are now passed in as e.g. "--package=dmg" * Print a huge warning when signing is disabled so we're less likely to ship unsigned binaries to users. * Make console.logs during packaging consistent and parallel ("creating..." followed by "created.") * More aggressive signing warnings * Warn when building OS X app on non-OS X platform (because signing will never work on non-OS X platforms) * Warn when building Windows app on non-Windows platform (because signing doesn't work yet on non-Windows platforms)
83 lines
2.1 KiB
Markdown
83 lines
2.1 KiB
Markdown
<h1 align="center">
|
|
<br>
|
|
<a href="https://webtorrent.io"><img src="https://webtorrent.io/img/WebTorrent.png" alt="WebTorrent" width="200"></a>
|
|
<br>
|
|
WebTorrent Desktop
|
|
<br>
|
|
<br>
|
|
</h1>
|
|
|
|
<h4 align="center">The streaming torrent client. For OS X, Windows, and Linux.</h4>
|
|
|
|
<p align="center">
|
|
<a href="https://gitter.im/feross/webtorrent"><img src="https://img.shields.io/badge/gitter-join%20chat%20%E2%86%92-brightgreen.svg" alt="Gitter"></a>
|
|
<a href="https://travis-ci.org/feross/webtorrent-desktop"><img src="https://img.shields.io/travis/feross/webtorrent-desktop/master.svg" alt="Travis"></a>
|
|
<a href="https://github.com/feross/webtorrent-desktop/releases"><img src="https://img.shields.io/github/release/feross/webtorrent-desktop.svg" alt="Release"></a>
|
|
</p>
|
|
|
|
## Install
|
|
|
|
**WebTorrent Desktop** is still under very active development. You can download the latest version from the [releases](https://github.com/feross/webtorrent-desktop/releases) page.
|
|
|
|
## Screenshot
|
|
|
|
<p align="center">
|
|
<img src="https://webtorrent.io/img/screenshot-main.png" width="562" height="630" alt="screenshot" align="center">
|
|
</p>
|
|
|
|
## How to Contribute
|
|
|
|
### Install dependencies
|
|
|
|
```
|
|
$ npm install
|
|
```
|
|
|
|
### Run app
|
|
|
|
```
|
|
$ npm start
|
|
```
|
|
|
|
### Package app
|
|
|
|
Builds app binaries for OS X, Linux, and Windows.
|
|
|
|
```
|
|
$ npm run package
|
|
```
|
|
|
|
To build for one platform:
|
|
|
|
```
|
|
$ npm run package -- [platform]
|
|
```
|
|
|
|
Where `[platform]` is `darwin`, `linux`, `win32`, or `all` (default).
|
|
|
|
The following optional arguments are available:
|
|
|
|
- `--package=[type]` - Package only one output file. `type` is `deb`, `dmg`, `zip`, or `all` (default)
|
|
- `--sign` - Sign the application (OS X, Windows)
|
|
|
|
#### Windows build notes
|
|
|
|
To package the Windows app from non-Windows platforms, [Wine](https://www.winehq.org/) needs
|
|
to be installed.
|
|
|
|
On OS X, first install [XQuartz](http://www.xquartz.org/), then run:
|
|
|
|
```
|
|
brew install wine
|
|
```
|
|
|
|
(Requires the [Homebrew](http://brew.sh/) package manager.)
|
|
|
|
### Code Style
|
|
|
|
[](https://github.com/feross/standard)
|
|
|
|
## License
|
|
|
|
MIT. Copyright (c) [Feross Aboukhadijeh](http://feross.org).
|