History

mmcwilliams 4356abc820 Disable light from the UI if necessary. Kind of circuitous, will refactor.		2019-03-21 22:55:12 -04:00
..
assets/icons	New icons	2018-03-14 23:15:01 -04:00
css	Remove log from UI. Just use console and write directly to system log.	2019-03-21 15:47:07 -04:00
data	Rename all keys to full "camera_" vs "cam_" and "projector_" vs "proj_" for consistency across the app.	2019-03-21 21:02:28 -04:00
fonts	Fixed font-awesome	2016-04-13 17:36:12 -04:00
js	Print the current active version into the mcopy.state object	2019-03-21 21:32:33 -04:00
less	Remove log from UI. Just use console and write directly to system log.	2019-03-21 15:47:07 -04:00
lib	Disable light from the UI if necessary. Kind of circuitous, will refactor.	2019-03-21 22:55:12 -04:00
scripts	Run docs as shell, not bash	2019-03-04 22:09:26 -05:00
src	Print the current active version into the mcopy.state object	2019-03-21 21:32:33 -04:00
test	Update mscript tests. Could not repro error because it is due to escaping.	2019-02-24 08:31:22 -05: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
display.html	Add new display and capture modules. Don't need new capture module rn.	2019-02-08 13:16:42 -05:00
gulpfile.js	Stop building app with mscript.js, gets required by index.js	2018-01-05 15:47:54 -05:00
index.html	Rename all keys to full "camera_" vs "cam_" and "projector_" vs "proj_" for consistency across the app.	2019-03-21 21:02:28 -04:00
main.js	Took a tiny detour on the film out feature, or "digital projector". This now avoids showing a browser window fullscreen on mac, which is having performance issues when opening and then running sequences. There is a major source of lag, seemingly coming from the camera? Need to test with fake projector to see if there's a problem with the arduino lib.	2019-03-21 22:33:30 -04:00
package-lock.json	Create and install main process lib to control the cmd.js module	2019-03-21 19:33:01 -04:00
package.json	Create and install main process lib to control the cmd.js module	2019-03-21 19:33:01 -04:00

Readme.md

mcopy desktop app

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

git
node.js

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.