v1.5.79

Fix start script

.dockerignore

@@ -1 +1,2 @@
 *
+!requirements.txt

.editorconfig

@@ -9,5 +9,14 @@ charset = utf-8
 trim_trailing_whitespace = true
 insert_final_newline = true
 
+[*.md]
+trim_trailing_whitespace = false
+
 [Makefile]
 indent_style = tab
+
+[*.ts]
+indent_style = tab
+
+[*.tsx]
+indent_style = tab

.eslintrc.yml

@@ -6,68 +6,33 @@ env:
   mocha: true
 plugins:
   - lodash
-extends: 'eslint:recommended'
+  - jsdoc
+  - node
+  - react
+extends: 'standard'
+parserOptions:
+  sourceType: 'script'
+  ecmaFeatures:
+    jsx: true
+settings:
+  jsdoc:
+    additionalTagNames:
+      customTags:
+        - fulfil
 rules:
 
   # Possible Errors
 
-  no-cond-assign:
-    - error
   no-console:
     - off
-  no-constant-condition:
-    - error
-  no-control-regex:
-    - error
-  no-debugger:
-    - error
-  no-dupe-args:
-    - error
-  no-dupe-keys:
-    - error
-  no-duplicate-case:
-    - error
   no-empty:
     - error
-  no-empty-character-class:
-    - error
-  no-ex-assign:
-    - error
-  no-extra-boolean-cast:
-    - error
-  no-extra-parens:
-    - error
   no-extra-semi:
     - error
-  no-func-assign:
-    - error
-  no-inner-declarations:
-    - error
-    - both
-  no-invalid-regexp:
-    - error
-  no-irregular-whitespace:
-    - error
   no-negated-in-lhs:
     - error
-  no-obj-calls:
-    - error
   no-prototype-builtins:
     - error
-  no-regex-spaces:
-    - error
-  no-sparse-arrays:
-    - error
-  no-template-curly-in-string:
-    - error
-  no-unexpected-multiline:
-    - error
-  no-unreachable:
-    - error
-  no-unsafe-finally:
-    - error
-  use-isnan:
-    - error
   valid-jsdoc:
     - error
     - requireReturn: false
@@ -83,13 +48,9 @@ rules:
       prefer:
         arg: "param"
         return: "returns"
-  valid-typeof:
-    - error
 
   # Best Practices
 
-  accessor-pairs:
-    - error
   array-callback-return:
     - error
   block-scoped-var:
@@ -104,19 +65,12 @@ rules:
     - error
   default-case:
     - error
-  dot-location:
-    - error
-    - property
   dot-notation:
     - error
-  eqeqeq:
-    - error
   guard-for-in:
     - error
   no-alert:
     - error
-  no-caller:
-    - error
   no-case-declarations:
     - error
   no-div-regex:
@@ -125,106 +79,43 @@ rules:
     - error
   no-empty-function:
     - error
-  no-empty-pattern:
-    - error
   no-eq-null:
     - error
-  no-eval:
-    - error
-  no-extend-native:
-    - error
-  no-extra-bind:
-    - error
   no-extra-label:
     - error
-  no-fallthrough:
-    - error
-  no-floating-decimal:
-    - error
-  no-global-assign:
-    - error
   no-implicit-coercion:
     - error
   no-implicit-globals:
     - error
-  no-implied-eval:
-    - error
-  no-iterator:
-    - error
-  no-labels:
-    - error
-  no-lone-blocks:
-    - error
   no-loop-func:
     - error
   no-magic-numbers:
     - error
-  no-multi-spaces:
-    - error
-  no-multi-str:
-    - error
   no-native-reassign:
     - error
-  no-new:
-    - error
-  no-new-func:
-    - error
-  no-new-wrappers:
-    - error
-  no-octal:
-    - error
-  no-octal-escape:
-    - error
   no-param-reassign:
     - error
-  no-proto:
-    - error
-  no-redeclare:
-    - error
   no-restricted-properties:
     - error
     - property: __proto__
-  no-return-assign:
-    - error
   no-return-await:
     - error
   no-script-url:
     - error
-  no-self-assign:
-    - error
-  no-self-compare:
-    - error
-  no-sequences:
-    - error
-  no-throw-literal:
-    - error
-  no-unmodified-loop-condition:
-    - error
   no-unused-expressions:
     - error
   no-unused-labels:
     - error
-  no-useless-call:
-    - error
   no-useless-concat:
     - error
-  no-useless-escape:
-    - error
   no-void:
     - error
   no-warning-comments:
     - off
-  no-with:
-    - error
   radix:
     - error
   vars-on-top:
     - off
-  wrap-iife:
-    - error
-    - outside
-  yoda:
-    - error
 
   # Strict mode
 
@@ -239,21 +130,11 @@ rules:
     - always
   no-catch-shadow:
     - error
-  no-delete-var:
-    - error
-  no-label-var:
-    - error
   no-restricted-globals:
     - error
     - event
   no-shadow:
     - error
-  no-shadow-restricted-names:
-    - error
-  no-undef:
-    - error
-  no-undef-init:
-    - error
   no-undefined:
     - error
   no-unused-vars:
@@ -267,14 +148,8 @@ rules:
     - error
   global-require:
     - off
-  handle-callback-err:
-    - error
   no-mixed-requires:
     - error
-  no-new-require:
-    - error
-  no-path-concat:
-    - error
   no-process-env:
     - off
   no-process-exit:
@@ -287,38 +162,20 @@ rules:
   array-bracket-spacing:
     - error
     - always
-  block-spacing:
-    - error
-  brace-style:
-    - error
-    - 1tbs
-  camelcase:
-    - error
   capitalized-comments:
     - error
     - always
     - ignoreConsecutiveComments: true
-  comma-dangle:
-    - error
-    - never
   comma-spacing:
     - error
     - before: false
       after: true
-  comma-style:
-    - error
-    - last
   computed-property-spacing:
     - error
     - never
   consistent-this:
     - error
     - self
-  eol-last:
-    - error
-  func-call-spacing:
-    - error
-    - never
   func-name-matching:
     - error
     - always
@@ -335,19 +192,9 @@ rules:
     - min: 2
       exceptions:
         - "_"
-  indent:
+  id-match:
     - error
-    - 2
-    - SwitchCase: 1
-  key-spacing:
-    - error
-    - beforeColon: false
-      afterColon: true
-      mode: strict
-  keyword-spacing:
-    - error
-    - before: true
-      after: true
+    - "^[_0-9A-Za-z\\$]+$"
   line-comment-position:
     - error
     - position: above
@@ -382,16 +229,9 @@ rules:
     - error
     - max: 1
   multiline-ternary:
-    - error
-    - never
-  new-cap:
-    - error
-  new-parens:
-    - error
+    - off
   newline-per-chained-call:
     - off
-  no-array-constructor:
-    - error
   no-bitwise:
     - error
   no-continue:
@@ -402,21 +242,12 @@ rules:
     - error
   no-mixed-operators:
     - error
-  no-mixed-spaces-and-tabs:
-    - error
   no-multi-assign:
     - error
-  no-multiple-empty-lines:
-    - error
-    - max: 1
-      maxEOF: 1
-      maxBOF: 0
   no-negated-condition:
     - error
   no-nested-ternary:
     - error
-  no-new-object:
-    - error
   no-plusplus:
     - error
   no-restricted-syntax:
@@ -425,46 +256,28 @@ rules:
     - ForInStatement
   no-spaced-func:
     - error
-  no-tabs:
-    - error
-  no-trailing-spaces:
-    - error
   no-underscore-dangle:
     - error
     - allowAfterThis: false
-  no-unneeded-ternary:
-    - error
-  no-whitespace-before-property:
-    - error
   object-curly-newline:
     - error
-    - minProperties: 1
+    - minProperties: 3
+      consistent: true
   object-curly-spacing:
     - error
     - always
-  object-property-newline:
-    - error
   one-var-declaration-per-line:
     - error
     - always
-  one-var:
-    - error
-    - never
   operator-assignment:
     - error
     - always
-  operator-linebreak:
-    - error
-    - before
-  padded-blocks:
-    - error
-    - classes: always
-  quote-props:
-    - error
-    - as-needed
   quotes:
     - error
     - single
+  quote-props:
+    - error
+    - as-needed
   require-jsdoc:
     - error
     - require:
@@ -472,30 +285,11 @@ rules:
         ClassDeclaration: true
         MethodDefinition: true
         ArrowFunctionExpression: true
-  semi:
-    - error
-    - always
-  semi-spacing:
-    - error
-    - before: false
-      after: true
-  space-before-blocks:
-    - error
   space-before-function-paren:
     - error
-    - never
-  space-in-parens:
-    - error
-    - never
-  space-infix-ops:
-    - error
-  space-unary-ops:
-    - error
-    - words: true
-      nonwords: false
-  spaced-comment:
-    - error
-    - always
+    - anonymous: always
+      named: always
+      asyncArrow: always
   template-tag-spacing:
     - error
     - always
@@ -504,9 +298,6 @@ rules:
 
   # ECMAScript 6
 
-  arrow-body-style:
-    - error
-    - always
   arrow-parens:
     - error
     - always
@@ -514,32 +305,12 @@ rules:
     - error
     - before: true
       after: true
-  constructor-super:
-    - error
   generator-star-spacing:
     - error
     - before: true
       after: false
-  no-class-assign:
-    - error
   no-confusing-arrow:
     - error
-  no-const-assign:
-    - error
-  no-dupe-class-members:
-    - error
-  no-duplicate-imports:
-    - error
-  no-new-symbol:
-    - error
-  no-this-before-super:
-    - error
-  no-useless-computed-key:
-    - error
-  no-useless-constructor:
-    - error
-  no-useless-rename:
-    - error
   no-var:
     - error
   object-shorthand:
@@ -547,8 +318,6 @@ rules:
     - always
   prefer-const:
     - error
-  prefer-reflect:
-    - error
   prefer-spread:
     - error
   prefer-numeric-literals:
@@ -562,17 +331,8 @@ rules:
     - allowNamedFunctions: false
   require-yield:
     - error
-  rest-spread-spacing:
-    - error
-  template-curly-spacing:
-    - error
-    - never
   symbol-description:
     - error
-  yield-star-spacing:
-    - error
-    - before: true
-      after: false
 
   # Lodash
 
@@ -645,3 +405,50 @@ rules:
     - error
   lodash/prefer-times:
     - error
+
+  # JSDoc
+
+  jsdoc/check-param-names:
+    - error
+  jsdoc/check-tag-names:
+    - error
+  jsdoc/newline-after-description:
+    - error
+  jsdoc/require-example:
+    - error
+  jsdoc/require-hyphen-before-param-description:
+    - error
+  jsdoc/require-param:
+    - error
+  jsdoc/require-param-description:
+    - error
+  jsdoc/require-param-type:
+    - error
+  jsdoc/require-returns-type:
+    - error
+
+  # Node
+
+  node/no-deprecated-api:
+    - error
+  node/no-missing-import:
+    - error
+  node/no-missing-require:
+    - error
+  node/process-exit-as-throw:
+    - error
+  node/no-extraneous-require:
+    - error
+  node/no-extraneous-import:
+    - error
+
+  # React
+
+  react/jsx-uses-vars:
+    - error
+
+overrides:
+  files: ['*.jsx']
+  rules:
+    require-jsdoc:
+    - off

.gitattributes

@@ -1,18 +1,23 @@
 # Javascript files must retain LF line-endings (to keep eslint happy)
 *.js text eol=lf
+*.jsx text eol=lf
+*.ts text eol=lf
+*.tsx text eol=lf
 # CSS and SCSS files must retain LF line-endings (to keep ensure-staged-sass.sh happy)
 *.css text eol=lf
 *.scss text eol=lf
 
 # Text files
-dictionary text
 Dockerfile* text
 .dockerignore text
 .editorconfig text
 etcher text
 .git* text
 *.html text
-*.json text
+*.json text eol=lf
+*.cpp text
+*.h text
+*.gyp text
 LICENSE text
 Makefile text
 *.md text
@@ -20,14 +25,36 @@ Makefile text
 *.bat text
 *.svg text
 *.yml text
+*.patch text
+*.txt text
+CODEOWNERS text
+*.plist text
 
 # Binary files (no line-ending conversions)
-*.bz2 binary
-*.gz binary
-*.icns binary
-*.ico binary
-*.img binary
-*.png binary
-*.xz binary
-*.zip binary
-*.dmg binary
+*.bz2 binary diff=hex
+*.gz binary diff=hex
+*.icns binary diff=hex
+*.ico binary diff=hex
+*.tiff binary diff=hex
+*.img binary diff=hex
+*.iso binary diff=hex
+*.png binary diff=hex
+*.bin binary diff=hex
+*.elf binary diff=hex
+*.xz binary diff=hex
+*.zip binary diff=hex
+*.dtb binary diff=hex
+*.dtbo binary diff=hex
+*.dat binary diff=hex
+*.bin binary diff=hex
+*.dmg binary diff=hex
+*.rpi-sdcard binary diff=hex
+*.wic binary diff=hex
+*.foo binary diff=hex
+*.eot binary diff=hex
+*.otf binary diff=hex
+*.woff binary diff=hex
+*.woff2 binary diff=hex
+*.ttf binary diff=hex
+xz-without-extension binary diff=hex
+wmic-output.txt binary diff=hex

.github/ISSUE_TEMPLATE.md

@@ -1,5 +1,6 @@
-- **Etcher version:**
-- **Operating system and architecture:**
-- **Do you see any meaningful error information on DevTools?**
+- **Etcher version:** 
+- **Operating system and architecture:** 
+- **Image flashed:** 
+- **Do you see any meaningful error information in the DevTools?** 
 
-<!-- You can open DevTools by pressing `Ctrl+Alt+I`, or `Cmd+Alt+I` if you're running OS X. -->
+<!-- You can open DevTools by pressing `Ctrl+Shift+I` (`Ctrl+Alt+I` for Etcher before v1.3.x), or `Cmd+Alt+I` if you're on Mac OS. -->

.gitignore

@@ -1,5 +1,5 @@
 # Logs
-logs
+/logs
 *.log
 npm-debug.log*
 
@@ -9,10 +9,13 @@ pids
 *.seed
 
 # Directory for instrumented libs generated by jscoverage/JSCover
-lib-cov
+/lib-cov
+
+# Image stream output directory
+/tests/image-stream/output
 
 # Coverage directory used by tools like istanbul
-coverage
+/coverage
 
 # Grunt intermediate storage (http://gruntjs.com/creating-plugins#storing-task-files)
 .grunt
@@ -21,16 +24,17 @@ coverage
 .lock-wscript
 
 # Compiled binary addons (http://nodejs.org/api/addons.html)
-build/Release
+/build
+
+# Generated files
+/generated
 
 # Dependency directory
 # https://docs.npmjs.com/misc/faq#should-i-check-my-node-modules-folder-into-git
 node_modules
-bower_components
 
-# Compiled Electron releases
-release/
-etcher-release/
+# Compiled Etcher releases
+/dist
 
 # Certificates
 *.spc
@@ -39,3 +43,7 @@ etcher-release/
 *.cer
 *.crt
 *.pem
+
+# OSX files
+
+.DS_Store

.gitmodules

@@ -0,0 +1,4 @@
+[submodule "scripts/resin"]
+	path = scripts/resin
+	url = https://github.com/balena-io/scripts.git
+	branch = master

.resinci.json

@@ -0,0 +1,85 @@
+{
+  "electron": {
+    "npm_version": "6.7.0",
+    "dependencies": {
+      "linux": [
+        "libudev-dev",
+        "libusb-1.0-0-dev",
+        "libyaml-dev",
+        "libgtk-3-0",
+        "libatk-bridge2.0-0",
+        "libdbus-1-3",
+        "libc6"
+      ]
+    },
+    "builder": {
+      "appId": "io.balena.etcher",
+      "copyright": "Copyright 2016-2019 Balena Ltd",
+      "productName": "balenaEtcher",
+      "nodeGypRebuild": true,
+      "afterPack": "./afterPack.js",
+      "files": [
+        "build/Release/elevator.node",
+        "generated",
+        "lib/shared/catalina-sudo/sudo-askpass.osascript.js",
+        "lib/gui/app/index.html",
+        "lib/gui/css/*.css",
+        "lib/gui/css/fonts/*.woff2",
+        "lib/gui/assets/*.svg",
+        "assets/icon.png",
+        "!node_modules/**/**",
+        "node_modules/**/*.js",
+        "node_modules/**/*.json",
+        "node_modules/**/*.node",
+        "node_modules/**/*.dll",
+        "node_modules/node-raspberrypi-usbboot/blobs/**",
+        "node_modules/flexboxgrid/dist/flexboxgrid.css",
+        "node_modules/roboto-fontface/fonts/roboto/Roboto-Thin.woff",
+        "node_modules/roboto-fontface/fonts/roboto/Roboto-Light.woff",
+        "node_modules/roboto-fontface/fonts/roboto/Roboto-Regular.woff",
+        "node_modules/roboto-fontface/fonts/roboto/Roboto-Medium.woff",
+        "node_modules/roboto-fontface/fonts/roboto/Roboto-Bold.woff",
+        "node_modules/bootstrap-sass/assets/fonts/bootstrap/glyphicons-halflings-regular.woff2"
+      ],
+      "afterSign": "./afterSignHook.js",
+      "mac": {
+        "asar": false,
+        "category": "public.app-category.developer-tools",
+        "hardenedRuntime": true,
+        "entitlements": "entitlements.mac.plist",
+        "entitlementsInherit": "entitlements.mac.plist"
+      },
+      "dmg": {
+        "iconSize": 110,
+        "contents": [
+          {
+            "x": 140,
+            "y": 245
+          },
+          {
+            "x": 415,
+            "y": 245,
+            "type": "link",
+            "path": "/Applications"
+          }
+        ],
+        "window": {
+          "width": 544,
+          "height": 407
+        }
+      },
+      "linux": {
+        "category": "Utility",
+        "packageCategory": "utils",
+        "synopsis": "balenaEtcher is a powerful OS image flasher built with web technologies to ensure flashing an SDCard or USB drive is a pleasant and safe experience. It protects you from accidentally writing to your hard-drives, ensures every byte of data was written correctly and much more."
+      },
+      "deb": {
+        "compression": "bzip2",
+        "priority": "optional",
+        "depends": [
+          "polkit-1-auth-agent | policykit-1-gnome | polkit-kde-1"
+        ]
+      }
+    }
+  }
+}

.travis.yml

@@ -1,74 +0,0 @@
-language: node_js
-sudo: false
-node_js:
-  - "6.1.0"
-
-git:
-  depth: 3
-
-services:
-  - docker
-
-addons:
-  apt:
-    sources:
-      - ubuntu-toolchain-r-test
-    packages:
-      - libstdc++-6-dev
-
-env:
-  global:
-    - CCACHE_TEMPDIR=/tmp/.ccache-temp
-    - CCACHE_COMPRESS=1
-    - CC="clang"
-    - CXX="clang++"
-  matrix:
-    - TARGET_ARCH=x64
-    - TARGET_ARCH=x86
-
-matrix:
-  fast_finish: true
-  exclude:
-    - os: osx
-      env: TARGET_ARCH=x86
-
-os:
-  - linux
-  - osx
-
-before_install:
-  - npm config set spin=false
-
-install:
-  - if [[ "$TRAVIS_OS_NAME" == "linux" ]]; then
-      ./scripts/build/docker/run-command.sh -r "${TARGET_ARCH}" -s "${PWD}" -c "make info && make electron-develop";
-    else
-      pip install codespell==1.9.2 awscli;
-      npm install -g asar;
-      brew install afsctool jq;
-      make info;
-      travis_wait make electron-develop;
-    fi
-
-script:
-  - if [[ "$TRAVIS_OS_NAME" == "linux" ]]; then
-      ./scripts/build/docker/run-command.sh -r "${TARGET_ARCH}" -s "${PWD}" -c "make sanity-checks && xvfb-run --server-args=$XVFB_ARGS npm test";
-    else
-      make sanity-checks && npm test;
-    fi
-
-deploy:
-  provider: script
-  skip_cleanup: true
-  script: scripts/ci/deploy-travis.sh
-  on:
-    branch: master
-
-notifications:
-  email: false
-  webhooks:
-    urls:
-      - https://webhooks.gitter.im/e/0a019c8b9828eb9f6a72
-    on_success: change
-    on_failure: always
-    on_start: never

CHANGELOG.md

@@ -3,10 +3,855 @@
 All notable changes to this project will be documented in this file.
 This project adheres to [Semantic Versioning](http://semver.org/).
 
+# v1.5.79
+## (2020-02-20)
+
+* Remove "Download the React DevTools for a better development experience" message [Alexis Svinartchouk]
+* Fix error when launching from terminal when installed via apt. [Alois Klink]
+
+# v1.5.78
+## (2020-02-19)
+
+* Update drivelist to 8.0.10 to fix parsing lsblk --pairs [Alexis Svinartchouk]
+
+# v1.5.77
+## (2020-02-17)
+
+* Fix error message not being shown on write error [Alexis Svinartchouk]
+* The RGBLed module has been moved to a separate repository [Alexis Svinartchouk]
+
+# v1.5.76
+## (2020-02-05)
+
+* Prefix temp permissions script name [Lorenzo Alberto Maria Ambrosi]
+* Fix image drop zone, remove react-dropzone dependency [Alexis Svinartchouk]
+* Update etcher-sdk to ^2.0.17 [Alexis Svinartchouk]
+
+# v1.5.75
+## (2020-02-05)
+
+* Initialize leds object map [Omar López]
+
+# v1.5.74
+## (2020-02-04)
+
+* Etcher pro leds feature [Alexis Svinartchouk]
+* Compress deb package with bzip instead of xz [Alexis Svinartchouk]
+* Update electron to 7.1.11 [Alexis Svinartchouk]
+* Sort devices by device path on Linux [Alexis Svinartchouk]
+
+# v1.5.73
+## (2020-01-28)
+
+* Update electron to v7.1.10 [Alexis Svinartchouk]
+
+# v1.5.72
+## (2020-01-27)
+
+* Remove no longer used angular svg-icon component [Alexis Svinartchouk]
+* Remove no longer used closestUnit angular filter [Alexis Svinartchouk]
+
+# v1.5.71
+## (2020-01-14)
+
+* Update resin-corvus to 2.0.5 [Lorenzo Alberto Maria Ambrosi]
+
+# v1.5.70
+## (2019-12-13)
+
+* Make header draggable again [Lorenzo Alberto Maria Ambrosi]
+* Refactor drive selector and confirm modal to React [Lorenzo Alberto Maria Ambrosi]
+* Rework lib/gui/app/styled-components to typescript [Alexis Svinartchouk]
+* Convert FlashAnother & FlashResults to typescript [Lorenzo Alberto Maria Ambrosi]
+* Use React instead of Angular for image selection [Lucian]
+* Convert the drive selection step to React [Thodoris Greasidis]
+* chore: move flash step to React [Stevche Radevski]
+* Use React instead of Angular for image selection [Lucian]
+
+# v1.5.69
+## (2019-12-10)
+
+* Don't add --no-sandbox when ELECTRON_RUN_AS_NODE true [Alexis Svinartchouk]
+
+# v1.5.68
+## (2019-12-08)
+
+* Add version in settings modal [Lorenzo Alberto Maria Ambrosi]
+
+# v1.5.67
+## (2019-12-06)
+
+* Fix elevation on macos in development [Alexis Svinartchouk]
+
+# v1.5.66
+## (2019-12-03)
+
+* Update spectron to ^8 [Alexis Svinartchouk]
+* Update dependencies, get node-usb from npm [Alexis Svinartchouk]
+* Update nan to ^2.14 [Alexis Svinartchouk]
+* Use the same entrypoint for etcher and the child writer [Alexis Svinartchouk]
+* Require angular-mocks only when needed [Alexis Svinartchouk]
+* Remove no longer needed pkg dev dependency [Alexis Svinartchouk]
+* Update mocha, remove nock [Alexis Svinartchouk]
+* Remove no longer needed xml2js [Alexis Svinartchouk]
+* Remove node-pre-gyp patch that is no longer needed with electron 6 [Alexis Svinartchouk]
+* Update electron-mocha to ^8.1.2, remove acorn [Alexis Svinartchouk]
+* Update electron to 6.0.10 [Alexis Svinartchouk]
+
+# v1.5.65
+## (2019-12-02)
+
+* Convert settings modal to typescript [Lorenzo Alberto Maria Ambrosi]
+* Refactor settings page into modal [Lorenzo Alberto Maria Ambrosi]
+
+# v1.5.64
+## (2019-11-22)
+
+* Use bash instead of sh for running the elevated process on Linux and Mac [Alexis Svinartchouk]
+
+# v1.5.63
+## (2019-11-08)
+
+* Introduce an FAQ file [Dimitrios Lytras]
+
+# v1.5.62
+## (2019-11-06)
+
+* Update drivelist to 8.0.9 [Alexis Svinartchouk]
+
+# v1.5.61
+## (2019-11-05)
+
+* Notarize app on macOS [Lorenzo Alberto Maria Ambrosi]
+
+# v1.5.60
+## (2019-10-18)
+
+* Upgrade ext2fs to 1.0.30 [Matthew McGinn]
+
+# v1.5.59
+## (2019-10-14)
+
+* Catch console log messages from SafeWebView [Roman Mazur]
+
+# v1.5.58
+## (2019-10-10)
+
+* Remove leftover GH-pages configuration file [Dimitrios Lytras]
+
+# v1.5.57
+## (2019-09-16)
+
+* Fix entrypoint when options are passed to electron [Alexis Svinartchouk]
+
+# v1.5.56
+## (2019-08-20)
+
+* Fix windows portable download [Lorenzo Alberto Maria Ambrosi]
+
+# v1.5.55
+## (2019-08-19)
+
+* Update etcher-sdk to ^2.0.13 [Alexis Svinartchouk]
+
+# v1.5.54
+## (2019-08-07)
+
+* Fix auto-updater check for updates [Lorenzo Alberto Maria Ambrosi]
+
+# v1.5.53
+## (2019-08-06)
+
+* Allow typescript files [Lorenzo Alberto Maria Ambrosi]
+
+# v1.5.52
+## (2019-07-22)
+
+* Don't use wmic's ProviderName if it's empty [Alexis Svinartchouk]
+
+# v1.5.51
+## (2019-06-28)
+
+* Update sudo-prompt to ^9.0.0 [Alexis Svinartchouk]
+
+# v1.5.50
+## (2019-06-13)
+
+* Option for trimming ext partitions on raw images [Alexis Svinartchouk]
+
+# v1.5.49
+## (2019-06-13)
+
+* Make window size configurable [Alexis Svinartchouk]
+
+# v1.5.48
+## (2019-06-13)
+
+* Don't use sudo-prompt when already elevated [Alexis Svinartchouk]
+
+# v1.5.47
+## (2019-06-10)
+
+* Rework drive-selector with react + rendition [Lorenzo Alberto Maria Ambrosi]
+* Use rendition theme property for step buttons [Lorenzo Alberto Maria Ambrosi]
+* Upgrade styled-system to v4.1.0 [Lorenzo Alberto Maria Ambrosi]
+* Upgrade rendition to v8.7.2 [Lorenzo Alberto Maria Ambrosi]
+
+# v1.5.46
+## (2019-06-09)
+
+* Update ext2fs to 1.0.29 [Alexis Svinartchouk]
+
+# v1.5.45
+## (2019-06-04)
+
+* Empty commit to trigger build [Alexis Svinartchouk]
+
+# v1.5.44
+## (2019-06-03)
+
+* Fix elevation on windows when the path contains "&" or "'" [Alexis Svinartchouk]
+
+# v1.5.43
+## (2019-05-28)
+
+* Revert "Include sass in webpack configs" [Lorenzo Alberto Maria Ambrosi]
+
+# v1.5.42
+## (2019-05-28)
+
+* Include sass in webpack configs [Lorenzo Alberto Maria Ambrosi]
+
+# v1.5.41
+## (2019-05-27)
+
+* waffle.io removal and adding a link to the license [Mateusz Hajder]
+
+# v1.5.40
+## (2019-05-24)
+
+* windows installer and portable version support both ia32 and x64 [Alexis Svinartchouk]
+
+# v1.5.39
+## (2019-05-14)
+
+* Add clean-shrinkwrap script to postshrinkwrap step [Lorenzo Alberto Maria Ambrosi]
+
+# v1.5.38
+## (2019-05-13)
+
+* Add mention to usbboot compatibility [Carlo Maria Curinga]
+
+# v1.5.37
+## (2019-05-13)
+
+* Bump react dependency to v16.8.5 [Lorenzo Alberto Maria Ambrosi]
+
+# v1.5.36
+## (2019-05-13)
+
+* Update etcher-sdk to ^2.0.9 [Alexis Svinartchouk]
+
+# v1.5.35
+## (2019-05-10)
+
+* Downgrade electron 4.1.5 -> 3.1.9 [Alexis Svinartchouk]
+
+# v1.5.34
+## (2019-05-09)
+
+* Use https url for fetching config, avoid redirection [Alexis Svinartchouk]
+* win32: fix running diskpart when the tmp file path contains spaces [Alexis Svinartchouk]
+
+# v1.5.33
+## (2019-04-30)
+
+* Fix gzipped files verification percentage and dmg verification. [Alexis Svinartchouk]
+
+# v1.5.32
+## (2019-04-30)
+
+* Export NPM_VERSION variable in Makefile [Lorenzo Alberto Maria Ambrosi]
+
+# v1.5.31
+## (2019-04-29)
+
+* Update etcher-sdk to ^2.0.3 [Alexis Svinartchouk]
+* Update electron to 4.1.5 [Alexis Svinartchouk]
+
+# v1.5.30
+## (2019-04-24)
+
+* Don't show a dialog when the write fails. [Alexis Svinartchouk]
+
+# v1.5.29
+## (2019-04-19)
+
+* Add support for auto-updating feature [Giovanni Garufi]
+
+# v1.5.28
+## (2019-04-18)
+
+* Update electron-builder to ^20.40.2 [Alexis Svinartchouk]
+* Update etcher-sdk to ^2.0.1 [Alexis Svinartchouk]
+
+# v1.5.27
+## (2019-04-16)
+
+* (Windows): Fix reading images from network drives when the tmp dir has spaces [Alexis Svinartchouk]
+
+# v1.5.26
+## (2019-04-12)
+
+* (Windows): Fix reading images from network drives containing non ascii characters [Alexis Svinartchouk]
+
+# v1.5.25
+## (2019-04-09)
+
+* New parameter in webview for opt-out analytics [Lorenzo Alberto Maria Ambrosi]
+
+# v1.5.24
+## (2019-04-05)
+
+* Update resin-corvus to ^2.0.3 [Alexis Svinartchouk]
+
+# v1.5.23
+## (2019-04-03)
+
+* Configure versionbot to publish repo metadata to github pages [Giovanni Garufi]
+
+# v1.5.22
+## (2019-04-02)
+
+* (Windows): Use full path to wmic as some systems don't have it in their PATH [Alexis Svinartchouk]
+
+# v1.5.21
+## (2019-04-02)
+
+* Fix error when config.analytics was undefined [Alexis Svinartchouk]
+
+# v1.5.20
+## (2019-04-01)
+
+* Don't try to flash when no device is selected [Alexis Svinartchouk]
+* Reformat changelog [Giovanni Garufi]
+* Avoid "Error: There is already a flash in progress" errors [Alexis Svinartchouk]
+
+# v1.5.19
+## (2019-03-28)
+
+* Update resin-corvus to ^2.0.2 [Alexis Svinartchouk]
+* Better reporting of unhandled rejections to sentry [Alexis Svinartchouk]
+
+# v1.5.18
+## (2019-03-26)
+
+* Update build scripts [Giovanni Garufi]
+
+## v1.5.17 - 2019-03-25
+
+### Misc
+
+- Automatically publish github release from CI
+
+## v1.5.16 - 2019-03-25
+
+### Misc
+
+- Add repo.yml
+
+## v1.5.15 - 2019-03-20
+
+### Misc
+
+- Show the correct logo on usbboot devices on Ubuntu
+
+## v1.5.14 - 2019-03-20
+
+### Misc
+
+- Update etcher-sdk to ^1.3.10
+
+## v1.5.13 - 2019-03-18
+
+### Misc
+
+- Update build scripts
+
+## v1.5.12 - 2019-03-15
+
+### Misc
+
+- Update build scripts
+
+## v1.5.11 - 2019-03-12
+
+### Misc
+
+- Fixed broken Hombrew cask link for etcher
+- Remove no longer used travis and appveyor configs
+
+## v1.5.10 - 2019-03-12
+
+### Misc
+
+- Update resin-scripts
+
+## v1.5.9 - 2019-03-05
+
+### Misc
+
+- Update etcher-sdk to 1.3.0
+
+## v1.5.8 - 2019-03-01
+
+### Misc
+
+- Update ext2fs to 1.0.27
+
+## v1.5.7 - 2019-03-01
+
+### Fixes
+
+- Update docs
+- Fix disappearing modal window
+
+### Misc
+
+- Fix blurred background image
+
+## v1.5.6 - 2019-02-28
+
+### Misc
+
+- Target electron 3 runtime in babel options
+
+## v1.5.5 - 2019-02-28
+
+### Misc
+
+- Don't pass undefined sockets to ipc.server.emit()
+- Fix error when event.dataTransfer.files is empty
+- Fix error message not showing when an unsupported image is selected
+- Avoid `Invalid percentage` exceptions
+- Update etcher-sdk to 1.1.0
+
+## v1.5.4 - 2019-02-27
+
+### Misc
+
+- Add missing step for submodule cloning in README
+
+## v1.5.3 - 2019-02-27
+
+### Misc
+
+- Throw error if no commit is annotated with a changelog entry
+
+## v1.5.2 - 2019-02-26
+
+- Enable versionist editVersion
+
+## v1.5.1 - 2019-02-22
+
+### Misc
+
+- Removed lodash dependency in versionist.conf.js
+
+## v1.5.0 - 2019-02-16
+
+### Misc
+
+- Reworked flashing logic with etcher-sdk
+- Add support for flashing Raspberry Pi CM3+
+- Upgrade to Electron v3.
+- Upgrade to NPM 6.7.0
+- Fix incorrect drives list on Linux
+- Changed “Drive Contains Image” to “Drive Mountpoint Contains Image”
+- Removed etcher-cli
+
+## v1.4.9 - 2018-12-19
+
+### Fixes
+
+- Fix update notifier error popping up on v1.4.1->1.4.8
+
+### Misc
+
+- Added React component for the Flash Results button
+- Added React component for the Flash Another button
+- Restyle success screen and enlarge UI elements
+- Use https for fetching sub modules
+- Add `.wic` image extension as supported format
+
+## v1.4.8 - 2018-11-23
+
+### Features
+
+- Added featured-project while flashing
+
+### Fixes
+
+- Moved back the write cancel button
+- Reject drives with null size (fixes pretty-bytes error)
+
+## v1.4.7 - 2018-11-12
+
+### Fixes
+
+- Fix typo in contributing guidelines
+- Modify versionist.conf.js to match new internal commit guidelines
+
+### Misc
+
+- Rename etcher to balena-etcher
+- Convert Select Image button to Rendition
+
+## v1.4.6 - 2018-10-28
+
+### Fixes
+
+- Provide a Buffer to xxhash.Stream
+- Fix 64 bit detection on arm
+- Fix incorrect file constraint path
+- Fix flash cancel button interaction
+
+### Misc
+
+- Add new balena.io logos
+- Use Resin CI scripts to build Etcher
+- Enable React lint rules
+- Convert Progress Button to Rendition
+
+## v1.4.5 - 2018-10-11
+
+### Features
+
+- Center content independent to window resolution.
+- Add electron-native file-picker component.
+- Hide unsafe mode option toggle with an env var.
+- Use new design background color and drive step size ordering.
+- Add a convenience Storage class on top of localStorage.
+- Introduce env var to toggle autoselection of all drives.
+- Add font-awesome.
+- Add support for configuration files
+- Use GTK-3 darkTheme mode.
+- Add environment variable to toggle fullscreen.
+- Allow blacklisting of drives through and environment variable ETCHER_BLACKLISTED_DRIVES.
+- Show selected drives below drive selection step.
+- Add a button to cancel the flash process.
+- Download usbboot drivers installer when clicking a driverless usbboot device on Windows.
+- Allow disabling links and hiding help link with an env var.
+
+### Fixes
+
+- Add "make webpack" to travis-ci build script
+- Makefile: Don't use tilde in rpm versions
+- Change Spectron port so not to overlap with other builds
+- Fix multi-writes analytics by reusing existing logic in multi-write events.
+- Load usbboot adapter on start on GNU/Linux if running as root.
+
+### Misc
+
+- Update drivelist to v6.4.2
+- Add instructions for installing and uninstalling on Solus.
+
+## v1.4.4 - 2018-04-24
+
+### Fixes
+
+- Don't display status dots with a quantity of zero on success screen
+- Correct wording of flash status to use "successful" instead of "succeeded"
+- Keep single drive-image pairs with warnings selected
+
+### Misc
+
+- Improve notification messages
+
+## v1.4.3 - 2018-04-19
+
+### Fixes
+
+- Fix blob handling for usbboot
+
+## v1.4.2 - 2018-04-18
+
+### Features
+
+- Make the progress button blue on verification
+- Display succeeded and failed devices on finish screen
+
+### Fixes
+
+- Exclude RAID devices from drive selection list
+- Display untitled device when device lacks description
+- Prefix multiple devices label with quantity
+- Fix handling of errors over IPC
+- Fix usbboot blob loading
+- Revert using native binding to clean disks on Windows
+
+## v1.4.1 - 2018-04-10
+
+### Fixes
+
+- Exclude package.json from UI bundle
+
+## v1.4.0 - 2018-04-05
+
+### Features
+
+- Move the drive selector warning dialog to the flash step
+- Display image size for comparison if drive is too small
+- Implement writing to multiple destinations simultaneously
+- Add colorised multi-writes progress status dots
+- Move CLI write preparation logic into SDK
+- Make the drive-selector button orange on warnings
+- Warn the user on selection of large drives
+- Consolidate low-level components into Etcher SDK
+- Use native code to clean drives on Windows
+- Increase UV_THREADPOOL_SIZE to allocate 4 threads per CPU
+- Add icon next to drive size when compatibility warnings exist
+- Display number of active devices while flashing in CLI
+- Replace CRC32 checksums with SHA512
+- Enable usbboot on Linux if run as root
+
+### Fixes
+
+- Improve spacing to the drive-selector warning/error labels
+- Line wrap selector size subtitles wholly
+- Hide the size label given multiple devices
+- Use correct usbboot blob path in AppImages
+- Fix EINVAL error on Linux
+- Fix enabling debug output
+- Fix DevTools opening in docked mode
+- Fix menu's application name
+- Fix "Array buffer allocation failed" when flashing some .dmg images
+- Log the banner load event to analytics
+- Warn on usbboot load error in the console on Linux
+- Ensure image/drive size is displayed on new line
+- Don't force-inherit process environment on Windows
+
+### Misc
+
+- Replace Helvetica as the main font with Roboto
+- Update Electron to v1.7.13
+- Add spacing to the drive warning icon
+- Use multi-drive methods with drive-list warning button
+- Remove unused & deprecated robot protocol
+- Update copyright years
+- Update instructions in ISSUE_TEMPLATE
+- Use Concourse CI for automated release builds
+- Only publish production packages to Bintray (remove devel)
+- Replace Gitter with Resin.io Forums for support
+- Add support for arm64 / armv8 / aarch64 in build scripts
+- Add descriptive name to modal popup windows
+
+## v1.3.1 - 2018-01-23
+
+### Fixes
+
+- Fix "stdout maxBuffer" error on Linux
+- Fix Etcher not working / crashing on older Windows systems
+- Fix not all partitions being unmounted after flashing on Linux
+- Fix selection of images in folders with file extension on Mac OS
+
+### Misc
+
+- Update Electron to v1.7.11
+
+## v1.3.0 - 2018-01-04
+
+### Features
+
+- Display connected Compute Modules even if Windows doesn't have the necessary drivers to act on them
+- Add read/write retry delays with backoff to ...
+- Add native application menu (which fixes OS native window management shortcuts not working)
+
+### Fixes
+
+- Fix "Couldn't scan drives" error
+- Ensure the writer process dies when the GUI application is killed
+- Run elevated writing process asynchronously on Windows
+- Fix trailing space in environment variables during Windows elevation
+- Don't send analytics events when attempting to toggle a disabled drive
+- Fix handling of transient write errors on Linux (EBUSY)
+- Fix runaway perl process in drivelist on Mac OS
+
+### Misc
+
+- Update Electron from v1.7.9 to v1.7.10
+- Remove Angular dependency from image-writer
+
+## v1.2.1 - 2017-12-06
+
+### Fixes
+
+- Fix handling of temporary read/write errors
+- Don't send initial Mixpanel events before "Anonymous Tracking" settings are loaded
+- Fix verification step reading from the cache
+
+## v1.2.0 - 2017-11-22
+
+### Features
+
+- Display actual write speed
+- Add the progress and status to the window title.
+- Add a sudo-prompt upon launch on Linux-based systems.
+- Add optional progress bars to drive-selector drives.
+- Increase the flashing speed of usbboot discovered devices.
+- Add eye candy to usbboot initialized devices.
+- Integrate Raspberry Pi's usbboot technology.
+
+### Fixes
+
+- Fix bzip2 streaming with the new pipelines
+- Remove Linux elevation meant for usbboot.
+- Fix `LIBUSB_ERROR_NO_DEVICE` error at the end of usbboot.
+- Gracefully handle scenarios where a USB drive is disconnected halfway through the usbboot procedure.
+- Make sure the progress button is always rounded.
+- Fix permission denied issues when XDG_RUNTIME_DIR is mounted with the `noexec` option.
+- Fix Etcher being unable to read certain zip files
+- Fix "Couldn't scan the drives: An unknown error occurred" error when there is a drive locked with BitLocker.
+- Fix "Missing state eta" error when speed is zero
+- Fix "Stuck on Starting..." error
+- Fix situations where the process would get stuck while flashing
+
+### Misc
+
+- Add the Python version (2.7) to the CONTRIBUTING doc.
+- Remove duplicate debug enabling in usbboot module.
+- Update Electron to v1.7.9
+- Retry ejection various times before giving up on Windows.
+- Try to use `$XDG_RUNTIME_DIR` to extract temporary scripts on GNU/Linux.
+
+## v1.1.2 - 2017-08-07
+
+### Features
+
+- Add support for `.rpi-sdcard` images
+
+### Fixes
+
+- Avoid "broken" icon when selecting a zip image archive with invalid SVG
+- Fix `UNABLE_TO_GET_ISSUER_CERT_LOCALLY` error at startup when behind certain proxies
+- Fix `EHOSTDOWN` error at startup
+- Display a user-friendly error message if the user is not in the sudoers file
+- Make archive-embedded SVG icons work again
+- Fix "imageBasename is not defined" error on the CLI
+- Fix various drive scanning Windows errors
+
+### Misc
+
+- Improve Windows drive detection error codes.
+
+## v1.1.1 - 2017-07-25
+
+### Fixes
+
+- Prevent "percentage above 100%" errors on DMG images
+- Fix Etcher not starting flashes in AppImages
+- Fix most "Unmount failed" errors on macOS
+
+## v1.1.0 - 2017-07-20
+
+### Features
+
+- Add image name, drive name, and icon to OS notifications
+- Add support for `.sdcard` images
+- Start publishing RPM packages
+- Generate single-binary portable installers on Windows
+- Show friendlier error dialogs when opening an image results in an error
+- Generate one-click Windows NSIS installers
+- Show the application version in the WebView banners
+- Show a warning message if the selected image has no partition table
+- Make use of `pkg` to package the Etcher CLI
+- Send anonymous analytics about package types
+- Minor style improvements to the fallback success page banner
+- Turn the update notifier modal into a native dialog
+
+### Fixes
+
+- Fix "You don't have access to this resource" error at startup when behind a firewall
+- Fix `UNABLE_TO_VERIFY_LEAF_SIGNATURE` error at startup when behind a proxy
+- Reset webview after navigating away from the success screen
+- Fix occasional increased CPU usage because of perl regular expression in macOS
+- Don't install to `C:\Program Files (x86)` on 64-bit Windows systems
+- Fix "file is not accessible" error when flashing an image that lives inside a directory whose name is UTF-16 encoded on Windows.
+- Fix various interrelated Windows `.bat` spawning issues
+- Fix 0.0 GB Windows drive detection issues
+- Cleanup drive detection temporary scripts in GNU/Linux and macOS
+- Ensure no analytics events are sent if error reporting is disabled
+- Retry various times on `EAGAIN` when spawning drive scanning scripts
+- Don't break up size numbers in the drive selector
+
+### Misc
+
+- Remove "Advanced" settings subtitle
+- Remove support for the `ETCHER_DISABLE_UPDATES` environment variable
+- Swap speed and time below the flashing progress bar
+
+## v1.0.0 - 2017-05-12
+
+### Features
+
+- Implement a dynamic finish page.
+- Display nicer error dialog when reading an invalid image.
+
+### Fixes
+
+- Prevent drive from getting re-mounted in macOS even when the unmount on success setting is enabled.
+- Fix `ECONNRESET` and `ECONNREFUSED` errors when checking for updates on unstable connections.
+- Fix application stuck at "Starting..." on Windows.
+- Fix error on startup when Windows username contained an ampersand.
+
+## v1.0.0-rc.5 - 2017-05-02
+
+### Fixes
+
+- Fix various elevation issues on Windows
+- Treat unknown images as octet stream
+- Fix uncaught errors when cancelling elevation requests on Windows when the system's language is not English.
+
+## v1.0.0-rc.4 - 2017-04-22
+
+### Fixes
+
+- Fix "Unmount failed" on Windows where the PC is connected to network drives.
+- Various fixes for when drive descriptions contain special characters.
+
+### Misc
+
+- Show a friendly user message on EIO after many retries.
+- Show user friendly messages for `EBUSY, read` and `EBUSY, write` errors on macOS.
+
+## v1.0.0-rc.3 - 2017-04-14
+
+### Fixes
+
+- Show a user friendly message when the drive is unplugged half-way through.
+- Fix "UNKNOWN: unknown error" error when unplugging an SD Card from an internal reader on Windows.
+- Fix "function createError(opts) {}" error on validation failure.
+- Fix "Unmount failed, invalid drive" error on Windows.
+- Fix Apple disk image detection & streaming.
+
+### Misc
+
+- Improve error reporting accuracy.
+
+## v1.0.0-rc.2 - 2017-04-11
+
+### Fixes
+
+- Display a user error if the image is no longer accessible when the writer starts.
+- Prevent uncaught `EISDIR` when dropping a directory to the application.
+- Fix "Path must be a string. Received undefined" when selecting Apple images.
+- Don't interpret certain ISO images as unsupported.
+
 ## v1.0.0-rc.1 - 2017-04-10
 
 ### Features
 
+- Add support for Apple Disk images.
 - Add the un-truncated drive description to the selected drive step tooltip.
 - Prevent flashing an image that is larger than the drive with the CLI.
 
@@ -287,8 +1132,8 @@ This project adheres to [Semantic Versioning](http://semver.org/).
 ### Fixes
 
 - Fix broken image drag and drop functionality.
-- Prevent global shortcuts from interferring with another applications.
-- Prevent re-activating the "Flash" button with the keybaord shortcuts when a flash is already in process.
+- Prevent global shortcuts from interfering with another applications.
+- Prevent re-activating the "Flash" button with the keyboard shortcuts when a flash is already in process.
 - Fix certain non-removable Windows devices not being filtered out.
 - Display non-mountable Windows drives in the drive selector.
 

CODEOWNERS

@@ -0,0 +1,2 @@
+* @thundron @zvin @jviotti
+/scripts @nazrhom

FAQ.md

@@ -0,0 +1,46 @@
+## Why is my drive not bootable?
+
+Etcher copies images to drives byte by byte, without doing any transformation to the final device, which means images that require special treatment to be made bootable, like Windows images, will not work out of the box. In these cases, the general advice is to use software specific to those kind of images, usually available from the image publishers themselves. You can find more information [here](https://github.com/balena-io/etcher/blob/master/docs/USER-DOCUMENTATION.md#why-is-my-drive-not-bootable).
+
+## How can I configure persistent storage?
+
+Some programs, usually oriented at making GNU/Linux live USB drives, include an option to set persistent storage. This is currently not supported by Etcher, so if you require this functionality, we advise to fallback to [UNetbootin](https://unetbootin.github.io/).
+
+## How do I flash Ubuntu ISOs
+
+Ubuntu images (and potentially some other related GNU/Linux distributions) have a peculiar format that allows the image to boot without any further modification from both CDs and USB drives.
+A consequence of this enhancement is that some programs, like parted get confused about the drive's format and partition table, printing warnings such as:
+
+> /dev/xxx contains GPT signatures, indicating that it has a GPT table. However, it does not have a valid fake msdos partition table, as it should. Perhaps it was corrupted -- possibly by a program that doesn't understand GPT partition tables. Or perhaps you deleted the GPT table, and are now using an msdos partition table. Is this a GPT partition table? Both the primary and backup GPT tables are corrupt. Try making a fresh table, and using Parted's rescue feature to recover partitions.
+
+> Warning: The driver descriptor says the physical block size is 2048 bytes, but Linux says it is 512 bytes.
+
+All these warnings are safe to ignore, and your drive should be able to boot without any problems.
+Refer to [the following message from Ubuntu's mailing list](https://lists.ubuntu.com/archives/ubuntu-devel/2011-June/033495.html) if you want to learn more.
+
+## How do I run Etcher on Wayland?
+
+The XWayland Server provides backwards compatibility to run any X client on Wayland, including Etcher.
+This usually works out of the box on mainstream GNU/Linux distributions that properly support Wayland. If it doesn't, make sure the xwayland.so module is being loaded by declaring it in your [weston.ini](http://manpages.ubuntu.com/manpages/wily/man5/weston.ini.5.html):
+
+```
+[core]
+modules=xwayland.so
+```
+
+## What are the runtime GNU/LINUX dependencies?
+
+[This entry](https://github.com/balena-io/etcher/blob/master/docs/USER-DOCUMENTATION.md#runtime-gnulinux-dependencies) aims to provide an up to date list of runtime dependencies needed to run Etcher on a GNU/Linux system.
+
+## How can I recover the broken drive?
+
+Sometimes, things might go wrong, and you end up with a half-flashed drive that is unusable by your operating systems, and common graphical tools might even refuse to get it back to a normal state.
+To solve these kinds of problems, we've collected [a list of fail-proof methods](https://github.com/balena-io/etcher/blob/master/docs/USER-DOCUMENTATION.md#recovering-broken-drives) to completely erase your drive in major operating systems.
+
+## I receive ”No polkit authentication agent found” error in GNU/Linux
+
+Etcher requires an available [polkit authentication agent](https://wiki.archlinux.org/index.php/Polkit#Authentication_agents) in your system in order to show a secure password prompt dialog to perform elevation. Make sure you have one installed for the desktop environment of your choice.
+
+## May I run Etcher in older macOS versions?
+
+Etcher GUI is based on the [Electron](http://electron.atom.io/) framework, [which only supports macOS 10.9 and newer versions](https://github.com/electron/electron/blob/master/docs/tutorial/support.md#supported-platforms).

Makefile

@@ -2,8 +2,12 @@
 # Build configuration
 # ---------------------------------------------------------------------
 
+RESIN_SCRIPTS ?= ./scripts/resin
+export NPM_VERSION ?= 6.7.0
+S3_BUCKET = artifacts.ci.balena-cloud.com
+
 # This directory will be completely deleted by the `clean` rule
-BUILD_DIRECTORY ?= release
+BUILD_DIRECTORY ?= dist
 
 # See http://stackoverflow.com/a/20763842/1641422
 BUILD_DIRECTORY_PARENT = $(dir $(BUILD_DIRECTORY))
@@ -12,37 +16,16 @@ $(error $(BUILD_DIRECTORY_PARENT) does not exist)
 endif
 
 BUILD_TEMPORARY_DIRECTORY = $(BUILD_DIRECTORY)/.tmp
-BUILD_OUTPUT_DIRECTORY = $(BUILD_DIRECTORY)/out
 
-# ---------------------------------------------------------------------
-# Application configuration
-# ---------------------------------------------------------------------
+$(BUILD_DIRECTORY):
+	mkdir $@
 
-ELECTRON_VERSION = $(shell jq -r '.devDependencies["electron-prebuilt"]' package.json)
-NODE_VERSION = 6.1.0
-COMPANY_NAME = $(shell jq -r '.companyName' package.json)
-APPLICATION_NAME = $(shell jq -r '.displayName' package.json)
-APPLICATION_DESCRIPTION = $(shell jq -r '.description' package.json)
-APPLICATION_COPYRIGHT = $(shell jq -r '.copyright' package.json)
-APPLICATION_CATEGORY = public.app-category.developer-tools
-APPLICATION_BUNDLE_ID = io.resin.etcher
-APPLICATION_FILES = lib,assets
+$(BUILD_TEMPORARY_DIRECTORY): | $(BUILD_DIRECTORY)
+	mkdir $@
 
-# Add the current commit to the version if release type is "snapshot"
-RELEASE_TYPE ?= snapshot
-PACKAGE_JSON_VERSION = $(shell jq -r '.version' package.json)
-ifeq ($(RELEASE_TYPE),production)
-APPLICATION_VERSION = $(PACKAGE_JSON_VERSION)
-S3_BUCKET = resin-production-downloads
-endif
-ifeq ($(RELEASE_TYPE),snapshot)
-CURRENT_COMMIT_HASH = $(shell git log -1 --format="%h")
-APPLICATION_VERSION = $(PACKAGE_JSON_VERSION)+$(CURRENT_COMMIT_HASH)
-S3_BUCKET = resin-nightly-downloads
-endif
-ifndef APPLICATION_VERSION
-$(error Invalid release type: $(RELEASE_TYPE))
-endif
+# See https://stackoverflow.com/a/13468229/1641422
+SHELL := /bin/bash
+PATH := $(shell pwd)/node_modules/.bin:$(PATH)
 
 # ---------------------------------------------------------------------
 # Operating system and architecture detection
@@ -50,7 +33,7 @@ endif
 
 # http://stackoverflow.com/a/12099167
 ifeq ($(OS),Windows_NT)
-	HOST_PLATFORM = win32
+	PLATFORM = win32
 
 	ifeq ($(PROCESSOR_ARCHITEW6432),AMD64)
 		HOST_ARCH = x64
@@ -64,7 +47,7 @@ ifeq ($(OS),Windows_NT)
 	endif
 else
 	ifeq ($(shell uname -s),Linux)
-		HOST_PLATFORM = linux
+		PLATFORM = linux
 
 		ifeq ($(shell uname -m),x86_64)
 			HOST_ARCH = x64
@@ -73,11 +56,20 @@ else
 			HOST_ARCH = x86
 		endif
 		ifeq ($(shell uname -m),armv7l)
-			HOST_ARCH = armv7l
+			HOST_ARCH = armv7hf
+		endif
+		ifeq ($(shell uname -m),aarch64)
+			HOST_ARCH = aarch64
+		endif
+		ifeq ($(shell uname -m),armv8)
+			HOST_ARCH = aarch64
+		endif
+		ifeq ($(shell uname -m),arm64)
+			HOST_ARCH = aarch64
 		endif
 	endif
 	ifeq ($(shell uname -s),Darwin)
-		HOST_PLATFORM = darwin
+		PLATFORM = darwin
 
 		ifeq ($(shell uname -m),x86_64)
 			HOST_ARCH = x64
@@ -85,17 +77,11 @@ else
 	endif
 endif
 
-ifndef HOST_PLATFORM
-$(error We couldn't detect your host platform)
+ifndef PLATFORM
+$(error We could not detect your host platform)
 endif
 ifndef HOST_ARCH
-$(error We couldn't detect your host architecture)
-endif
-
-TARGET_PLATFORM = $(HOST_PLATFORM)
-
-ifneq ($(TARGET_PLATFORM),$(HOST_PLATFORM))
-$(error We don't support cross-platform builds yet)
+$(error We could not detect your host architecture)
 endif
 
 # Default to host architecture. You can override by doing:
@@ -104,308 +90,31 @@ endif
 #
 TARGET_ARCH ?= $(HOST_ARCH)
 
-# Support x86 builds from x64 in GNU/Linux
-# See https://github.com/addaleax/lzma-native/issues/27
-ifeq ($(TARGET_PLATFORM),linux)
-	ifneq ($(HOST_ARCH),$(TARGET_ARCH))
-		ifeq ($(TARGET_ARCH),x86)
-			export CFLAGS += -m32
-		else
-$(error Can't build $(TARGET_ARCH) binaries on a $(HOST_ARCH) host)
-		endif
-	endif
-endif
-
 # ---------------------------------------------------------------------
-# Code signing
+# Electron
 # ---------------------------------------------------------------------
-
-ifeq ($(TARGET_PLATFORM),darwin)
-ifndef CODE_SIGN_IDENTITY
-$(warning No code-sign identity found (CODE_SIGN_IDENTITY is not set))
-endif
-endif
-
-ifeq ($(TARGET_PLATFORM),win32)
-ifndef CODE_SIGN_CERTIFICATE
-$(warning No code-sign certificate found (CODE_SIGN_CERTIFICATE is not set))
-ifndef CODE_SIGN_CERTIFICATE_PASSWORD
-$(warning No code-sign certificate password found (CODE_SIGN_CERTIFICATE_PASSWORD is not set))
-endif
-endif
-endif
-
-# ---------------------------------------------------------------------
-# Analytics
-# ---------------------------------------------------------------------
-
-ifndef ANALYTICS_SENTRY_TOKEN
-$(warning No Sentry token found (ANALYTICS_SENTRY_TOKEN is not set))
-endif
-
-ifndef ANALYTICS_MIXPANEL_TOKEN
-$(warning No Mixpanel token found (ANALYTICS_MIXPANEL_TOKEN is not set))
-endif
-
-# ---------------------------------------------------------------------
-# Extra variables
-# ---------------------------------------------------------------------
-
-TARGET_ARCH_DEBIAN = $(shell ./scripts/build/architecture-convert.sh -r $(TARGET_ARCH) -t debian)
-
-PRODUCT_NAME = etcher
-APPLICATION_NAME_LOWERCASE = $(shell echo $(APPLICATION_NAME) | tr A-Z a-z)
-APPLICATION_VERSION_DEBIAN = $(shell echo $(APPLICATION_VERSION) | tr "-" "~")
-
-# ---------------------------------------------------------------------
-# Rules
-# ---------------------------------------------------------------------
-
-# See http://stackoverflow.com/a/12528721
-# Note that the blank line before 'endef' is actually important - don't delete it
-define execute-command
-	$(1)
-
-endef
-
-$(BUILD_DIRECTORY):
-	mkdir $@
-
-$(BUILD_TEMPORARY_DIRECTORY): | $(BUILD_DIRECTORY)
-	mkdir $@
-
-$(BUILD_DIRECTORY)/electron-$(TARGET_PLATFORM)-$(TARGET_ARCH)-dependencies: | $(BUILD_DIRECTORY)
-	mkdir $@
-
-$(BUILD_DIRECTORY)/node-$(TARGET_PLATFORM)-$(TARGET_ARCH)-dependencies: | $(BUILD_DIRECTORY)
-	mkdir $@
-
-$(BUILD_OUTPUT_DIRECTORY): | $(BUILD_DIRECTORY)
-	mkdir $@
-
-$(BUILD_DIRECTORY)/electron-$(TARGET_PLATFORM)-$(TARGET_ARCH)-dependencies/node_modules: package.json npm-shrinkwrap.json \
-	| $(BUILD_DIRECTORY)/electron-$(TARGET_PLATFORM)-$(TARGET_ARCH)-dependencies
-	./scripts/build/dependencies-npm.sh -p \
-		-r "$(TARGET_ARCH)" \
-		-v "$(ELECTRON_VERSION)" \
-		-x $| \
-		-t electron \
-		-s "$(TARGET_PLATFORM)"
-
-$(BUILD_DIRECTORY)/node-$(TARGET_PLATFORM)-$(TARGET_ARCH)-dependencies/node_modules: package.json npm-shrinkwrap.json \
-	| $(BUILD_DIRECTORY)/node-$(TARGET_PLATFORM)-$(TARGET_ARCH)-dependencies
-	./scripts/build/dependencies-npm.sh -p -f \
-		-r "$(TARGET_ARCH)" \
-		-v "$(NODE_VERSION)" \
-		-x $| \
-		-t node \
-		-s "$(TARGET_PLATFORM)"
-
-$(BUILD_DIRECTORY)/electron-$(TARGET_PLATFORM)-$(APPLICATION_VERSION)-$(TARGET_ARCH)-app: \
-	$(BUILD_DIRECTORY)/electron-$(TARGET_PLATFORM)-$(TARGET_ARCH)-dependencies/node_modules \
-	| $(BUILD_DIRECTORY) $(BUILD_TEMPORARY_DIRECTORY)
-	./scripts/build/electron-create-resources-app.sh -s . -o $@ \
-		-v $(APPLICATION_VERSION) \
-		-f "$(APPLICATION_FILES)"
-	cp -RLf $< $@
-
-ifdef ANALYTICS_SENTRY_TOKEN
-	./scripts/build/jq-insert.sh \
-		-p ".analytics.sentry.token" \
-		-v "$(ANALYTICS_SENTRY_TOKEN)" \
-		-f $@/package.json \
-		-t $(BUILD_TEMPORARY_DIRECTORY)
-endif
-
-ifdef ANALYTICS_MIXPANEL_TOKEN
-	./scripts/build/jq-insert.sh \
-		-p ".analytics.mixpanel.token" \
-		-v "$(ANALYTICS_MIXPANEL_TOKEN)" \
-		-f $@/package.json \
-		-t $(BUILD_TEMPORARY_DIRECTORY)
-endif
-
-$(BUILD_DIRECTORY)/electron-$(TARGET_PLATFORM)-$(APPLICATION_VERSION)-$(TARGET_ARCH)-app.asar: \
-	$(BUILD_DIRECTORY)/electron-$(TARGET_PLATFORM)-$(APPLICATION_VERSION)-$(TARGET_ARCH)-app \
-	| $(BUILD_DIRECTORY)
-	./scripts/build/electron-create-asar.sh -d $< -o $@
-
-$(BUILD_DIRECTORY)/electron-$(ELECTRON_VERSION)-$(TARGET_PLATFORM)-$(TARGET_ARCH).zip: \
-	| $(BUILD_DIRECTORY)
-	./scripts/build/electron-download-package.sh \
-		-r "$(TARGET_ARCH)" \
-		-v "$(ELECTRON_VERSION)" \
-		-s "$(TARGET_PLATFORM)" \
-		-o $@
-
-$(BUILD_DIRECTORY)/$(APPLICATION_NAME)-cli-$(TARGET_PLATFORM)-$(APPLICATION_VERSION)-$(TARGET_ARCH)-app: \
-	package.json lib \
-	$(BUILD_DIRECTORY)/node-$(TARGET_PLATFORM)-$(TARGET_ARCH)-dependencies/node_modules \
-	| $(BUILD_DIRECTORY)
-	mkdir $@
-	$(foreach prerequisite,$^,$(call execute-command,cp -rf $(prerequisite) $@))
-
-$(BUILD_DIRECTORY)/$(APPLICATION_NAME)-cli-$(TARGET_PLATFORM)-$(APPLICATION_VERSION)-$(TARGET_ARCH).js: \
-	$(BUILD_DIRECTORY)/$(APPLICATION_NAME)-cli-$(TARGET_PLATFORM)-$(APPLICATION_VERSION)-$(TARGET_ARCH)-app \
-	| $(BUILD_DIRECTORY)
-	./scripts/build/concatenate-javascript.sh -e $</lib/cli/etcher.js -o $@
-
-$(BUILD_DIRECTORY)/$(APPLICATION_NAME)-cli-$(APPLICATION_VERSION)-$(TARGET_PLATFORM)-$(TARGET_ARCH): \
-	$(BUILD_DIRECTORY)/node-$(TARGET_PLATFORM)-$(TARGET_ARCH)-dependencies/node_modules \
-	$(BUILD_DIRECTORY)/$(APPLICATION_NAME)-cli-$(TARGET_PLATFORM)-$(APPLICATION_VERSION)-$(TARGET_ARCH).js \
-	| $(BUILD_DIRECTORY) $(BUILD_TEMPORARY_DIRECTORY)
-	./scripts/build/node-package-cli.sh -o $@ -l $< \
-		-n $(APPLICATION_NAME) \
-		-e $(word 2,$^) \
+electron-develop: | $(BUILD_TEMPORARY_DIRECTORY)
+	$(RESIN_SCRIPTS)/electron/install.sh \
+		-b $(shell pwd) \
 		-r $(TARGET_ARCH) \
-		-s $(TARGET_PLATFORM)
+		-s $(PLATFORM) \
+		-m $(NPM_VERSION)
 
-ifeq ($(TARGET_PLATFORM),win32)
-	./scripts/build/electron-brand-exe.sh \
-		-f $@/etcher.exe \
-		-n $(APPLICATION_NAME) \
-		-d "$(APPLICATION_DESCRIPTION)" \
-		-v "$(APPLICATION_VERSION)" \
-		-c "$(APPLICATION_COPYRIGHT)" \
-		-m "$(COMPANY_NAME)" \
-		-i assets/icon.ico \
-		-w $(BUILD_TEMPORARY_DIRECTORY)
-endif
+electron-test:
+	$(RESIN_SCRIPTS)/electron/test.sh \
+		-b $(shell pwd) \
+		-s $(PLATFORM)
 
-ifeq ($(TARGET_PLATFORM),darwin)
-ifdef CODE_SIGN_IDENTITY
-	./scripts/build/electron-sign-file-darwin.sh -f $@/etcher -i "$(CODE_SIGN_IDENTITY)"
-endif
-endif
+assets/dmg/background.tiff: assets/dmg/background.png assets/dmg/background@2x.png
+	tiffutil -cathidpicheck $^ -out $@
 
-ifeq ($(TARGET_PLATFORM),win32)
-ifdef CODE_SIGN_CERTIFICATE
-ifdef CODE_SIGN_CERTIFICATE_PASSWORD
-	./scripts/build/electron-sign-exe-win32.sh -f $@/etcher.exe \
-		-d "$(APPLICATION_NAME) - $(APPLICATION_VERSION)" \
-		-c $(CODE_SIGN_CERTIFICATE) \
-		-p $(CODE_SIGN_CERTIFICATE_PASSWORD)
-endif
-endif
-endif
-
-$(BUILD_DIRECTORY)/$(APPLICATION_NAME)-$(APPLICATION_VERSION)-$(TARGET_PLATFORM)-$(TARGET_ARCH): \
-	$(BUILD_DIRECTORY)/electron-$(TARGET_PLATFORM)-$(APPLICATION_VERSION)-$(TARGET_ARCH)-app.asar \
-	$(BUILD_DIRECTORY)/electron-$(ELECTRON_VERSION)-$(TARGET_PLATFORM)-$(TARGET_ARCH).zip \
-	| $(BUILD_DIRECTORY) $(BUILD_TEMPORARY_DIRECTORY)
-ifeq ($(TARGET_PLATFORM),darwin)
-	./scripts/build/electron-configure-package-darwin.sh -p $(word 2,$^) -a $< \
-		-n "$(APPLICATION_NAME)" \
-		-v "$(APPLICATION_VERSION)" \
-		-b "$(APPLICATION_BUNDLE_ID)" \
-		-c "$(APPLICATION_COPYRIGHT)" \
-		-t "$(APPLICATION_CATEGORY)" \
-		-i assets/icon.icns \
-		-o $@
-endif
-
-ifeq ($(TARGET_PLATFORM),linux)
-	./scripts/build/electron-configure-package-linux.sh -p $(word 2,$^) -a $< \
-		-n "$(APPLICATION_NAME)" \
-		-v "$(APPLICATION_VERSION)" \
-		-l LICENSE \
-		-o $@
-endif
-
-ifeq ($(TARGET_PLATFORM),win32)
-	./scripts/build/electron-configure-package-win32.sh -p $(word 2,$^) -a $< \
-		-n "$(APPLICATION_NAME)" \
-		-d "$(APPLICATION_DESCRIPTION)" \
-		-v "$(APPLICATION_VERSION)" \
-		-l LICENSE \
-		-c "$(APPLICATION_COPYRIGHT)" \
-		-m "$(COMPANY_NAME)" \
-		-i assets/icon.ico \
-		-w $(BUILD_TEMPORARY_DIRECTORY) \
-		-o $@
-ifdef CODE_SIGN_CERTIFICATE
-ifdef CODE_SIGN_CERTIFICATE_PASSWORD
-	./scripts/build/electron-sign-exe-win32.sh -f $@/$(APPLICATION_NAME).exe \
-		-d "$(APPLICATION_NAME) - $(APPLICATION_VERSION)" \
-		-c $(CODE_SIGN_CERTIFICATE) \
-		-p $(CODE_SIGN_CERTIFICATE_PASSWORD)
-endif
-endif
-endif
-
-$(BUILD_DIRECTORY)/$(APPLICATION_NAME)-$(APPLICATION_VERSION)-$(TARGET_PLATFORM)-$(TARGET_ARCH)-rw.dmg: \
-	$(BUILD_DIRECTORY)/$(APPLICATION_NAME)-$(APPLICATION_VERSION)-darwin-$(TARGET_ARCH) \
-	| $(BUILD_DIRECTORY)
-	./scripts/build/electron-create-readwrite-dmg-darwin.sh -p $< -o $@ \
-		-n "$(APPLICATION_NAME)" \
-		-i assets/icon.icns \
-		-b assets/osx/installer.png
-
-$(BUILD_OUTPUT_DIRECTORY)/$(APPLICATION_NAME)-$(APPLICATION_VERSION)-darwin-$(TARGET_ARCH).zip: \
-	$(BUILD_DIRECTORY)/$(APPLICATION_NAME)-$(APPLICATION_VERSION)-darwin-$(TARGET_ARCH) \
-	| $(BUILD_OUTPUT_DIRECTORY)
-ifdef CODE_SIGN_IDENTITY
-	./scripts/build/electron-sign-app-darwin.sh -a $</$(APPLICATION_NAME).app -i "$(CODE_SIGN_IDENTITY)"
-endif
-	./scripts/build/electron-installer-app-zip-darwin.sh -a $</$(APPLICATION_NAME).app -o $@
-
-$(BUILD_OUTPUT_DIRECTORY)/$(APPLICATION_NAME)-$(APPLICATION_VERSION)-darwin-$(TARGET_ARCH).dmg: \
-	$(BUILD_DIRECTORY)/$(APPLICATION_NAME)-$(APPLICATION_VERSION)-$(TARGET_PLATFORM)-$(TARGET_ARCH)-rw.dmg \
-	| $(BUILD_OUTPUT_DIRECTORY)
-ifdef CODE_SIGN_IDENTITY
-	./scripts/build/electron-sign-dmg-darwin.sh \
-		-n "$(APPLICATION_NAME)" \
-		-d $< \
-		-i "$(CODE_SIGN_IDENTITY)"
-endif
-	./scripts/build/electron-create-readonly-dmg-darwin.sh -d $< -o $@
-
-$(BUILD_DIRECTORY)/$(APPLICATION_NAME)-$(APPLICATION_VERSION)-linux-$(TARGET_ARCH).AppDir: \
-	$(BUILD_DIRECTORY)/$(APPLICATION_NAME)-$(APPLICATION_VERSION)-linux-$(TARGET_ARCH) \
-	| $(BUILD_DIRECTORY)
-	./scripts/build/electron-create-appdir.sh -p $< -o $@ \
-		-n "$(APPLICATION_NAME)" \
-		-d "$(APPLICATION_DESCRIPTION)" \
-		-r "$(TARGET_ARCH)" \
-		-b "$(APPLICATION_NAME_LOWERCASE)" \
-		-i assets/icon.png
-
-$(BUILD_DIRECTORY)/$(APPLICATION_NAME)-$(APPLICATION_VERSION)-linux-$(TARGET_ARCH).AppImage: \
-	$(BUILD_DIRECTORY)/$(APPLICATION_NAME)-$(APPLICATION_VERSION)-linux-$(TARGET_ARCH).AppDir \
-	| $(BUILD_DIRECTORY) $(BUILD_TEMPORARY_DIRECTORY)
-	./scripts/build/electron-create-appimage-linux.sh -d $< -o $@ \
-		-r "$(TARGET_ARCH)" \
-		-w "$(BUILD_TEMPORARY_DIRECTORY)"
-
-$(BUILD_OUTPUT_DIRECTORY)/$(APPLICATION_NAME)-$(APPLICATION_VERSION)-linux-$(TARGET_ARCH).zip: \
-	$(BUILD_DIRECTORY)/$(APPLICATION_NAME)-$(APPLICATION_VERSION)-linux-$(TARGET_ARCH).AppImage \
-	| $(BUILD_OUTPUT_DIRECTORY)
-	./scripts/build/electron-installer-appimage-zip.sh -i $< -o $@
-
-$(BUILD_OUTPUT_DIRECTORY)/$(APPLICATION_NAME_LOWERCASE)-electron_$(APPLICATION_VERSION_DEBIAN)_$(TARGET_ARCH_DEBIAN).deb: \
-	$(BUILD_DIRECTORY)/$(APPLICATION_NAME)-$(APPLICATION_VERSION)-linux-$(TARGET_ARCH) \
-	| $(BUILD_OUTPUT_DIRECTORY)
-	./scripts/build/electron-installer-debian-linux.sh -p $< -r "$(TARGET_ARCH)" -o $| \
-		-c scripts/build/debian/config.json
-
-$(BUILD_OUTPUT_DIRECTORY)/$(APPLICATION_NAME)-$(APPLICATION_VERSION)-win32-$(TARGET_ARCH).zip: \
-	$(BUILD_DIRECTORY)/$(APPLICATION_NAME)-$(APPLICATION_VERSION)-win32-$(TARGET_ARCH) \
-	| $(BUILD_OUTPUT_DIRECTORY)
-	./scripts/build/electron-installer-zip-win32.sh -a $< -o $@
-
-$(BUILD_OUTPUT_DIRECTORY)/$(APPLICATION_NAME)-$(APPLICATION_VERSION)-win32-$(TARGET_ARCH).exe: \
-	$(BUILD_DIRECTORY)/$(APPLICATION_NAME)-$(APPLICATION_VERSION)-win32-$(TARGET_ARCH) \
-	| $(BUILD_OUTPUT_DIRECTORY) $(BUILD_TEMPORARY_DIRECTORY)
-	./scripts/build/electron-installer-nsis-win32.sh -n $(APPLICATION_NAME) -a $< -t $(BUILD_TEMPORARY_DIRECTORY) -o $@
-
-ifdef CODE_SIGN_CERTIFICATE
-ifdef CODE_SIGN_CERTIFICATE_PASSWORD
-	./scripts/build/electron-sign-exe-win32.sh -f $@ \
-		-d "$(APPLICATION_NAME) - $(APPLICATION_VERSION)" \
-		-c $(CODE_SIGN_CERTIFICATE) \
-		-p $(CODE_SIGN_CERTIFICATE_PASSWORD)
-endif
-endif
+electron-build: assets/dmg/background.tiff | $(BUILD_TEMPORARY_DIRECTORY)
+	$(RESIN_SCRIPTS)/electron/build.sh \
+		-b $(shell pwd) \
+		-r $(TARGET_ARCH) \
+		-s $(PLATFORM) \
+		-v production \
+		-n $(BUILD_TEMPORARY_DIRECTORY)/npm
 
 # ---------------------------------------------------------------------
 # Phony targets
@@ -414,123 +123,84 @@ endif
 TARGETS = \
 	help \
 	info \
+	lint \
+	lint-ts \
+	lint-sass \
+	lint-cpp \
+	lint-spell \
+	test-spectron \
+	test-gui \
+	test \
 	sanity-checks \
 	clean \
 	distclean \
-	package-electron \
-	package-cli \
-	cli-develop \
-	electron-develop
+	webpack \
+	electron-develop \
+	electron-test \
+	electron-build
 
-package-electron: $(BUILD_DIRECTORY)/$(APPLICATION_NAME)-$(APPLICATION_VERSION)-$(TARGET_PLATFORM)-$(TARGET_ARCH)
-package-cli: $(BUILD_DIRECTORY)/$(APPLICATION_NAME)-cli-$(APPLICATION_VERSION)-$(TARGET_PLATFORM)-$(TARGET_ARCH)
-
-ifeq ($(TARGET_PLATFORM),darwin)
-electron-installer-app-zip: $(BUILD_OUTPUT_DIRECTORY)/$(APPLICATION_NAME)-$(APPLICATION_VERSION)-$(TARGET_PLATFORM)-$(TARGET_ARCH).zip
-electron-installer-dmg: $(BUILD_OUTPUT_DIRECTORY)/$(APPLICATION_NAME)-$(APPLICATION_VERSION)-$(TARGET_PLATFORM)-$(TARGET_ARCH).dmg
-TARGETS += \
-	electron-installer-dmg \
-	electron-installer-app-zip
-PUBLISH_AWS_S3 += \
-	$(BUILD_OUTPUT_DIRECTORY)/$(APPLICATION_NAME)-$(APPLICATION_VERSION)-$(TARGET_PLATFORM)-$(TARGET_ARCH).zip \
-	$(BUILD_OUTPUT_DIRECTORY)/$(APPLICATION_NAME)-$(APPLICATION_VERSION)-$(TARGET_PLATFORM)-$(TARGET_ARCH).dmg
-endif
-
-ifeq ($(TARGET_PLATFORM),linux)
-electron-installer-appimage: $(BUILD_OUTPUT_DIRECTORY)/$(APPLICATION_NAME)-$(APPLICATION_VERSION)-$(TARGET_PLATFORM)-$(TARGET_ARCH).zip
-electron-installer-debian: $(BUILD_OUTPUT_DIRECTORY)/$(APPLICATION_NAME_LOWERCASE)-electron_$(APPLICATION_VERSION_DEBIAN)_$(TARGET_ARCH_DEBIAN).deb
-TARGETS +=  \
-	electron-installer-appimage \
-	electron-installer-debian
-PUBLISH_AWS_S3 += \
-	$(BUILD_OUTPUT_DIRECTORY)/$(APPLICATION_NAME)-$(APPLICATION_VERSION)-$(TARGET_PLATFORM)-$(TARGET_ARCH).zip
-PUBLISH_BINTRAY_DEBIAN += \
-	$(BUILD_OUTPUT_DIRECTORY)/$(APPLICATION_NAME_LOWERCASE)-electron_$(APPLICATION_VERSION_DEBIAN)_$(TARGET_ARCH_DEBIAN).deb
-endif
-
-ifeq ($(TARGET_PLATFORM),win32)
-electron-installer-zip: $(BUILD_OUTPUT_DIRECTORY)/$(APPLICATION_NAME)-$(APPLICATION_VERSION)-$(TARGET_PLATFORM)-$(TARGET_ARCH).zip
-electron-installer-nsis: $(BUILD_OUTPUT_DIRECTORY)/$(APPLICATION_NAME)-$(APPLICATION_VERSION)-win32-$(TARGET_ARCH).exe
-TARGETS += \
-	electron-installer-zip \
-	electron-installer-nsis
-PUBLISH_AWS_S3 += \
-	$(BUILD_OUTPUT_DIRECTORY)/$(APPLICATION_NAME)-$(APPLICATION_VERSION)-$(TARGET_PLATFORM)-$(TARGET_ARCH).zip \
-	$(BUILD_OUTPUT_DIRECTORY)/$(APPLICATION_NAME)-$(APPLICATION_VERSION)-win32-$(TARGET_ARCH).exe
-endif
-
-ifdef PUBLISH_AWS_S3
-publish-aws-s3: $(PUBLISH_AWS_S3)
-ifeq ($(RELEASE_TYPE),production)
-	$(foreach publishable,$^,$(call execute-command,./scripts/publish/aws-s3.sh \
-		-f $(publishable) \
-		-b $(S3_BUCKET) \
-		-v $(APPLICATION_VERSION) \
-		-p $(PRODUCT_NAME)))
-endif
-ifeq ($(RELEASE_TYPE),snapshot)
-	$(foreach publishable,$^,$(call execute-command,./scripts/publish/aws-s3.sh \
-		-f $(publishable) \
-		-b $(S3_BUCKET) \
-		-v $(APPLICATION_VERSION) \
-		-p $(PRODUCT_NAME) \
-		-k $(shell date +"%Y-%m-%d")))
-endif
-
-TARGETS += publish-aws-s3
-endif
-
-ifdef PUBLISH_BINTRAY_DEBIAN
-publish-bintray-debian: $(PUBLISH_BINTRAY_DEBIAN)
-	$(foreach publishable,$^,$(call execute-command,./scripts/publish/bintray-debian.sh \
-		-f $(publishable) \
-		-v $(APPLICATION_VERSION_DEBIAN) \
-		-r $(TARGET_ARCH) \
-		-c $(APPLICATION_NAME_LOWERCASE) \
-		-t $(RELEASE_TYPE)))
-
-TARGETS += publish-bintray-debian
-endif
+webpack:
+	./node_modules/.bin/webpack
 
 .PHONY: $(TARGETS)
 
-cli-develop:
-	./scripts/build/dependencies-npm.sh \
-		-r "$(TARGET_ARCH)" \
-		-v "$(ELECTRON_VERSION)" \
-		-t node \
-		-s "$(TARGET_PLATFORM)"
+sass:
+	npm rebuild node-sass
+	node-sass lib/gui/app/scss/main.scss > lib/gui/css/main.css
 
-electron-develop:
-	./scripts/build/dependencies-npm.sh \
-		-r "$(TARGET_ARCH)" \
-		-v "$(ELECTRON_VERSION)" \
-		-t electron \
-		-s "$(TARGET_PLATFORM)"
+lint-ts:
+	resin-lint --fix --typescript typings lib tests scripts/clean-shrinkwrap.ts webpack.config.ts
+
+lint-sass:
+	sass-lint lib/gui/scss
+
+lint-cpp:
+	cpplint --recursive src
+
+lint-spell:
+	codespell \
+		--dictionary - \
+		--dictionary dictionary.txt \
+		--skip *.svg *.gz,*.bz2,*.xz,*.zip,*.img,*.dmg,*.iso,*.rpi-sdcard,*.wic,.DS_Store,*.dtb,*.dtbo,*.dat,*.elf,*.bin,*.foo,xz-without-extension \
+		lib tests docs Makefile *.md LICENSE
+
+lint: lint-ts lint-sass lint-cpp lint-spell
+
+MOCHA_OPTIONS=--recursive --reporter spec --require ts-node/register
+
+# See https://github.com/electron/spectron/issues/127
+ETCHER_SPECTRON_ENTRYPOINT ?= $(shell node -e 'console.log(require("electron"))')
+test-spectron:
+	ETCHER_SPECTRON_ENTRYPOINT="$(ETCHER_SPECTRON_ENTRYPOINT)" mocha $(MOCHA_OPTIONS) tests/spectron/runner.spec.ts
+
+test-gui:
+	electron-mocha $(MOCHA_OPTIONS) --full-trace --no-sandbox --renderer tests/gui/**/*.ts
+
+test-sdk:
+	electron-mocha $(MOCHA_OPTIONS) --full-trace --no-sandbox tests/shared/**/*.ts
+
+test: test-gui test-sdk test-spectron
 
 help:
 	@echo "Available targets: $(TARGETS)"
 
 info:
-	@echo "Application version : $(APPLICATION_VERSION)"
-	@echo "Release type        : $(RELEASE_TYPE)"
-	@echo "Host platform       : $(HOST_PLATFORM)"
+	@echo "Platform            : $(PLATFORM)"
 	@echo "Host arch           : $(HOST_ARCH)"
-	@echo "Target platform     : $(TARGET_PLATFORM)"
 	@echo "Target arch         : $(TARGET_ARCH)"
 
 sanity-checks:
-	./scripts/ci/ensure-all-node-requirements-available.sh
 	./scripts/ci/ensure-staged-sass.sh
-	./scripts/ci/ensure-npm-dependencies-compatibility.sh
-	./scripts/ci/ensure-npm-shrinkwrap-versions.sh
 	./scripts/ci/ensure-all-file-extensions-in-gitattributes.sh
-	./scripts/ci/ensure-all-text-files-only-ascii.sh
 
 clean:
 	rm -rf $(BUILD_DIRECTORY)
 
 distclean: clean
 	rm -rf node_modules
+	rm -rf build
+	rm -rf dist
+	rm -rf generated
+	rm -rf $(BUILD_TEMPORARY_DIRECTORY)
 
 .DEFAULT_GOAL = help

README.md

@@ -1,70 +1,109 @@
-Etcher
-======
+# Etcher
 
 > Flash OS images to SD cards & USB drives, safely and easily.
 
 Etcher is a powerful OS image flasher built with web technologies to ensure
 flashing an SDCard or USB drive is a pleasant and safe experience. It protects
 you from accidentally writing to your hard-drives, ensures every byte of data
-was written correctly and much more.
+was written correctly and much more. It can also flash directly Raspberry Pi devices that support the usbboot protocol
 
-[![dependencies](https://david-dm.org/resin-io/etcher.svg)](https://david-dm.org/resin-io/etcher.svg)
-[![Build Status](https://travis-ci.org/resin-io/etcher.svg?branch=master)](https://travis-ci.org/resin-io/etcher)
-[![Build status](https://ci.appveyor.com/api/projects/status/e745k1gt39nik0t7/branch/master?svg=true)](https://ci.appveyor.com/project/resin-io/etcher/branch/master)
-[![Gitter](https://badges.gitter.im/resin-io/etcher.svg)](https://gitter.im/resin-io/etcher?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge)
-[![Stories in Ready](https://badge.waffle.io/resin-io/etcher.svg?label=in%20progress&title=In%20Progress)](https://waffle.io/resin-io/etcher)
+[![Current Release](https://img.shields.io/github/release/balena-io/etcher.svg?style=flat-square)](https://balena.io/etcher)
+[![License](https://img.shields.io/github/license/balena-io/etcher.svg?style=flat-square)](https://github.com/balena-io/etcher/blob/master/LICENSE)
+[![Dependency status](https://img.shields.io/david/balena-io/etcher.svg?style=flat-square)](https://david-dm.org/balena-io/etcher)
+[![Balena.io Forums](https://img.shields.io/discourse/https/forums.balena.io/topics.svg?style=flat-square&label=balena.io%20forums)](https://forums.balena.io/c/etcher)
 
 ***
 
-[**Download**][etcher] | [**Support**][SUPPORT] | [**Documentation**][USER-DOCUMENTATION] | [**Contributing**][CONTRIBUTING] | [**Roadmap**][milestones] | [**CLI**][CLI]
+[**Download**][etcher] | [**Support**][SUPPORT] | [**Documentation**][USER-DOCUMENTATION] | [**Contributing**][CONTRIBUTING] | [**Roadmap**][milestones]
 
-![Etcher](https://raw.githubusercontent.com/resin-io/etcher/master/screenshot.png)
-
-Supported Operating Systems
----------------------------
+## Supported Operating Systems
 
 - Linux (most distros)
-- macOS 10.9 and later
+- macOS 10.10 (Yosemite) and later
 - Microsoft Windows 7 and later
 
 Note that Etcher will run on any platform officially supported by
 [Electron][electron]. Read more in their
 [documentation][electron-supported-platforms].
 
-Installers
-----------
+## Installers
 
 Refer to the [downloads page][etcher] for the latest pre-made
 installers for all supported operating systems.
 
 #### Debian and Ubuntu based Package Repository (GNU/Linux x86/x64)
 
-1. Save the following as `/etc/apt/sources.list.d/etcher.list`:
+1. Add Etcher debian repository:
 
-    ```
-    deb https://dl.bintray.com/resin-io/debian stable etcher
+    ```sh
+    echo "deb https://deb.etcher.io stable etcher" | sudo tee /etc/apt/sources.list.d/balena-etcher.list
     ```
 
 2. Trust Bintray.com's GPG key:
 
     ```sh
-    sudo apt-key adv --keyserver hkp://pgp.mit.edu:80 --recv-keys 379CE192D401AB61
+    sudo apt-key adv --keyserver keyserver.ubuntu.com --recv-keys 379CE192D401AB61
     ```
 
 3. Update and install:
 
     ```sh
     sudo apt-get update
-    sudo apt-get install etcher-electron
+    sudo apt-get install balena-etcher-electron
     ```
 
 ##### Uninstall
 
 ```sh
-sudo apt-get remove etcher-electron
-sudo rm /etc/apt/sources.list.d/etcher.list
+sudo apt-get remove balena-etcher-electron
+sudo rm /etc/apt/sources.list.d/balena-etcher.list
 sudo apt-get update
 ```
+#### Redhat (RHEL) and Fedora based Package Repository (GNU/Linux x86/x64)
+
+1. Add Etcher rpm repository:
+
+    ```sh
+    sudo wget https://balena.io/etcher/static/etcher-rpm.repo -O /etc/yum.repos.d/etcher-rpm.repo
+    ```
+
+2. Update and install:
+
+    ```sh
+    sudo yum install -y balena-etcher-electron
+    ```
+    or
+    ```sh
+    sudo dnf install -y balena-etcher-electron
+    ```
+
+##### Uninstall
+
+```sh
+sudo yum remove -y balena-etcher-electron
+sudo rm /etc/yum.repos.d/etcher-rpm.repo
+sudo yum clean all
+sudo yum makecache fast
+```
+or
+```sh
+sudo dnf remove -y balena-etcher-electron
+sudo rm /etc/yum.repos.d/etcher-rpm.repo
+sudo dnf clean all
+sudo dnf makecache
+```
+
+#### Solus (GNU/Linux x64)
+
+```sh
+sudo eopkg it etcher
+```
+
+##### Uninstall
+
+```sh
+sudo eopkg rm etcher
+```
 
 #### Brew Cask (macOS)
 
@@ -73,34 +112,46 @@ so it might not refer to the latest version immediately after an Etcher
 release.
 
 ```sh
-brew cask install etcher
+brew cask install balenaetcher
 ```
 
 ##### Uninstall
 
 ```sh
-brew cask uninstall etcher
+brew cask uninstall balenaetcher
 ```
 
-Support
--------
+#### Chocolatey (Windows)
+
+This package is maintained by [@majkinetor](https://github.com/majkinetor), and
+is kept up to date automatically.
+
+```sh
+choco install etcher
+```
+
+##### Uninstall
+
+```sh
+choco uninstall etcher
+```
+
+## Support
 
 If you're having any problem, please [raise an issue][newissue] on GitHub and
-the resin.io team will be happy to help.
+the balena.io team will be happy to help.
 
-License
--------
+## License
 
 Etcher is free software, and may be redistributed under the terms specified in
 the [license].
 
-[etcher]: https://etcher.io
-[electron]: http://electron.atom.io
-[electron-supported-platforms]: http://electron.atom.io/docs/tutorial/supported-platforms/
-[SUPPORT]: https://github.com/resin-io/etcher/blob/master/SUPPORT.md
-[CONTRIBUTING]: https://github.com/resin-io/etcher/blob/master/docs/CONTRIBUTING.md
-[CLI]: https://github.com/resin-io/etcher/blob/master/docs/CLI.md
-[USER-DOCUMENTATION]: https://github.com/resin-io/etcher/blob/master/docs/USER-DOCUMENTATION.md
-[milestones]: https://github.com/resin-io/etcher/milestones
-[newissue]: https://github.com/resin-io/etcher/issues/new
-[license]: https://github.com/resin-io/etcher/blob/master/LICENSE
+[etcher]: https://balena.io/etcher
+[electron]: https://electronjs.org/
+[electron-supported-platforms]: https://electronjs.org/docs/tutorial/support#supported-platforms
+[SUPPORT]: https://github.com/balena-io/etcher/blob/master/SUPPORT.md
+[CONTRIBUTING]: https://github.com/balena-io/etcher/blob/master/docs/CONTRIBUTING.md
+[USER-DOCUMENTATION]: https://github.com/balena-io/etcher/blob/master/docs/USER-DOCUMENTATION.md
+[milestones]: https://github.com/balena-io/etcher/milestones
+[newissue]: https://github.com/balena-io/etcher/issues/new
+[license]: https://github.com/balena-io/etcher/blob/master/LICENSE

SUPPORT.md

@@ -4,12 +4,13 @@ Getting help with Etcher
 There are various ways to get support for Etcher if you experience an issue or
 have an idea you'd like to share with us.
 
-Gitter
+Forums
 ------
 
-We have a [Gitter chat room][gitter] for Etcher which is open to everyone,
-please come join us :). Drop us a line there and the resin.io staff and
-community users will be happy to assist.
+We have a [Discourse forum][discourse] which is open to everyone, so please
+come join us :). Drop us a line there and the balena.io staff and community
+users will be happy to assist. Your question might already be answered, so take
+a look at the existing threads before opening a new one!
 
 Make sure to mention the following information to help us provide better
 support:
@@ -19,7 +20,7 @@ support:
 - The operating system you're running Etcher in.
 
 - Relevant logging output, if any, from DevTools, which you can open by
-  pressing `Ctrl+Alt+I` or `Cmd+Alt+I` depending on your platform.
+  pressing `Ctrl+Shift+I` or `Cmd+Alt+I` depending on your platform.
 
 GitHub
 ------
@@ -28,6 +29,6 @@ If you encounter an issue or have a suggestion, head on over to Etcher's [issue
 tracker][issues] and if there isn't a ticket covering it, [create
 one][new-issue].
 
-[gitter]: https://gitter.im/resin-io/etcher
-[issues]: https://github.com/resin-io/etcher/issues
-[new-issue]: https://github.com/resin-io/etcher/issues/new
+[discourse]: https://forums.balena.io/c/etcher
+[issues]: https://github.com/balena-io/etcher/issues
+[new-issue]: https://github.com/balena-io/etcher/issues/new

afterPack.js

@@ -0,0 +1,31 @@
+'use strict'
+
+const cp = require('child_process')
+const fs = require('fs')
+const outdent = require('outdent')
+const path = require('path')
+
+exports.default = function(context) {
+  if (context.packager.platform.name !== 'linux') {
+    return
+  }
+  const scriptPath = path.join(context.appOutDir, context.packager.executableName)
+  const binPath = scriptPath + '.bin'
+  cp.execFileSync('mv', [scriptPath, binPath])
+  fs.writeFileSync(
+    scriptPath,
+    outdent({trimTrailingNewline: false})`
+      #!/bin/bash
+
+      # Resolve symlinks. Warning, readlink -f doesn't work on MacOS/BSD
+      script_dir="$(dirname "$(readlink -f "\${BASH_SOURCE[0]}")")"
+
+      if [[ $EUID -ne 0 ]] || [[ $ELECTRON_RUN_AS_NODE ]]; then
+        "\${script_dir}"/${context.packager.executableName}.bin "$@"
+      else
+        "\${script_dir}"/${context.packager.executableName}.bin "$@" --no-sandbox
+      fi
+    `
+  )
+  cp.execFileSync('chmod', ['+x', scriptPath])
+}

afterSignHook.js

@@ -0,0 +1,22 @@
+'use strict'
+
+const { notarize } = require('electron-notarize')
+
+async function main(context) {
+  const { electronPlatformName, appOutDir } = context
+  if (electronPlatformName !== 'darwin') {
+    return
+  }
+
+  const appName = context.packager.appInfo.productFilename
+  const appleId = 'accounts+apple@balena.io'
+
+  await notarize({
+    appBundleId: 'io.balena.etcher',
+    appPath: `${appOutDir}/${appName}.app`,
+    appleId,
+    appleIdPassword: `@keychain:Application Loader: ${appleId}`
+  })
+}
+
+exports.default = main

appveyor.yml

@@ -1,59 +0,0 @@
-# appveyor file
-# http://www.appveyor.com/docs/appveyor-yml
-
-image: Visual Studio 2015
-
-cache:
-  - C:\Users\appveyor\.node-gyp
-  - '%AppData%\npm-cache'
-  - C:\ProgramData\chocolatey\bin -> appveyor.yml
-  - C:\ProgramData\chocolatey\lib -> appveyor.yml
-  - C:\Users\appveyor\AppData\Local\Temp\chocolatey -> appveyor.yml
-
-# what combinations to test
-environment:
-  global:
-    ELECTRON_NO_ATTACH_CONSOLE: true
-    nodejs_version: 6.1.0
-  matrix:
-    - TARGET_ARCH: x64
-    - TARGET_ARCH: x86
-
-clone_depth: 3
-
-matrix:
-  fast_finish: true
-
-install:
-  - ps: Install-Product node $env:nodejs_version x64
-  - npm install -g npm@4.4.4
-  - npm install -g rimraf asar
-  - choco install nsis -version 2.51
-  - choco install jq
-  - choco install curl
-  - set PATH=C:\Program Files (x86)\Windows Kits\8.1\bin\x86;%PATH%
-  - set PATH=C:\Program Files (x86)\NSIS;%PATH%
-  - set PATH=C:\MinGW\bin;%PATH%
-  - set PATH=C:\MinGW\msys\1.0\bin;%PATH%
-  - pip install codespell==1.9.2 awscli
-  - make info
-  - make electron-develop
-
-build: off
-
-test_script:
-  - node --version
-  - npm --version
-  - make sanity-checks
-  - cmd: npm test
-
-deploy_script:
-  - cmd: .\scripts\ci\deploy-appveyor.bat
-
-notifications:
-
-  - provider: Webhook
-    url: https://webhooks.gitter.im/e/0becb34b32e20d389bb8
-    on_build_success: false
-    on_build_failure: true
-    on_build_status_changed: true

bin/etcher

@@ -1,2 +0,0 @@
-#!/usr/bin/env node
-require('../lib/cli/etcher');

binding.gyp

@@ -0,0 +1,35 @@
+{
+  "targets": [
+    {
+      "target_name": "elevator",
+      "include_dirs" : [
+        "src",
+        "<!(node -e \"require('nan')\")"
+      ],
+      'conditions': [
+
+        [ 'OS=="win"', {
+          "sources": [
+            "src/utils/v8utils.cpp",
+            "src/os/win32/elevate.cpp",
+            "src/elevator_init.cpp",
+          ],
+          "libraries": [
+            "-lShell32.lib",
+          ],
+        } ],
+
+        [ 'OS=="mac"', {
+          "xcode_settings": {
+            "OTHER_CPLUSPLUSFLAGS": [
+              "-stdlib=libc++"
+            ],
+            "OTHER_LDFLAGS": [
+              "-stdlib=libc++"
+            ]
+          }
+        } ]
+      ],
+    }
+  ],
+}

dev-app-update.yml

@@ -0,0 +1,4 @@
+owner: balena-io
+repo: etcher
+provider: github
+updaterCacheDirName: balena-etcher-updater

dictionary

@@ -1,2 +0,0 @@
-boolen->boolean
-aknowledge->acknowledge

dictionary.txt

@@ -0,0 +1,9 @@
+boolen->boolean
+aknowledge->acknowledge
+seleted->selected
+reming->remind
+locl->local
+subsribe->subscribe
+unsubsribe->unsubscribe
+calcluate->calculate
+dictionaty->dictionary

docs/ARCHITECTURE.md

@@ -12,7 +12,6 @@ technologies used in Etcher that you should become familiar with:
 
 - [Electron][electron]
 - [NodeJS][nodejs]
-- [AngularJS][angularjs]
 - [Redux][redux]
 - [ImmutableJS][immutablejs]
 - [Bootstrap][bootstrap]
@@ -40,64 +39,18 @@ to submit their work or bug reports.
 
 These are the main Etcher components, in a nutshell:
 
-- [Etcher Image Write][etcher-image-write]
-
-This is the repository that implements the actual procedures to write an image
-to a raw device and the place where image validation resides. Its main purpose
-is to abstract the messy details of interacting with raw devices in all major
-operating systems.
-
-- [Etcher Image Stream](https://github.com/resin-io-modules/etcher-image-stream)
-
-The goal of this project is to convert any kind of input into a readable stream
-representing the image so it can be plugged to [etcher-image-write]. Inputs
-that this module might handle could be, for example: a simple image file, a URL
-to an image, a compressed image, an image inside a ZIP archive, etc. Together
-with [etcher-image-write], these modules are the building blocks needed to take
-an image representation to the user's device, the "Etcher's backend".
-
-- [Drivelist](https://github.com/resin-io-modules/drivelist)
+- [Drivelist](https://github.com/balena-io-modules/drivelist)
 
 As the name implies, this module's duty is to detect the connected drives
 uniformly in all major operating systems, along with valuable metadata, like if
 a drive is removable or not, to prevent users from trying to write an image to
 a system drive.
 
-- [Etcher](https://github.com/resin-io/etcher)
+- [Etcher](https://github.com/balena-io/etcher)
 
 This is the *"main repository"*, from which you're reading this from, which is
 basically the front-end and glue for all previously listed projects.
 
-Front-ends
-----------
-
-The main repository consists of the implementation of the Etcher CLI and the
-Etcher GUI (the desktop application), located at [`lib/cli/`][cli-dir] and
-[`lib/gui/`][gui-dir], respectively.
-
-In fact, the only front-end that interacts directly with Etcher's backend is
-the CLI. The GUI merely forks the CLI and communicates with its child process
-to get state information.
-
-In this sense, you can consider the GUI as being the front-end to the CLI,
-which is in turn the front-end to the actual image writing functionality.
-
-As a way to simplify how the GUI forks the CLI in a packaged and distributed
-context, both the CLI and GUI share the same application entry point. This
-means that the same Etcher binary can behave as CLI or GUI as needed.
-
-## Process communication
-
-As mentioned before, the Etcher GUI forks the CLI and retrieves information
-from it to update its state. In order to accomplish this, the Etcher CLI
-contains certain features to ease communication:
-
-- [Well-documented exit codes.][exit-codes]
-
-- An environment variable called `ETCHER_CLI_ROBOT` option, which when set
-  causes the Etcher CLI to output state in a way that can be easily
-  parsed by a machine.
-
 Summary
 -------
 
@@ -108,13 +61,10 @@ since fresh eyes could help unveil things that we take for granted, but should
 be documented instead!
 
 [lego-blocks]: https://github.com/sindresorhus/ama/issues/10#issuecomment-117766328
-[etcher-image-write]: https://github.com/resin-io-modules/etcher-image-write
-[exit-codes]: https://github.com/resin-io/etcher/blob/master/lib/shared/exit-codes.js
-[cli-dir]: https://github.com/resin-io/etcher/tree/master/lib/cli
-[gui-dir]: https://github.com/resin-io/etcher/tree/master/lib/gui
+[exit-codes]: https://github.com/balena-io/etcher/blob/master/lib/shared/exit-codes.js
+[gui-dir]: https://github.com/balena-io/etcher/tree/master/lib/gui
 [electron]: http://electron.atom.io
 [nodejs]: https://nodejs.org
-[angularjs]: https://angularjs.org
 [redux]: http://redux.js.org
 [immutablejs]: http://facebook.github.io/immutable-js/
 [bootstrap]: http://getbootstrap.com

docs/CLI.md

@@ -1,51 +0,0 @@
-Etcher CLI
-==========
-
-The Etcher CLI is a command-line tool that aims to provide all the benefits of
-the Etcher desktop application in a way that can be run from a terminal, or
-even used from a script.
-
-In fact, the Etcher desktop application is simply a wrapper around the CLI,
-which is the place where the actual writing logic takes place.
-
-Running
--------
-
-We are not oficially releasing the Etcher CLI as a separate package yet, but
-you can run it locally with the following steps:
-
-- Clone the Etcher repository.
-
-```
-git clone https://github.com/resin-io/etcher
-```
-
-- Install the dependencies by running:
-
-```sh
-npm install
-```
-
-- Run the Etcher CLI from `bin/etcher`.
-
-```
-./bin/etcher --help
-```
-
-Options
--------
-
-```
-  --help, -h     show help
-  --version, -v  show version number
-  --drive, -d    drive
-  --check, -c    validate write
-  --yes, -y      confirm non-interactively
-  --unmount, -u  unmount on success
-```
-
-Debug mode
-----------
-
-You can set the `ETCHER_CLI_DEBUG` environment variable to make the Etcher CLI
-print error stack traces.

docs/COMMIT-GUIDELINES.md

@@ -56,11 +56,6 @@ The scope is required for types that make sense, such as `feat`, `fix`,
 `test`, etc. Certain commit types, such as `chore` might not have a clearly
 defined scope, in which case its better to omit it.
 
-When it applies, the scope must be either `GUI` or `CLI`.
-
-A commit that takes part in both the GUI and CLI scopes, and makes more logical
-sense that way, might entirely omit the scope.
-
 Subject
 -------
 
@@ -122,8 +117,8 @@ A commit can include multiple instances of this tag.
 Examples:
 
 ```
-Closes: https://github.com/resin-io/etcher/issues/XXX
-Fixes: https://github.com/resin-io/etcher/issues/XXX
+Closes: https://github.com/balena-io/etcher/issues/XXX
+Fixes: https://github.com/balena-io/etcher/issues/XXX
 ```
 
 ### `Change-Type: <type>`
@@ -198,7 +193,7 @@ first non compressed extension.
 
 Change-Type: patch
 Changelog-Entry: Don't interpret image file name information between dots as image extensions.
-Fixes: https://github.com/resin-io/etcher/issues/492
+Fixes: https://github.com/balena-io/etcher/issues/492
 ```
 
 ***
@@ -212,8 +207,8 @@ the operating system still thinks the drive has a file system.
 
 Change-Type: patch
 Changelog-Entry: Upgrade `etcher-image-write` to v5.0.2.
-Link: https://github.com/resin-io-modules/etcher-image-write/blob/master/CHANGELOG.md#502---2016-06-27
-Fixes: https://github.com/resin-io/etcher/issues/531
+Link: https://github.com/balena-io-modules/etcher-image-write/blob/master/CHANGELOG.md#502---2016-06-27
+Fixes: https://github.com/balena-io/etcher/issues/531
 ```
 
 ***
@@ -243,7 +238,7 @@ re-used by other services.
 
 Change-Type: minor
 Changelog-Entry: Check for updates and show a modal prompting the user to download the latest version.
-Closes: https://github.com/resin-io/etcher/issues/396
+Closes: https://github.com/balena-io/etcher/issues/396
 ```
 
 [angular-commit-guidelines]: https://github.com/angular/angular.js/blob/master/CONTRIBUTING.md#commit

docs/CONTRIBUTING.md

@@ -10,18 +10,119 @@ High-level Etcher overview
 Make sure you checkout our [ARCHITECTURE.md][ARCHITECTURE] guide, which aims to
 explain how all the pieces fit together.
 
-Running locally
----------------
-
-See the [RUNNING-LOCALLY.md][RUNNING-LOCALLY] guide.
-
 Developing
 ----------
 
-We rely on various `npm` scripts to perform some common tasks:
+### Prerequisites
 
-- `npm run lint`: Run the linter.
-- `npm run sass`: Compile SCSS files.
+#### Common
+
+- [NodeJS](https://nodejs.org) (at least v6.11)
+- [Python 2.7](https://www.python.org)
+- [jq](https://stedolan.github.io/jq/)
+- [curl](https://curl.haxx.se/)
+- [npm](https://www.npmjs.com/) (version 6.7)
+
+```sh
+pip install -r requirements.txt
+```
+
+You might need to run this with `sudo` or administrator permissions.
+
+#### Windows
+
+- [NSIS v2.51](http://nsis.sourceforge.net/Main_Page) (v3.x won't work)
+- Either one of the following:
+  - [Visual C++ 2015 Build Tools](http://landinghub.visualstudio.com/visual-cpp-build-tools) containing standalone compilers, libraries and scripts
+  - Install the [windows-build-tools](https://github.com/felixrieseberg/windows-build-tools) via npm with `npm install --global windows-build-tools`
+  - [Visual Studio Community 2015](https://www.microsoft.com/en-us/download/details.aspx?id=48146) (free) (other editions, like Professional and Enterprise, should work too)
+    **NOTE:** Visual Studio 2015 doesn't install C++ by default. You have to rerun the
+    setup, select "Modify" and then check `Visual C++ -> Common Tools for Visual
+    C++ 2015` (see http://stackoverflow.com/a/31955339)
+- [MinGW](http://www.mingw.org)
+
+You might need to `npm config set msvs_version 2015` for node-gyp to correctly detect
+the version of Visual Studio you're using (in this example VS2015).
+
+The following MinGW packages are required:
+
+- `msys-make`
+- `msys-unzip`
+- `msys-zip`
+- `msys-bash`
+- `msys-coreutils`
+
+#### macOS
+
+- [Xcode](https://developer.apple.com/xcode/)
+
+It's not enough to have [Xcode Command Line Tools] installed. Xcode must be installed
+as well.
+
+#### Linux
+
+- `libudev-dev` for libusb (install with `sudo apt install libudev-dev` for example)
+
+### Cloning the project
+
+```sh
+git clone --recursive https://github.com/balena-io/etcher
+cd etcher
+```
+
+### Installing npm dependencies
+
+**NOTE:** Please make use of the following command to install npm dependencies rather
+than simply running `npm install` given that we need to do extra configuration
+to make sure native dependencies are correctly compiled for Electron, otherwise
+the application might not run successfully.
+
+If you're on Windows, **run the command from the _Developer Command Prompt for
+VS2015_**, to ensure all Visual Studio command utilities are available in the
+`%PATH%`.
+
+```sh
+make electron-develop
+```
+
+### Running the application
+
+#### GUI
+
+```sh
+# Build the GUI
+make webpack
+# Start Electron
+npm start
+```
+
+Testing
+-------
+
+To run the test suite, run the following command:
+
+```sh
+npm test
+```
+
+Given the nature of this application, not everything can be unit tested. For
+example:
+
+- The writing operating on real raw devices.
+- Platform inconsistencies.
+- Style changes.
+- Artwork.
+
+We encourage our contributors to test the application on as many operating
+systems as they can before sending a pull request.
+
+*The test suite is run automatically by CI servers when you send a pull
+request.*
+
+We also rely on various `make` targets to perform some common tasks:
+
+- `make lint`: Run the linter.
+- `make sass`: Compile SCSS files.
 
 We make use of [EditorConfig] to communicate indentation, line endings and
 other text editing default. We encourage you to install the relevant plugin in
@@ -46,28 +147,33 @@ Use the following steps to ensure everything goes flawlessly:
 
 - Commit *both* `package.json` and `npm-shrinkwrap.json`.
 
-Testing
--------
+Diffing Binaries
+----------------
 
-To run the test suite, run the following command:
+Binary files are tagged as "binary" in the `.gitattributes` file, but also have
+a `diff=hex` tag, which allows you to see hexdump-style diffs for binaries,
+if you add the following to either your global or repository-local git config:
 
 ```sh
-npm test
+$ git config diff.hex.textconv hexdump
+$ git config diff.hex.binary true
 ```
 
-Given the nature of this application, not everything can be unit tested. For
-example:
+And global, respectively:
 
-- The writing operating on real raw devices.
-- Platform inconsistencies.
-- Style changes.
-- Artwork.
+```sh
+$ git config --global diff.hex.textconv hexdump
+$ git config --global diff.hex.binary true
+```
 
-We encourage our contributors to test the application on as many operating
-systems as they can before sending a pull request.
+If you don't have `hexdump` available on your platform,
+you can try [hxd], which is also a bit faster.
 
-*The test suite is run automatically by CI servers when you send a pull
-request.*
+Commit Guidelines
+-----------------
+
+See [COMMIT-GUIDELINES.md][COMMIT-GUIDELINES] for a thorough guide on how to
+write commit messages.
 
 Sending a pull request
 ----------------------
@@ -95,7 +201,7 @@ Before your pull request can be merged, the following conditions must hold:
 
 - The linter doesn't throw any warning.
 
-- All the tests passes.
+- All the tests pass.
 
 - The coding style aligns with the project's convention.
 
@@ -104,7 +210,9 @@ systems we support.
 
 Don't hesitate to get in touch if you have any questions or need any help!
 
-[ARCHITECTURE]: https://github.com/resin-io/etcher/blob/master/docs/ARCHITECTURE.md
-[RUNNING-LOCALLY]: https://github.com/resin-io/etcher/blob/master/docs/RUNNING-LOCALLY.md
+[ARCHITECTURE]: https://github.com/balena-io/etcher/blob/master/docs/ARCHITECTURE.md
+[COMMIT-GUIDELINES]: https://github.com/balena-io/etcher/blob/master/docs/COMMIT-GUIDELINES.md
 [EditorConfig]: http://editorconfig.org
 [shrinkwrap]: https://docs.npmjs.com/cli/shrinkwrap
+[hxd]: https://github.com/jhermsmeier/hxd
+[Xcode Command Line Tools]: https://developer.apple.com/library/content/technotes/tn2339/_index.html

docs/MAINTAINERS.md

@@ -1,46 +1,174 @@
 Maintaining Etcher
 ==================
 
-This document is meant to serve as a guide for maintainers to perform common
-tasks.
+This document is meant to serve as a guide for maintainers to perform common tasks.
 
-Preparing a new version
------------------------
+Releasing
+---------
 
-- Bump the version number in the `package.json`'s `version` property.
+### Release Types
 
-- Bump the version number in the `package.json`'s `builder.win.version`
+- **snapshot** (default): A continues snapshot of current master, made by the CI services
+- **production**: Full releases
 
-- Bump the version number in the `npm-shrinkwrap.json`'s `version` property.
+### Flight Plan
 
-- Add a new entry to `CHANGELOG.md` by running `npm run changelog`.
+#### Preparation
 
-- Re-take `screenshot.png` so it displays the latest version in the bottom
-right corner.
+- [Prepare the new version](#preparing-a-new-version)
+- [Generate build artifacts](#generating-binaries) (binaries, archives, etc.)
+- [Draft a release on GitHub](https://github.com/balena-io/etcher/releases)
+    - Upload build artifacts to GitHub release draft
 
-- Commit the changes with the version number as the commit title, including the
-`v` prefix, to `master`. For example:
+#### Testing
 
-```sh
-git commit -m "v1.0.0" # not 1.0.0
+- Test the prepared release and build artifacts properly on **all supported operating systems** to prevent regressions that went uncaught by the CI tests (see [MANUAL-TESTING.md](MANUAL-TESTING.md))
+- If regressions or other issues arise, create issues on the repository for each one, and decide whether to fix them in this release (meaning repeating the process up until this point), or to follow up with a patch release
+
+#### Publishing
+
+- [Publish release draft on GitHub](https://github.com/balena-io/etcher/releases)
+- [Post release note to forums](https://forums.balena.io/c/etcher)
+- [Submit Windows binaries to Symantec for whitelisting](#submitting-binaries-to-symantec)
+- [Update the website](https://github.com/balena-io/etcher-homepage)
+- Wait 2-3 hours for analytics (Sentry, Mixpanel) to trickle in and check for elevated error rates, or regressions
+- If regressions arise; pull the release, and release a patched version, else:
+- [Upload deb & rpm packages to Bintray](#uploading-packages-to-bintray)
+- [Upload build artifacts to Amazon S3](#uploading-binaries-to-amazon-s3)
+- Post changelog with `#release-notes` tag on Flowdock
+- If this release packs noteworthy major changes:
+  - Write a blog post about it, and / or
+  - Write about it to the Etcher mailing list
+
+### Generating binaries
+
+**Environment**
+
+Make sure to set the analytics tokens when generating production release binaries:
+
+```bash
+export ANALYTICS_SENTRY_TOKEN="xxxxxx"
+export ANALYTICS_MIXPANEL_TOKEN="xxxxxx"
 ```
 
-- Create an annotated tag for the new version. The commit title should equal
-the annotated tag name. For example:
+#### Linux
 
-```sh
-git tag -a v1.0.0 -m "v1.0.0"
+##### Clean dist folder
+
+**NOTE:** Make sure to adjust the path as necessary (here the Etcher repository has been cloned to `/home/$USER/code/etcher`)
+
+```bash
+./scripts/build/docker/run-command.sh -r x64 -s . -c "make distclean"
 ```
 
-- Push the commit and the annotated tag.
+##### Generating artifacts
 
-```sh
-git push
-git push --tags
+```bash
+# x64
+
+# Build Debian packages
+./scripts/build/docker/run-command.sh -r x64 -s . -c "make electron-develop && make RELEASE_TYPE=production electron-installer-debian"
+# Build RPM packages
+./scripts/build/docker/run-command.sh -r x64 -s . -c "make electron-develop && make RELEASE_TYPE=production electron-installer-redhat"
+# Build AppImages
+./scripts/build/docker/run-command.sh -r x64 -s . -c "make electron-develop && make RELEASE_TYPE=production electron-installer-appimage"
+
+# x86
+
+# Build Debian packages
+./scripts/build/docker/run-command.sh -r x86 -s . -c "make electron-develop && make RELEASE_TYPE=production electron-installer-debian"
+# Build RPM packages
+./scripts/build/docker/run-command.sh -r x86 -s . -c "make electron-develop && make RELEASE_TYPE=production electron-installer-redhat"
+# Build AppImages
+./scripts/build/docker/run-command.sh -r x86 -s . -c "make electron-develop && make RELEASE_TYPE=production electron-installer-appimage"
 ```
 
-Upgrading Electron
-------------------
+#### Mac OS
 
-- Upgrade the `electron-prebuilt` dependency version in `package.json` to an
-*exact version* (no `~`, `^`, etc).
+**ATTENTION:** For production releases you'll need the code-signing key,
+and set `CSC_NAME` to generate signed binaries on Mac OS.
+
+```bash
+make electron-develop
+
+# Build the zip
+make RELEASE_TYPE=production electron-installer-app-zip
+# Build the dmg
+make RELEASE_TYPE=production electron-installer-dmg
+```
+
+#### Windows
+
+**ATTENTION:** For production releases you'll need the code-signing key,
+and set `CSC_LINK`, and `CSC_KEY_PASSWORD` to generate signed binaries on Windows.
+
+**NOTE:**
+- Keep in mind to also generate artifacts for x86, with `TARGET_ARCH=x86`.
+
+```bash
+make electron-develop
+
+# Build the Portable version
+make RELEASE_TYPE=production electron-installer-portable
+# Build the Installer
+make RELEASE_TYPE=production electron-installer-nsis
+```
+
+### Uploading packages to Bintray
+
+```bash
+export BINTRAY_USER="username@account"
+export BINTRAY_API_KEY="youruserapikey"
+```
+
+```bash
+./scripts/publish/bintray.sh -c "etcher" -t "production" -v "1.2.1" -o "etcher" -p "debian" -y "debian" -r "x64" -f "dist/etcher-electron_1.2.1_amd64.deb"
+./scripts/publish/bintray.sh -c "etcher" -t "production" -v "1.2.1" -o "etcher" -p "debian" -y "debian" -r "x86" -f "dist/etcher-electron_1.2.1_i386.deb"
+./scripts/publish/bintray.sh -c "etcher" -t "production" -v "1.2.1" -o "etcher" -p "redhat" -y "redhat" -r "x64" -f "dist/etcher-electron-1.2.1.x86_64.rpm"
+./scripts/publish/bintray.sh -c "etcher" -t "production" -v "1.2.1" -o "etcher" -p "redhat" -y "redhat" -r "x86" -f "dist/etcher-electron-1.2.1.i686.rpm"
+```
+
+### Uploading binaries to Amazon S3
+
+```bash
+export S3_KEY="..."
+```
+
+```bash
+./scripts/publish/aws-s3.sh -b "balena-production-downloads" -v "1.2.1" -p "etcher" -f "dist/<filename>"
+```
+
+### Dealing with a Problematic Release
+
+There can be times where a release is accidentally plagued with bugs. If you
+released a new version and notice the error rates are higher than normal, then
+revert the problematic release as soon as possible, until the bugs are fixed.
+
+You can revert a version by deleting its builds from the S3 bucket and Bintray.
+Refer to the `Makefile` for the up to date information about the S3 bucket
+where we push builds to, and get in touch with the balena.io operations team to
+get write access to it.
+
+The Etcher update notifier dialog and the website only show the a certain
+version if all the expected files have been uploaded to it, so deleting a
+single package or two is enough to bring down the whole version.
+
+Use the following command to delete files from S3:
+
+```bash
+aws s3api delete-object --bucket <bucket name> --key <file name>
+```
+
+The Bintray dashboard provides an easy way to delete a version's files.
+
+
+### Submitting binaries to Symantec
+
+- [Report a Suspected Erroneous Detection](https://submit.symantec.com/false_positive/standard/)
+- Fill out form:
+  - **Select Submission Type:** "Provide a direct download URL"
+  - **Name of the software being detected:** Etcher
+  - **Name of detection given by Symantec product:** WS.Reputation.1
+  - **Contact name:** Balena.io Ltd
+  - **E-mail address:** hello@etcher.io
+  - **Are you the creator or distributor of the software in question?** Yes

docs/MANUAL-TESTING.md

@@ -0,0 +1,115 @@
+Manual Testing
+==============
+
+This document describes a high-level script of manual tests to check for. We
+should aim to replace items on this list with automated Spectron test cases.
+
+Image Selection
+---------------
+
+- [ ] Cancel image selection dialog
+- [ ] Select an unbootable image (without a partition table), and expect a
+  sensible warning
+- [ ] Attempt to select a ZIP archive with more than one image
+- [ ] Attempt to select a tar archive (with any compression method)
+- [ ] Change image selection
+- [ ] Select a Windows image, and expect a sensible warning
+
+Drive Selection
+---------------
+
+- [ ] Open the drive selection modal
+- [ ] Switch drive selection
+- [ ] Insert a single drive, and expect auto-selection
+- [ ] Insert more than one drive, and don't expect auto-selection
+- [ ] Insert a locked SD Card and expect a warning
+- [ ] Insert a too small drive and expect a warning
+- [ ] Put an image into a drive and attempt to flash the image to the drive
+  that contains it
+- [ ] Attempt to flash a compressed image (for which we can get the
+  uncompressed size) into a drive that is big enough to hold the compressed
+  image, but not big enough to hold the uncompressed version
+- [ ] Enable "Unsafe Mode" and attempt to select a system drive
+- [ ] Enable "Unsafe Mode", and if there is only one system drive (and no
+  removable ones), don't expect autoselection
+
+Image Support
+-------------
+
+Run the following tests with and without validation enabled:
+
+- [ ] Flash an uncompressed image
+- [ ] Flash a Bzip2 image
+- [ ] Flash a XZ image
+- [ ] Flash a ZIP image
+- [ ] Flash a GZ image
+- [ ] Flash a DMG image
+- [ ] Flash an image whose size is not a multiple of 512 bytes
+- [ ] Flash a compressed image whose size is not a multiple of 512 bytes
+- [ ] Flash an archive whose image size is not a multiple of 512 bytes
+- [ ] Flash an archive image containing a logo
+- [ ] Flash an archive image containing a blockmap file
+- [ ] Flash an archive image containing a manifest metadata file
+
+Flashing Process
+----------------
+
+- [ ] Unplug the drive during flash or validation
+- [ ] Click "Flash", cancel elevation dialog, and click "Flash" again
+- [ ] Start flashing an image, try to close Etcher, cancel the application
+  close warning dialog, and check that Etcher continues to flash the image
+
+### Child Writer
+
+- [ ] Kill the child writer process (i.e. with `SIGINT` or `SIGKILL`), and
+  check that the UI reacts appropriately
+- [ ] Close the application while flashing using the window manager close icon
+- [ ] Close the application while flashing using the OS keyboard shortcut
+- [ ] Close the application from the terminal using Ctrl-C while flashing
+- [ ] Force kill the application (using a process monitor tool, etc)
+
+In all these cases, the child writer process should not remain alive. Note that
+in some systems you need to open your process monitor tool of choice with extra
+permissions to see the elevated child writer process.
+
+GUI
+----
+
+- [ ] Close application from the terminal using Ctrl-C while the application is
+  idle
+- [ ] Click footer links that take you to an external website
+- [ ] Attempt to change image or drive selection while flashing
+- [ ] Go to the settings page while flashing and come back
+- [ ] Flash consecutive images without closing the application
+- [ ] Remove the selected drive right before clicking "Flash"
+- [ ] Minimize the application
+- [ ] Start the application given no internet connection
+
+Success Banner
+--------------
+
+- [ ] Click an external link on the success banner (with and without internet
+  connection)
+
+Elevation Prompt
+----------------
+
+- [ ] Flash an image as `root`/administrator
+- [ ] Reject elevation prompt
+- [ ] Put incorrect elevation prompt password
+- [ ] Unplug the drive during elevation
+
+Unmounting
+----------
+
+- [ ] Disable unmounting and flash an image
+- [ ] Flash an image with a file system that is readable by the host OS, and
+  check that is unmounted correctly
+
+Analytics
+---------
+
+- [ ] Disable analytics, open DevTools Network pane or a packet sniffer, and
+  check that no request is sent
+- [ ] **Disable analytics, refresh application from DevTools (using Cmd-R or
+  F5), and check that initial events are not sent to Mixpanel**

docs/PUBLISHING.md

@@ -4,13 +4,55 @@ Publishing Etcher
 This is a small guide to package and publish Etcher to all supported operating
 systems.
 
+Release Types
+-------------
+
+Etcher supports **production** and **snapshot** release types. Each is
+published to a different S3 bucket, and production release types are code
+signed, while snapshot release types aren't and include a short git commit-hash
+as a build number. For example, `1.0.0-beta.19` is a production release type,
+while `1.0.0-beta.19+531ab82` is a snapshot release type.
+
+In terms of comparison: `1.0.0-beta.19` (production) < `1.0.0-beta.19+531ab82`
+(snapshot) < `1.0.0-rc.1` (production) < `1.0.0-rc.1+7fde24a` (snapshot) <
+`1.0.0` (production) < `1.0.0+2201e5f` (snapshot). Keep in mind that if you're
+running a production release type, you'll only be prompted to update to
+production release types, and if you're running a snapshot release type, you'll
+only be prompted to update to other snapshot release types.
+
+The build system creates (and publishes) snapshot release types by default, but
+you can build a specific release type by setting the `RELEASE_TYPE` make
+variable.  For example:
+
+```sh
+make <target> RELEASE_TYPE=snapshot
+make <target> RELEASE_TYPE=production
+```
+
+We can control the version range a specific Etcher version will consider when
+showing the update notification dialog by tweaking the `updates.semverRange`
+property of `package.json`.
+
+Update Channels
+---------------
+
+Etcher has a setting to include the unstable update channel. If this option is
+set, Etcher will consider both stable and unstable versions when showing the
+update notifier dialog. Unstable versions are the ones that contain a `beta`
+pre-release tag. For example:
+
+- Production unstable version: `1.4.0-beta.1`
+- Snapshot unstable version: `1.4.0-beta.1+7fde24a`
+- Production stable version: `1.4.0`
+- Snapshot stable version: `1.4.0+7fde24a`
+
 Signing
 -------
 
 ### OS X
 
 1. Get our Apple Developer ID certificate for signing applications distributed
-outside the Mac App Store from the resin.io Apple account.
+outside the Mac App Store from the balena.io Apple account.
 
 2. Install the Developer ID certificate to your Mac's Keychain by double
 clicking on the certificate file.
@@ -20,7 +62,7 @@ packaging for OS X.
 
 ### Windows
 
-1. Get access to our code signing certificate and decryption key as a resin.io
+1. Get access to our code signing certificate and decryption key as a balena.io
 employee by asking for it from the relevant people.
 
 2. Place the certificate in the root of the Etcher repository naming it
@@ -29,40 +71,31 @@ employee by asking for it from the relevant people.
 Packaging
 ---------
 
+The resulting installers will be saved to `dist/out`.
+
+Run the following commands:
 
 ### OS X
 
-Run the following command:
-
 ```sh
 make electron-installer-dmg
 make electron-installer-app-zip
 ```
 
-The resulting installers will be saved to `release/out`.
-
 ### GNU/Linux
 
-Run the following command:
-
 ```sh
 make electron-installer-appimage
 make electron-installer-debian
 ```
 
-The resulting installers will be saved to `release/out`.
-
 ### Windows
 
-Run the following command:
-
 ```sh
 make electron-installer-zip
 make electron-installer-nsis
 ```
 
-The resulting installers will be saved to `etcher-release/installers`.
-
 Publishing to Bintray
 ---------------------
 
@@ -76,7 +109,7 @@ Make sure you set the following environment variables:
 Run the following command:
 
 ```sh
-make publish-bintray-debian RELEASE_TYPE=<production|snapshot>
+make publish-bintray-debian
 ```
 
 Publishing to S3
@@ -85,17 +118,17 @@ Publishing to S3
 - [AWS CLI][aws-cli]
 
 Make sure you have the [AWS CLI tool][aws-cli] installed and configured to
-access resin.io's production or snapshot S3 bucket.
+access balena.io's production or snapshot S3 bucket.
 
 Run the following command to publish all files for the current combination of
 _platform_ and _arch_ (building them if necessary):
 
 ```sh
-make publish-aws-s3 RELEASE_TYPE=<production|snapshot>
+make publish-aws-s3
 ```
 
 Also add links to each AWS S3 file in [GitHub Releases][github-releases]. See
-[`v1.0.0-beta.17`](https://github.com/resin-io/etcher/releases/tag/v1.0.0-beta.17)
+[`v1.0.0-beta.17`](https://github.com/balena-io/etcher/releases/tag/v1.0.0-beta.17)
 as an example.
 
 Publishing to Homebrew Cask
@@ -110,14 +143,12 @@ Publishing to Homebrew Cask
 Announcing
 ----------
 
-Post messages to the [Etcher forum][resin-forum-etcher] and
-[Etcher gitter channel][gitter-etcher] announcing the new version
+Post messages to the [Etcher forum][balena-forum-etcher] announcing the new version
 of Etcher, and including the relevant section of the Changelog.
 
 [aws-cli]: https://aws.amazon.com/cli
 [bintray]: https://bintray.com
-[etcher-cask-file]: https://github.com/caskroom/homebrew-cask/blob/master/Casks/etcher.rb
+[etcher-cask-file]: https://github.com/caskroom/homebrew-cask/blob/master/Casks/balenaetcher.rb
 [homebrew-cask]: https://github.com/caskroom/homebrew-cask
-[resin-forum-etcher]: https://talk.resin.io/c/etcher/annoucements
-[gitter-etcher]: https://gitter.im/resin-io/etcher
-[github-releases]: https://github.com/resin-io/etcher/releases
+[balena-forum-etcher]: https://forums.balena.io/c/etcher
+[github-releases]: https://github.com/balena-io/etcher/releases

docs/RUNNING-LOCALLY.md

@@ -1,85 +0,0 @@
-Running locally
-===============
-
-This document aims to serve as a guide to get Etcher running locally on your
-development machine.
-
-Prerequisites
--------------
-
-### Common
-
-- [NodeJS](https://nodejs.org) (at least v6)
-- [Python](https://www.python.org)
-- [jq](https://stedolan.github.io/jq/)
-- [Asar](https://github.com/electron/asar)
-- [Codespell](https://github.com/lucasdemarchi/codespell)
-- [curl](https://curl.haxx.se/)
-
-### Windows
-
-- [Rimraf](https://github.com/isaacs/rimraf)
-- [NSIS v2.51](http://nsis.sourceforge.net/Main_Page) (v3.x won't work)
-- Either one of the following:
-  - [Visual C++ 2015 Build Tools](http://landinghub.visualstudio.com/visual-cpp-build-tools) containing standalone compilers, libraries and scripts
-  - Install the [windows-build-tools](https://github.com/felixrieseberg/windows-build-tools) via npm with `npm install --global windows-build-tools`
-  - [Visual Studio Community 2015](https://www.microsoft.com/en-us/download/details.aspx?id=48146) (free) (other editions, like Professional and Enterprise, should work too)
-    **NOTE:** Visual Studio 2015 doesn't install C++ by default. You have to rerun the
-    setup, select "Modify" and then check `Visual C++ -> Common Tools for Visual
-    C++ 2015` (see http://stackoverflow.com/a/31955339)
-- [MinGW](http://www.mingw.org)
-
-The following MinGW packages are required:
-
-- `msys-make`
-- `msys-unzip`
-- `msys-zip`
-- `msys-bash`
-- `msys-coreutils`
-
-### OS X
-
-- [XCode](https://developer.apple.com/xcode/)
-- [afsctool](https://brkirch.wordpress.com/afsctool/)
-
-Cloning the project
--------------------
-
-```sh
-git clone https://github.com/resin-io/etcher
-cd etcher
-```
-
-Installing npm dependencies
----------------------------
-
-**Make sure you have all the pre-requisites listed above installed in your
-system before running the `install` script.**
-
-Please make use of the following scripts to install npm dependencies rather
-than simply running `npm install` given that we need to do extra configuration
-to make sure native dependencies are correctly compiled for Electron, otherwise
-the application might not run successfully.
-
-If you're on Windows, **run the command from the _Developer Command Prompt for
-VS2015_**, to ensure all Visual Studio command utilities are available in the
-`%PATH%`.
-
-```sh
-make electron-develop
-```
-
-Running the application
------------------------
-
-### GUI
-
-```sh
-npm start
-```
-
-### CLI
-
-```sh
-node bin/etcher
-```

docs/USER-DOCUMENTATION.md

@@ -14,8 +14,8 @@ images, usually available from the image publishers themselves.
 
 Images known to require special treatment:
 
-- Microsoft Windows (use [Windows USB/DVD Download Tool][windows-usb-tool], or
-  [Rufus][rufus]).
+- Microsoft Windows (use [Windows USB/DVD Download Tool][windows-usb-tool], 
+  [Rufus][rufus], or [WoeUSB][woeusb]).
 
 - Windows 10 IoT (use the [Windows 10 IoT Core Dashboard][windows-iot-dashboard])
 
@@ -30,7 +30,7 @@ if you require this functionality, we advise to fallback to
 Deactivate desktop shortcut prompt on GNU/Linux
 -----------------------------------------------
 
-This is a feature provided by [AppImages](appimage), where the applications
+This is a feature provided by [AppImages][appimage], where the applications
 prompts the user to automatically register a desktop shortcut to easily access
 the application.
 
@@ -130,25 +130,6 @@ run Etcher on a GNU/Linux system.
 
 - liblzma (for xz decompression)
 
-Disable update notifications
-----------------------------
-
-You can disable update notifications, which can be useful when running Etcher
-outside a common desktop environment (like in a [resin.io] application), by
-setting the `ETCHER_DISABLE_UPDATES` environment variable.
-
-In GNU/Linux and Mac OS X:
-
-```sh
-export ETCHER_DISABLE_UPDATES=1
-```
-
-In Windows:
-
-```sh
-set ETCHER_DISABLE_UPDATES=1
-```
-
 Recovering broken drives
 ------------------------
 
@@ -210,20 +191,18 @@ Running in older macOS versions
 -------------------------------
 
 Etcher GUI is based on the [Electron][electron] framework, [which only supports
-macOS 10.9 and newer versions][electron-supported-platforms].
+macOS 10.10 (Yosemite) and newer versions][electron-supported-platforms].
 
-You can however, run the [Etcher CLI][etcher-cli], which should work in older
-platforms.
-
-[resin.io]: https://resin.io
+[balena.io]: https://balena.io
 [appimage]: http://appimage.org
 [xwayland]: https://wayland.freedesktop.org/xserver.html
 [weston.ini]: http://manpages.ubuntu.com/manpages/wily/man5/weston.ini.5.html
 [diskpart]: https://technet.microsoft.com/en-us/library/cc770877(v=ws.11).aspx
-[electron]: http://electron.atom.io
-[electron-supported-platforms]: https://github.com/electron/electron/blob/master/docs/tutorial/supported-platforms.md
-[etcher-cli]: https://github.com/resin-io/etcher/blob/master/docs/CLI.md
+[electron]: https://electronjs.org/
+[electron-supported-platforms]: https://electronjs.org/docs/tutorial/support#supported-platforms
+[publishing]: https://github.com/balena-io/etcher/blob/master/docs/PUBLISHING.md
 [windows-usb-tool]: https://www.microsoft.com/en-us/download/windows-usb-dvd-download-tool
 [rufus]: https://rufus.akeo.ie
 [unetbootin]: https://unetbootin.github.io
 [windows-iot-dashboard]: https://developer.microsoft.com/en-us/windows/iot/downloads
+[woeusb]: https://github.com/slacka/WoeUSB

docs/_config.yml

@@ -1 +0,0 @@
-theme: jekyll-theme-minimal

electron-builder.yml

@@ -0,0 +1,111 @@
+appId: io.balena.etcher
+copyright: Copyright 2016-2019 Balena Ltd
+productName: balenaEtcher
+npmRebuild: true
+nodeGypRebuild: true
+publish: null
+afterPack: "./afterPack.js"
+files:
+  - build/Release/elevator.node
+  - generated
+  - lib/shared/catalina-sudo/sudo-askpass.osascript.js
+  - lib/gui/app/index.html
+  - lib/gui/css/*.css
+  - lib/gui/css/fonts/*.woff2
+  - lib/gui/assets/*.svg
+  - assets/icon.png
+  - "!node_modules/**/**"
+  - "node_modules/**/*.js"
+  - "node_modules/**/*.json"
+  - "node_modules/**/*.node"
+  - "node_modules/**/*.dll"
+  - node_modules/node-raspberrypi-usbboot/blobs/**
+  - node_modules/flexboxgrid/dist/flexboxgrid.css
+  - node_modules/roboto-fontface/fonts/roboto/Roboto-Thin.woff
+  - node_modules/roboto-fontface/fonts/roboto/Roboto-Light.woff
+  - node_modules/roboto-fontface/fonts/roboto/Roboto-Regular.woff
+  - node_modules/roboto-fontface/fonts/roboto/Roboto-Medium.woff
+  - node_modules/roboto-fontface/fonts/roboto/Roboto-Bold.woff
+  - node_modules/bootstrap-sass/assets/fonts/bootstrap/glyphicons-halflings-regular.woff2
+mac:
+  asar: false
+  icon: assets/icon.icns
+  category: public.app-category.developer-tools
+  hardenedRuntime: true
+  entitlements: "entitlements.mac.plist"
+  entitlementsInherit: "entitlements.mac.plist"
+dmg:
+  background: assets/dmg/background.tiff
+  icon: assets/icon.icns
+  iconSize: 110
+  contents:
+    - x: 140
+      y: 225
+    - x: 415
+      y: 225
+      type: link
+      path: /Applications
+  window:
+    width: 540
+    height: 405
+win:
+  icon: assets/icon.ico
+nsis:
+  oneClick: true
+  runAfterFinish: true
+  installerIcon: assets/icon.ico
+  uninstallerIcon: assets/icon.ico
+  deleteAppDataOnUninstall: true
+  license: LICENSE
+  artifactName: "${productName}-Setup-${version}.${ext}"
+portable:
+  artifactName: "${productName}-Portable-${version}.${ext}"
+  requestExecutionLevel: user
+linux:
+  category: Utility
+  packageCategory: utils
+  executableName: balena-etcher-electron
+  synopsis: balenaEtcher is a powerful OS image flasher built with web technologies to ensure flashing an SDCard or USB drive is a pleasant and safe experience. It protects you from accidentally writing to your hard-drives, ensures every byte of data was written correctly and much more.
+  icon: assets/iconset
+deb:
+  priority: optional
+  depends:
+    - gconf2
+    - gconf-service
+    - libappindicator1
+    - libasound2
+    - libatk1.0-0
+    - libc6
+    - libcairo2
+    - libcups2
+    - libdbus-1-3
+    - libexpat1
+    - libfontconfig1
+    - libfreetype6
+    - libgcc1
+    - libgconf-2-4
+    - libgdk-pixbuf2.0-0
+    - libglib2.0-0
+    - libgtk-3-0
+    - liblzma5
+    - libnotify4
+    - libnspr4
+    - libnss3
+    - libpango1.0-0
+    - libstdc++6
+    - libx11-6
+    - libxcomposite1
+    - libxcursor1
+    - libxdamage1
+    - libxext6
+    - libxfixes3
+    - libxi6
+    - libxrandr2
+    - libxrender1
+    - libxss1
+    - libxtst6
+    - polkit-1-auth-agent | policykit-1-gnome | polkit-kde-1
+rpm:
+  depends:
+    - lsb
+    - libXScrnSaver

entitlements.mac.plist

@@ -0,0 +1,18 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+  <dict>
+    <key>com.apple.security.cs.allow-jit</key>
+    <true/>
+    <key>com.apple.security.cs.allow-unsigned-executable-memory</key>
+    <true/>
+    <key>com.apple.security.cs.allow-dyld-environment-variables</key>
+    <true/>
+    <key>com.apple.security.device.usb</key>
+    <true/>
+    <key>com.apple.security.files.user-selected.read-only</key>
+    <true/>
+    <key>com.apple.security.network.client</key>
+    <true/>
+  </dict>
+</plist>

lib/child-writer/README.md

@@ -1,69 +0,0 @@
-Etcher Child Writer
-===================
-
-This module is in charge of dealing with the gory details of elevating and
-managing the child writer process. As a word of warning, it contains tons of
-workarounds and "hacks" to deal with platform differences, packaging, and
-inter-process communication. This empowers us to write this small guide to
-explain how it works in a more high level manner, hoping to make it easier to
-grok for contributors.
-
-The problem
------------
-
-Elevating a forked process is an easy task. Thanks to the widely available NPM
-modules to display nice GUI prompt dialogs, elevation is just a matter of
-executing the process with one of those modules instead of with `child_process`
-directly.
-
-The main problems we faced are:
-
-- The modules that implement elevation provide "execution" support, but don't
-  allow us to fork/spawn the process and consume its `stdout` and `stderr` in a
-  stream fashion. This also means that we can't use the nice `process.send` IPC
-  communication channel directly that `child_process.fork` gives us to send
-  messages back to the parent.
-
-- Since we can't assume anything from the environment Etcher is running on, we
-  must make use of the same application entry point to execute both the GUI and
-  the CLI code, which starts to get messy once we throw `asar` packaging into
-  the mix.
-
-- Each elevation mechanism has its quirks, mainly on GNU/Linux. Making sure
-  that the forked process was elevated correctly and could work without issues
-  required various workarounds targeting `pkexec` or `kdesudo`.
-
-How it works
-------------
-
-The Etcher binary runs in CLI or GUI mode depending on an environment variable
-called `ELECTRON_RUN_AS_NODE`. When this variable is set, it instructs Electron
-to run as a normal NodeJS process (without Chromium, etc), but still keep any
-patches applied by Electron, like `asar` support.
-
-When the Etcher GUI is ran, and the user presses the "Flash!" button, the GUI
-creates an IPC server, and forks a process called the "writer proxy", passing
-it all the required information to perform the flashing, such as the image
-path, the device path, the current settings, etc.
-
-The writer proxy then checks if its currently elevated, and if not, prompts the
-user for elevation and re-spawns itself.
-
-Once the writer proxy has enough permissions to directly access devices, it
-spawns the Etcher CLI passing the `--robot` option along with all the
-information gathered before. The `--robot` option basically tells the Etcher
-CLI to output state information in a way that can be very easily parsed by the
-parent process.
-
-The output of the Etcher CLI is then sent to the IPC server that was opened by
-the GUI, which nicely displays them in the progress bar the user sees.
-
-Summary
--------
-
-There are lots of details we're omitting for the sake of clarity. Feel free to
-dive in inside the child writer code, which is heavily commented to explain the
-reasons behind each decision or workaround.
-
-Don't hesitate in getting in touch if you have any suggestion, or just want to
-know more!

lib/child-writer/cli.js

@@ -1,100 +0,0 @@
-/*
- * Copyright 2016 resin.io
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *    http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-
-'use strict';
-
-const _ = require('lodash');
-
-/**
- * @summary Get the explicit boolean form of an argument
- * @function
- * @private
- *
- * @description
- * We refer as "explicit boolean form of an argument" to a boolean
- * argument in either normal or negated form.
- *
- * For example: `--check` and `--no-check`;
- *
- * @param {String} argumentName - argument name
- * @param {Boolean} value - argument value
- * @returns {String} argument
- *
- * @example
- * console.log(cli.getBooleanArgumentForm('check', true));
- * > '--check'
- *
- * @example
- * console.log(cli.getBooleanArgumentForm('check', false));
- * > '--no-check'
- */
-exports.getBooleanArgumentForm = (argumentName, value) => {
-  const prefix = _.attempt(() => {
-    if (!value) {
-      return '--no-';
-    }
-
-    const SHORT_OPTION_LENGTH = 1;
-    if (_.size(argumentName) === SHORT_OPTION_LENGTH) {
-      return '-';
-    }
-
-    return '--';
-  });
-
-  return prefix + argumentName;
-};
-
-/**
- * @summary Get CLI writer arguments
- * @function
- * @public
- *
- * @param {Object} options - options
- * @param {String} options.image - image
- * @param {String} options.device - device
- * @param {String} options.entryPoint - entry point
- * @param {Boolean} [options.validateWriteOnSuccess] - validate write on success
- * @param {Boolean} [options.unmountOnSuccess] - unmount on success
- * @returns {String[]} arguments
- *
- * @example
- * const argv = cli.getArguments({
- *   image: 'path/to/rpi.img',
- *   device: '/dev/disk2'
- *   entryPoint: 'path/to/app.asar',
- *   validateWriteOnSuccess: true,
- *   unmountOnSuccess: true
- * });
- */
-exports.getArguments = (options) => {
-  const argv = [
-    options.entryPoint,
-    options.image,
-    '--drive',
-    options.device,
-
-    // Explicitly set the boolean flag in positive
-    // or negative way in order to be on the safe
-    // side in case the Etcher CLI changes the
-    // default value of these options.
-    exports.getBooleanArgumentForm('unmount', options.unmountOnSuccess),
-    exports.getBooleanArgumentForm('check', options.validateWriteOnSuccess)
-
-  ];
-
-  return argv;
-};

lib/child-writer/constants.js

@@ -1,40 +0,0 @@
-/*
- * Copyright 2016 resin.io
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *    http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-
-'use strict';
-
-const path = require('path');
-
-/**
- * @summary Child writer constants
- * @namespace CONSTANTS
- * @public
- */
-module.exports = {
-
-  /**
-   * @property {String} PROJECT_ROOT
-   * @memberof CONSTANTS
-   */
-  PROJECT_ROOT: path.join(__dirname, '..', '..'),
-
-  /**
-   * @property {String} WRITER_PROXY_SCRIPT
-   * @memberof CONSTANTS
-   */
-  WRITER_PROXY_SCRIPT: path.join(__dirname, 'writer-proxy.js')
-
-};

lib/child-writer/index.js

@@ -1,198 +0,0 @@
-/*
- * Copyright 2016 resin.io
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *    http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-
-'use strict';
-
-const EventEmitter = require('events').EventEmitter;
-const _ = require('lodash');
-const childProcess = require('child_process');
-const ipc = require('node-ipc');
-const rendererUtils = require('./renderer-utils');
-const cli = require('./cli');
-const CONSTANTS = require('./constants');
-const EXIT_CODES = require('../shared/exit-codes');
-const robot = require('../shared/robot');
-
-/**
- * @summary Perform a write
- * @function
- * @public
- *
- * @param {String} image - image
- * @param {Object} drive - drive
- * @param {Object} options - options
- * @returns {EventEmitter} event emitter
- *
- * @example
- * const child = childWriter.write('path/to/rpi.img', {
- *   device: '/dev/disk2'
- * }, {
- *   validateWriteOnSuccess: true,
- *   unmountOnSuccess: true
- * });
- *
- * child.on('progress', (state) => {
- *   console.log(state);
- * });
- *
- * child.on('error', (error) => {
- *   throw error;
- * });
- *
- * child.on('done', () => {
- *   console.log('Validation was successful!');
- * });
- */
-exports.write = (image, drive, options) => {
-  const emitter = new EventEmitter();
-
-  const argv = cli.getArguments({
-    entryPoint: rendererUtils.getApplicationEntryPoint(),
-    image,
-    device: drive.device,
-    validateWriteOnSuccess: options.validateWriteOnSuccess,
-    unmountOnSuccess: options.unmountOnSuccess
-  });
-
-  // There might be multiple Etcher instances running at
-  // the same time, therefore we must ensure each IPC
-  // server/client has a different name.
-  process.env.IPC_SERVER_ID = `etcher-server-${process.pid}`;
-  process.env.IPC_CLIENT_ID = `etcher-client-${process.pid}`;
-
-  ipc.config.id = process.env.IPC_SERVER_ID;
-  ipc.config.silent = true;
-  ipc.serve();
-
-  /**
-   * @summary Safely terminate the IPC server
-   * @function
-   * @private
-   *
-   * @example
-   * terminateServer();
-   */
-  const terminateServer = () => {
-
-    // Turns out we need to destroy all sockets for
-    // the server to actually close. Otherwise, it
-    // just stops receiving any further connections,
-    // but remains open if there are active ones.
-    _.each(ipc.server.sockets, (socket) => {
-      socket.destroy();
-    });
-
-    ipc.server.stop();
-  };
-
-  /**
-   * @summary Emit an error to the client
-   * @function
-   * @private
-   *
-   * @param {Error} error - error
-   *
-   * @example
-   * emitError(new Error('foo bar'));
-   */
-  const emitError = (error) => {
-    terminateServer();
-    emitter.emit('error', error);
-  };
-
-  /**
-   * @summary Bridge robot message to the child writer caller
-   * @function
-   * @private
-   *
-   * @param {String} message - robot message
-   *
-   * @example
-   * bridgeRobotMessage(robot.buildMessage('foo', {
-   *   bar: 'baz'
-   * }));
-   */
-  const bridgeRobotMessage = (message) => {
-    try {
-      const parsedMessage = robot.parseMessage(message);
-
-      // These are lighweight accessor methods for
-      // the properties of the parsed message
-      const messageCommand = robot.getCommand(parsedMessage);
-      const messageData = robot.getData(parsedMessage);
-
-      // The error object is decomposed by the CLI for serialisation
-      // purposes. We compose it back to an `Error` here in order
-      // to provide better encapsulation.
-      if (messageCommand === 'error') {
-        emitError(robot.recomposeErrorMessage(parsedMessage));
-      } else if (messageCommand === 'log') {
-        console.log(messageData);
-      } else {
-        emitter.emit(messageCommand, messageData);
-      }
-
-    } catch (error) {
-      emitError(error);
-    }
-  };
-
-  ipc.server.on('error', emitError);
-  ipc.server.on('message', bridgeRobotMessage);
-
-  ipc.server.on('start', () => {
-    const child = childProcess.fork(CONSTANTS.WRITER_PROXY_SCRIPT, argv, {
-      silent: true,
-      env: process.env
-    });
-
-    child.stdout.on('data', (data) => {
-      console.info(`WRITER: ${data.toString()}`);
-    });
-
-    child.stderr.on('data', (data) => {
-      bridgeRobotMessage(data.toString());
-
-      // This function causes the `close` event to be emitted
-      child.kill();
-
-    });
-
-    child.on('error', emitError);
-
-    child.on('close', (code) => {
-      terminateServer();
-
-      if (code === EXIT_CODES.CANCELLED) {
-        return emitter.emit('done', {
-          cancelled: true
-        });
-      }
-
-      // We shouldn't emit the `done` event manually here
-      // since the writer process will take care of it.
-      if (code === EXIT_CODES.SUCCESS || code === EXIT_CODES.VALIDATION_ERROR) {
-        return null;
-      }
-
-      return emitError(new Error(`Child process exited with error code: ${code}`));
-    });
-  });
-
-  ipc.server.start();
-
-  return emitter;
-};

lib/child-writer/renderer-utils.js

@@ -1,51 +0,0 @@
-/*
- * Copyright 2016 resin.io
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *    http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-
-'use strict';
-
-/**
- * This file is only meant to be loaded by the renderer process.
- */
-
-const path = require('path');
-const isRunningInAsar = require('electron-is-running-in-asar');
-const electron = require('electron');
-const CONSTANTS = require('./constants');
-
-/**
- * @summary Get application entry point
- * @function
- * @public
- *
- * @returns {String} entry point
- *
- * @example
- * const entryPoint = rendererUtils.getApplicationEntryPoint();
- */
-exports.getApplicationEntryPoint = () => {
-  if (isRunningInAsar()) {
-    return path.join(process.resourcesPath, 'app.asar');
-  }
-
-  const ENTRY_POINT_ARGV_INDEX = 1;
-  const relativeEntryPoint = electron.remote.process.argv[ENTRY_POINT_ARGV_INDEX];
-
-  // On GNU/Linux, `pkexec` resolves relative paths
-  // from `/root`, therefore we pass an absolute path,
-  // in order to be on the safe side.
-  return path.join(CONSTANTS.PROJECT_ROOT, relativeEntryPoint);
-
-};

lib/child-writer/utils.js

@@ -1,45 +0,0 @@
-/*
- * Copyright 2016 resin.io
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *    http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-
-'use strict';
-
-const _ = require('lodash');
-
-/**
- * @summary Split stringified object lines
- * @function
- * @public
- *
- * @description
- * This function takes special care to not consider new lines
- * inside the object properties.
- *
- * @param {String} lines - lines
- * @returns {String[]} split lines
- *
- * @example
- * const result = utils.splitObjectLines('{"foo":"bar"}\n{"hello":"Hello\nWorld"}');
- * console.log(result);
- *
- * > [ '{"foo":"bar"}', '{"hello":"Hello\nWorld"}' ]
- */
-exports.splitObjectLines = (lines) => {
-  return _.chain(lines)
-    .split(/((?:[^\n"']|"[^"]*"|'[^']*')+)/)
-    .map(_.trim)
-    .reject(_.isEmpty)
-    .value();
-};

lib/child-writer/writer-proxy.js

@@ -1,245 +0,0 @@
-/*
- * Copyright 2016 resin.io
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *    http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-
-'use strict';
-
-const Bluebird = require('bluebird');
-const childProcess = require('child_process');
-const commandJoin = require('command-join');
-const ipc = require('node-ipc');
-const _ = require('lodash');
-const os = require('os');
-const path = require('path');
-const sudoPrompt = Bluebird.promisifyAll(require('sudo-prompt'));
-const utils = require('./utils');
-const EXIT_CODES = require('../shared/exit-codes');
-const errors = require('../shared/errors');
-const robot = require('../shared/robot');
-const permissions = require('../shared/permissions');
-const packageJSON = require('../../package.json');
-
-// This script is in charge of spawning the writer process and
-// ensuring it has the necessary privileges. It might look a bit
-// complex at first sight, but this is only because elevation
-// modules don't work in a spawn/fork fashion.
-//
-// This script spawns the writer process and redirects its `stdout`
-// and `stderr` to the parent process using IPC communication,
-// taking care of the writer elevation as needed.
-
-/**
- * @summary The Etcher executable file path
- * @constant
- * @private
- * @type {String}
- */
-const executable = _.first(process.argv);
-
-/**
- * @summary The first index that represents an actual option argument
- * @constant
- * @private
- * @type {Number}
- *
- * @description
- * The first arguments are usually the program executable itself, etc.
- */
-const OPTIONS_INDEX_START = 2;
-
-/**
- * @summary The list of Etcher argument options
- * @constant
- * @private
- * @type {String[]}
- */
-const etcherArguments = process.argv.slice(OPTIONS_INDEX_START);
-
-return permissions.isElevated().then((elevated) => {
-
-  if (!elevated) {
-    console.log('Attempting to elevate');
-
-    if (os.platform() === 'win32') {
-      const elevator = Bluebird.promisifyAll(require('elevator'));
-
-      const commandArguments = [
-        'set',
-        'ELECTRON_RUN_AS_NODE=1',
-        '&&',
-        'set',
-        `IPC_SERVER_ID=${process.env.IPC_SERVER_ID}`,
-        '&&',
-        'set',
-        `IPC_CLIENT_ID=${process.env.IPC_CLIENT_ID}`,
-        '&&',
-
-        // This is a trick to make the binary afterwards catch
-        // the environment variables set just previously.
-        'call'
-
-      ].concat(process.argv);
-
-      // For debugging purposes
-      console.log(`Running: ${commandArguments.join(' ')}`);
-
-      return elevator.executeAsync(commandArguments, {
-        hidden: true,
-        terminating: true,
-        doNotPushdCurrentDirectory: true,
-        waitForTermination: true
-      }).catch({
-        code: 'ELEVATE_CANCELLED'
-      }, () => {
-        process.exit(EXIT_CODES.CANCELLED);
-      });
-    }
-
-    const commandArguments = _.attempt(() => {
-      const commandPrefix = [
-
-        // Some elevation tools, like `pkexec` or `kdesudo`, don't
-        // provide a way to preserve the environment, therefore we
-        // have to make sure the environment variables we're interested
-        // in are manually inherited.
-        'env',
-        'ELECTRON_RUN_AS_NODE=1',
-        `IPC_SERVER_ID=${process.env.IPC_SERVER_ID}`,
-        `IPC_CLIENT_ID=${process.env.IPC_CLIENT_ID}`,
-
-        // This environment variable prevents the AppImages
-        // desktop integration script from presenting the
-        // "installation" dialog.
-        'SKIP=1'
-
-      ];
-
-      if (process.env.APPIMAGE && process.env.APPDIR) {
-
-        // Translate the current arguments to point to the AppImage
-        // Relative paths are resolved from `/tmp/.mount_XXXXXX/usr`
-        const translatedArguments = _.chain(process.argv)
-          .tail()
-          .invokeMap('replace', path.join(process.env.APPDIR, 'usr/'), '')
-          .value();
-
-        return commandPrefix
-          .concat([ process.env.APPIMAGE ])
-          .concat(translatedArguments);
-      }
-
-      return commandPrefix.concat(process.argv);
-    });
-
-    const command = commandJoin(commandArguments);
-
-    // For debugging purposes
-    console.log(`Running: ${command}`);
-
-    return sudoPrompt.execAsync(command, {
-      name: packageJSON.displayName
-    }).then((stdout, stderr) => {
-      if (!_.isEmpty(stderr)) {
-        throw errors.createError(stderr);
-      }
-
-    // We're hardcoding internal error messages declared by `sudo-prompt`.
-    // There doesn't seem to be a better way to handle these errors, so
-    // for now, we should make sure we double check if the error messages
-    // have changed every time we upgrade `sudo-prompt`.
-
-    }).catch({
-      message: 'User did not grant permission.'
-    }, () => {
-      process.exit(EXIT_CODES.CANCELLED);
-    }).catch({
-      message: 'No polkit authentication agent found.'
-    }, () => {
-      throw errors.createUserError(
-        'No polkit authentication agent found',
-        'Please install a polkit authentication agent for your desktop environment of choice to continue'
-      );
-    });
-  }
-
-  console.log('Re-spawning with elevation');
-
-  return new Bluebird((resolve, reject) => {
-    ipc.config.id = process.env.IPC_CLIENT_ID;
-    ipc.config.silent = true;
-
-    // > If set to 0, the client will NOT try to reconnect.
-    // See https://github.com/RIAEvangelist/node-ipc/
-    //
-    // The purpose behind this change is for this process
-    // to emit a "disconnect" event as soon as the GUI
-    // process is closed, so we can kill the CLI as well.
-    ipc.config.stopRetrying = 0;
-
-    ipc.connectTo(process.env.IPC_SERVER_ID, () => {
-      ipc.of[process.env.IPC_SERVER_ID].on('error', reject);
-      ipc.of[process.env.IPC_SERVER_ID].on('connect', () => {
-
-        const child = childProcess.spawn(executable, etcherArguments, {
-          env: {
-
-            // The CLI might call operating system utilities (like `diskutil`),
-            // so we must ensure the `PATH` is inherited.
-            PATH: process.env.PATH,
-
-            ELECTRON_RUN_AS_NODE: 1,
-            ETCHER_CLI_ROBOT: 1
-          }
-        });
-
-        ipc.of[process.env.IPC_SERVER_ID].on('disconnect', _.bind(child.kill, child));
-        child.on('error', reject);
-        child.on('close', resolve);
-
-        /**
-         * @summary Emit an object message to the IPC server
-         * @function
-         * @private
-         *
-         * @param {Buffer} data - json message data
-         *
-         * @example
-         * emitMessage(Buffer.from(JSON.stringify({
-         *   foo: 'bar'
-         * })));
-         */
-        const emitMessage = (data) => {
-
-          // Output from stdout/stderr coming from the CLI might be buffered,
-          // causing several progress lines to come up at once as single message.
-          // Trying to parse multiple JSON objects separated by new lines will
-          // of course make the parser confused, causing errors later on.
-          _.each(utils.splitObjectLines(data.toString()), (object) => {
-            ipc.of[process.env.IPC_SERVER_ID].emit('message', object);
-          });
-
-        };
-
-        child.stdout.on('data', emitMessage);
-        child.stderr.on('data', emitMessage);
-      });
-    });
-  }).then((exitCode) => {
-    process.exit(exitCode);
-  });
-}).catch((error) => {
-  robot.printError(error);
-  process.exit(EXIT_CODES.GENERAL_ERROR);
-});

lib/cli/README.md

@@ -1,46 +0,0 @@
-Etcher CLI
-==========
-
-The Etcher CLI is a command line interface to the Etcher writer backend, and
-currently the only module in the "Etcher" umbrella that makes use of this
-backend directly.
-
-This module also has the task of unmounting the drives before and after
-flashing.
-
-Notice the Etcher CLI is not worried about elevation, and assumes it has enough
-permissions to continue, throwing an error otherwise. Consult the
-[`lib/child-writer`][child-writer] module to understand how elevation works on
-Etcher.
-
-The robot option
-----------------
-
-Setting the `ETCHER_CLI_ROBOT` environment variable allows other applications
-to easily consume the output of the Etcher CLI in real-time. When using the
-`ETCHER_CLI_ROBOT` option, the `--yes` option is implicit, therefore you need
-to manually specify `--drive`.
-
-When `ETCHER_CLI_ROBOT` is used, the program will output JSON lines containing
-the progress state and other useful information. For example:
-
-```
-$ sudo ETCHER_CLI_ROBOT=1 etcher image.iso --drive /dev/disk2
-{"command":"progress","data":{"type":"write","percentage":1,"eta":130,"speed":1703936}}
-...
-{"command":"progress","data":{"type":"check","percentage":100,"eta":0,"speed":17180514}}
-{"command":"done","data":{"sourceChecksum":"27c39a5d"}}
-```
-
-See documentation about the robot mode at [`lib/shared/robot`][robot].
-
-Exit codes
-----------
-
-The Etcher CLI uses certain exit codes to signal the result of the operation.
-These are documented in [`lib/shared/exit-codes.js`][exit-codes] and are also
-printed on the Etcher CLI help page.
-
-[exit-codes]: https://github.com/resin-io/etcher/blob/master/lib/shared/exit-codes.js
-[robot]: https://github.com/resin-io/etcher/tree/master/lib/shared/robot
-[child-writer]: https://github.com/resin-io/etcher/tree/master/lib/child-writer

lib/cli/etcher.js

@@ -1,144 +0,0 @@
-/*
- * Copyright 2016 resin.io
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *    http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-
-'use strict';
-
-const _ = require('lodash');
-const Bluebird = require('bluebird');
-const visuals = require('resin-cli-visuals');
-const form = require('resin-cli-form');
-const drivelist = Bluebird.promisifyAll(require('drivelist'));
-const writer = require('./writer');
-const utils = require('./utils');
-const options = require('./options');
-const robot = require('../shared/robot');
-const messages = require('../shared/messages');
-const EXIT_CODES = require('../shared/exit-codes');
-const errors = require('../shared/errors');
-const permissions = require('../shared/permissions');
-
-const ARGV_IMAGE_PATH_INDEX = 0;
-const imagePath = options._[ARGV_IMAGE_PATH_INDEX];
-
-permissions.isElevated().then((elevated) => {
-  if (!elevated) {
-    throw errors.createUserError(
-      messages.error.elevationRequired(),
-      'This tool requires special permissions to write to external drives'
-    );
-  }
-
-  return form.run([
-    {
-      message: 'Select drive',
-      type: 'drive',
-      name: 'drive'
-    },
-    {
-      message: 'This will erase the selected drive. Are you sure?',
-      type: 'confirm',
-      name: 'yes',
-      default: false
-    }
-  ], {
-    override: {
-      drive: options.drive,
-
-      // If `options.yes` is `false`, pass `null`,
-      // otherwise the question will not be asked because
-      // `false` is a defined value.
-      yes: robot.isEnabled(process.env) || options.yes || null
-
-    }
-  });
-}).then((answers) => {
-  if (!answers.yes) {
-    throw errors.createUserError('Aborted', 'We can\'t proceed without confirmation');
-  }
-
-  const progressBars = {
-    write: new visuals.Progress('Flashing'),
-    check: new visuals.Progress('Validating')
-  };
-
-  return drivelist.listAsync().then((drives) => {
-    const selectedDrive = _.find(drives, {
-      device: answers.drive
-    });
-
-    if (!selectedDrive) {
-      throw errors.createUserError(
-        'The selected drive was not found',
-        `We can't find ${answers.drive} in your system. Did you unplug the drive?`
-      );
-    }
-
-    return writer.writeImage(imagePath, selectedDrive, {
-      unmountOnSuccess: options.unmount,
-      validateWriteOnSuccess: options.check
-    }, (state) => {
-
-      if (robot.isEnabled(process.env)) {
-        robot.printMessage('progress', {
-          type: state.type,
-          percentage: Math.floor(state.percentage),
-          eta: state.eta,
-          speed: Math.floor(state.speed)
-        });
-      } else {
-        progressBars[state.type].update(state);
-      }
-
-    });
-  });
-}).then((results) => {
-
-  return Bluebird.try(() => {
-    if (robot.isEnabled(process.env)) {
-      return robot.printMessage('done', {
-        sourceChecksum: results.sourceChecksum
-      });
-    }
-
-    console.log(messages.info.flashComplete());
-
-    if (results.sourceChecksum) {
-      console.log(`Checksum: ${results.sourceChecksum}`);
-    }
-
-    return Bluebird.resolve();
-  }).then(() => {
-    process.exit(EXIT_CODES.SUCCESS);
-  });
-
-}).catch((error) => {
-
-  return Bluebird.try(() => {
-    if (robot.isEnabled(process.env)) {
-      return robot.printError(error);
-    }
-
-    utils.printError(error);
-    return Bluebird.resolve();
-  }).then(() => {
-    if (error.code === 'EVALIDATION') {
-      process.exit(EXIT_CODES.VALIDATION_ERROR);
-    }
-
-    process.exit(EXIT_CODES.GENERAL_ERROR);
-  });
-
-});

lib/cli/options.js

@@ -1,159 +0,0 @@
-/*
- * Copyright 2016 resin.io
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *    http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-
-'use strict';
-
-const _ = require('lodash');
-const fs = require('fs');
-const yargs = require('yargs');
-const utils = require('./utils');
-const robot = require('../shared/robot');
-const EXIT_CODES = require('../shared/exit-codes');
-const errors = require('../shared/errors');
-const packageJSON = require('../../package.json');
-
-/**
- * @summary The minimum required number of CLI arguments
- * @constant
- * @private
- * @type {Number}
- */
-const MINIMUM_NUMBER_OF_ARGUMENTS = 1;
-
-/**
- * @summary The index of the image argument
- * @constant
- * @private
- * @type {Number}
- */
-const IMAGE_PATH_ARGV_INDEX = 0;
-
-/**
- * @summary The first index that represents an actual option argument
- * @constant
- * @private
- * @type {Number}
- *
- * @description
- * The first arguments are usually the program executable itself, etc.
- */
-const OPTIONS_INDEX_START = 2;
-
-/**
- * @summary Parsed CLI options and arguments
- * @type {Object}
- * @public
- */
-module.exports = yargs
-
-  // Don't wrap at all
-  .wrap(null)
-
-  .demand(MINIMUM_NUMBER_OF_ARGUMENTS, 'Missing image')
-
-  // Usage help
-  .usage('Usage: $0 [options] <image>')
-  .epilogue([
-    'Exit codes:',
-    _.map(EXIT_CODES, (value, key) => {
-      const reason = _.map(_.split(key, '_'), _.capitalize).join(' ');
-      return `  ${value} - ${reason}`;
-    }).join('\n'),
-    '',
-    'If you need help, don\'t hesitate in contacting us at:',
-    '',
-    '  GitHub: https://github.com/resin-io/etcher/issues/new',
-    '  Gitter: https://gitter.im/resin-io/etcher'
-  ].join('\n'))
-
-  // Examples
-  .example('$0 raspberry-pi.img')
-  .example('$0 --no-check raspberry-pi.img')
-  .example('$0 -d /dev/disk2 ubuntu.iso')
-  .example('$0 -d /dev/disk2 -y rpi.img')
-
-  // Help option
-  .help()
-
-  // Version option
-  .version(_.constant(packageJSON.version))
-
-  // Error reporting
-  .fail((message, error) => {
-    const errorObject = error || errors.createUserError(message);
-
-    if (robot.isEnabled(process.env)) {
-      robot.printError(errorObject);
-    } else {
-      yargs.showHelp();
-      utils.printError(errorObject);
-    }
-
-    process.exit(EXIT_CODES.GENERAL_ERROR);
-  })
-
-  // Assert that image exists
-  .check((argv) => {
-    fs.accessSync(argv._[IMAGE_PATH_ARGV_INDEX]);
-    return true;
-  })
-
-  .check((argv) => {
-    if (robot.isEnabled(process.env) && !argv.drive) {
-      throw errors.createUserError(
-        'Missing drive',
-        'You need to explicitly pass a drive when enabling robot mode'
-      );
-    }
-
-    return true;
-  })
-
-  .options({
-    help: {
-      describe: 'show help',
-      boolean: true,
-      alias: 'h'
-    },
-    version: {
-      describe: 'show version number',
-      boolean: true,
-      alias: 'v'
-    },
-    drive: {
-      describe: 'drive',
-      string: true,
-      alias: 'd'
-    },
-    check: {
-      describe: 'validate write',
-      boolean: true,
-      alias: 'c',
-      default: true
-    },
-    yes: {
-      describe: 'confirm non-interactively',
-      boolean: true,
-      alias: 'y'
-    },
-    unmount: {
-      describe: 'unmount on success',
-      boolean: true,
-      alias: 'u',
-      default: true
-    }
-  })
-  .parse(process.argv.slice(OPTIONS_INDEX_START));

lib/cli/utils.js

@@ -1,47 +0,0 @@
-/*
- * Copyright 2016 resin.io
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *    http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-
-'use strict';
-
-const chalk = require('chalk');
-const errors = require('../shared/errors');
-
-/**
- * @summary Print an error to stderr
- * @function
- * @public
- *
- * @param {Error} error - error
- *
- * @example
- * utils.printError(new Error('Oops!'));
- */
-exports.printError = (error) => {
-  const title = errors.getTitle(error);
-  const description = errors.getDescription(error, {
-    userFriendlyDescriptionsOnly: true
-  });
-
-  console.error(chalk.red(title));
-
-  if (description) {
-    console.error(`\n${chalk.red(description)}`);
-  }
-
-  if (process.env.ETCHER_CLI_DEBUG && error.stack) {
-    console.error(`\n${chalk.red(error.stack)}`);
-  }
-};

lib/cli/writer.js

@@ -1,115 +0,0 @@
-/*
- * Copyright 2016 resin.io
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *    http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-
-'use strict';
-
-const imageWrite = require('etcher-image-write');
-const Bluebird = require('bluebird');
-const fs = Bluebird.promisifyAll(require('fs'));
-const mountutils = Bluebird.promisifyAll(require('mountutils'));
-const os = require('os');
-const imageStream = require('../image-stream');
-const errors = require('../shared/errors');
-const constraints = require('../shared/drive-constraints');
-
-/**
- * @summary Write an image to a disk drive
- * @function
- * @public
- *
- * @description
- * See https://github.com/resin-io-modules/etcher-image-write for information
- * about the `state` object passed to `onProgress` callback.
- *
- * @param {String} imagePath - path to image
- * @param {Object} drive - drive
- * @param {Object} options - options
- * @param {Boolean} [options.unmountOnSuccess=false] - unmount on success
- * @param {Boolean} [options.validateWriteOnSuccess=false] - validate write on success
- * @param {Function} onProgress - on progress callback (state)
- *
- * @fulfil {Boolean} - whether the operation was successful
- * @returns {Promise}
- *
- * @example
- * writer.writeImage('path/to/image.img', {
- *   device: '/dev/disk2'
- * }, {
- *   unmountOnSuccess: true,
- *   validateWriteOnSuccess: true
- * }, (state) => {
- *   console.log(state.percentage);
- * }).then(() => {
- *   console.log('Done!');
- * });
- */
-exports.writeImage = (imagePath, drive, options, onProgress) => {
-  return Bluebird.try(() => {
-
-    // Unmounting a drive in Windows means we can't write to it anymore
-    if (os.platform() === 'win32') {
-      return Bluebird.resolve();
-    }
-
-    return mountutils.unmountDiskAsync(drive.device);
-  }).then(() => {
-    return fs.openAsync(drive.raw, 'rs+');
-  }).then((driveFileDescriptor) => {
-    return imageStream.getFromFilePath(imagePath).then((image) => {
-      if (!constraints.isDriveLargeEnough(drive, image)) {
-        throw errors.createUserError(
-          'The image you selected is too big for this drive',
-          'Please connect a bigger drive and try again'
-        );
-      }
-
-      return imageWrite.write({
-        fd: driveFileDescriptor,
-        device: drive.raw,
-        size: drive.size
-      }, {
-        stream: image.stream,
-        size: image.size.original
-      }, {
-        check: options.validateWriteOnSuccess,
-        transform: image.transform,
-        bmap: image.bmap,
-        bytesToZeroOutFromTheBeginning: image.bytesToZeroOutFromTheBeginning
-      });
-    }).then((writer) => {
-      return new Bluebird((resolve, reject) => {
-        writer.on('progress', onProgress);
-        writer.on('error', reject);
-        writer.on('done', resolve);
-      });
-    }).tap(() => {
-
-      // Make sure the device stream file descriptor is closed
-      // before returning control the the caller. Not closing
-      // the file descriptor (and waiting for it) results in
-      // `EBUSY` errors when attempting to unmount the drive
-      // right afterwards in some Windows 7 systems.
-      return fs.closeAsync(driveFileDescriptor).then(() => {
-
-        if (!options.unmountOnSuccess) {
-          return Bluebird.resolve();
-        }
-
-        return mountutils.unmountDiskAsync(drive.device);
-      });
-    });
-  });
-};

lib/gui/app.js

@@ -1,272 +0,0 @@
-/*
- * Copyright 2016 resin.io
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *    http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-
-/**
- * @module Etcher
- */
-
-'use strict';
-
-/* eslint-disable no-var */
-
-var angular = require('angular');
-
-/* eslint-enable no-var */
-
-const electron = require('electron');
-const Bluebird = require('bluebird');
-const EXIT_CODES = require('../shared/exit-codes');
-const messages = require('../shared/messages');
-const packageJSON = require('../../package.json');
-const flashState = require('./models/flash-state');
-
-const Store = require('./models/store');
-
-const app = angular.module('Etcher', [
-  require('angular-ui-router'),
-  require('angular-ui-bootstrap'),
-  require('angular-if-state'),
-
-  // Etcher modules
-  require('./modules/analytics'),
-  require('./modules/error'),
-  require('./modules/drive-scanner'),
-
-  // Models
-  require('./models/selection-state'),
-  require('./models/drives'),
-
-  // Components
-  require('./components/svg-icon/svg-icon'),
-  require('./components/update-notifier/update-notifier'),
-  require('./components/warning-modal/warning-modal'),
-
-  // Pages
-  require('./pages/main/main'),
-  require('./pages/finish/finish'),
-  require('./pages/settings/settings'),
-
-  // OS
-  require('./os/window-progress/window-progress'),
-  require('./os/open-external/open-external'),
-  require('./os/dropzone/dropzone'),
-  require('./os/dialog/dialog'),
-
-  // Utils
-  require('./utils/manifest-bind/manifest-bind')
-]);
-
-app.run(() => {
-  console.log([
-    ' _____ _       _',
-    '|  ___| |     | |',
-    '| |__ | |_ ___| |__   ___ _ __',
-    '|  __|| __/ __| \'_ \\ / _ \\ \'__|',
-    '| |___| || (__| | | |  __/ |',
-    '\\____/ \\__\\___|_| |_|\\___|_|',
-    '',
-    'Interested in joining the Etcher team?',
-    'Drop us a line at join+etcher@resin.io'
-  ].join('\n'));
-});
-
-app.run((AnalyticsService, ErrorService, UpdateNotifierService, SelectionStateModel) => {
-  AnalyticsService.logEvent('Application start');
-
-  const shouldCheckForUpdates = UpdateNotifierService.shouldCheckForUpdates();
-
-  if (!shouldCheckForUpdates || process.env.ETCHER_DISABLE_UPDATES) {
-    AnalyticsService.logEvent('Not checking for updates', {
-      shouldCheckForUpdates,
-      disableUpdatesEnvironmentVariable: process.env.ETCHER_DISABLE_UPDATES
-    });
-    return;
-  }
-
-  AnalyticsService.logEvent('Checking for updates', {
-    currentVersion: packageJSON.version
-  });
-
-  UpdateNotifierService.isLatestVersion().then((isLatestVersion) => {
-
-    if (isLatestVersion) {
-      AnalyticsService.logEvent('Update notification skipped', {
-        reason: 'Latest version'
-      });
-      return Bluebird.resolve();
-    }
-
-    // In case the internet connection is not good and checking the
-    // latest published version takes too long, only show notify
-    // the user about the new version if he didn't start the flash
-    // process (e.g: selected an image), otherwise such interruption
-    // might be annoying.
-    if (SelectionStateModel.hasImage()) {
-      AnalyticsService.logEvent('Update notification skipped', {
-        reason: 'Image selected'
-      });
-      return Bluebird.resolve();
-    }
-
-    AnalyticsService.logEvent('Notifying update');
-
-    return UpdateNotifierService.notify();
-
-  }).catch(ErrorService.reportException);
-
-});
-
-app.run((AnalyticsService, OSWindowProgressService) => {
-  Store.subscribe(() => {
-    const currentFlashState = flashState.getFlashState();
-
-    // There is usually a short time period between the `isFlashing()`
-    // property being set, and the flashing actually starting, which
-    // might cause some non-sense flashing state logs including
-    // `undefined` values.
-    //
-    // We use the presence of `.eta` to determine that the actual
-    // writing started.
-    if (!flashState.isFlashing() || !currentFlashState.eta) {
-      return;
-    }
-
-    AnalyticsService.logDebug([
-      `Progress (${currentFlashState.type}):`,
-      `${currentFlashState.percentage}% at ${currentFlashState.speed} MB/s`,
-      `(eta ${currentFlashState.eta}s)`
-    ].join(' '));
-
-    OSWindowProgressService.set(currentFlashState.percentage);
-  });
-});
-
-app.run(($timeout, DriveScannerService, DrivesModel, ErrorService) => {
-  DriveScannerService.on('drives', (drives) => {
-
-    // Safely trigger a digest cycle.
-    // In some cases, AngularJS doesn't acknowledge that the
-    // available drives list has changed, and incorrectly
-    // keeps asking the user to "Connect a drive".
-    $timeout(() => {
-      DrivesModel.setDrives(drives);
-    });
-  });
-
-  DriveScannerService.on('error', (error) => {
-
-    // Stop the drive scanning loop in case of errors,
-    // otherwise we risk presenting the same error over
-    // and over again to the user, while also heavily
-    // spamming our error reporting service.
-    DriveScannerService.stop();
-
-    return ErrorService.reportException(error);
-  });
-
-  DriveScannerService.start();
-});
-
-app.run(($window, AnalyticsService, WarningModalService, ErrorService, OSDialogService) => {
-  let popupExists = false;
-
-  $window.addEventListener('beforeunload', (event) => {
-    if (!flashState.isFlashing() || popupExists) {
-      AnalyticsService.logEvent('Close application', {
-        isFlashing: flashState.isFlashing()
-      });
-      return;
-    }
-
-    // Don't close window while flashing
-    event.returnValue = false;
-
-    // Don't open any more popups
-    popupExists = true;
-
-    AnalyticsService.logEvent('Close attempt while flashing');
-
-    OSDialogService.showWarning({
-      confirmationLabel: 'Yes, quit',
-      rejectionLabel: 'Cancel',
-      title: 'Are you sure you want to close Etcher?',
-      description: messages.warning.exitWhileFlashing()
-    }).then((confirmed) => {
-      if (confirmed) {
-        AnalyticsService.logEvent('Close confirmed while flashing');
-
-        // This circumvents the 'beforeunload' event unlike
-        // electron.remote.app.quit() which does not.
-        electron.remote.process.exit(EXIT_CODES.SUCCESS);
-
-      }
-
-      AnalyticsService.logEvent('Close rejected while flashing');
-      popupExists = false;
-    }).catch(ErrorService.reportException);
-  });
-});
-
-app.run(($rootScope, AnalyticsService) => {
-  $rootScope.$on('$stateChangeSuccess', (event, toState, toParams, fromState) => {
-
-    // Ignore first navigation
-    if (!fromState.name) {
-      return;
-    }
-
-    AnalyticsService.logEvent('Navigate', {
-      to: toState.name,
-      from: fromState.name
-    });
-  });
-});
-
-app.config(($urlRouterProvider) => {
-  $urlRouterProvider.otherwise('/main');
-});
-
-app.config(($provide) => {
-  $provide.decorator('$exceptionHandler', ($delegate, $injector) => {
-    return (exception, cause) => {
-      const ErrorService = $injector.get('ErrorService');
-      ErrorService.reportException(exception);
-      $delegate(exception, cause);
-    };
-  });
-});
-
-app.controller('HeaderController', function(SelectionStateModel, OSOpenExternalService) {
-
-  /**
-   * @summary Open help page
-   * @function
-   * @public
-   *
-   * @description
-   * This application will open either the image's support url, declared
-   * in the archive `manifest.json`, or the default Etcher help page.
-   *
-   * @example
-   * HeaderController.openHelpPage();
-   */
-  this.openHelpPage = () => {
-    const DEFAULT_SUPPORT_URL = 'https://github.com/resin-io/etcher/blob/master/SUPPORT.md';
-    const supportUrl = SelectionStateModel.getImageSupportUrl() || DEFAULT_SUPPORT_URL;
-    OSOpenExternalService.open(supportUrl);
-  };
-
-});

lib/gui/app/app.ts

@@ -0,0 +1,352 @@
+/*
+ * Copyright 2016 balena.io
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import * as electron from 'electron';
+import * as sdk from 'etcher-sdk';
+import * as _ from 'lodash';
+import outdent from 'outdent';
+import * as React from 'react';
+import * as ReactDOM from 'react-dom';
+import * as uuidV4 from 'uuid/v4';
+
+import * as packageJSON from '../../../package.json';
+import * as EXIT_CODES from '../../shared/exit-codes';
+import * as messages from '../../shared/messages';
+import * as availableDrives from './models/available-drives';
+import * as flashState from './models/flash-state';
+import { init as ledsInit } from './models/leds';
+import * as settings from './models/settings';
+import { Actions, observe, store } from './models/store';
+import * as analytics from './modules/analytics';
+import { scanner as driveScanner } from './modules/drive-scanner';
+import * as exceptionReporter from './modules/exception-reporter';
+import { updateLock } from './modules/update-lock';
+import * as osDialog from './os/dialog';
+import * as windowProgress from './os/window-progress';
+import MainPage from './pages/main/MainPage';
+
+window.addEventListener(
+	'unhandledrejection',
+	(event: PromiseRejectionEvent | any) => {
+		// Promise: event.reason
+		// Bluebird: event.detail.reason
+		// Anything else: event
+		const error =
+			event.reason || (event.detail && event.detail.reason) || event;
+		analytics.logException(error);
+		event.preventDefault();
+	},
+);
+
+// Set application session UUID
+store.dispatch({
+	type: Actions.SET_APPLICATION_SESSION_UUID,
+	data: uuidV4(),
+});
+
+// Set first flashing workflow UUID
+store.dispatch({
+	type: Actions.SET_FLASHING_WORKFLOW_UUID,
+	data: uuidV4(),
+});
+
+const applicationSessionUuid = store.getState().toJS().applicationSessionUuid;
+const flashingWorkflowUuid = store.getState().toJS().flashingWorkflowUuid;
+
+console.log(outdent`
+	${outdent}
+	 _____ _       _
+	|  ___| |     | |
+	| |__ | |_ ___| |__   ___ _ __
+	|  __|| __/ __| '_ \\ / _ \\ '__|
+	| |___| || (__| | | |  __/ |
+	\\____/ \\__\\___|_| |_|\\___|_|
+
+	Interested in joining the Etcher team?
+	Drop us a line at join+etcher@balena.io
+
+	Version = ${packageJSON.version}, Type = ${packageJSON.packageType}
+`);
+
+const currentVersion = packageJSON.version;
+
+analytics.logEvent('Application start', {
+	packageType: packageJSON.packageType,
+	version: currentVersion,
+	applicationSessionUuid,
+});
+
+observe(() => {
+	if (!flashState.isFlashing()) {
+		return;
+	}
+
+	const currentFlashState = flashState.getFlashState();
+	const stateType =
+		!currentFlashState.flashing && currentFlashState.verifying
+			? `Verifying ${currentFlashState.verifying}`
+			: `Flashing ${currentFlashState.flashing}`;
+
+	// NOTE: There is usually a short time period between the `isFlashing()`
+	// property being set, and the flashing actually starting, which
+	// might cause some non-sense flashing state logs including
+	// `undefined` values.
+	analytics.logDebug(
+		`${stateType} devices, ` +
+			`${currentFlashState.percentage}% at ${currentFlashState.speed} MB/s ` +
+			`(total ${currentFlashState.totalSpeed} MB/s) ` +
+			`eta in ${currentFlashState.eta}s ` +
+			`with ${currentFlashState.failed} failed devices`,
+	);
+
+	windowProgress.set(currentFlashState);
+});
+
+/**
+ * @summary The radix used by USB ID numbers
+ */
+const USB_ID_RADIX = 16;
+
+/**
+ * @summary The expected length of a USB ID number
+ */
+const USB_ID_LENGTH = 4;
+
+/**
+ * @summary Convert a USB id (e.g. product/vendor) to a string
+ *
+ * @example
+ * console.log(usbIdToString(2652))
+ * > '0x0a5c'
+ */
+function usbIdToString(id: number): string {
+	return `0x${_.padStart(id.toString(USB_ID_RADIX), USB_ID_LENGTH, '0')}`;
+}
+
+/**
+ * @summary Product ID of BCM2708
+ */
+const USB_PRODUCT_ID_BCM2708_BOOT = 0x2763;
+
+/**
+ * @summary Product ID of BCM2710
+ */
+const USB_PRODUCT_ID_BCM2710_BOOT = 0x2764;
+
+/**
+ * @summary Compute module descriptions
+ */
+const COMPUTE_MODULE_DESCRIPTIONS: _.Dictionary<string> = {
+	[USB_PRODUCT_ID_BCM2708_BOOT]: 'Compute Module 1',
+	[USB_PRODUCT_ID_BCM2710_BOOT]: 'Compute Module 3',
+};
+
+let BLACKLISTED_DRIVES: string[] = [];
+
+function driveIsAllowed(drive: {
+	devicePath: string;
+	device: string;
+	raw: string;
+}) {
+	return !(
+		BLACKLISTED_DRIVES.includes(drive.devicePath) ||
+		BLACKLISTED_DRIVES.includes(drive.device) ||
+		BLACKLISTED_DRIVES.includes(drive.raw)
+	);
+}
+
+type Drive =
+	| sdk.sourceDestination.BlockDevice
+	| sdk.sourceDestination.UsbbootDrive
+	| sdk.sourceDestination.DriverlessDevice;
+
+function prepareDrive(drive: Drive) {
+	if (drive instanceof sdk.sourceDestination.BlockDevice) {
+		// @ts-ignore (BlockDevice.drive is private)
+		return drive.drive;
+	} else if (drive instanceof sdk.sourceDestination.UsbbootDrive) {
+		// This is a workaround etcher expecting a device string and a size
+		// @ts-ignore
+		drive.device = drive.usbDevice.portId;
+		drive.size = null;
+		// @ts-ignore
+		drive.progress = 0;
+		drive.disabled = true;
+		drive.on('progress', progress => {
+			updateDriveProgress(drive, progress);
+		});
+		return drive;
+	} else if (drive instanceof sdk.sourceDestination.DriverlessDevice) {
+		const description =
+			COMPUTE_MODULE_DESCRIPTIONS[
+				drive.deviceDescriptor.idProduct.toString()
+			] || 'Compute Module';
+		return {
+			device: `${usbIdToString(
+				drive.deviceDescriptor.idVendor,
+			)}:${usbIdToString(drive.deviceDescriptor.idProduct)}`,
+			displayName: 'Missing drivers',
+			description,
+			mountpoints: [],
+			isReadOnly: false,
+			isSystem: false,
+			disabled: true,
+			icon: 'warning',
+			size: null,
+			link:
+				'https://www.raspberrypi.org/documentation/hardware/computemodule/cm-emmc-flashing.md',
+			linkCTA: 'Install',
+			linkTitle: 'Install missing drivers',
+			linkMessage: outdent`
+				Would you like to download the necessary drivers from the Raspberry Pi Foundation?
+				This will open your browser.
+
+
+				Once opened, download and run the installer from the "Windows Installer" section to install the drivers
+			`,
+		};
+	}
+}
+
+function setDrives(drives: _.Dictionary<any>) {
+	availableDrives.setDrives(_.values(drives));
+}
+
+function getDrives() {
+	return _.keyBy(availableDrives.getDrives() || [], 'device');
+}
+
+function addDrive(drive: Drive) {
+	const preparedDrive = prepareDrive(drive);
+	if (!driveIsAllowed(preparedDrive)) {
+		return;
+	}
+	const drives = getDrives();
+	drives[preparedDrive.device] = preparedDrive;
+	setDrives(drives);
+}
+
+function removeDrive(drive: Drive) {
+	const preparedDrive = prepareDrive(drive);
+	const drives = getDrives();
+	delete drives[preparedDrive.device];
+	setDrives(drives);
+}
+
+function updateDriveProgress(
+	drive: sdk.sourceDestination.UsbbootDrive,
+	progress: number,
+) {
+	const drives = getDrives();
+	// @ts-ignore
+	const driveInMap = drives[drive.device];
+	if (driveInMap) {
+		driveInMap.progress = progress;
+		setDrives(drives);
+	}
+}
+
+driveScanner.on('attach', addDrive);
+driveScanner.on('detach', removeDrive);
+
+driveScanner.on('error', error => {
+	// Stop the drive scanning loop in case of errors,
+	// otherwise we risk presenting the same error over
+	// and over again to the user, while also heavily
+	// spamming our error reporting service.
+	driveScanner.stop();
+
+	return exceptionReporter.report(error);
+});
+
+driveScanner.start();
+
+let popupExists = false;
+
+window.addEventListener('beforeunload', async event => {
+	if (!flashState.isFlashing() || popupExists) {
+		analytics.logEvent('Close application', {
+			isFlashing: flashState.isFlashing(),
+			applicationSessionUuid,
+		});
+		return;
+	}
+
+	// Don't close window while flashing
+	event.returnValue = false;
+
+	// Don't open any more popups
+	popupExists = true;
+
+	analytics.logEvent('Close attempt while flashing', {
+		applicationSessionUuid,
+		flashingWorkflowUuid,
+	});
+
+	try {
+		const confirmed = await osDialog.showWarning({
+			confirmationLabel: 'Yes, quit',
+			rejectionLabel: 'Cancel',
+			title: 'Are you sure you want to close Etcher?',
+			description: messages.warning.exitWhileFlashing(),
+		});
+		if (confirmed) {
+			analytics.logEvent('Close confirmed while flashing', {
+				flashInstanceUuid: flashState.getFlashUuid(),
+				applicationSessionUuid,
+				flashingWorkflowUuid,
+			});
+
+			// This circumvents the 'beforeunload' event unlike
+			// electron.remote.app.quit() which does not.
+			electron.remote.process.exit(EXIT_CODES.SUCCESS);
+		}
+
+		analytics.logEvent('Close rejected while flashing', {
+			applicationSessionUuid,
+			flashingWorkflowUuid,
+		});
+		popupExists = false;
+	} catch (error) {
+		exceptionReporter.report(error);
+	}
+});
+
+function extendLock() {
+	updateLock.extend();
+}
+
+window.addEventListener('click', extendLock);
+window.addEventListener('touchstart', extendLock);
+
+// Initial update lock acquisition
+extendLock();
+
+async function main(): Promise<void> {
+	try {
+		await settings.load();
+	} catch (error) {
+		exceptionReporter.report(error);
+	}
+	BLACKLISTED_DRIVES = settings.get('driveBlacklist') || [];
+	ledsInit();
+	ReactDOM.render(
+		React.createElement(MainPage),
+		document.getElementById('main'),
+	);
+}
+
+main();

lib/gui/app/components/drive-selector/DriveSelectorModal.tsx

@@ -0,0 +1,292 @@
+/*
+ * Copyright 2019 balena.io
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import { Drive as DrivelistDrive } from 'drivelist';
+import * as _ from 'lodash';
+import * as React from 'react';
+import { Modal } from 'rendition';
+
+import {
+	COMPATIBILITY_STATUS_TYPES,
+	getDriveImageCompatibilityStatuses,
+	hasListDriveImageCompatibilityStatus,
+	isDriveValid,
+} from '../../../../shared/drive-constraints';
+import { bytesToClosestUnit } from '../../../../shared/units';
+import { getDrives, hasAvailableDrives } from '../../models/available-drives';
+import * as selectionState from '../../models/selection-state';
+import { store } from '../../models/store';
+import * as analytics from '../../modules/analytics';
+import { open as openExternal } from '../../os/open-external/services/open-external';
+
+/**
+ * @summary Determine if we can change a drive's selection state
+ */
+function shouldChangeDriveSelectionState(drive: DrivelistDrive) {
+	return isDriveValid(drive, selectionState.getImage());
+}
+
+/**
+ * @summary Toggle a drive selection
+ */
+function toggleDrive(drive: DrivelistDrive) {
+	const canChangeDriveSelectionState = shouldChangeDriveSelectionState(drive);
+
+	if (canChangeDriveSelectionState) {
+		analytics.logEvent('Toggle drive', {
+			drive,
+			previouslySelected: selectionState.isDriveSelected(drive.device),
+			applicationSessionUuid: store.getState().toJS().applicationSessionUuid,
+			flashingWorkflowUuid: store.getState().toJS().flashingWorkflowUuid,
+		});
+
+		selectionState.toggleDrive(drive.device);
+	}
+}
+
+/**
+ * @summary Get a drive's compatibility status object(s)
+ *
+ * @description
+ * Given a drive, return its compatibility status with the selected image,
+ * containing the status type (ERROR, WARNING), and accompanying
+ * status message.
+ */
+function getDriveStatuses(
+	drive: DrivelistDrive,
+): Array<{ type: number; message: string }> {
+	return getDriveImageCompatibilityStatuses(drive, selectionState.getImage());
+}
+
+function keyboardToggleDrive(
+	drive: DrivelistDrive,
+	event: React.KeyboardEvent<HTMLDivElement>,
+) {
+	const ENTER = 13;
+	const SPACE = 32;
+	if (_.includes([ENTER, SPACE], event.keyCode)) {
+		toggleDrive(drive);
+	}
+}
+
+interface DriverlessDrive {
+	link: string;
+	linkTitle: string;
+	linkMessage: string;
+}
+
+export function DriveSelectorModal({ close }: { close: () => void }) {
+	const defaultMissingDriversModalState: { drive?: DriverlessDrive } = {};
+	const [missingDriversModal, setMissingDriversModal] = React.useState(
+		defaultMissingDriversModalState,
+	);
+	const [drives, setDrives] = React.useState(getDrives());
+
+	React.useEffect(() => {
+		const unsubscribe = store.subscribe(() => {
+			setDrives(getDrives());
+		});
+		return unsubscribe;
+	});
+
+	/**
+	 * @summary Prompt the user to install missing usbboot drivers
+	 */
+	function installMissingDrivers(drive: {
+		link: string;
+		linkTitle: string;
+		linkMessage: string;
+	}) {
+		if (drive.link) {
+			analytics.logEvent('Open driver link modal', {
+				url: drive.link,
+				applicationSessionUuid: store.getState().toJS().applicationSessionUuid,
+				flashingWorkflowUuid: store.getState().toJS().flashingWorkflowUuid,
+			});
+			setMissingDriversModal({ drive });
+		}
+	}
+
+	/**
+	 * @summary Select a drive and close the modal
+	 */
+	async function selectDriveAndClose(drive: DrivelistDrive) {
+		const canChangeDriveSelectionState = await shouldChangeDriveSelectionState(
+			drive,
+		);
+
+		if (canChangeDriveSelectionState) {
+			selectionState.selectDrive(drive.device);
+
+			analytics.logEvent('Drive selected (double click)', {
+				applicationSessionUuid: store.getState().toJS().applicationSessionUuid,
+				flashingWorkflowUuid: store.getState().toJS().flashingWorkflowUuid,
+			});
+
+			close();
+		}
+	}
+
+	const hasStatus = hasListDriveImageCompatibilityStatus(
+		selectionState.getSelectedDrives(),
+		selectionState.getImage(),
+	);
+
+	return (
+		<Modal
+			className="modal-drive-selector-modal"
+			title="Select a Drive"
+			done={close}
+			action="Continue"
+			style={{
+				padding: '20px 30px 11px 30px',
+			}}
+			primaryButtonProps={{
+				primary: !hasStatus,
+				warning: hasStatus,
+			}}
+		>
+			<div>
+				<ul
+					style={{
+						height: '250px',
+						overflowX: 'hidden',
+						overflowY: 'auto',
+						padding: '0',
+					}}
+				>
+					{_.map(drives, (drive, index) => {
+						return (
+							<li
+								key={`item-${drive.displayName}`}
+								className="list-group-item"
+								// @ts-ignore (FIXME: not	a valid <li> attribute but used by css rule)
+								disabled={!isDriveValid(drive, selectionState.getImage())}
+								onDoubleClick={() => selectDriveAndClose(drive)}
+								onClick={() => toggleDrive(drive)}
+							>
+								{drive.icon && (
+									<img
+										className="list-group-item-section"
+										alt="Drive device type logo"
+										src={`../assets/${drive.icon}.svg`}
+										width="25"
+										height="30"
+									/>
+								)}
+								<div
+									className="list-group-item-section list-group-item-section-expanded"
+									tabIndex={15 + index}
+									onKeyPress={evt => keyboardToggleDrive(drive, evt)}
+								>
+									<h6 className="list-group-item-heading">
+										{drive.description}
+										{drive.size && (
+											<span className="word-keep">
+												{' '}
+												- {bytesToClosestUnit(drive.size)}
+											</span>
+										)}
+									</h6>
+									{!drive.link && (
+										<p className="list-group-item-text">{drive.displayName}</p>
+									)}
+									{drive.link && (
+										<p className="list-group-item-text">
+											{drive.displayName} -{' '}
+											<b>
+												<a onClick={() => installMissingDrivers(drive)}>
+													{drive.linkCTA}
+												</a>
+											</b>
+										</p>
+									)}
+
+									<footer className="list-group-item-footer">
+										{_.map(getDriveStatuses(drive), (status, idx) => {
+											const className = {
+												[COMPATIBILITY_STATUS_TYPES.WARNING]: 'label-warning',
+												[COMPATIBILITY_STATUS_TYPES.ERROR]: 'label-danger',
+											};
+											return (
+												<span
+													key={`${drive.displayName}-status-${idx}`}
+													className={`label ${className[status.type]}`}
+												>
+													{status.message}
+												</span>
+											);
+										})}
+									</footer>
+									{Boolean(drive.progress) && (
+										<progress
+											className="drive-init-progress"
+											value={drive.progress}
+											max="100"
+										></progress>
+									)}
+								</div>
+
+								{isDriveValid(drive, selectionState.getImage()) && (
+									<span
+										className="list-group-item-section tick tick--success"
+										// @ts-ignore (FIXME: not	a valid <span> attribute but used by css rule)
+										disabled={!selectionState.isDriveSelected(drive.device)}
+									></span>
+								)}
+							</li>
+						);
+					})}
+					{!hasAvailableDrives() && (
+						<li className="list-group-item">
+							<div>
+								<b>Connect a drive!</b>
+								<div>No removable drive detected.</div>
+							</div>
+						</li>
+					)}
+				</ul>
+			</div>
+
+			{missingDriversModal.drive !== undefined && (
+				<Modal
+					width={400}
+					title={missingDriversModal.drive.linkTitle}
+					cancel={() => setMissingDriversModal({})}
+					done={() => {
+						try {
+							if (missingDriversModal.drive !== undefined) {
+								openExternal(missingDriversModal.drive.link);
+							}
+						} catch (error) {
+							analytics.logException(error);
+						} finally {
+							setMissingDriversModal({});
+						}
+					}}
+					action={'Yes, continue'}
+					cancelButtonProps={{
+						children: 'Cancel',
+					}}
+					children={
+						missingDriversModal.drive.linkMessage ||
+						`Etcher will open ${missingDriversModal.drive.link} in your browser`
+					}
+				></Modal>
+			)}
+		</Modal>
+	);
+}

lib/gui/app/components/drive-selector/styles/_drive-selector.scss

@@ -1,5 +1,5 @@
 /*
- * Copyright 2016 resin.io
+ * Copyright 2016 balena.io
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -15,7 +15,7 @@
  */
 
 .modal-drive-selector-modal .modal-content {
-  width: 300px;
+  width: 315px;
   height: 320px;
 }
 
@@ -30,7 +30,7 @@
 
 .modal-drive-selector-modal {
 
-  .list-group-item-footer {
+  .list-group-item-footer:has(span) {
     margin-top: 8px;
   }
 
@@ -52,12 +52,19 @@
     border-color: darken($palette-theme-light-background, 7%);
     padding: 12px 0;
 
-    > .tick {
-      font-size: 11px;
+    .list-group-item-section-expanded {
+      flex-grow: 1;
+      margin-left: 15px;
     }
 
-    :first-child {
-      flex-grow: 1;
+    .list-group-item-section + .list-group-item-section {
+      margin-left: 10px;
+      display: inline-block;
+      vertical-align: middle;
+    }
+
+    > .tick {
+      font-size: 11px;
     }
 
     &:first-child {
@@ -67,6 +74,26 @@
     &[disabled] .list-group-item-heading {
       color: $palette-theme-light-soft-foreground;
     }
+
+    .drive-init-progress {
+      appearance: none;
+      width: 100%;
+      height: 2.5px;
+      border: none;
+      border-radius: 50% 50%;
+    }
+
+    .drive-init-progress::-webkit-progress-bar {
+      background-color: $palette-theme-default-background;
+      border: none;
+      outline: none;
+    }
+
+    .drive-init-progress::-webkit-progress-value {
+      border-bottom: 1px solid darken($palette-theme-primary-background, 15);
+      background-color: $palette-theme-primary-background;
+    }
+
   }
 
   .list-group-item-heading {
@@ -78,5 +105,9 @@
     font-size: 11px;
     color: $palette-theme-light-soft-foreground;
   }
+
+  .word-keep {
+    word-break: keep-all;
+  }
 }
 

lib/gui/app/components/drive-selector/target-selector.tsx

@@ -0,0 +1,143 @@
+/*
+ * Copyright 2019 balena.io
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import { Drive as DrivelistDrive } from 'drivelist';
+import * as _ from 'lodash';
+import * as React from 'react';
+import { Txt } from 'rendition';
+import { default as styled } from 'styled-components';
+
+import {
+	getDriveImageCompatibilityStatuses,
+	Image,
+} from '../../../../shared/drive-constraints';
+import { bytesToClosestUnit } from '../../../../shared/units';
+import { getSelectedDrives } from '../../models/selection-state';
+import {
+	ChangeButton,
+	DetailsText,
+	StepButton,
+	StepNameButton,
+} from '../../styled-components';
+import { middleEllipsis } from '../../utils/middle-ellipsis';
+
+const TargetDetail = styled(props => <Txt.span {...props}></Txt.span>)`
+	float: ${({ float }) => float};
+`;
+
+interface TargetSelectorProps {
+	targets: any[];
+	disabled: boolean;
+	openDriveSelector: () => any;
+	reselectDrive: () => any;
+	flashing: boolean;
+	show: boolean;
+	tooltip: string;
+	image: Image;
+}
+
+function DriveCompatibilityWarning(props: {
+	drive: DrivelistDrive;
+	image: Image;
+}) {
+	const compatibilityWarnings = getDriveImageCompatibilityStatuses(
+		props.drive,
+		props.image,
+	);
+	if (compatibilityWarnings.length === 0) {
+		return null;
+	}
+	const messages = _.map(compatibilityWarnings, 'message');
+	return (
+		<Txt.span
+			className="glyphicon glyphicon-exclamation-sign"
+			ml={2}
+			tooltip={messages.join(', ')}
+		/>
+	);
+}
+
+export function TargetSelector(props: TargetSelectorProps) {
+	const targets = getSelectedDrives();
+
+	if (targets.length === 1) {
+		const target = targets[0];
+		return (
+			<>
+				<StepNameButton plain tooltip={props.tooltip}>
+					{middleEllipsis(target.description, 20)}
+				</StepNameButton>
+				{!props.flashing && (
+					<ChangeButton plain mb={14} onClick={props.reselectDrive}>
+						Change
+					</ChangeButton>
+				)}
+				<DetailsText>
+					<DriveCompatibilityWarning drive={target} image={props.image} />
+					{bytesToClosestUnit(target.size)}
+				</DetailsText>
+			</>
+		);
+	}
+
+	if (targets.length > 1) {
+		const targetsTemplate = [];
+		for (const target of targets) {
+			targetsTemplate.push(
+				<DetailsText
+					key={target.device}
+					tooltip={`${target.description} ${
+						target.displayName
+					} ${bytesToClosestUnit(target.size)}`}
+					px={21}
+				>
+					<Txt.span>
+						<DriveCompatibilityWarning drive={target} image={props.image} />
+						<TargetDetail float="left">
+							{middleEllipsis(target.description, 14)}
+						</TargetDetail>
+						<TargetDetail float="right">
+							{bytesToClosestUnit(target.size)}
+						</TargetDetail>
+					</Txt.span>
+				</DetailsText>,
+			);
+		}
+		return (
+			<>
+				<StepNameButton plain tooltip={props.tooltip}>
+					{targets.length} Targets
+				</StepNameButton>
+				{!props.flashing && (
+					<ChangeButton plain onClick={props.reselectDrive} mb={14}>
+						Change
+					</ChangeButton>
+				)}
+				{targetsTemplate}
+			</>
+		);
+	}
+
+	return (
+		<StepButton
+			tabindex={targets.length > 0 ? -1 : 2}
+			disabled={props.disabled}
+			onClick={props.openDriveSelector}
+		>
+			Select target
+		</StepButton>
+	);
+}

lib/gui/app/components/featured-project/featured-project.tsx

@@ -0,0 +1,56 @@
+/*
+ * Copyright 2016 balena.io
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import * as React from 'react';
+
+import * as settings from '../../models/settings';
+import * as analytics from '../../modules/analytics';
+import { SafeWebview } from '../safe-webview/safe-webview';
+
+interface FeaturedProjectProps {
+	onWebviewShow: (isWebviewShowing: boolean) => void;
+}
+
+interface FeaturedProjectState {
+	endpoint: string | null;
+}
+
+export class FeaturedProject extends React.Component<
+	FeaturedProjectProps,
+	FeaturedProjectState
+> {
+	constructor(props: FeaturedProjectProps) {
+		super(props);
+		this.state = { endpoint: null };
+	}
+
+	public componentDidMount() {
+		try {
+			const endpoint =
+				settings.get('featuredProjectEndpoint') ||
+				'https://assets.balena.io/etcher-featured/index.html';
+			this.setState({ endpoint });
+		} catch (error) {
+			analytics.logException(error);
+		}
+	}
+
+	public render() {
+		return this.state.endpoint ? (
+			<SafeWebview src={this.state.endpoint} {...this.props}></SafeWebview>
+		) : null;
+	}
+}

lib/gui/app/components/finish/finish.tsx

@@ -0,0 +1,135 @@
+/*
+ * Copyright 2019 balena.io
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import * as _ from 'lodash';
+import * as React from 'react';
+import * as uuidV4 from 'uuid/v4';
+
+import * as messages from '../../../../shared/messages';
+import * as flashState from '../../models/flash-state';
+import * as selectionState from '../../models/selection-state';
+import { store } from '../../models/store';
+import * as analytics from '../../modules/analytics';
+import { updateLock } from '../../modules/update-lock';
+import { open as openExternal } from '../../os/open-external/services/open-external';
+import { FlashAnother } from '../flash-another/flash-another';
+import { FlashResults } from '../flash-results/flash-results';
+import { SVGIcon } from '../svg-icon/svg-icon';
+
+const restart = (options: any, goToMain: () => void) => {
+	const {
+		applicationSessionUuid,
+		flashingWorkflowUuid,
+	} = store.getState().toJS();
+	if (!options.preserveImage) {
+		selectionState.deselectImage();
+	}
+	selectionState.deselectAllDrives();
+	analytics.logEvent('Restart', {
+		...options,
+		applicationSessionUuid,
+		flashingWorkflowUuid,
+	});
+
+	// Re-enable lock release on inactivity
+	updateLock.resume();
+
+	// Reset the flashing workflow uuid
+	store.dispatch({
+		type: 'SET_FLASHING_WORKFLOW_UUID',
+		data: uuidV4(),
+	});
+
+	goToMain();
+};
+
+const formattedErrors = () => {
+	const errors = _.map(
+		_.get(flashState.getFlashResults(), ['results', 'errors']),
+		error => {
+			return `${error.device}: ${error.message || error.code}`;
+		},
+	);
+	return errors.join('\n');
+};
+
+function FinishPage({ goToMain }: { goToMain: () => void }) {
+	// @ts-ignore
+	const results = flashState.getFlashResults().results || {};
+	const progressMessage = messages.progress;
+	return (
+		<div className="page-finish row around-xs">
+			<div className="col-xs">
+				<div className="box center">
+					<FlashResults
+						results={results}
+						message={progressMessage}
+						errors={formattedErrors}
+					></FlashResults>
+
+					<FlashAnother
+						onClick={(options: any) => restart(options, goToMain)}
+					></FlashAnother>
+				</div>
+
+				<div className="box center">
+					<div className="fallback-banner">
+						<div className="caption caption-big">
+							Thanks for using
+							<span
+								style={{ cursor: 'pointer' }}
+								onClick={() =>
+									openExternal(
+										'https://balena.io/etcher?ref=etcher_offline_banner',
+									)
+								}
+							>
+								<SVGIcon
+									paths={['../../assets/etcher.svg']}
+									width="165px"
+									height="auto"
+								></SVGIcon>
+							</span>
+						</div>
+						<div className="caption caption-small fallback-footer">
+							made with
+							<SVGIcon
+								paths={['../../assets/love.svg']}
+								width="auto"
+								height="20px"
+							></SVGIcon>
+							by
+							<span
+								style={{ cursor: 'pointer' }}
+								onClick={() =>
+									openExternal('https://balena.io?ref=etcher_success')
+								}
+							>
+								<SVGIcon
+									paths={['../../assets/balena.svg']}
+									width="auto"
+									height="20px"
+								></SVGIcon>
+							</span>
+						</div>
+					</div>
+				</div>
+			</div>
+		</div>
+	);
+}
+
+export default FinishPage;

lib/gui/app/components/flash-another/flash-another.tsx

@@ -0,0 +1,44 @@
+/*
+ * Copyright 2019 balena.io
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import * as React from 'react';
+import styled from 'styled-components';
+import { position, right } from 'styled-system';
+import { BaseButton, ThemedProvider } from '../../styled-components';
+
+const Div = styled.div<any>`
+	${position}
+	${right}
+`;
+
+export interface FlashAnotherProps {
+	onClick: (options: { preserveImage: boolean }) => void;
+}
+
+export const FlashAnother = (props: FlashAnotherProps) => {
+	return (
+		<ThemedProvider>
+			<Div position="absolute" right="152px">
+				<BaseButton
+					primary
+					onClick={props.onClick.bind(null, { preserveImage: true })}
+				>
+					Flash Another
+				</BaseButton>
+			</Div>
+		</ThemedProvider>
+	);
+};

lib/gui/app/components/flash-results/flash-results.tsx

@@ -0,0 +1,65 @@
+/*
+ * Copyright 2019 balena.io
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import * as _ from 'lodash';
+import * as React from 'react';
+import styled from 'styled-components';
+import { left, position, space, top } from 'styled-system';
+import { Underline } from '../../styled-components';
+
+const Div: any = styled.div<any>`
+  ${position}
+  ${top}
+  ${left}
+  ${space}
+`;
+
+export const FlashResults: any = ({
+	errors,
+	results,
+	message,
+}: {
+	errors: () => string;
+	results: any;
+	message: any;
+}) => {
+	return (
+		<Div position="absolute" left="153px" top="66px">
+			<div className="inline-flex title">
+				<span className="tick tick--success space-right-medium"></span>
+				<h3>Flash Complete!</h3>
+			</div>
+			<Div className="results" mt="11px" mr="0" mb="0" ml="40px">
+				<Underline tooltip={errors()}>
+					{_.map(results.devices, (quantity, type) => {
+						return quantity ? (
+							<div
+								key={type}
+								className={`target-status-line target-status-${type}`}
+							>
+								<span className="target-status-dot"></span>
+								<span className="target-status-quantity">{quantity}</span>
+								<span className="target-status-message">
+									{message[type](quantity)}
+								</span>
+							</div>
+						) : null;
+					})}
+				</Underline>
+			</Div>
+		</Div>
+	);
+};

lib/gui/app/components/image-selector/image-selector.tsx

@@ -0,0 +1,420 @@
+/*
+ * Copyright 2016 balena.io
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import * as sdk from 'etcher-sdk';
+import * as _ from 'lodash';
+import { GPTPartition, MBRPartition } from 'partitioninfo';
+import * as path from 'path';
+import * as React from 'react';
+import { Modal } from 'rendition';
+import { default as styled } from 'styled-components';
+
+import * as errors from '../../../../shared/errors';
+import * as messages from '../../../../shared/messages';
+import * as supportedFormats from '../../../../shared/supported-formats';
+import * as shared from '../../../../shared/units';
+import * as selectionState from '../../models/selection-state';
+import { observe, store } from '../../models/store';
+import * as analytics from '../../modules/analytics';
+import * as exceptionReporter from '../../modules/exception-reporter';
+import * as osDialog from '../../os/dialog';
+import { replaceWindowsNetworkDriveLetter } from '../../os/windows-network-drives';
+import {
+	ChangeButton,
+	DetailsText,
+	Footer,
+	StepButton,
+	StepNameButton,
+	StepSelection,
+	Underline,
+} from '../../styled-components';
+import { middleEllipsis } from '../../utils/middle-ellipsis';
+import { SVGIcon } from '../svg-icon/svg-icon';
+
+// TODO move these styles to rendition
+const ModalText = styled.p`
+	a {
+		color: rgb(0, 174, 239);
+
+		&:hover {
+			color: rgb(0, 139, 191);
+		}
+	}
+`;
+
+const mainSupportedExtensions = _.intersection(
+	['img', 'iso', 'zip'],
+	supportedFormats.getAllExtensions(),
+);
+
+const extraSupportedExtensions = _.difference(
+	supportedFormats.getAllExtensions(),
+	mainSupportedExtensions,
+).sort();
+
+function getState() {
+	return {
+		hasImage: selectionState.hasImage(),
+		imageName: selectionState.getImageName(),
+		imageSize: selectionState.getImageSize(),
+	};
+}
+
+interface ImageSelectorProps {
+	flashing: boolean;
+}
+
+interface ImageSelectorState {
+	hasImage: boolean;
+	imageName: string;
+	imageSize: number;
+	warning: { message: string; title: string | null } | null;
+	showImageDetails: boolean;
+}
+
+export class ImageSelector extends React.Component<
+	ImageSelectorProps,
+	ImageSelectorState
+> {
+	private unsubscribe: () => void;
+
+	constructor(props: ImageSelectorProps) {
+		super(props);
+		this.state = {
+			...getState(),
+			warning: null,
+			showImageDetails: false,
+		};
+
+		this.openImageSelector = this.openImageSelector.bind(this);
+		this.reselectImage = this.reselectImage.bind(this);
+		this.onDrop = this.onDrop.bind(this);
+		this.showSelectedImageDetails = this.showSelectedImageDetails.bind(this);
+	}
+
+	public componentDidMount() {
+		this.unsubscribe = observe(() => {
+			this.setState(getState());
+		});
+	}
+
+	public componentWillUnmount() {
+		this.unsubscribe();
+	}
+
+	private reselectImage() {
+		analytics.logEvent('Reselect image', {
+			previousImage: selectionState.getImage(),
+			applicationSessionUuid: store.getState().toJS().applicationSessionUuid,
+			flashingWorkflowUuid: store.getState().toJS().flashingWorkflowUuid,
+		});
+
+		this.openImageSelector();
+	}
+
+	private selectImage(
+		image: sdk.sourceDestination.Metadata & {
+			path: string;
+			extension: string;
+			hasMBR: boolean;
+		},
+	) {
+		if (!supportedFormats.isSupportedImage(image.path)) {
+			const invalidImageError = errors.createUserError({
+				title: 'Invalid image',
+				description: messages.error.invalidImage(image.path),
+			});
+
+			osDialog.showError(invalidImageError);
+			analytics.logEvent(
+				'Invalid image',
+				_.merge(
+					{
+						applicationSessionUuid: store.getState().toJS()
+							.applicationSessionUuid,
+						flashingWorkflowUuid: store.getState().toJS().flashingWorkflowUuid,
+					},
+					image,
+				),
+			);
+			return;
+		}
+
+		try {
+			let message = null;
+			let title = null;
+
+			if (supportedFormats.looksLikeWindowsImage(image.path)) {
+				analytics.logEvent('Possibly Windows image', {
+					image,
+					applicationSessionUuid: store.getState().toJS()
+						.applicationSessionUuid,
+					flashingWorkflowUuid: store.getState().toJS().flashingWorkflowUuid,
+				});
+				message = messages.warning.looksLikeWindowsImage();
+				title = 'Possible Windows image detected';
+			} else if (!image.hasMBR) {
+				analytics.logEvent('Missing partition table', {
+					image,
+					applicationSessionUuid: store.getState().toJS()
+						.applicationSessionUuid,
+					flashingWorkflowUuid: store.getState().toJS().flashingWorkflowUuid,
+				});
+				title = 'Missing partition table';
+				message = messages.warning.missingPartitionTable();
+			}
+
+			if (message) {
+				this.setState({
+					warning: {
+						message,
+						title,
+					},
+				});
+			}
+
+			selectionState.selectImage(image);
+			analytics.logEvent('Select image', {
+				// An easy way so we can quickly identify if we're making use of
+				// certain features without printing pages of text to DevTools.
+				image: {
+					...image,
+					logo: Boolean(image.logo),
+					blockMap: Boolean(image.blockMap),
+				},
+				applicationSessionUuid: store.getState().toJS().applicationSessionUuid,
+				flashingWorkflowUuid: store.getState().toJS().flashingWorkflowUuid,
+			});
+		} catch (error) {
+			exceptionReporter.report(error);
+		}
+	}
+
+	private async selectImageByPath(imagePath: string) {
+		try {
+			imagePath = await replaceWindowsNetworkDriveLetter(imagePath);
+		} catch (error) {
+			analytics.logException(error);
+		}
+		if (!supportedFormats.isSupportedImage(imagePath)) {
+			const invalidImageError = errors.createUserError({
+				title: 'Invalid image',
+				description: messages.error.invalidImage(imagePath),
+			});
+
+			osDialog.showError(invalidImageError);
+			analytics.logEvent('Invalid image', { path: imagePath });
+			return;
+		}
+
+		const source = new sdk.sourceDestination.File(
+			imagePath,
+			sdk.sourceDestination.File.OpenFlags.Read,
+		);
+		try {
+			const innerSource = await source.getInnerSource();
+			const metadata = (await innerSource.getMetadata()) as sdk.sourceDestination.Metadata & {
+				hasMBR: boolean;
+				partitions: MBRPartition[] | GPTPartition[];
+				path: string;
+				extension: string;
+			};
+			const partitionTable = await innerSource.getPartitionTable();
+			if (partitionTable) {
+				metadata.hasMBR = true;
+				metadata.partitions = partitionTable.partitions;
+			} else {
+				metadata.hasMBR = false;
+			}
+			metadata.path = imagePath;
+			metadata.extension = path.extname(imagePath).slice(1);
+			this.selectImage(metadata);
+		} catch (error) {
+			const imageError = errors.createUserError({
+				title: 'Error opening image',
+				description: messages.error.openImage(
+					path.basename(imagePath),
+					error.message,
+				),
+			});
+			osDialog.showError(imageError);
+			analytics.logException(error);
+		} finally {
+			try {
+				await source.close();
+			} catch (error) {
+				// Noop
+			}
+		}
+	}
+
+	private async openImageSelector() {
+		analytics.logEvent('Open image selector', {
+			applicationSessionUuid: store.getState().toJS().applicationSessionUuid,
+			flashingWorkflowUuid: store.getState().toJS().flashingWorkflowUuid,
+		});
+
+		try {
+			const imagePath = await osDialog.selectImage();
+			// Avoid analytics and selection state changes
+			// if no file was resolved from the dialog.
+			if (!imagePath) {
+				analytics.logEvent('Image selector closed', {
+					applicationSessionUuid: store.getState().toJS()
+						.applicationSessionUuid,
+					flashingWorkflowUuid: store.getState().toJS().flashingWorkflowUuid,
+				});
+				return;
+			}
+			this.selectImageByPath(imagePath);
+		} catch (error) {
+			exceptionReporter.report(error);
+		}
+	}
+
+	private onDrop(event: React.DragEvent<HTMLDivElement>) {
+		const [file] = event.dataTransfer.files;
+		if (file) {
+			this.selectImageByPath(file.path);
+		}
+	}
+
+	private onDragOver(event: React.DragEvent<HTMLDivElement>) {
+		// Needed to get onDrop events on div elements
+		event.preventDefault();
+	}
+
+	private onDragEnter(event: React.DragEvent<HTMLDivElement>) {
+		// Needed to get onDrop events on div elements
+		event.preventDefault();
+	}
+
+	private showSelectedImageDetails() {
+		analytics.logEvent('Show selected image tooltip', {
+			imagePath: selectionState.getImagePath(),
+			flashingWorkflowUuid: store.getState().toJS().flashingWorkflowUuid,
+			applicationSessionUuid: store.getState().toJS().applicationSessionUuid,
+		});
+
+		this.setState({
+			showImageDetails: true,
+		});
+	}
+
+	// TODO add a visual change when dragging a file over the selector
+	public render() {
+		const { flashing } = this.props;
+		const { showImageDetails } = this.state;
+
+		const hasImage = selectionState.hasImage();
+
+		const imageBasename = hasImage
+			? path.basename(selectionState.getImagePath())
+			: '';
+		const imageName = selectionState.getImageName();
+		const imageSize = selectionState.getImageSize();
+
+		return (
+			<>
+				<div
+					className="box text-center relative"
+					onDrop={this.onDrop}
+					onDragEnter={this.onDragEnter}
+					onDragOver={this.onDragOver}
+				>
+					<div className="center-block">
+						<SVGIcon
+							contents={[selectionState.getImageLogo()]}
+							paths={['../../assets/image.svg']}
+						/>
+					</div>
+
+					<div className="space-vertical-large">
+						{hasImage ? (
+							<>
+								<StepNameButton
+									plain
+									onClick={this.showSelectedImageDetails}
+									tooltip={imageBasename}
+								>
+									{middleEllipsis(imageName || imageBasename, 20)}
+								</StepNameButton>
+								{!flashing && (
+									<ChangeButton plain mb={14} onClick={this.reselectImage}>
+										Change
+									</ChangeButton>
+								)}
+								<DetailsText>
+									{shared.bytesToClosestUnit(imageSize)}
+								</DetailsText>
+							</>
+						) : (
+							<StepSelection>
+								<StepButton onClick={this.openImageSelector}>
+									Select image
+								</StepButton>
+								<Footer>
+									{mainSupportedExtensions.join(', ')}, and{' '}
+									<Underline tooltip={extraSupportedExtensions.join(', ')}>
+										many more
+									</Underline>
+								</Footer>
+							</StepSelection>
+						)}
+					</div>
+				</div>
+
+				{this.state.warning != null && (
+					<Modal
+						titleElement={
+							<span>
+								<span
+									style={{ color: '#d9534f' }}
+									className="glyphicon glyphicon-exclamation-sign"
+								></span>{' '}
+								<span>{this.state.warning.title}</span>
+							</span>
+						}
+						action="Continue"
+						cancel={() => {
+							this.setState({ warning: null });
+							this.reselectImage();
+						}}
+						done={() => {
+							this.setState({ warning: null });
+						}}
+						primaryButtonProps={{ warning: true, primary: false }}
+					>
+						<ModalText
+							dangerouslySetInnerHTML={{ __html: this.state.warning.message }}
+						/>
+					</Modal>
+				)}
+
+				{showImageDetails && (
+					<Modal
+						title="Image File Name"
+						done={() => {
+							this.setState({ showImageDetails: false });
+						}}
+					>
+						{selectionState.getImagePath()}
+					</Modal>
+				)}
+			</>
+		);
+	}
+}

lib/gui/app/components/progress-button/progress-button.tsx

@@ -0,0 +1,145 @@
+/*
+ * Copyright 2016 balena.io
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import * as Color from 'color';
+import * as React from 'react';
+import { ProgressBar } from 'rendition';
+import { css, default as styled, keyframes } from 'styled-components';
+
+import { StepButton, StepSelection } from '../../styled-components';
+import { colors } from '../../theme';
+
+const darkenForegroundStripes = 0.18;
+const desaturateForegroundStripes = 0.2;
+const progressButtonStripesForegroundColor = Color(colors.primary.background)
+	.darken(darkenForegroundStripes)
+	.desaturate(desaturateForegroundStripes)
+	.string();
+
+const desaturateBackgroundStripes = 0.05;
+const progressButtonStripesBackgroundColor = Color(colors.primary.background)
+	.desaturate(desaturateBackgroundStripes)
+	.string();
+
+const ProgressButtonStripes = keyframes`
+  0% {
+    background-position: 0 0;
+  }
+
+  100% {
+    background-position: 20px 20px;
+  }
+`;
+
+const ProgressButtonStripesRule = css`
+	${ProgressButtonStripes} 1s linear infinite;
+`;
+
+const FlashProgressBar = styled(ProgressBar)`
+	> div {
+		width: 200px;
+		height: 48px;
+		color: white !important;
+		text-shadow: none !important;
+	}
+
+	width: 200px;
+	height: 48px;
+	font-size: 16px;
+	line-height: 48px;
+
+	background: ${Color(colors.warning.background)
+		.darken(darkenForegroundStripes)
+		.string()};
+`;
+
+const FlashProgressBarValidating = styled(FlashProgressBar)`
+	// Notice that we add 0.01 to certain gradient stop positions.
+	// That workarounds a Chrome rendering issue where diagonal
+	// lines look spiky.
+	// See https://github.com/balena-io/etcher/issues/472
+
+	background-image: -webkit-gradient(
+		linear,
+		0 0,
+		100% 100%,
+		color-stop(0.25, ${progressButtonStripesForegroundColor}),
+		color-stop(0.26, ${progressButtonStripesBackgroundColor}),
+		color-stop(0.5, ${progressButtonStripesBackgroundColor}),
+		color-stop(0.51, ${progressButtonStripesForegroundColor}),
+		color-stop(0.75, ${progressButtonStripesForegroundColor}),
+		color-stop(0.76, ${progressButtonStripesBackgroundColor}),
+		to(${progressButtonStripesBackgroundColor})
+	);
+
+	background-color: white;
+
+	animation: ${ProgressButtonStripesRule};
+	overflow: hidden;
+
+	background-size: 20px 20px;
+`;
+
+interface ProgressButtonProps {
+	striped: boolean;
+	active: boolean;
+	percentage: number;
+	label: string;
+	disabled: boolean;
+	callback: () => any;
+}
+
+/**
+ * Progress Button component
+ */
+export class ProgressButton extends React.Component<ProgressButtonProps> {
+	public render() {
+		if (this.props.active) {
+			if (this.props.striped) {
+				return (
+					<StepSelection>
+						<FlashProgressBarValidating
+							primary
+							emphasized
+							value={this.props.percentage}
+						>
+							{this.props.label}
+						</FlashProgressBarValidating>
+					</StepSelection>
+				);
+			}
+
+			return (
+				<StepSelection>
+					<FlashProgressBar warning emphasized value={this.props.percentage}>
+						{this.props.label}
+					</FlashProgressBar>
+				</StepSelection>
+			);
+		}
+
+		return (
+			<StepSelection>
+				<StepButton
+					onClick={this.props.callback}
+					disabled={this.props.disabled}
+				>
+					{this.props.label}
+				</StepButton>
+			</StepSelection>
+		);
+	}
+}

lib/gui/app/components/reduced-flashing-infos/reduced-flashing-infos.tsx

@@ -0,0 +1,95 @@
+/*
+ * Copyright 2016 balena.io
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import * as React from 'react';
+import { default as styled } from 'styled-components';
+import { color } from 'styled-system';
+
+import { SVGIcon } from '../svg-icon/svg-icon';
+
+const Div = styled.div`
+	position: absolute;
+	top: 45px;
+	left: 545px;
+
+	> span.step-name {
+		justify-content: flex-start;
+
+		> span {
+			margin-left: 10px;
+		}
+
+		> span:nth-child(2) {
+			font-weight: 500;
+		}
+
+		> span:nth-child(3) {
+			font-weight: 400;
+			font-style: italic;
+		}
+	}
+
+	.svg-icon[disabled] {
+		opacity: 0.4;
+	}
+`;
+
+const Span = styled.span`
+	${color}
+`;
+
+interface ReducedFlashingInfosProps {
+	imageLogo: string;
+	imageName: string;
+	imageSize: string;
+	driveTitle: string;
+	shouldShow: boolean;
+}
+
+export class ReducedFlashingInfos extends React.Component<
+	ReducedFlashingInfosProps
+> {
+	constructor(props: ReducedFlashingInfosProps) {
+		super(props);
+		this.state = {};
+	}
+
+	public render() {
+		return this.props.shouldShow ? (
+			<Div>
+				<Span className="step-name">
+					<SVGIcon
+						disabled
+						contents={[this.props.imageLogo]}
+						paths={['../../assets/image.svg']}
+						width="20px"
+					></SVGIcon>
+					<Span>{this.props.imageName}</Span>
+					<Span color="#7e8085">{this.props.imageSize}</Span>
+				</Span>
+
+				<Span className="step-name">
+					<SVGIcon
+						disabled
+						paths={['../../assets/drive.svg']}
+						width="20px"
+					></SVGIcon>
+					<Span>{this.props.driveTitle}</Span>
+				</Span>
+			</Div>
+		) : null;
+	}
+}

lib/gui/app/components/safe-webview/safe-webview.tsx

@@ -0,0 +1,213 @@
+/*
+ * Copyright 2017 balena.io
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import * as electron from 'electron';
+import * as _ from 'lodash';
+import * as React from 'react';
+
+import * as packageJSON from '../../../../../package.json';
+import * as settings from '../../models/settings';
+import { store } from '../../models/store';
+import * as analytics from '../../modules/analytics';
+
+/**
+ * @summary Electron session identifier
+ */
+const ELECTRON_SESSION = 'persist:success-banner';
+
+/**
+ * @summary Etcher version search-parameter key
+ */
+const ETCHER_VERSION_PARAM = 'etcher-version';
+
+/**
+ * @summary API version search-parameter key
+ */
+const API_VERSION_PARAM = 'api-version';
+
+/**
+ * @summary Opt-out analytics search-parameter key
+ */
+const OPT_OUT_ANALYTICS_PARAM = 'optOutAnalytics';
+
+/**
+ * @summary Webview API version
+ *
+ * @description
+ * Changing this number represents a departure from an older API and as such
+ * should only be changed when truly necessary as it introduces breaking changes.
+ * This version number is exposed to the banner such that it can determine what
+ * features are safe to utilize.
+ *
+ * See `git blame -L n` where n is the line below for the history of version changes.
+ */
+const API_VERSION = '2';
+
+interface SafeWebviewProps {
+	// The website source URL
+	src: string;
+	// @summary Refresh the webview
+	refreshNow?: boolean;
+	// Webview lifecycle event
+	onWebviewShow?: (isWebviewShowing: boolean) => void;
+}
+
+interface SafeWebviewState {
+	shouldShow: boolean;
+}
+
+/**
+ * @summary Webviews that hide/show depending on the HTTP status returned
+ */
+export class SafeWebview extends React.PureComponent<
+	SafeWebviewProps,
+	SafeWebviewState
+> {
+	private entryHref: string;
+	private session: electron.Session;
+	private webviewRef: React.RefObject<electron.WebviewTag>;
+
+	constructor(props: SafeWebviewProps) {
+		super(props);
+		this.webviewRef = React.createRef();
+		this.state = {
+			shouldShow: true,
+		};
+		const url = new window.URL(this.props.src);
+		// We set the version GET parameters here.
+		url.searchParams.set(ETCHER_VERSION_PARAM, packageJSON.version);
+		url.searchParams.set(API_VERSION_PARAM, API_VERSION);
+		url.searchParams.set(
+			OPT_OUT_ANALYTICS_PARAM,
+			(!settings.get('errorReporting')).toString(),
+		);
+		this.entryHref = url.href;
+		// Events steal 'this'
+		this.didFailLoad = _.bind(this.didFailLoad, this);
+		this.didGetResponseDetails = _.bind(this.didGetResponseDetails, this);
+		// Make a persistent electron session for the webview
+		this.session = electron.remote.session.fromPartition(ELECTRON_SESSION, {
+			// Disable the cache for the session such that new content shows up when refreshing
+			cache: false,
+		});
+	}
+
+	private static logWebViewMessage(event: electron.ConsoleMessageEvent) {
+		console.log('Message from SafeWebview:', event.message);
+	}
+
+	public render() {
+		return (
+			<webview
+				ref={this.webviewRef}
+				partition={ELECTRON_SESSION}
+				style={{
+					flex: this.state.shouldShow ? undefined : '0 1',
+					width: this.state.shouldShow ? undefined : '0',
+					height: this.state.shouldShow ? undefined : '0',
+				}}
+			/>
+		);
+	}
+
+	// Add the Webview events
+	public componentDidMount() {
+		// Events React is unaware of have to be handled manually
+		if (this.webviewRef.current !== null) {
+			this.webviewRef.current.addEventListener(
+				'did-fail-load',
+				this.didFailLoad,
+			);
+			this.webviewRef.current.addEventListener(
+				'new-window',
+				SafeWebview.newWindow,
+			);
+			this.webviewRef.current.addEventListener(
+				'console-message',
+				SafeWebview.logWebViewMessage,
+			);
+			this.session.webRequest.onCompleted(this.didGetResponseDetails);
+			// It's important that this comes after the partition setting, otherwise it will
+			// use another session and we can't change it without destroying the element again
+			this.webviewRef.current.src = this.entryHref;
+		}
+	}
+
+	// Remove the Webview events
+	public componentWillUnmount() {
+		// Events that React is unaware of have to be handled manually
+		if (this.webviewRef.current !== null) {
+			this.webviewRef.current.removeEventListener(
+				'did-fail-load',
+				this.didFailLoad,
+			);
+			this.webviewRef.current.removeEventListener(
+				'new-window',
+				SafeWebview.newWindow,
+			);
+			this.webviewRef.current.removeEventListener(
+				'console-message',
+				SafeWebview.logWebViewMessage,
+			);
+		}
+		this.session.webRequest.onCompleted(null);
+	}
+
+	// Set the element state to hidden
+	public didFailLoad() {
+		this.setState({
+			shouldShow: false,
+		});
+		if (this.props.onWebviewShow) {
+			this.props.onWebviewShow(false);
+		}
+	}
+
+	// Set the element state depending on the HTTP response code
+	public didGetResponseDetails(event: electron.OnCompletedListenerDetails) {
+		// This seems to pick up all requests related to the webview,
+		// only care about this event if it's a request for the main frame
+		if (event.resourceType === 'mainFrame') {
+			const HTTP_OK = 200;
+			analytics.logEvent('SafeWebview loaded', {
+				event,
+				applicationSessionUuid: store.getState().toJS().applicationSessionUuid,
+				flashingWorkflowUuid: store.getState().toJS().flashingWorkflowUuid,
+			});
+			this.setState({
+				shouldShow: event.statusCode === HTTP_OK,
+			});
+			if (this.props.onWebviewShow) {
+				this.props.onWebviewShow(event.statusCode === HTTP_OK);
+			}
+		}
+	}
+
+	// Open link in browser if it's opened as a 'foreground-tab'
+	public static newWindow(event: electron.NewWindowEvent) {
+		const url = new window.URL(event.url);
+		if (
+			_.every([
+				url.protocol === 'http:' || url.protocol === 'https:',
+				event.disposition === 'foreground-tab',
+				// Don't open links if they're disabled by the env var
+				!settings.get('disableExternalLinks'),
+			])
+		) {
+			electron.shell.openExternal(url.href);
+		}
+	}
+}

lib/gui/app/components/settings/settings.tsx

@@ -0,0 +1,223 @@
+/*
+ * Copyright 2019 balena.io
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import { faGithub } from '@fortawesome/free-brands-svg-icons';
+import { FontAwesomeIcon } from '@fortawesome/react-fontawesome';
+import * as _ from 'lodash';
+import * as os from 'os';
+import * as React from 'react';
+import { Badge, Checkbox, Modal } from 'rendition';
+import styled from 'styled-components';
+
+import { version } from '../../../../../package.json';
+import * as settings from '../../models/settings';
+import { store } from '../../models/store';
+import * as analytics from '../../modules/analytics';
+import { open as openExternal } from '../../os/open-external/services/open-external';
+
+const { useState } = React;
+const platform = os.platform();
+
+interface WarningModalProps {
+	message: string;
+	confirmLabel: string;
+	cancel: () => void;
+	done: () => void;
+}
+
+const WarningModal = ({
+	message,
+	confirmLabel,
+	cancel,
+	done,
+}: WarningModalProps) => {
+	return (
+		<Modal
+			title={confirmLabel}
+			action={confirmLabel}
+			cancel={cancel}
+			done={done}
+			style={{
+				width: 420,
+				height: 300,
+			}}
+			primaryButtonProps={{ warning: true }}
+		>
+			{message}
+		</Modal>
+	);
+};
+
+interface Setting {
+	name: string;
+	label: string | JSX.Element;
+	options?: any;
+	hide?: boolean;
+}
+
+const settingsList: Setting[] = [
+	{
+		name: 'errorReporting',
+		label: 'Anonymously report errors and usage statistics to balena.io',
+	},
+	{
+		name: 'unmountOnSuccess',
+		/**
+		 * On Windows, "Unmounting" basically means "ejecting".
+		 * On top of that, Windows users are usually not even
+		 * familiar with the meaning of "unmount", which comes
+		 * from the UNIX world.
+		 */
+		label: `${platform === 'win32' ? 'Eject' : 'Auto-unmount'} on success`,
+	},
+	{
+		name: 'validateWriteOnSuccess',
+		label: 'Validate write on success',
+	},
+	{
+		name: 'trim',
+		label: 'Trim ext{2,3,4} partitions before writing (raw images only)',
+	},
+	{
+		name: 'updatesEnabled',
+		label: 'Auto-updates enabled',
+	},
+	{
+		name: 'unsafeMode',
+		label: (
+			<span>
+				Unsafe mode{' '}
+				<Badge danger fontSize={12}>
+					Dangerous
+				</Badge>
+			</span>
+		),
+		options: {
+			description: `Are you sure you want to turn this on?
+			You will be able to overwrite your system drives if you're not careful.`,
+			confirmLabel: 'Enable unsafe mode',
+		},
+		hide: settings.get('disableUnsafeMode'),
+	},
+];
+
+interface SettingsModalProps {
+	toggleModal: (value: boolean) => void;
+}
+
+export const SettingsModal: any = styled(
+	({ toggleModal }: SettingsModalProps) => {
+		const [currentSettings, setCurrentSettings]: [
+			_.Dictionary<any>,
+			React.Dispatch<React.SetStateAction<_.Dictionary<any>>>,
+		] = useState(settings.getAll());
+		const [warning, setWarning]: [
+			any,
+			React.Dispatch<React.SetStateAction<any>>,
+		] = useState({});
+
+		const toggleSetting = async (setting: string, options?: any) => {
+			const value = currentSettings[setting];
+			const dangerous = !_.isUndefined(options);
+
+			analytics.logEvent('Toggle setting', {
+				setting,
+				value,
+				dangerous,
+				// @ts-ignore
+				applicationSessionUuid: store.getState().toJS().applicationSessionUuid,
+			});
+
+			if (value || !dangerous) {
+				await settings.set(setting, !value);
+				setCurrentSettings({
+					...currentSettings,
+					[setting]: !value,
+				});
+				setWarning({});
+				return;
+			}
+
+			// Show warning since it's a dangerous setting
+			setWarning({
+				setting,
+				settingValue: value,
+				...options,
+			});
+		};
+
+		return (
+			<Modal
+				id="settings-modal"
+				title="Settings"
+				done={() => toggleModal(false)}
+				style={{
+					width: 780,
+					height: 420,
+				}}
+			>
+				<div>
+					{_.map(settingsList, (setting: Setting, i: number) => {
+						return setting.hide ? null : (
+							<div key={setting.name}>
+								<Checkbox
+									toggle
+									tabIndex={6 + i}
+									label={setting.label}
+									checked={currentSettings[setting.name]}
+									onChange={() => toggleSetting(setting.name, setting.options)}
+								/>
+							</div>
+						);
+					})}
+					<div>
+						<span
+							onClick={() =>
+								openExternal(
+									'https://github.com/balena-io/etcher/blob/master/CHANGELOG.md',
+								)
+							}
+						>
+							<FontAwesomeIcon icon={faGithub} /> {version}
+						</span>
+					</div>
+				</div>
+
+				{_.isEmpty(warning) ? null : (
+					<WarningModal
+						message={warning.description}
+						confirmLabel={warning.confirmLabel}
+						done={() => {
+							settings.set(warning.setting, !warning.settingValue);
+							setCurrentSettings({
+								...currentSettings,
+								[warning.setting]: true,
+							});
+							setWarning({});
+						}}
+						cancel={() => {
+							setWarning({});
+						}}
+					/>
+				)}
+			</Modal>
+		);
+	},
+)`
+	> div:nth-child(3) {
+		justify-content: center;
+	}
+`;

lib/gui/app/components/svg-icon/svg-icon.tsx

@@ -0,0 +1,142 @@
+/*
+ * Copyright 2018 balena.io
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import * as fs from 'fs';
+import * as _ from 'lodash';
+import * as path from 'path';
+import * as React from 'react';
+
+import * as analytics from '../../modules/analytics';
+
+const domParser = new window.DOMParser();
+
+const DEFAULT_SIZE = '40px';
+
+/**
+ * @summary Try to parse SVG contents and return it data encoded
+ *
+ * @param {String} contents - SVG XML contents
+ * @returns {String|null}
+ *
+ * @example
+ * const encodedSVG = tryParseSVGContents('<svg><path></path></svg>')
+ *
+ * img.src = encodedSVG
+ */
+function tryParseSVGContents(contents: string) {
+	const doc = domParser.parseFromString(contents, 'image/svg+xml');
+	const parserError = doc.querySelector('parsererror');
+	const svg = doc.querySelector('svg');
+
+	if (!parserError && svg) {
+		return `data:image/svg+xml,${encodeURIComponent(svg.outerHTML)}`;
+	}
+
+	return null;
+}
+
+interface SVGIconProps {
+	// Paths to SVG files to be tried in succession if any fails
+	paths: string[];
+	// List of embedded SVG contents to be tried in succession if any fails
+	contents?: string[];
+	// SVG image width unit
+	width?: string;
+	// SVG image height unit
+	height?: string;
+	// Should the element visually appear grayed out and disabled?
+	disabled?: boolean;
+}
+
+/**
+ * @summary SVG element that takes both filepaths and file contents
+ */
+export class SVGIcon extends React.Component<SVGIconProps> {
+	public render() {
+		// __dirname behaves strangely inside a Webpack bundle,
+		// so we need to provide different base directories
+		// depending on whether __dirname is absolute or not,
+		// which helps detecting a Webpack bundle.
+		// We use global.__dirname inside a Webpack bundle since
+		// that's the only way to get the "real" __dirname.
+		let baseDirectory: string;
+		if (path.isAbsolute(__dirname)) {
+			baseDirectory = path.join(__dirname, '..');
+		} else {
+			// @ts-ignore
+			baseDirectory = global.__dirname;
+		}
+
+		let svgData = '';
+
+		_.find(this.props.contents, content => {
+			const attempt = tryParseSVGContents(content);
+
+			if (attempt) {
+				svgData = attempt;
+				return true;
+			}
+
+			return false;
+		});
+
+		if (!svgData) {
+			_.find(this.props.paths, relativePath => {
+				// This means the path to the icon should be
+				// relative to *this directory*.
+				// TODO: There might be a way to compute the path
+				// relatively to the `index.html`.
+				const imagePath = path.join(baseDirectory, 'assets', relativePath);
+
+				const contents = _.attempt(() => {
+					return fs.readFileSync(imagePath, {
+						encoding: 'utf8',
+					});
+				});
+
+				if (_.isError(contents)) {
+					analytics.logException(contents);
+					return false;
+				}
+
+				const parsed = tryParseSVGContents(contents);
+
+				if (parsed) {
+					svgData = parsed;
+					return true;
+				}
+
+				return false;
+			});
+		}
+
+		const width = this.props.width || DEFAULT_SIZE;
+		const height = this.props.height || DEFAULT_SIZE;
+
+		return (
+			<img
+				className="svg-icon"
+				style={{
+					width,
+					height,
+				}}
+				src={svgData}
+				// @ts-ignore
+				disabled={this.props.disabled}
+			></img>
+		);
+	}
+}

lib/gui/app/index.html

@@ -0,0 +1,14 @@
+<!DOCTYPE html>
+<html>
+  <head>
+    <meta charset="UTF-8">
+    <title>Etcher</title>
+    <link rel="stylesheet" type="text/css" href="../../../node_modules/flexboxgrid/dist/flexboxgrid.css">
+    <link rel="stylesheet" type="text/css" href="../css/main.css">
+    <link rel="stylesheet" type="text/css" href="../css/desktop.css">
+  </head>
+  <body>
+    <main id="main"></main>
+    <script src="../../../generated/gui.js"></script>
+  </body>
+</html>

lib/gui/app/models/available-drives.ts

@@ -1,5 +1,5 @@
 /*
- * Copyright 2016 resin.io
+ * Copyright 2016 balena.io
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -14,10 +14,21 @@
  * limitations under the License.
  */
 
-.modal-warning-modal .modal-content {
-  width: 350px;
+import * as _ from 'lodash';
+
+import { Actions, store } from './store';
+
+export function hasAvailableDrives() {
+	return !_.isEmpty(getDrives());
 }
 
-.modal-warning-modal .modal-title .glyphicon {
-  color: $palette-theme-danger-background;
+export function setDrives(drives: any[]) {
+	store.dispatch({
+		type: Actions.SET_AVAILABLE_DRIVES,
+		data: drives,
+	});
+}
+
+export function getDrives(): any[] {
+	return store.getState().toJS().availableDrives;
 }

lib/gui/app/models/flash-state.ts

@@ -0,0 +1,131 @@
+/*
+ * Copyright 2016 balena.io
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import * as sdk from 'etcher-sdk';
+import * as _ from 'lodash';
+
+import { bytesToMegabytes } from '../../../shared/units';
+import { Actions, store } from './store';
+
+/**
+ * @summary Reset flash state
+ */
+export function resetState() {
+	store.dispatch({
+		type: Actions.RESET_FLASH_STATE,
+	});
+}
+
+/**
+ * @summary Check if currently flashing
+ */
+export function isFlashing(): boolean {
+	return store.getState().toJS().isFlashing;
+}
+
+/**
+ * @summary Set the flashing flag
+ *
+ * @description
+ * The flag is used to signify that we're going to
+ * start a flash process.
+ */
+export function setFlashingFlag() {
+	store.dispatch({
+		type: Actions.SET_FLASHING_FLAG,
+	});
+}
+
+/**
+ * @summary Unset the flashing flag
+ *
+ * @description
+ * The flag is used to signify that the write process ended.
+ */
+export function unsetFlashingFlag(results: {
+	cancelled?: boolean;
+	sourceChecksum?: string;
+	errorCode?: string | number;
+}) {
+	store.dispatch({
+		type: Actions.UNSET_FLASHING_FLAG,
+		data: results,
+	});
+}
+
+/**
+ * @summary Set the flashing state
+ */
+export function setProgressState(
+	state: sdk.multiWrite.MultiDestinationProgress,
+) {
+	// Preserve only one decimal place
+	const PRECISION = 1;
+	const data = _.assign({}, state, {
+		percentage:
+			state.percentage !== undefined && _.isFinite(state.percentage)
+				? Math.floor(state.percentage)
+				: undefined,
+
+		speed: _.attempt(() => {
+			if (_.isFinite(state.speed)) {
+				return _.round(bytesToMegabytes(state.speed), PRECISION);
+			}
+
+			return null;
+		}),
+
+		totalSpeed: _.attempt(() => {
+			if (_.isFinite(state.totalSpeed)) {
+				return _.round(bytesToMegabytes(state.totalSpeed), PRECISION);
+			}
+
+			return null;
+		}),
+	});
+
+	store.dispatch({
+		type: Actions.SET_FLASH_STATE,
+		data,
+	});
+}
+
+export function getFlashResults() {
+	return store.getState().toJS().flashResults;
+}
+
+export function getFlashState() {
+	return store
+		.getState()
+		.get('flashState')
+		.toJS();
+}
+
+export function wasLastFlashCancelled() {
+	return _.get(getFlashResults(), ['cancelled'], false);
+}
+
+export function getLastFlashSourceChecksum(): string {
+	return getFlashResults().sourceChecksum;
+}
+
+export function getLastFlashErrorCode() {
+	return getFlashResults().errorCode;
+}
+
+export function getFlashUuid() {
+	return store.getState().toJS().flashUuid;
+}

lib/gui/app/models/leds.ts

@@ -0,0 +1,99 @@
+/*
+ * Copyright 2020 balena.io
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import {
+	AnimationFunction,
+	blinkWhite,
+	breatheGreen,
+	Color,
+	RGBLed,
+} from 'sys-class-rgb-led';
+
+import * as settings from './settings';
+import { observe } from './store';
+
+const leds: Map<string, RGBLed> = new Map();
+
+function setLeds(
+	drivesPaths: Set<string>,
+	colorOrAnimation: Color | AnimationFunction,
+) {
+	for (const path of drivesPaths) {
+		const led = leds.get(path);
+		if (led) {
+			if (Array.isArray(colorOrAnimation)) {
+				led.setStaticColor(colorOrAnimation);
+			} else {
+				led.setAnimation(colorOrAnimation);
+			}
+		}
+	}
+}
+
+export function updateLeds(
+	availableDrives: string[],
+	selectedDrives: string[],
+) {
+	const off = new Set(leds.keys());
+	const available = new Set(availableDrives);
+	const selected = new Set(selectedDrives);
+	for (const s of selected) {
+		available.delete(s);
+	}
+	for (const a of available) {
+		off.delete(a);
+	}
+	setLeds(off, [0, 0, 0]);
+	setLeds(available, breatheGreen);
+	setLeds(selected, blinkWhite);
+}
+
+interface DeviceFromState {
+	devicePath?: string;
+	device: string;
+}
+
+export function init() {
+	// ledsMapping is something like:
+	// {
+	// 	'platform-xhci-hcd.0.auto-usb-0:1.1.1:1.0-scsi-0:0:0:0': [
+	// 		'led1_r',
+	// 		'led1_g',
+	// 		'led1_b',
+	// 	],
+	// 	...
+	// }
+	const ledsMapping: _.Dictionary<[string, string, string]> =
+		settings.get('ledsMapping') || {};
+	for (const [drivePath, ledsNames] of Object.entries(ledsMapping)) {
+		leds.set('/dev/disk/by-path/' + drivePath, new RGBLed(ledsNames));
+	}
+	observe(state => {
+		const availableDrives = state
+			.get('availableDrives')
+			.toJS()
+			.filter((d: DeviceFromState) => d.devicePath);
+		const availableDrivesPaths = availableDrives.map(
+			(d: DeviceFromState) => d.devicePath,
+		);
+		// like /dev/sda
+		const selectedDrivesDevices = state.getIn(['selection', 'devices']).toJS();
+		const selectedDrivesPaths = availableDrives
+			.filter((d: DeviceFromState) => selectedDrivesDevices.includes(d.device))
+			.map((d: DeviceFromState) => d.devicePath);
+		updateLeds(availableDrivesPaths, selectedDrivesPaths);
+	});
+}

lib/gui/app/models/local-settings.ts

@@ -0,0 +1,73 @@
+/*
+ * Copyright 2017 balena.io
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import * as electron from 'electron';
+import { promises as fs } from 'fs';
+import * as path from 'path';
+
+const JSON_INDENT = 2;
+
+/**
+ * @summary Userdata directory path
+ * @description
+ * Defaults to the following:
+ * - `%APPDATA%/etcher` on Windows
+ * - `$XDG_CONFIG_HOME/etcher` or `~/.config/etcher` on Linux
+ * - `~/Library/Application Support/etcher` on macOS
+ * See https://electronjs.org/docs/api/app#appgetpathname
+ *
+ * NOTE: The ternary is due to this module being loaded both,
+ * Electron's main process and renderer process
+ */
+const USER_DATA_DIR = electron.app
+	? electron.app.getPath('userData')
+	: electron.remote.app.getPath('userData');
+
+const CONFIG_PATH = path.join(USER_DATA_DIR, 'config.json');
+
+async function readConfigFile(filename: string): Promise<any> {
+	let contents = '{}';
+	try {
+		contents = await fs.readFile(filename, { encoding: 'utf8' });
+	} catch (error) {
+		if (error.code !== 'ENOENT') {
+			throw error;
+		}
+	}
+	try {
+		return JSON.parse(contents);
+	} catch (parseError) {
+		console.error(parseError);
+		return {};
+	}
+}
+
+async function writeConfigFile(filename: string, data: any): Promise<any> {
+	await fs.writeFile(filename, JSON.stringify(data, null, JSON_INDENT));
+	return data;
+}
+
+export async function readAll(): Promise<any> {
+	return await readConfigFile(CONFIG_PATH);
+}
+
+export async function writeAll(settings: any): Promise<any> {
+	return await writeConfigFile(CONFIG_PATH, settings);
+}
+
+export async function clear(): Promise<void> {
+	await fs.unlink(CONFIG_PATH);
+}

lib/gui/app/models/selection-state.ts

@@ -0,0 +1,161 @@
+/*
+ * Copyright 2016 balena.io
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import * as _ from 'lodash';
+
+import * as availableDrives from './available-drives';
+import { Actions, store } from './store';
+
+/**
+ * @summary Select a drive by its device path
+ */
+export function selectDrive(driveDevice: string) {
+	store.dispatch({
+		type: Actions.SELECT_DRIVE,
+		data: driveDevice,
+	});
+}
+
+/**
+ * @summary Toggle drive selection
+ */
+export function toggleDrive(driveDevice: string) {
+	if (isDriveSelected(driveDevice)) {
+		deselectDrive(driveDevice);
+	} else {
+		selectDrive(driveDevice);
+	}
+}
+
+export function selectImage(image: any) {
+	store.dispatch({
+		type: Actions.SELECT_IMAGE,
+		data: image,
+	});
+}
+
+/**
+ * @summary Get all selected drives' devices
+ */
+export function getSelectedDevices(): string[] {
+	return store
+		.getState()
+		.getIn(['selection', 'devices'])
+		.toJS();
+}
+
+/**
+ * @summary Get all selected drive objects
+ */
+export function getSelectedDrives(): any[] {
+	const drives = availableDrives.getDrives();
+	return _.map(getSelectedDevices(), device => {
+		return _.find(drives, { device });
+	});
+}
+
+/**
+ * @summary Get the selected image
+ */
+export function getImage() {
+	return _.get(store.getState().toJS(), ['selection', 'image']);
+}
+
+export function getImagePath(): string {
+	return _.get(store.getState().toJS(), ['selection', 'image', 'path']);
+}
+
+export function getImageSize(): number {
+	return _.get(store.getState().toJS(), ['selection', 'image', 'size']);
+}
+
+export function getImageUrl(): string {
+	return _.get(store.getState().toJS(), ['selection', 'image', 'url']);
+}
+
+export function getImageName(): string {
+	return _.get(store.getState().toJS(), ['selection', 'image', 'name']);
+}
+
+export function getImageLogo(): string {
+	return _.get(store.getState().toJS(), ['selection', 'image', 'logo']);
+}
+
+export function getImageSupportUrl(): string {
+	return _.get(store.getState().toJS(), ['selection', 'image', 'supportUrl']);
+}
+
+export function getImageRecommendedDriveSize(): number {
+	return _.get(store.getState().toJS(), [
+		'selection',
+		'image',
+		'recommendedDriveSize',
+	]);
+}
+
+/**
+ * @summary Check if there is a selected drive
+ */
+export function hasDrive(): boolean {
+	return Boolean(getSelectedDevices().length);
+}
+
+/**
+ * @summary Check if there is a selected image
+ */
+export function hasImage(): boolean {
+	return Boolean(getImage());
+}
+
+/**
+ * @summary Remove drive from selection
+ */
+export function deselectDrive(driveDevice: string) {
+	store.dispatch({
+		type: Actions.DESELECT_DRIVE,
+		data: driveDevice,
+	});
+}
+
+export function deselectImage() {
+	store.dispatch({
+		type: Actions.DESELECT_IMAGE,
+	});
+}
+
+export function deselectAllDrives() {
+	_.each(getSelectedDevices(), deselectDrive);
+}
+
+/**
+ * @summary Clear selections
+ */
+export function clear() {
+	deselectImage();
+	deselectAllDrives();
+}
+
+/**
+ * @summary Check whether a given device is selected.
+ */
+export function isDriveSelected(driveDevice: string) {
+	if (!driveDevice) {
+		return false;
+	}
+
+	const selectedDriveDevices = getSelectedDevices();
+	return _.includes(selectedDriveDevices, driveDevice);
+}

lib/gui/app/models/settings.ts

@@ -0,0 +1,110 @@
+/*
+ * Copyright 2016 balena.io
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import * as _debug from 'debug';
+import * as _ from 'lodash';
+
+import * as packageJSON from '../../../../package.json';
+import * as errors from '../../../shared/errors';
+import * as localSettings from './local-settings';
+
+const debug = _debug('etcher:models:settings');
+
+// exported for tests
+export const DEFAULT_SETTINGS: _.Dictionary<any> = {
+	unsafeMode: false,
+	errorReporting: true,
+	unmountOnSuccess: true,
+	validateWriteOnSuccess: true,
+	trim: false,
+	updatesEnabled:
+		packageJSON.updates.enabled &&
+		!_.includes(['rpm', 'deb'], packageJSON.packageType),
+	lastSleptUpdateNotifier: null,
+	lastSleptUpdateNotifierVersion: null,
+	desktopNotifications: true,
+};
+
+let settings = _.cloneDeep(DEFAULT_SETTINGS);
+
+/**
+ * @summary Reset settings to their default values
+ */
+export async function reset(): Promise<void> {
+	debug('reset');
+	// TODO: Remove default settings from config file (?)
+	settings = _.cloneDeep(DEFAULT_SETTINGS);
+	return await localSettings.writeAll(settings);
+}
+
+/**
+ * @summary Extend the application state with the local settings
+ */
+export async function load(): Promise<void> {
+	debug('load');
+	const loadedSettings = await localSettings.readAll();
+	_.assign(settings, loadedSettings);
+}
+
+/**
+ * @summary Set a setting value
+ */
+export async function set(key: string, value: any): Promise<void> {
+	debug('set', key, value);
+	if (_.isNil(key)) {
+		throw errors.createError({
+			title: 'Missing setting key',
+		});
+	}
+
+	if (!_.isString(key)) {
+		throw errors.createError({
+			title: `Invalid setting key: ${key}`,
+		});
+	}
+
+	const previousValue = settings[key];
+	settings[key] = value;
+	try {
+		await localSettings.writeAll(settings);
+	} catch (error) {
+		// Revert to previous value if persisting settings failed
+		settings[key] = previousValue;
+		throw error;
+	}
+}
+
+/**
+ * @summary Get a setting value
+ */
+export function get(key: string): any {
+	return _.cloneDeep(_.get(settings, [key]));
+}
+
+/**
+ * @summary Check if setting value exists
+ */
+export function has(key: string): boolean {
+	return settings[key] != null;
+}
+
+/**
+ * @summary Get all setting values
+ */
+export function getAll() {
+	debug('getAll');
+	return _.cloneDeep(settings);
+}

lib/gui/app/models/store.ts

@@ -0,0 +1,572 @@
+/*
+ * Copyright 2016 balena.io
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import * as Immutable from 'immutable';
+import * as _ from 'lodash';
+import * as redux from 'redux';
+import * as uuidV4 from 'uuid/v4';
+
+import * as constraints from '../../../shared/drive-constraints';
+import * as errors from '../../../shared/errors';
+import * as fileExtensions from '../../../shared/file-extensions';
+import * as supportedFormats from '../../../shared/supported-formats';
+import * as utils from '../../../shared/utils';
+import * as settings from './settings';
+
+/**
+ * @summary Verify and throw if any state fields are nil
+ */
+function verifyNoNilFields(
+	object: _.Dictionary<any>,
+	fields: string[],
+	name: string,
+) {
+	const nilFields = _.filter(fields, field => {
+		return _.isNil(_.get(object, field));
+	});
+	if (nilFields.length) {
+		throw new Error(`Missing ${name} fields: ${nilFields.join(', ')}`);
+	}
+}
+
+/**
+ * @summary FLASH_STATE fields that can't be nil
+ */
+const flashStateNoNilFields = ['speed', 'totalSpeed'];
+
+/**
+ * @summary SELECT_IMAGE fields that can't be nil
+ */
+const selectImageNoNilFields = ['path', 'extension'];
+
+/**
+ * @summary Application default state
+ */
+const DEFAULT_STATE = Immutable.fromJS({
+	applicationSessionUuid: '',
+	flashingWorkflowUuid: '',
+	availableDrives: [],
+	selection: {
+		devices: Immutable.OrderedSet(),
+	},
+	isFlashing: false,
+	flashResults: {},
+	flashState: {
+		flashing: 0,
+		verifying: 0,
+		successful: 0,
+		failed: 0,
+		percentage: 0,
+		speed: null,
+		totalSpeed: null,
+	},
+});
+
+/**
+ * @summary Application supported action messages
+ */
+export enum Actions {
+	SET_AVAILABLE_DRIVES,
+	SET_FLASH_STATE,
+	RESET_FLASH_STATE,
+	SET_FLASHING_FLAG,
+	UNSET_FLASHING_FLAG,
+	SELECT_DRIVE,
+	SELECT_IMAGE,
+	DESELECT_DRIVE,
+	DESELECT_IMAGE,
+	SET_APPLICATION_SESSION_UUID,
+	SET_FLASHING_WORKFLOW_UUID,
+}
+
+interface Action {
+	type: Actions;
+	data: any;
+}
+
+/**
+ * @summary Get available drives from the state
+ *
+ * @param {Object} state - state object
+ * @returns {Object} new state
+ */
+function getAvailableDrives(state: typeof DEFAULT_STATE) {
+	return state.get('availableDrives').toJS();
+}
+
+/**
+ * @summary The redux store reducer
+ */
+function storeReducer(
+	state = DEFAULT_STATE,
+	action: Action,
+): typeof DEFAULT_STATE {
+	switch (action.type) {
+		case Actions.SET_AVAILABLE_DRIVES: {
+			// Type: action.data : Array<DriveObject>
+
+			if (!action.data) {
+				throw errors.createError({
+					title: 'Missing drives',
+				});
+			}
+
+			let drives = action.data;
+
+			if (!_.isArray(drives) || !_.every(drives, _.isObject)) {
+				throw errors.createError({
+					title: `Invalid drives: ${drives}`,
+				});
+			}
+
+			drives = _.sortBy(drives, [
+				// Devices with no devicePath first (usbboot)
+				d => !!d.devicePath,
+				// Then sort by devicePath (only available on Linux with udev) or device
+				d => d.devicePath || d.device,
+			]);
+
+			const newState = state.set('availableDrives', Immutable.fromJS(drives));
+			const selectedDevices = newState.getIn(['selection', 'devices']).toJS();
+
+			// Remove selected drives that are stale, i.e. missing from availableDrives
+			const nonStaleNewState = _.reduce(
+				selectedDevices,
+				(accState, device) => {
+					// Check whether the drive still exists in availableDrives
+					if (
+						device &&
+						!_.find(drives, {
+							device,
+						})
+					) {
+						// Deselect this drive gone from availableDrives
+						return storeReducer(accState, {
+							type: Actions.DESELECT_DRIVE,
+							data: device,
+						});
+					}
+
+					return accState;
+				},
+				newState,
+			);
+
+			const shouldAutoselectAll = Boolean(
+				settings.get('disableExplicitDriveSelection'),
+			);
+			const AUTOSELECT_DRIVE_COUNT = 1;
+			const nonStaleSelectedDevices = nonStaleNewState
+				.getIn(['selection', 'devices'])
+				.toJS();
+			const hasSelectedDevices =
+				nonStaleSelectedDevices.length >= AUTOSELECT_DRIVE_COUNT;
+			const shouldAutoselectOne =
+				drives.length === AUTOSELECT_DRIVE_COUNT && !hasSelectedDevices;
+
+			if (shouldAutoselectOne || shouldAutoselectAll) {
+				// Even if there's no image selected, we need to call several
+				// drive/image related checks, and `{}` works fine with them
+				const image = state
+					.getIn(['selection', 'image'], Immutable.fromJS({}))
+					.toJS();
+
+				return _.reduce(
+					drives,
+					(accState, drive) => {
+						if (
+							_.every([
+								constraints.isDriveValid(drive, image),
+								constraints.isDriveSizeRecommended(drive, image),
+
+								// We don't want to auto-select large drives
+								!constraints.isDriveSizeLarge(drive),
+
+								// We don't want to auto-select system drives,
+								// even when "unsafe mode" is enabled
+								!constraints.isSystemDrive(drive),
+							]) ||
+							(shouldAutoselectAll && constraints.isDriveValid(drive, image))
+						) {
+							// Auto-select this drive
+							return storeReducer(accState, {
+								type: Actions.SELECT_DRIVE,
+								data: drive.device,
+							});
+						}
+
+						// Deselect this drive in case it still is selected
+						return storeReducer(accState, {
+							type: Actions.DESELECT_DRIVE,
+							data: drive.device,
+						});
+					},
+					nonStaleNewState,
+				);
+			}
+
+			return nonStaleNewState;
+		}
+
+		case Actions.SET_FLASH_STATE: {
+			// Type: action.data : FlashStateObject
+
+			if (!state.get('isFlashing')) {
+				throw errors.createError({
+					title: "Can't set the flashing state when not flashing",
+				});
+			}
+
+			verifyNoNilFields(action.data, flashStateNoNilFields, 'flash');
+
+			if (
+				!_.every(
+					_.pick(action.data, [
+						'flashing',
+						'verifying',
+						'successful',
+						'failed',
+					]),
+					_.isFinite,
+				)
+			) {
+				throw errors.createError({
+					title: 'State quantity field(s) not finite number',
+				});
+			}
+
+			if (
+				!_.isUndefined(action.data.percentage) &&
+				!utils.isValidPercentage(action.data.percentage)
+			) {
+				throw errors.createError({
+					title: `Invalid state percentage: ${action.data.percentage}`,
+				});
+			}
+
+			if (!_.isUndefined(action.data.eta) && !_.isNumber(action.data.eta)) {
+				throw errors.createError({
+					title: `Invalid state eta: ${action.data.eta}`,
+				});
+			}
+
+			return state.set('flashState', Immutable.fromJS(action.data));
+		}
+
+		case Actions.RESET_FLASH_STATE: {
+			return state
+				.set('isFlashing', false)
+				.set('flashState', DEFAULT_STATE.get('flashState'))
+				.set('flashResults', DEFAULT_STATE.get('flashResults'))
+				.delete('flashUuid');
+		}
+
+		case Actions.SET_FLASHING_FLAG: {
+			return state
+				.set('isFlashing', true)
+				.set('flashUuid', uuidV4())
+				.set('flashResults', DEFAULT_STATE.get('flashResults'));
+		}
+
+		case Actions.UNSET_FLASHING_FLAG: {
+			// Type: action.data : FlashResultsObject
+
+			if (!action.data) {
+				throw errors.createError({
+					title: 'Missing results',
+				});
+			}
+
+			_.defaults(action.data, {
+				cancelled: false,
+			});
+
+			if (!_.isBoolean(action.data.cancelled)) {
+				throw errors.createError({
+					title: `Invalid results cancelled: ${action.data.cancelled}`,
+				});
+			}
+
+			if (action.data.cancelled && action.data.sourceChecksum) {
+				throw errors.createError({
+					title:
+						"The sourceChecksum value can't exist if the flashing was cancelled",
+				});
+			}
+
+			if (
+				action.data.sourceChecksum &&
+				!_.isString(action.data.sourceChecksum)
+			) {
+				throw errors.createError({
+					title: `Invalid results sourceChecksum: ${action.data.sourceChecksum}`,
+				});
+			}
+
+			if (
+				action.data.errorCode &&
+				!_.isString(action.data.errorCode) &&
+				!_.isNumber(action.data.errorCode)
+			) {
+				throw errors.createError({
+					title: `Invalid results errorCode: ${action.data.errorCode}`,
+				});
+			}
+
+			return state
+				.set('isFlashing', false)
+				.set('flashResults', Immutable.fromJS(action.data))
+				.set('flashState', DEFAULT_STATE.get('flashState'));
+		}
+
+		case Actions.SELECT_DRIVE: {
+			// Type: action.data : String
+
+			const device = action.data;
+
+			if (!device) {
+				throw errors.createError({
+					title: 'Missing drive',
+				});
+			}
+
+			if (!_.isString(device)) {
+				throw errors.createError({
+					title: `Invalid drive: ${device}`,
+				});
+			}
+
+			const selectedDrive = _.find(getAvailableDrives(state), { device });
+
+			if (!selectedDrive) {
+				throw errors.createError({
+					title: `The drive is not available: ${device}`,
+				});
+			}
+
+			if (selectedDrive.isReadOnly) {
+				throw errors.createError({
+					title: 'The drive is write-protected',
+				});
+			}
+
+			const image = state.getIn(['selection', 'image']);
+			if (
+				image &&
+				!constraints.isDriveLargeEnough(selectedDrive, image.toJS())
+			) {
+				throw errors.createError({
+					title: 'The drive is not large enough',
+				});
+			}
+
+			const selectedDevices = state.getIn(['selection', 'devices']);
+
+			return state.setIn(['selection', 'devices'], selectedDevices.add(device));
+		}
+
+		// TODO(jhermsmeier): Consolidate these assertions
+		// with image-stream / supported-formats, and have *one*
+		// place where all the image extension / format handling
+		// takes place, to avoid having to check 2+ locations with different logic
+		case Actions.SELECT_IMAGE: {
+			// Type: action.data : ImageObject
+
+			verifyNoNilFields(action.data, selectImageNoNilFields, 'image');
+
+			if (!_.isString(action.data.path)) {
+				throw errors.createError({
+					title: `Invalid image path: ${action.data.path}`,
+				});
+			}
+
+			if (!_.isString(action.data.extension)) {
+				throw errors.createError({
+					title: `Invalid image extension: ${action.data.extension}`,
+				});
+			}
+
+			const extension = _.toLower(action.data.extension);
+
+			if (!_.includes(supportedFormats.getAllExtensions(), extension)) {
+				throw errors.createError({
+					title: `Invalid image extension: ${action.data.extension}`,
+				});
+			}
+
+			let lastImageExtension = fileExtensions.getLastFileExtension(
+				action.data.path,
+			);
+			lastImageExtension = _.isString(lastImageExtension)
+				? _.toLower(lastImageExtension)
+				: lastImageExtension;
+
+			if (lastImageExtension !== extension) {
+				if (!_.isString(action.data.archiveExtension)) {
+					throw errors.createError({
+						title: 'Missing image archive extension',
+					});
+				}
+
+				const archiveExtension = _.toLower(action.data.archiveExtension);
+
+				if (
+					!_.includes(supportedFormats.getAllExtensions(), archiveExtension)
+				) {
+					throw errors.createError({
+						title: `Invalid image archive extension: ${action.data.archiveExtension}`,
+					});
+				}
+
+				if (lastImageExtension !== archiveExtension) {
+					throw errors.createError({
+						title: `Image archive extension mismatch: ${action.data.archiveExtension} and ${lastImageExtension}`,
+					});
+				}
+			}
+
+			const MINIMUM_IMAGE_SIZE = 0;
+
+			if (action.data.size !== undefined) {
+				if (
+					action.data.size < MINIMUM_IMAGE_SIZE ||
+					!_.isInteger(action.data.size)
+				) {
+					throw errors.createError({
+						title: `Invalid image size: ${action.data.size}`,
+					});
+				}
+			}
+
+			if (!_.isUndefined(action.data.compressedSize)) {
+				if (
+					action.data.compressedSize < MINIMUM_IMAGE_SIZE ||
+					!_.isInteger(action.data.compressedSize)
+				) {
+					throw errors.createError({
+						title: `Invalid image compressed size: ${action.data.compressedSize}`,
+					});
+				}
+			}
+
+			if (action.data.url && !_.isString(action.data.url)) {
+				throw errors.createError({
+					title: `Invalid image url: ${action.data.url}`,
+				});
+			}
+
+			if (action.data.name && !_.isString(action.data.name)) {
+				throw errors.createError({
+					title: `Invalid image name: ${action.data.name}`,
+				});
+			}
+
+			if (action.data.logo && !_.isString(action.data.logo)) {
+				throw errors.createError({
+					title: `Invalid image logo: ${action.data.logo}`,
+				});
+			}
+
+			const selectedDevices = state.getIn(['selection', 'devices']);
+
+			// Remove image-incompatible drives from selection with `constraints.isDriveValid`
+			return _.reduce(
+				selectedDevices.toJS(),
+				(accState, device) => {
+					const drive = _.find(getAvailableDrives(state), { device });
+					if (
+						!constraints.isDriveValid(drive, action.data) ||
+						!constraints.isDriveSizeRecommended(drive, action.data)
+					) {
+						return storeReducer(accState, {
+							type: Actions.DESELECT_DRIVE,
+							data: device,
+						});
+					}
+
+					return accState;
+				},
+				state,
+			).setIn(['selection', 'image'], Immutable.fromJS(action.data));
+		}
+
+		case Actions.DESELECT_DRIVE: {
+			// Type: action.data : String
+
+			if (!action.data) {
+				throw errors.createError({
+					title: 'Missing drive',
+				});
+			}
+
+			if (!_.isString(action.data)) {
+				throw errors.createError({
+					title: `Invalid drive: ${action.data}`,
+				});
+			}
+
+			const selectedDevices = state.getIn(['selection', 'devices']);
+
+			// Remove drive from set in state
+			return state.setIn(
+				['selection', 'devices'],
+				selectedDevices.delete(action.data),
+			);
+		}
+
+		case Actions.DESELECT_IMAGE: {
+			return state.deleteIn(['selection', 'image']);
+		}
+
+		case Actions.SET_APPLICATION_SESSION_UUID: {
+			return state.set('applicationSessionUuid', action.data);
+		}
+
+		case Actions.SET_FLASHING_WORKFLOW_UUID: {
+			return state.set('flashingWorkflowUuid', action.data);
+		}
+
+		default: {
+			return state;
+		}
+	}
+}
+
+export const store = redux.createStore(storeReducer, DEFAULT_STATE);
+
+/**
+ * @summary Observe the store for changes
+ * @param {Function} onChange - change handler
+ * @returns {Function} unsubscribe
+ */
+export function observe(onChange: (state: typeof DEFAULT_STATE) => void) {
+	let currentState: typeof DEFAULT_STATE | null = null;
+
+	/**
+	 * @summary Internal change detection handler
+	 */
+	const changeHandler = () => {
+		const nextState = store.getState();
+		if (!_.isEqual(nextState, currentState)) {
+			currentState = nextState;
+			onChange(currentState);
+		}
+	};
+
+	changeHandler();
+
+	return store.subscribe(changeHandler);
+}

lib/gui/app/modules/analytics.ts

@@ -0,0 +1,123 @@
+/*
+ * Copyright 2016 balena.io
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import * as _ from 'lodash';
+import * as resinCorvus from 'resin-corvus/browser';
+
+import * as packageJSON from '../../../../package.json';
+import { getConfig, hasProps } from '../../../shared/utils';
+import * as settings from '../models/settings';
+
+const sentryToken =
+	settings.get('analyticsSentryToken') ||
+	_.get(packageJSON, ['analytics', 'sentry', 'token']);
+const mixpanelToken =
+	settings.get('analyticsMixpanelToken') ||
+	_.get(packageJSON, ['analytics', 'mixpanel', 'token']);
+
+const configUrl =
+	settings.get('configUrl') || 'https://balena.io/etcher/static/config.json';
+
+const DEFAULT_PROBABILITY = 0.1;
+
+const services = {
+	sentry: sentryToken,
+	mixpanel: mixpanelToken,
+};
+
+resinCorvus.install({
+	services,
+	options: {
+		release: packageJSON.version,
+		shouldReport: () => {
+			return settings.get('errorReporting');
+		},
+		mixpanelDeferred: true,
+	},
+});
+
+let mixpanelSample = DEFAULT_PROBABILITY;
+
+/**
+ * @summary Init analytics configurations
+ */
+async function initConfig() {
+	let validatedConfig = null;
+	try {
+		const config = await getConfig(configUrl);
+		const mixpanel = _.get(config, ['analytics', 'mixpanel'], {});
+		mixpanelSample = mixpanel.probability || DEFAULT_PROBABILITY;
+		if (isClientEligible(mixpanelSample)) {
+			validatedConfig = validateMixpanelConfig(mixpanel);
+		}
+	} catch (err) {
+		resinCorvus.logException(err);
+	}
+	resinCorvus.setConfigs({
+		mixpanel: validatedConfig,
+	});
+}
+
+initConfig();
+
+/**
+ * @summary Check that the client is eligible for analytics
+ */
+function isClientEligible(probability: number) {
+	return Math.random() < probability;
+}
+
+/**
+ * @summary Check that config has at least HTTP_PROTOCOL and api_host
+ */
+function validateMixpanelConfig(config: {
+	api_host?: string;
+	HTTP_PROTOCOL?: string;
+}) {
+	const mixpanelConfig = {
+		api_host: 'https://api.mixpanel.com',
+	};
+	if (hasProps(config, ['HTTP_PROTOCOL', 'api_host'])) {
+		mixpanelConfig.api_host = `${config.HTTP_PROTOCOL}://${config.api_host}`;
+	}
+	return mixpanelConfig;
+}
+
+/**
+ * @summary Log a debug message
+ *
+ * @description
+ * This function sends the debug message to error reporting services.
+ */
+export const logDebug = resinCorvus.logDebug;
+
+/**
+ * @summary Log an event
+ *
+ * @description
+ * This function sends the debug message to product analytics services.
+ */
+export function logEvent(message: string, data: any) {
+	resinCorvus.logEvent(message, { ...data, sample: mixpanelSample });
+}
+
+/**
+ * @summary Log an exception
+ *
+ * @description
+ * This function logs an exception to error reporting services.
+ */
+export const logException = resinCorvus.logException;

lib/gui/app/modules/drive-scanner.ts

@@ -0,0 +1,46 @@
+/*
+ * Copyright 2016 balena.io
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import * as sdk from 'etcher-sdk';
+import { geteuid, platform } from 'process';
+
+import * as settings from '../models/settings';
+
+/**
+ * @summary returns true if system drives should be shown
+ */
+function includeSystemDrives() {
+	return settings.get('unsafeMode') && !settings.get('disableUnsafeMode');
+}
+
+const adapters: sdk.scanner.adapters.Adapter[] = [
+	new sdk.scanner.adapters.BlockDeviceAdapter(includeSystemDrives),
+];
+
+// Can't use permissions.isElevated() here as it returns a promise and we need to set
+// module.exports = scanner right now.
+if (platform !== 'linux' || geteuid() === 0) {
+	adapters.push(new sdk.scanner.adapters.UsbbootDeviceAdapter());
+}
+
+if (
+	platform === 'win32' &&
+	sdk.scanner.adapters.DriverlessDeviceAdapter !== undefined
+) {
+	adapters.push(new sdk.scanner.adapters.DriverlessDeviceAdapter());
+}
+
+export const scanner = new sdk.scanner.Scanner(adapters);

lib/gui/app/modules/exception-reporter.ts

@@ -1,5 +1,5 @@
 /*
- * Copyright 2016 resin.io
+ * Copyright 2016 balena.io
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -14,15 +14,16 @@
  * limitations under the License.
  */
 
-'use strict';
+import { logException } from '../modules/analytics';
+import { showError } from '../os/dialog';
 
 /**
- * @module Etcher.OS.Dropzone
+ * @summary Report an exception
  */
-
-const angular = require('angular');
-const MODULE_NAME = 'Etcher.OS.Dropzone';
-const OSDropzone = angular.module(MODULE_NAME, []);
-OSDropzone.directive('osDropzone', require('./directives/dropzone'));
-
-module.exports = MODULE_NAME;
+export function report(exception?: Error) {
+	if (exception === undefined) {
+		return;
+	}
+	showError(exception);
+	logException(exception);
+}

lib/gui/app/modules/image-writer.ts

@@ -0,0 +1,353 @@
+/*
+ * Copyright 2016 balena.io
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import { Drive as DrivelistDrive } from 'drivelist';
+import * as electron from 'electron';
+import * as sdk from 'etcher-sdk';
+import * as _ from 'lodash';
+import * as ipc from 'node-ipc';
+import * as os from 'os';
+import * as path from 'path';
+
+import * as packageJSON from '../../../../package.json';
+import * as errors from '../../../shared/errors';
+import * as permissions from '../../../shared/permissions';
+import * as flashState from '../models/flash-state';
+import * as selectionState from '../models/selection-state';
+import * as settings from '../models/settings';
+import { store } from '../models/store';
+import * as analytics from '../modules/analytics';
+import * as windowProgress from '../os/window-progress';
+import { updateLock } from './update-lock';
+
+const THREADS_PER_CPU = 16;
+
+// There might be multiple Etcher instances running at
+// the same time, therefore we must ensure each IPC
+// server/client has a different name.
+const IPC_SERVER_ID = `etcher-server-${process.pid}`;
+const IPC_CLIENT_ID = `etcher-client-${process.pid}`;
+
+ipc.config.id = IPC_SERVER_ID;
+ipc.config.socketRoot = path.join(
+	process.env.XDG_RUNTIME_DIR || os.tmpdir(),
+	path.sep,
+);
+
+// NOTE: Ensure this isn't disabled, as it will cause
+// the stdout maxBuffer size to be exceeded when flashing
+ipc.config.silent = true;
+
+/**
+ * @summary Handle a flash error and log it to analytics
+ */
+function handleErrorLogging(
+	error: Error & { code: string },
+	analyticsData: any,
+) {
+	const eventData = {
+		...analyticsData,
+		applicationSessionUuid: store.getState().toJS().applicationSessionUuid,
+		flashingWorkflowUuid: store.getState().toJS().flashingWorkflowUuid,
+		flashInstanceUuid: flashState.getFlashUuid(),
+	};
+
+	if (error.code === 'EVALIDATION') {
+		analytics.logEvent('Validation error', eventData);
+	} else if (error.code === 'EUNPLUGGED') {
+		analytics.logEvent('Drive unplugged', eventData);
+	} else if (error.code === 'EIO') {
+		analytics.logEvent('Input/output error', eventData);
+	} else if (error.code === 'ENOSPC') {
+		analytics.logEvent('Out of space', eventData);
+	} else if (error.code === 'ECHILDDIED') {
+		analytics.logEvent('Child died unexpectedly', eventData);
+	} else {
+		analytics.logEvent('Flash error', {
+			...eventData,
+			error: errors.toJSON(error),
+		});
+	}
+}
+
+function terminateServer() {
+	// Turns out we need to destroy all sockets for
+	// the server to actually close. Otherwise, it
+	// just stops receiving any further connections,
+	// but remains open if there are active ones.
+	// @ts-ignore (no Server.sockets in @types/node-ipc)
+	for (const socket of ipc.server.sockets) {
+		socket.destroy();
+	}
+	ipc.server.stop();
+}
+
+function writerArgv(): string[] {
+	let entryPoint = electron.remote.app.getAppPath();
+	// AppImages run over FUSE, so the files inside the mount point
+	// can only be accessed by the user that mounted the AppImage.
+	// This means we can't re-spawn Etcher as root from the same
+	// mount-point, and as a workaround, we re-mount the original
+	// AppImage as root.
+	if (os.platform() === 'linux' && process.env.APPIMAGE && process.env.APPDIR) {
+		entryPoint = entryPoint.replace(process.env.APPDIR, '');
+		return [
+			process.env.APPIMAGE,
+			'-e',
+			`require(\`\${process.env.APPDIR}${entryPoint}\`)`,
+		];
+	} else {
+		return [process.argv[0], entryPoint];
+	}
+}
+
+function writerEnv() {
+	return {
+		IPC_SERVER_ID,
+		IPC_CLIENT_ID,
+		IPC_SOCKET_ROOT: ipc.config.socketRoot,
+		ELECTRON_RUN_AS_NODE: '1',
+		UV_THREADPOOL_SIZE: (os.cpus().length * THREADS_PER_CPU).toString(),
+		// This environment variable prevents the AppImages
+		// desktop integration script from presenting the
+		// "installation" dialog
+		SKIP: '1',
+		...(process.platform === 'win32' ? {} : process.env),
+	};
+}
+
+interface FlashResults {
+	cancelled?: boolean;
+}
+
+/**
+ * @summary Perform write operation
+ *
+ * @description
+ * This function is extracted for testing purposes.
+ */
+export function performWrite(
+	image: string,
+	drives: DrivelistDrive[],
+	onProgress: sdk.multiWrite.OnProgressFunction,
+): Promise<{ cancelled?: boolean }> {
+	let cancelled = false;
+	ipc.serve();
+	return new Promise((resolve, reject) => {
+		ipc.server.on('error', error => {
+			terminateServer();
+			const errorObject = errors.fromJSON(error);
+			reject(errorObject);
+		});
+
+		ipc.server.on('log', message => {
+			console.log(message);
+		});
+
+		const flashResults: FlashResults = {};
+		const analyticsData = {
+			image,
+			drives,
+			driveCount: drives.length,
+			uuid: flashState.getFlashUuid(),
+			flashInstanceUuid: flashState.getFlashUuid(),
+			unmountOnSuccess: settings.get('unmountOnSuccess'),
+			validateWriteOnSuccess: settings.get('validateWriteOnSuccess'),
+			trim: settings.get('trim'),
+		};
+
+		ipc.server.on('fail', ({ error }) => {
+			handleErrorLogging(error, analyticsData);
+		});
+
+		ipc.server.on('done', event => {
+			event.results.errors = _.map(event.results.errors, data => {
+				return errors.fromJSON(data);
+			});
+			_.merge(flashResults, event);
+		});
+
+		ipc.server.on('abort', () => {
+			terminateServer();
+			cancelled = true;
+		});
+
+		// @ts-ignore
+		ipc.server.on('state', onProgress);
+
+		ipc.server.on('ready', (_data, socket) => {
+			ipc.server.emit(socket, 'write', {
+				imagePath: image,
+				destinations: drives,
+				validateWriteOnSuccess: settings.get('validateWriteOnSuccess'),
+				trim: settings.get('trim'),
+				unmountOnSuccess: settings.get('unmountOnSuccess'),
+			});
+		});
+
+		const argv = writerArgv();
+
+		ipc.server.on('start', async () => {
+			console.log(`Elevating command: ${_.join(argv, ' ')}`);
+			const env = writerEnv();
+			try {
+				const results = await permissions.elevateCommand(argv, {
+					applicationName: packageJSON.displayName,
+					environment: env,
+				});
+				flashResults.cancelled = cancelled || results.cancelled;
+			} catch (error) {
+				// This happens when the child is killed using SIGKILL
+				const SIGKILL_EXIT_CODE = 137;
+				if (error.code === SIGKILL_EXIT_CODE) {
+					error.code = 'ECHILDDIED';
+				}
+				reject(error);
+			} finally {
+				console.log('Terminating IPC server');
+				terminateServer();
+			}
+			console.log('Flash results', flashResults);
+
+			// This likely means the child died halfway through
+			if (
+				!flashResults.cancelled &&
+				!_.get(flashResults, ['results', 'bytesWritten'])
+			) {
+				reject(
+					errors.createUserError({
+						title: 'The writer process ended unexpectedly',
+						description:
+							'Please try again, and contact the Etcher team if the problem persists',
+						code: 'ECHILDDIED',
+					}),
+				);
+				return;
+			}
+			resolve(flashResults);
+		});
+
+		// Clear the update lock timer to prevent longer
+		// flashing timing it out, and releasing the lock
+		updateLock.pause();
+		ipc.server.start();
+	});
+}
+
+/**
+ * @summary Flash an image to drives
+ */
+export async function flash(
+	image: string,
+	drives: DrivelistDrive[],
+): Promise<void> {
+	if (flashState.isFlashing()) {
+		throw new Error('There is already a flash in progress');
+	}
+
+	flashState.setFlashingFlag();
+
+	const analyticsData = {
+		image,
+		drives,
+		driveCount: drives.length,
+		uuid: flashState.getFlashUuid(),
+		status: 'started',
+		flashInstanceUuid: flashState.getFlashUuid(),
+		unmountOnSuccess: settings.get('unmountOnSuccess'),
+		validateWriteOnSuccess: settings.get('validateWriteOnSuccess'),
+		trim: settings.get('trim'),
+		applicationSessionUuid: store.getState().toJS().applicationSessionUuid,
+		flashingWorkflowUuid: store.getState().toJS().flashingWorkflowUuid,
+	};
+
+	analytics.logEvent('Flash', analyticsData);
+
+	try {
+		// Using it from exports so it can be mocked during tests
+		const result = await exports.performWrite(
+			image,
+			drives,
+			flashState.setProgressState,
+		);
+		flashState.unsetFlashingFlag(result);
+	} catch (error) {
+		flashState.unsetFlashingFlag({ cancelled: false, errorCode: error.code });
+		windowProgress.clear();
+		let { results } = flashState.getFlashResults();
+		results = results || {};
+		const eventData = {
+			...analyticsData,
+			errors: results.errors,
+			devices: results.devices,
+			status: 'failed',
+			error,
+		};
+		analytics.logEvent('Write failed', eventData);
+		throw error;
+	}
+	windowProgress.clear();
+	if (flashState.wasLastFlashCancelled()) {
+		const eventData = {
+			...analyticsData,
+			status: 'cancel',
+		};
+		analytics.logEvent('Elevation cancelled', eventData);
+	} else {
+		const { results } = flashState.getFlashResults();
+		const eventData = {
+			...analyticsData,
+			errors: results.errors,
+			devices: results.devices,
+			status: 'finished',
+		};
+		analytics.logEvent('Done', eventData);
+	}
+}
+
+/**
+ * @summary Cancel write operation
+ */
+export function cancel() {
+	const drives = selectionState.getSelectedDevices();
+	const analyticsData = {
+		image: selectionState.getImagePath(),
+		drives,
+		driveCount: drives.length,
+		uuid: flashState.getFlashUuid(),
+		flashInstanceUuid: flashState.getFlashUuid(),
+		unmountOnSuccess: settings.get('unmountOnSuccess'),
+		validateWriteOnSuccess: settings.get('validateWriteOnSuccess'),
+		trim: settings.get('trim'),
+		applicationSessionUuid: store.getState().toJS().applicationSessionUuid,
+		flashingWorkflowUuid: store.getState().toJS().flashingWorkflowUuid,
+		status: 'cancel',
+	};
+	analytics.logEvent('Cancel', analyticsData);
+
+	// Re-enable lock release on inactivity
+	updateLock.resume();
+
+	try {
+		// @ts-ignore (no Server.sockets in @types/node-ipc)
+		const [socket] = ipc.server.sockets;
+		if (socket !== undefined) {
+			ipc.server.emit(socket, 'cancel');
+		}
+	} catch (error) {
+		analytics.logException(error);
+	}
+}

lib/gui/app/modules/progress-status.ts

@@ -0,0 +1,80 @@
+/*
+ * Copyright 2017 balena.io
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License")
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import { bytesToClosestUnit } from '../../../shared/units';
+import * as settings from '../models/settings';
+
+export interface FlashState {
+	flashing: number;
+	verifying: number;
+	successful: number;
+	failed: number;
+	percentage?: number;
+	speed: number;
+	position: number;
+}
+
+/**
+ * @summary Make the progress status subtitle string
+ *
+ * @param {Object} state - flashing metadata
+ *
+ * @returns {String}
+ *
+ * @example
+ * const status = progressStatus.fromFlashState({
+ *   flashing: 1,
+ *   verifying: 0,
+ *   successful: 0,
+ *   failed: 0,
+ *   percentage: 55,
+ *   speed: 2049
+ * })
+ *
+ * console.log(status)
+ * // '55% Flashing'
+ */
+export function fromFlashState(state: FlashState): string {
+	const isFlashing = Boolean(state.flashing);
+	const isValidating = !isFlashing && Boolean(state.verifying);
+	const shouldValidate = settings.get('validateWriteOnSuccess');
+	const shouldUnmount = settings.get('unmountOnSuccess');
+
+	if (state.percentage === 0 && !state.speed) {
+		if (isValidating) {
+			return 'Validating...';
+		}
+
+		return 'Starting...';
+	} else if (state.percentage === 100) {
+		if ((isValidating || !shouldValidate) && shouldUnmount) {
+			return 'Unmounting...';
+		}
+
+		return 'Finishing...';
+	} else if (isFlashing) {
+		if (state.percentage != null) {
+			return `${state.percentage}% Flashing`;
+		}
+		return `${bytesToClosestUnit(state.position)} flashed`;
+	} else if (isValidating) {
+		return `${state.percentage}% Validating`;
+	} else if (!isFlashing && !isValidating) {
+		return 'Failed';
+	}
+
+	throw new Error(`Invalid state: ${JSON.stringify(state)}`);
+}

lib/gui/app/modules/update-lock.ts

@@ -0,0 +1,188 @@
+/*
+ * Copyright 2018 balena.io
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import * as _debug from 'debug';
+import * as electron from 'electron';
+import { EventEmitter } from 'events';
+import * as createInactivityTimer from 'inactivity-timer';
+
+import * as settings from '../models/settings';
+import { logException } from './analytics';
+
+const debug = _debug('etcher:update-lock');
+
+/**
+ * Interaction timeout in milliseconds (defaults to 5 minutes)
+ * @type {Number}
+ * @constant
+ */
+const INTERACTION_TIMEOUT_MS = settings.has('interactionTimeout')
+	? parseInt(settings.get('interactionTimeout'), 10)
+	: 5 * 60 * 1000;
+
+class UpdateLock extends EventEmitter {
+	private paused: boolean;
+	private lockTimer: any;
+
+	constructor() {
+		super();
+		this.paused = false;
+		this.on('inactive', UpdateLock.onInactive);
+		this.lockTimer = createInactivityTimer(INTERACTION_TIMEOUT_MS, () => {
+			debug('inactive');
+			this.emit('inactive');
+		});
+	}
+
+	/**
+	 * @summary Inactivity event handler, releases the balena update lock on inactivity
+	 */
+	private static onInactive() {
+		if (settings.get('resinUpdateLock')) {
+			UpdateLock.check((checkError: Error, isLocked: boolean) => {
+				debug('inactive-check', Boolean(checkError));
+				if (checkError) {
+					logException(checkError);
+				}
+				if (isLocked) {
+					UpdateLock.release((error?: Error) => {
+						debug('inactive-release', Boolean(error));
+						if (error) {
+							logException(error);
+						}
+					});
+				}
+			});
+		}
+	}
+
+	/**
+	 * @summary Acquire the update lock
+	 */
+	private static acquire(callback: (error?: Error) => void) {
+		debug('lock');
+		if (settings.get('resinUpdateLock')) {
+			electron.ipcRenderer.once('resin-update-lock', (_event, error) => {
+				callback(error);
+			});
+			electron.ipcRenderer.send('resin-update-lock', 'lock');
+		} else {
+			callback(new Error('Update lock disabled'));
+		}
+	}
+
+	/**
+	 * @summary Release the update lock
+	 */
+	public static release(callback: (error?: Error) => void) {
+		debug('unlock');
+		if (settings.get('resinUpdateLock')) {
+			electron.ipcRenderer.once('resin-update-lock', (_event, error) => {
+				callback(error);
+			});
+			electron.ipcRenderer.send('resin-update-lock', 'unlock');
+		} else {
+			callback(new Error('Update lock disabled'));
+		}
+	}
+
+	/**
+	 * @summary Check the state of the update lock
+	 * @param {Function} callback - callback(error, isLocked)
+	 * @example
+	 * UpdateLock.check((error, isLocked) => {
+	 *   if (isLocked) {
+	 *     // ...
+	 *   }
+	 * })
+	 */
+	private static check(
+		callback: (error: Error | null, isLocked?: boolean) => void,
+	) {
+		debug('check');
+		if (settings.get('resinUpdateLock')) {
+			electron.ipcRenderer.once(
+				'resin-update-lock',
+				(_event, error, isLocked) => {
+					callback(error, isLocked);
+				},
+			);
+			electron.ipcRenderer.send('resin-update-lock', 'check');
+		} else {
+			callback(new Error('Update lock disabled'));
+		}
+	}
+
+	/**
+	 * @summary Extend the lock timer
+	 */
+	public extend() {
+		debug('extend');
+
+		if (this.paused) {
+			debug('extend:paused');
+			return;
+		}
+
+		this.lockTimer.signal();
+
+		// When extending, check that we have the lock,
+		// and acquire it, if not
+		if (settings.get('resinUpdateLock')) {
+			UpdateLock.check((checkError, isLocked) => {
+				if (checkError) {
+					logException(checkError);
+				}
+				if (!isLocked) {
+					UpdateLock.acquire(error => {
+						if (error) {
+							logException(error);
+						}
+						debug('extend-acquire', Boolean(error));
+					});
+				}
+			});
+		}
+	}
+
+	/**
+	 * @summary Clear the lock timer
+	 */
+	private clearTimer() {
+		debug('clear');
+		this.lockTimer.clear();
+	}
+
+	/**
+	 * @summary Clear the lock timer, and pause extension, avoiding triggering until resume()d
+	 */
+	public pause() {
+		debug('pause');
+		this.paused = true;
+		this.clearTimer();
+	}
+
+	/**
+	 * @summary Un-pause lock extension, and restart the timer
+	 */
+	public resume() {
+		debug('resume');
+		this.paused = false;
+		this.extend();
+	}
+}
+
+export const updateLock = new UpdateLock();

lib/gui/app/os/dialog.ts

@@ -0,0 +1,98 @@
+/*
+ * Copyright 2016 balena.io
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import * as electron from 'electron';
+import * as _ from 'lodash';
+
+import * as errors from '../../../shared/errors';
+import { getAllExtensions } from '../../../shared/supported-formats';
+
+/**
+ * @summary Open an image selection dialog
+ *
+ * @description
+ * Notice that by image, we mean *.img/*.iso/*.zip/etc files.
+ */
+export async function selectImage(): Promise<string | undefined> {
+	const options: electron.OpenDialogOptions = {
+		// This variable is set when running in GNU/Linux from
+		// inside an AppImage, and represents the working directory
+		// from where the AppImage was run (which might not be the
+		// place where the AppImage is located). `OWD` stands for
+		// "Original Working Directory".
+		//
+		// See: https://github.com/probonopd/AppImageKit/commit/1569d6f8540aa6c2c618dbdb5d6fcbf0003952b7
+		defaultPath: process.env.OWD,
+		properties: ['openFile', 'treatPackageAsDirectory'],
+		filters: [
+			{
+				name: 'OS Images',
+				extensions: [...getAllExtensions()].sort(),
+			},
+		],
+	};
+	const currentWindow = electron.remote.getCurrentWindow();
+	const [file] = (
+		await electron.remote.dialog.showOpenDialog(currentWindow, options)
+	).filePaths;
+	return file;
+}
+
+/**
+ * @summary Open a warning dialog
+ */
+export async function showWarning(options: {
+	confirmationLabel: string;
+	rejectionLabel: string;
+	title: string;
+	description: string;
+}): Promise<boolean> {
+	_.defaults(options, {
+		confirmationLabel: 'OK',
+		rejectionLabel: 'Cancel',
+	});
+
+	const BUTTONS = [options.confirmationLabel, options.rejectionLabel];
+
+	const BUTTON_CONFIRMATION_INDEX = _.indexOf(
+		BUTTONS,
+		options.confirmationLabel,
+	);
+	const BUTTON_REJECTION_INDEX = _.indexOf(BUTTONS, options.rejectionLabel);
+
+	const { response } = await electron.remote.dialog.showMessageBox(
+		electron.remote.getCurrentWindow(),
+		{
+			type: 'warning',
+			buttons: BUTTONS,
+			defaultId: BUTTON_REJECTION_INDEX,
+			cancelId: BUTTON_REJECTION_INDEX,
+			title: 'Attention',
+			message: options.title,
+			detail: options.description,
+		},
+	);
+	return response === BUTTON_CONFIRMATION_INDEX;
+}
+
+/**
+ * @summary Show error dialog for an Error instance
+ */
+export function showError(error: Error) {
+	const title = errors.getTitle(error);
+	const message = errors.getDescription(error);
+	electron.remote.dialog.showErrorBox(title, message);
+}

lib/gui/app/os/notification.ts

@@ -1,5 +1,5 @@
 /*
- * Copyright 2016 resin.io
+ * Copyright 2017 balena.io
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -14,20 +14,23 @@
  * limitations under the License.
  */
 
-'use strict';
+import * as electron from 'electron';
+
+import * as settings from '../models/settings';
 
 /**
- * @module Etcher.Components.FlashErrorModal
+ * @summary Send a notification
  */
+export function send(title: string, body: string, icon: string) {
+	// Bail out if desktop notifications are disabled
+	if (!settings.get('desktopNotifications')) {
+		return;
+	}
 
-const angular = require('angular');
-const MODULE_NAME = 'Etcher.Components.FlashErrorModal';
-const FlashErrorModal = angular.module(MODULE_NAME, [
-  require('../warning-modal/warning-modal'),
-  require('../../models/selection-state'),
-  require('../../modules/analytics')
-]);
+	// `app.dock` is only defined in OS X
+	if (electron.remote.app.dock) {
+		electron.remote.app.dock.bounce();
+	}
 
-FlashErrorModal.service('FlashErrorModalService', require('./services/flash-error-modal'));
-
-module.exports = MODULE_NAME;
+	return new window.Notification(title, { body, icon });
+}

lib/gui/app/os/open-external/services/open-external.ts

@@ -0,0 +1,39 @@
+/*
+ * Copyright 2016 balena.io
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import * as electron from 'electron';
+import * as settings from '../../../models/settings';
+import { store } from '../../../models/store';
+import { logEvent } from '../../../modules/analytics';
+
+/**
+ * @summary Open an external resource
+ */
+export function open(url: string) {
+	// Don't open links if they're disabled by the env var
+	if (settings.get('disableExternalLinks')) {
+		return;
+	}
+
+	logEvent('Open external link', {
+		url,
+		applicationSessionUuid: store.getState().toJS().applicationSessionUuid,
+	});
+
+	if (url) {
+		electron.shell.openExternal(url);
+	}
+}

lib/gui/app/os/window-progress.ts

@@ -0,0 +1,65 @@
+/*
+ * Copyright 2016 balena.io
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import * as electron from 'electron';
+
+import { percentageToFloat } from '../../../shared/utils';
+import { FlashState, fromFlashState } from '../modules/progress-status';
+
+/**
+ * @summary The title of the main window upon program launch
+ */
+const INITIAL_TITLE = document.title;
+
+/**
+ * @summary Make the full window status title
+ */
+function getWindowTitle(state?: FlashState) {
+	if (state) {
+		return `${INITIAL_TITLE} – ${fromFlashState(state)}`;
+	}
+	return INITIAL_TITLE;
+}
+
+/**
+ * @summary A reference to the current renderer Electron window
+ *
+ * @description
+ * We expose this property to `this` for testability purposes.
+ */
+export const currentWindow = electron.remote.getCurrentWindow();
+
+/**
+ * @summary Set operating system window progress
+ *
+ * @description
+ * Show progress inline in operating system task bar
+ */
+export function set(state: FlashState) {
+	if (state.percentage != null) {
+		exports.currentWindow.setProgressBar(percentageToFloat(state.percentage));
+	}
+	exports.currentWindow.setTitle(getWindowTitle(state));
+}
+
+/**
+ * @summary Clear the window progress bar
+ */
+export function clear() {
+	// Passing 0 or null/undefined doesn't work.
+	exports.currentWindow.setProgressBar(-1);
+	exports.currentWindow.setTitle(getWindowTitle(undefined));
+}

lib/gui/app/os/windows-network-drives.ts

@@ -0,0 +1,115 @@
+/*
+ * Copyright 2019 balena.io
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import { using } from 'bluebird';
+import { exec } from 'child_process';
+import { readFile } from 'fs';
+import { chain, trim } from 'lodash';
+import { platform } from 'os';
+import { join } from 'path';
+import { env } from 'process';
+import { promisify } from 'util';
+
+import { tmpFileDisposer } from '../../../shared/utils';
+
+const readFileAsync = promisify(readFile);
+
+const execAsync = promisify(exec);
+
+/**
+ * @summary Returns wmic's output for network drives
+ */
+export async function getWmicNetworkDrivesOutput(): Promise<string> {
+	// Exported for tests.
+	// When trying to read wmic's stdout directly from node, it is encoded with the current
+	// console codepage (depending on the computer).
+	// Decoding this would require getting this codepage somehow and using iconv as node
+	// doesn't know how to read cp850 directly for example.
+	// We could also use wmic's "/output:" switch but it doesn't work when the filename
+	// contains a space and the os temp dir may contain spaces ("D:\Windows Temp Files" for example).
+	// So we just redirect to a file and read it afterwards as we know it will be ucs2 encoded.
+	const options = {
+		// Close the file once it's created
+		discardDescriptor: true,
+		// Wmic fails with "Invalid global switch" when the "/output:" switch filename contains a dash ("-")
+		prefix: 'tmp',
+	};
+	return using(tmpFileDisposer(options), async ({ path }) => {
+		const command = [
+			join(env.SystemRoot as string, 'System32', 'Wbem', 'wmic'),
+			'path',
+			'Win32_LogicalDisk',
+			'Where',
+			'DriveType="4"',
+			'get',
+			'DeviceID,ProviderName',
+			'>',
+			`"${path}"`,
+		];
+		await execAsync(command.join(' '), { windowsHide: true });
+		return readFileAsync(path, 'ucs2');
+	});
+}
+
+/**
+ * @summary returns a Map of drive letter -> network locations on Windows: 'Z:' -> '\\\\192.168.0.1\\Public'
+ */
+async function getWindowsNetworkDrives(): Promise<Map<string, string>> {
+	// Use getWindowsNetworkDrives from "exports." so it can be mocked in tests
+	const result = await exports.getWmicNetworkDrivesOutput();
+	const couples: Array<[string, string]> = chain(result)
+		.split('\n')
+		// Remove header line
+		.slice(1)
+		// Remove extra spaces / tabs / carriage returns
+		.invokeMap(String.prototype.trim)
+		// Filter out empty lines
+		.compact()
+		.map((str: string): [string, string] => {
+			const colonPosition = str.indexOf(':');
+			if (colonPosition === -1) {
+				throw new Error(`Can't parse wmic output: ${result}`);
+			}
+			return [
+				str.slice(0, colonPosition + 1),
+				trim(str.slice(colonPosition + 1)),
+			];
+		})
+		.filter(couple => couple[1].length > 0)
+		.value();
+	return new Map(couples);
+}
+
+/**
+ * @summary Replaces network drive letter with network drive location in the provided filePath on Windows
+ */
+export async function replaceWindowsNetworkDriveLetter(
+	filePath: string,
+): Promise<string> {
+	let result = filePath;
+	if (platform() === 'win32') {
+		const matches = /^([A-Z]+:)\\(.*)$/.exec(filePath);
+		if (matches !== null) {
+			const [, drive, relativePath] = matches;
+			const drives = await getWindowsNetworkDrives();
+			const location = drives.get(drive);
+			if (location !== undefined) {
+				result = `${location}\\${relativePath}`;
+			}
+		}
+	}
+	return result;
+}

lib/gui/app/pages/finish/styles/_finish.scss

@@ -0,0 +1,174 @@
+/*
+ * Copyright 2016 balena.io
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+.page-finish {
+  margin-top: 60px;
+}
+
+.col-xs-5.inline-flex.items-baseline > span, .col-xs-5.inline-flex.items-baseline > div {
+  margin-bottom: -10px;
+}
+
+.page-finish .button-label {
+  margin: 0 auto $spacing-medium;
+
+  // Keep some spacing at the sides
+  max-width: $btn-min-width - 5px;
+}
+
+.page-finish .button-primary {
+  min-width: $btn-min-width;
+}
+
+.page-finish .title,
+.page-finish .title h3 {
+  color: $palette-theme-dark-foreground;
+  font-weight: bold;
+}
+
+.page-finish .huge-title {
+  font-size: 3.5em;
+}
+
+.page-finish .label {
+  display: inline-block;
+
+  > b {
+    color: $palette-theme-dark-soft-foreground;
+  }
+}
+
+.page-finish .soft {
+  color: $palette-theme-dark-soft-foreground;
+}
+
+.page-finish .separator-xs {
+  flex-grow: 0;
+  background-color: $palette-theme-dark-soft-background;
+  padding: 0px;
+  min-width: 2px;
+}
+
+.page-finish .center {
+  display: flex;
+  align-items: center;
+  justify-content: center;
+}
+
+.page-finish .box > div > button {
+  margin-right: 20px;
+}
+
+.page-finish webview {
+  width: 800px;
+  height: 300px;
+  position: absolute;
+  top: 80px;
+  left: 0;
+  z-index: 9001;
+}
+
+.page-finish .fallback-banner {
+  display: flex;
+  justify-content: center;
+  align-items: center;
+  flex-direction: column;
+  position: absolute;
+  bottom: 0;
+  color: white;
+  height: 320px;
+  width: 100vw;
+  left: 0;
+
+  > * {
+    display: flex;
+    justify-content: center;
+    align-items: center;
+  }
+
+  .caption {
+    display: flex;
+    font-weight: 500;
+  }
+
+  .caption-big {
+    font-size: 28px;
+    font-weight: bold;
+    position: absolute;
+    top: 75px;
+  }
+
+  .caption-small {
+    font-size: 12px;
+  }
+
+  .fallback-footer {
+    font-size: 12px;
+    display: flex;
+    align-items: center;
+    justify-content: center;
+    width: 100%;
+    position: absolute;
+    bottom: 0;
+    max-height: 21px;
+    margin-bottom: 17px;
+  }
+
+  .svg-icon {
+    margin: 0 10px;
+  }
+
+  .section-footer {
+    position: absolute;
+    right: 0;
+    bottom: 0;
+
+    .footer-right {
+      color: #7e8085;
+      font-size: 12px;
+      margin-right: 30px;
+    }
+  }
+}
+
+.inline-flex {
+  display: inline-flex;
+}
+
+.items-baseline {
+  align-items: baseline;
+}
+
+.page-finish .tick--success {
+  /* hack(Shou): for some reason the height is stretched */
+  height: 24px;
+  width: 24px;
+  border: none;
+  padding: 0;
+  margin: 0 15px 0 0;
+  justify-content: center;
+  align-items: center;
+  display: flex;
+  font-size: 16px;
+}
+
+.title-wrap {
+  margin-left: 5px;
+
+  > .title {
+    margin-bottom: 3px;
+  }
+}

lib/gui/app/pages/main/DriveSelector.tsx

@@ -0,0 +1,141 @@
+/*
+ * Copyright 2016 balena.io
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import * as _ from 'lodash';
+import * as React from 'react';
+import styled from 'styled-components';
+import { DriveSelectorModal } from '../../components/drive-selector/DriveSelectorModal';
+import { TargetSelector } from '../../components/drive-selector/target-selector';
+import { SVGIcon } from '../../components/svg-icon/svg-icon';
+import { getImage, getSelectedDrives } from '../../models/selection-state';
+import * as settings from '../../models/settings';
+import { observe, store } from '../../models/store';
+import * as analytics from '../../modules/analytics';
+
+const StepBorder = styled.div<{
+	disabled: boolean;
+	left?: boolean;
+	right?: boolean;
+}>`
+	height: 2px;
+	background-color: ${props =>
+		props.disabled
+			? props.theme.customColors.dark.disabled.foreground
+			: props.theme.customColors.dark.foreground};
+	position: absolute;
+	width: 124px;
+	top: 19px;
+
+	left: ${props => (props.left ? '-67px' : undefined)};
+	right: ${props => (props.right ? '-67px' : undefined)};
+`;
+
+const getDriveListLabel = () => {
+	return _.join(
+		_.map(getSelectedDrives(), (drive: any) => {
+			return `${drive.description} (${drive.displayName})`;
+		}),
+		'\n',
+	);
+};
+
+const shouldShowDrivesButton = () => {
+	return !settings.get('disableExplicitDriveSelection');
+};
+
+const getDriveSelectionStateSlice = () => ({
+	showDrivesButton: shouldShowDrivesButton(),
+	driveListLabel: getDriveListLabel(),
+	targets: getSelectedDrives(),
+	image: getImage(),
+});
+
+interface DriveSelectorProps {
+	webviewShowing: boolean;
+	disabled: boolean;
+	nextStepDisabled: boolean;
+	hasDrive: boolean;
+	flashing: boolean;
+}
+
+export const DriveSelector = ({
+	webviewShowing,
+	disabled,
+	nextStepDisabled,
+	hasDrive,
+	flashing,
+}: DriveSelectorProps) => {
+	// TODO: inject these from redux-connector
+	const [
+		{ showDrivesButton, driveListLabel, targets, image },
+		setStateSlice,
+	] = React.useState(getDriveSelectionStateSlice());
+	const [showDriveSelectorModal, setShowDriveSelectorModal] = React.useState(
+		false,
+	);
+
+	React.useEffect(() => {
+		return observe(() => {
+			setStateSlice(getDriveSelectionStateSlice());
+		});
+	}, []);
+
+	const showStepConnectingLines = !webviewShowing || !flashing;
+
+	return (
+		<div className="box text-center relative">
+			{showStepConnectingLines && (
+				<>
+					<StepBorder disabled={disabled} left />
+					<StepBorder disabled={nextStepDisabled} right />
+				</>
+			)}
+
+			<div className="center-block">
+				<SVGIcon paths={['../../assets/drive.svg']} disabled={disabled} />
+			</div>
+
+			<div className="space-vertical-large">
+				<TargetSelector
+					disabled={disabled}
+					show={!hasDrive && showDrivesButton}
+					tooltip={driveListLabel}
+					openDriveSelector={() => {
+						setShowDriveSelectorModal(true);
+					}}
+					reselectDrive={() => {
+						analytics.logEvent('Reselect drive', {
+							applicationSessionUuid: store.getState().toJS()
+								.applicationSessionUuid,
+							flashingWorkflowUuid: store.getState().toJS()
+								.flashingWorkflowUuid,
+						});
+						setShowDriveSelectorModal(true);
+					}}
+					flashing={flashing}
+					targets={targets}
+					image={image}
+				/>
+			</div>
+
+			{showDriveSelectorModal && (
+				<DriveSelectorModal
+					close={() => setShowDriveSelectorModal(false)}
+				></DriveSelectorModal>
+			)}
+		</div>
+	);
+};

lib/gui/app/pages/main/Flash.tsx

@@ -0,0 +1,313 @@
+/*
+ * Copyright 2016 balena.io
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import * as _ from 'lodash';
+import * as path from 'path';
+import * as React from 'react';
+import { Modal, Txt } from 'rendition';
+import * as constraints from '../../../../shared/drive-constraints';
+import * as messages from '../../../../shared/messages';
+import { DriveSelectorModal } from '../../components/drive-selector/DriveSelectorModal';
+import { ProgressButton } from '../../components/progress-button/progress-button';
+import { SVGIcon } from '../../components/svg-icon/svg-icon';
+import * as availableDrives from '../../models/available-drives';
+import * as flashState from '../../models/flash-state';
+import * as selection from '../../models/selection-state';
+import { store } from '../../models/store';
+import * as analytics from '../../modules/analytics';
+import { scanner as driveScanner } from '../../modules/drive-scanner';
+import * as imageWriter from '../../modules/image-writer';
+import * as progressStatus from '../../modules/progress-status';
+import * as notification from '../../os/notification';
+
+const COMPLETED_PERCENTAGE = 100;
+const SPEED_PRECISION = 2;
+
+const getWarningMessages = (drives: any, image: any) => {
+	const warningMessages = [];
+	for (const drive of drives) {
+		if (constraints.isDriveSizeLarge(drive)) {
+			warningMessages.push(messages.warning.largeDriveSize(drive));
+		} else if (!constraints.isDriveSizeRecommended(drive, image)) {
+			warningMessages.push(
+				messages.warning.unrecommendedDriveSize(image, drive),
+			);
+		}
+
+		// TODO(Shou): we should consider adding the same warning dialog for system drives and remove unsafe mode
+	}
+
+	return warningMessages;
+};
+
+const getErrorMessageFromCode = (errorCode: string) => {
+	// TODO: All these error codes to messages translations
+	// should go away if the writer emitted user friendly
+	// messages on the first place.
+	if (errorCode === 'EVALIDATION') {
+		return messages.error.validation();
+	} else if (errorCode === 'EUNPLUGGED') {
+		return messages.error.driveUnplugged();
+	} else if (errorCode === 'EIO') {
+		return messages.error.inputOutput();
+	} else if (errorCode === 'ENOSPC') {
+		return messages.error.notEnoughSpaceInDrive();
+	} else if (errorCode === 'ECHILDDIED') {
+		return messages.error.childWriterDied();
+	}
+	return '';
+};
+
+async function flashImageToDrive(goToSuccess: () => void): Promise<string> {
+	const devices = selection.getSelectedDevices();
+	const image: any = selection.getImage();
+	const drives = _.filter(availableDrives.getDrives(), (drive: any) => {
+		return _.includes(devices, drive.device);
+	});
+
+	if (drives.length === 0 || flashState.isFlashing()) {
+		return '';
+	}
+
+	// Stop scanning drives when flashing
+	// otherwise Windows throws EPERM
+	driveScanner.stop();
+
+	const iconPath = '../../assets/icon.png';
+	const basename = path.basename(image.path);
+	try {
+		await imageWriter.flash(image.path, drives);
+		if (!flashState.wasLastFlashCancelled()) {
+			const flashResults: any = flashState.getFlashResults();
+			notification.send(
+				'Flash complete!',
+				messages.info.flashComplete(
+					basename,
+					drives as any,
+					flashResults.results.devices,
+				),
+				iconPath,
+			);
+			goToSuccess();
+		}
+	} catch (error) {
+		// When flashing is cancelled before starting above there is no error
+		if (!error) {
+			return '';
+		}
+
+		notification.send(
+			'Oops! Looks like the flash failed.',
+			messages.error.flashFailure(path.basename(image.path), drives),
+			iconPath,
+		);
+
+		let errorMessage = getErrorMessageFromCode(error.code);
+		if (!errorMessage) {
+			error.image = basename;
+			analytics.logException(error);
+			errorMessage = messages.error.genericFlashError();
+		}
+
+		return errorMessage;
+	} finally {
+		availableDrives.setDrives([]);
+		driveScanner.start();
+	}
+
+	return '';
+}
+
+/**
+ * @summary Get progress button label
+ * @function
+ * @public
+ *
+ * @returns {String} progress button label
+ *
+ * @example
+ * const label = FlashController.getProgressButtonLabel()
+ */
+const getProgressButtonLabel = () => {
+	if (!flashState.isFlashing()) {
+		return 'Flash!';
+	}
+
+	// TODO: no any
+	return progressStatus.fromFlashState(flashState.getFlashState() as any);
+};
+
+const formatSeconds = (totalSeconds: number) => {
+	if (!totalSeconds && !_.isNumber(totalSeconds)) {
+		return '';
+	}
+	const minutes = Math.floor(totalSeconds / 60);
+	const seconds = Math.floor(totalSeconds - minutes * 60);
+
+	return `${minutes}m${seconds}s`;
+};
+
+export const Flash = ({ shouldFlashStepBeDisabled, goToSuccess }: any) => {
+	const state: any = flashState.getFlashState();
+	const isFlashing = flashState.isFlashing();
+	const flashErrorCode = flashState.getLastFlashErrorCode();
+
+	const [warningMessages, setWarningMessages] = React.useState<string[]>([]);
+	const [errorMessage, setErrorMessage] = React.useState('');
+	const [showDriveSelectorModal, setShowDriveSelectorModal] = React.useState(
+		false,
+	);
+
+	const handleWarningResponse = async (shouldContinue: boolean) => {
+		setWarningMessages([]);
+
+		if (!shouldContinue) {
+			setShowDriveSelectorModal(true);
+			return;
+		}
+
+		setErrorMessage(await flashImageToDrive(goToSuccess));
+	};
+
+	const handleFlashErrorResponse = (shouldRetry: boolean) => {
+		setErrorMessage('');
+		flashState.resetState();
+		if (shouldRetry) {
+			analytics.logEvent('Restart after failure', {
+				applicationSessionUuid: store.getState().toJS().applicationSessionUuid,
+				flashingWorkflowUuid: store.getState().toJS().flashingWorkflowUuid,
+			});
+		} else {
+			selection.clear();
+		}
+	};
+
+	const tryFlash = async () => {
+		const devices = selection.getSelectedDevices();
+		const image = selection.getImage();
+		const drives = _.filter(availableDrives.getDrives(), (drive: any) => {
+			return _.includes(devices, drive.device);
+		});
+
+		if (drives.length === 0 || flashState.isFlashing()) {
+			return;
+		}
+
+		const hasDangerStatus = constraints.hasListDriveImageCompatibilityStatus(
+			drives,
+			image,
+		);
+		if (hasDangerStatus) {
+			setWarningMessages(getWarningMessages(drives, image));
+			return;
+		}
+
+		setErrorMessage(await flashImageToDrive(goToSuccess));
+	};
+
+	return (
+		<>
+			<div className="box text-center">
+				<div className="center-block">
+					<SVGIcon
+						paths={['../../assets/flash.svg']}
+						disabled={shouldFlashStepBeDisabled}
+					/>
+				</div>
+
+				<div className="space-vertical-large">
+					<ProgressButton
+						striped={state.type === 'verifying'}
+						active={isFlashing}
+						percentage={state.percentage}
+						label={getProgressButtonLabel()}
+						disabled={Boolean(flashErrorCode) || shouldFlashStepBeDisabled}
+						callback={tryFlash}
+					></ProgressButton>
+
+					{isFlashing && (
+						<button
+							className="button button-link button-abort-write"
+							onClick={imageWriter.cancel}
+						>
+							<span className="glyphicon glyphicon-remove-sign"></span>
+						</button>
+					)}
+					{!_.isNil(state.speed) && state.percentage !== COMPLETED_PERCENTAGE && (
+						<p className="step-footer step-footer-split">
+							{Boolean(state.speed) && (
+								<span>{`${state.speed.toFixed(SPEED_PRECISION)} MB/s`}</span>
+							)}
+							{!_.isNil(state.eta) && (
+								<span>{`ETA: ${formatSeconds(state.eta)}`}</span>
+							)}
+						</p>
+					)}
+
+					{Boolean(state.failed) && (
+						<div className="target-status-wrap">
+							<div className="target-status-line target-status-failed">
+								<span className="target-status-dot"></span>
+								<span className="target-status-quantity">{state.failed}</span>
+								<span className="target-status-message">
+									{messages.progress.failed(state.failed)}{' '}
+								</span>
+							</div>
+						</div>
+					)}
+				</div>
+			</div>
+
+			{warningMessages && warningMessages.length > 0 && (
+				<Modal
+					width={400}
+					titleElement={'Attention'}
+					cancel={() => handleWarningResponse(false)}
+					done={() => handleWarningResponse(true)}
+					cancelButtonProps={{
+						children: 'Change',
+					}}
+					action={'Continue'}
+					primaryButtonProps={{ primary: false, warning: true }}
+				>
+					{_.map(warningMessages, (message, key) => (
+						<Txt key={key} whitespace="pre-line" mt={2}>
+							{message}
+						</Txt>
+					))}
+				</Modal>
+			)}
+
+			{errorMessage && (
+				<Modal
+					width={400}
+					titleElement={'Attention'}
+					cancel={() => handleFlashErrorResponse(false)}
+					done={() => handleFlashErrorResponse(true)}
+					action={'Retry'}
+				>
+					<Txt>{errorMessage}</Txt>
+				</Modal>
+			)}
+
+			{showDriveSelectorModal && (
+				<DriveSelectorModal
+					close={() => setShowDriveSelectorModal(false)}
+				></DriveSelectorModal>
+			)}
+		</>
+	);
+};

lib/gui/app/pages/main/MainPage.tsx

@@ -0,0 +1,262 @@
+/*
+ * Copyright 2019 balena.io
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import { faCog, faQuestionCircle } from '@fortawesome/free-solid-svg-icons';
+import { FontAwesomeIcon } from '@fortawesome/react-fontawesome';
+import * as _ from 'lodash';
+import * as path from 'path';
+import * as React from 'react';
+import { Button } from 'rendition';
+
+import { FeaturedProject } from '../../components/featured-project/featured-project';
+import FinishPage from '../../components/finish/finish';
+import { ImageSelector } from '../../components/image-selector/image-selector';
+import { ReducedFlashingInfos } from '../../components/reduced-flashing-infos/reduced-flashing-infos';
+import { SafeWebview } from '../../components/safe-webview/safe-webview';
+import { SettingsModal } from '../../components/settings/settings';
+import { SVGIcon } from '../../components/svg-icon/svg-icon';
+import * as flashState from '../../models/flash-state';
+import * as selectionState from '../../models/selection-state';
+import * as settings from '../../models/settings';
+import { observe } from '../../models/store';
+import { open as openExternal } from '../../os/open-external/services/open-external';
+import { ThemedProvider } from '../../styled-components';
+import { colors } from '../../theme';
+import { middleEllipsis } from '../../utils/middle-ellipsis';
+
+import { bytesToClosestUnit } from '../../../../shared/units';
+
+import { DriveSelector } from './DriveSelector';
+import { Flash } from './Flash';
+
+function getDrivesTitle() {
+	const drives = selectionState.getSelectedDrives();
+
+	if (drives.length === 1) {
+		// @ts-ignore
+		return drives[0].description || 'Untitled Device';
+	}
+
+	if (drives.length === 0) {
+		return 'No targets found';
+	}
+
+	return `${drives.length} Targets`;
+}
+
+function getImageBasename() {
+	if (!selectionState.hasImage()) {
+		return '';
+	}
+
+	const selectionImageName = selectionState.getImageName();
+	const imageBasename = path.basename(selectionState.getImagePath());
+	return selectionImageName || imageBasename;
+}
+
+interface MainPageStateFromStore {
+	isFlashing: boolean;
+	hasImage: boolean;
+	hasDrive: boolean;
+	imageLogo: string;
+	imageSize: number;
+	imageName: string;
+	driveTitle: string;
+}
+
+interface MainPageState {
+	current: 'main' | 'success';
+	isWebviewShowing: boolean;
+	hideSettings: boolean;
+}
+
+export class MainPage extends React.Component<
+	{},
+	MainPageState & MainPageStateFromStore
+> {
+	constructor(props: {}) {
+		super(props);
+		this.state = {
+			current: 'main',
+			isWebviewShowing: false,
+			hideSettings: true,
+			...this.stateHelper(),
+		};
+	}
+
+	private stateHelper(): MainPageStateFromStore {
+		return {
+			isFlashing: flashState.isFlashing(),
+			hasImage: selectionState.hasImage(),
+			hasDrive: selectionState.hasDrive(),
+			imageLogo: selectionState.getImageLogo(),
+			imageSize: selectionState.getImageSize(),
+			imageName: getImageBasename(),
+			driveTitle: getDrivesTitle(),
+		};
+	}
+
+	public componentDidMount() {
+		observe(() => {
+			this.setState(this.stateHelper());
+		});
+	}
+
+	public render() {
+		const shouldDriveStepBeDisabled = !this.state.hasImage;
+		const shouldFlashStepBeDisabled =
+			!this.state.hasImage || !this.state.hasDrive;
+
+		if (this.state.current === 'main') {
+			return (
+				<ThemedProvider style={{ height: '100%', width: '100%' }}>
+					<header
+						id="app-header"
+						style={{
+							width: '100%',
+							padding: '13px 14px',
+							textAlign: 'center',
+						}}
+					>
+						<span
+							style={{
+								cursor: 'pointer',
+							}}
+							onClick={() =>
+								openExternal('https://www.balena.io/etcher?ref=etcher_footer')
+							}
+							tabIndex={100}
+						>
+							<SVGIcon
+								paths={['../../assets/etcher.svg']}
+								width="123px"
+								height="22px"
+							/>
+						</span>
+
+						<span
+							style={{
+								float: 'right',
+								position: 'absolute',
+								right: 0,
+							}}
+						>
+							<Button
+								icon={<FontAwesomeIcon icon={faCog} />}
+								color={colors.secondary.background}
+								fontSize={24}
+								style={{ width: '30px' }}
+								plain
+								onClick={() => this.setState({ hideSettings: false })}
+								tabIndex={5}
+							/>
+							{!settings.get('disableExternalLinks') && (
+								<Button
+									icon={<FontAwesomeIcon icon={faQuestionCircle} />}
+									color={colors.secondary.background}
+									fontSize={24}
+									style={{ width: '30px' }}
+									plain
+									onClick={() =>
+										openExternal(
+											selectionState.getImageSupportUrl() ||
+												'https://github.com/balena-io/etcher/blob/master/SUPPORT.md',
+										)
+									}
+									tabIndex={5}
+								/>
+							)}
+						</span>
+					</header>
+					{this.state.hideSettings ? null : (
+						<SettingsModal
+							toggleModal={(value: boolean) => {
+								this.setState({ hideSettings: !value });
+							}}
+						/>
+					)}
+
+					<div
+						className="page-main row around-xs"
+						style={{ margin: '110px 50px' }}
+					>
+						<div className="col-xs">
+							<ImageSelector flashing={this.state.isFlashing} />
+						</div>
+
+						<div className="col-xs">
+							<DriveSelector
+								webviewShowing={this.state.isWebviewShowing}
+								disabled={shouldDriveStepBeDisabled}
+								nextStepDisabled={shouldFlashStepBeDisabled}
+								hasDrive={this.state.hasDrive}
+								flashing={this.state.isFlashing}
+							/>
+						</div>
+
+						{this.state.isFlashing && (
+							<div
+								className={`featured-project ${
+									this.state.isFlashing && this.state.isWebviewShowing
+										? 'fp-visible'
+										: ''
+								}`}
+							>
+								<FeaturedProject
+									onWebviewShow={(isWebviewShowing: boolean) => {
+										this.setState({ isWebviewShowing });
+									}}
+								/>
+							</div>
+						)}
+
+						<div>
+							<ReducedFlashingInfos
+								imageLogo={this.state.imageLogo}
+								imageName={middleEllipsis(this.state.imageName, 16)}
+								imageSize={
+									_.isNumber(this.state.imageSize)
+										? (bytesToClosestUnit(this.state.imageSize) as string)
+										: ''
+								}
+								driveTitle={middleEllipsis(this.state.driveTitle, 16)}
+								shouldShow={
+									this.state.isFlashing && this.state.isWebviewShowing
+								}
+							/>
+						</div>
+
+						<div className="col-xs">
+							<Flash
+								goToSuccess={() => this.setState({ current: 'success' })}
+								shouldFlashStepBeDisabled={shouldFlashStepBeDisabled}
+							/>
+						</div>
+					</div>
+				</ThemedProvider>
+			);
+		} else if (this.state.current === 'success') {
+			return (
+				<div className="section-loader isFinish">
+					<FinishPage goToMain={() => this.setState({ current: 'main' })} />
+					<SafeWebview src="https://www.balena.io/etcher/success-banner/" />
+				</div>
+			);
+		}
+	}
+}
+
+export default MainPage;

lib/gui/app/pages/main/styles/_main.scss

@@ -0,0 +1,201 @@
+/*
+ * Copyright 2016 balena.io
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+img[disabled] {
+  opacity: $disabled-opacity;
+}
+
+.page-main {
+  flex: 1;
+  align-self: center;
+  margin: 20px;
+}
+
+.page-main > .col-xs {
+  height: 165px;
+}
+
+.page-main .step-selection-text {
+  display: flex;
+  flex-wrap: wrap;
+  justify-content: center;
+  color: $palette-theme-dark-foreground;
+}
+
+.page-main .text-disabled > span {
+  color: $palette-theme-dark-disabled-foreground;
+}
+
+.page-main .step-drive.text-warning {
+  color: $palette-theme-warning-background;
+}
+
+.page-main .relative {
+  position: relative;
+}
+
+.page-main .button-abort-write {
+  width: 20px;
+  height: 20px;
+  margin: 0;
+  padding: 0;
+  font-size: 16px;
+  position: absolute;
+  right: -17px;
+  top: 30%;
+}
+
+.button-brick {
+  width: 200px;
+  height: 48px;
+  font-size: 16px;
+  font-weight: 300;
+}
+
+.page-main .step-tooltip {
+  display: block;
+  margin: -5px auto -20px;
+  color: $palette-theme-dark-disabled-foreground;
+  font-size: 10px;
+}
+
+.page-main .step-footer {
+  width: 100%;
+  color: $palette-theme-dark-disabled-foreground;
+  font-size: 10px;
+}
+
+.page-main p.step-footer {
+  margin-top: 9px;
+}
+
+.page-main .step-footer-split {
+  position: absolute;
+  top: 39px;
+  left: 28px;
+  margin-left: auto;
+  margin-right: auto;
+  display: flex;
+  justify-content: space-between;
+  width: $btn-min-width;
+}
+
+.page-main .button.step-footer {
+  font-size: 16px;
+  color: $palette-theme-primary-background;
+  border-radius: 0;
+  padding: 0;
+  width: 100%;
+  font-weight: 300;
+  height: 21px;
+}
+
+.page-main .step-drive.glyphicon {
+  margin-top: 1px;
+}
+
+.page-main div.step-fill,
+.page-main span.step-fill {
+  margin-top: 25px;
+}
+
+.page-main .step-drive.step-list {
+  &::-webkit-scrollbar {
+    width: 4px;
+  }
+
+  &::-webkit-scrollbar-thumb {
+    background-color: $palette-theme-dark-disabled-foreground;
+    border-radius: 4px;
+  }
+}
+
+.page-main .glyphicon {
+  vertical-align: text-top;
+}
+
+.page-main .step-name {
+  display: flex;
+  justify-content: center;
+  align-items: center;
+  height: 39px;
+  width: 100%;
+  font-weight: bold;
+  color: $palette-theme-primary-foreground;
+}
+
+.page-main .step-size {
+  color: $palette-theme-dark-disabled-foreground;
+  margin: 0 0 8px 0;
+  font-size: 16px;
+  line-height: 1.5;
+  height: 21px;
+  width: 100%;
+}
+
+.page-main .step-list {
+  height: 80px;
+  margin: 15px;
+  overflow-y: auto;
+  color: $palette-theme-dark-disabled-foreground;
+}
+
+.target-status-wrap {
+  display: flex;
+  position: absolute;
+  top: 62px;
+  flex-direction: column;
+  margin: 8px 28px;
+  align-items: flex-start;
+}
+
+.target-status-line {
+  display: flex;
+  align-items: baseline;
+  margin-bottom: 9px;
+
+  > .target-status-dot {
+    width: 12px;
+    height: 12px;
+    border-radius: 50%;
+    margin-right: 10px;
+  }
+
+  &.target-status-successful > .target-status-dot {
+    background-color: $palette-theme-success-background;
+  }
+  &.target-status-failed > .target-status-dot {
+    background-color: $palette-theme-danger-background;
+  }
+
+  > .target-status-quantity {
+    color: white;
+    font-weight: bold;
+  }
+
+  > .target-status-message {
+    color: gray;
+    margin-left: 10px;
+  }
+}
+
+.tooltip-inner {
+  white-space: pre-line;
+}
+
+.space-vertical-large {
+  position: relative;
+}