mcopy/app
mmcw-dev 2c76710f91 Add readme.md work for 1.0.3 release 2018-03-16 10:50:55 -04:00
..
assets/icons New icons 2018-03-14 23:15:01 -04:00
css app.css updated from seq.less change 2018-03-15 11:55:58 -04:00
data Save devices state 2018-02-01 14:52:47 -05:00
fonts Fixed font-awesome 2016-04-13 17:36:12 -04:00
js mse.mscript and mse.console for mscript editor features. 2018-03-05 13:27:00 -05:00
less All UI update for new mscript features 2018-03-14 23:17:42 -04:00
lib Require package file for server module. Still in dev. 2018-03-15 15:32:26 -04:00
src Migrate mscript functions into their own source file 2018-03-04 23:55:31 -05:00
tests Add mscript tests 2016-04-12 00:21:31 -04:00
.gitignore Hardcode cfg.json with all the new command characters. 2018-01-09 23:02:47 -05:00
Readme.md Add readme.md work for 1.0.3 release 2018-03-16 10:50:55 -04:00
build_linux.json Fix linux build process. Working now. 2018-03-15 15:32:09 -04:00
build_linux.sh Name package mcopy-app in linux build process 2018-03-15 15:33:45 -04:00
build_mac.sh Update build mac script 2018-03-14 23:43:42 -04:00
build_win.js Build windows .msi script 2018-01-30 04:08:35 -05:00
build_win.sh Target correct icon path 2018-03-15 11:23:36 -04:00
gulpfile.js Stop building app with mscript.js, gets required by index.js 2018-01-05 15:47:54 -05:00
icons.sh Placeholder icons and script for app icon. Windows is still not working, investigate the conversion step to see whether or not it is generating a valid icon. 2018-01-06 17:49:58 -05:00
index.html All UI update for new mscript features 2018-03-14 23:17:42 -04:00
install.sh No longer need logs directory locally. 2018-01-09 23:36:56 -05:00
main.js Add experimental feature library. 2018-03-15 14:51:26 -04:00
package-lock.json Rename package to mcopy-app to prevent issues installing alongside mtools. Incremented build after patching issues with the grid sequencer. 2018-03-15 15:31:50 -04:00
package.json Rename package to mcopy-app to prevent issues installing alongside mtools. Incremented build after patching issues with the grid sequencer. 2018-03-15 15:31:50 -04:00

Readme.md

mcopy desktop app

  1. Installation

Installation

The mcopy desktop app can be either installed from a binary (on macOS) or built from source on any platform that supports node.js and Electron apps.

Dependencies

Once node is installed (see below for platform-specific instructions) open your terminal application and enter the following commands:

git clone https://github.com/sixteenmillimeter/mcopy.git
cd mcopy/app
npm install

That's it. Once the npm install process is complete, the app can be launched with:

npm start

If you are interested in running in dev mode, simply use:

npm run dev

macOS

Installing node.js on macOS

The node.js runtime can be easily installed on macOS if you already have Homebrew. Simply install node.js with the command:

brew install node

If you're not using Homebrew, you can also install it from the node.js website.

Linux

Installing node.js on Linux

See this helpful document from the node.js Foundation about installing node.js from different package managers. This will provide more detailed instructions about distro-specific dependencies for node.js and the different packages available. Use a more current version of node, if available. At the time of this writing, development is taking place on node.js version 9.7.1.

Arduino firmware

It's recommended that on linux distributions, you have the Arduino IDE installed for debugging and to ensure that your system serial permissions are configured to communicate with the Arduino devices.

Binary installation

When installing from the pre-built .deb package, you may have to locate the package after installation using the following command:

dpkg -L mcopy-app

In the output, you should see an item like /usr/lib/mcopy-app/mcopy which is the binary that contains the desktop app. I will improve the Linux build process, but will also accept any PRs which improve it as well.

Windows

Installing node.js on Windows

Install node.js on Windows using one of their many install options.