mcopy/Readme.md

80 lines
3.4 KiB
Markdown
Raw Permalink Normal View History

# mcopy
2018-03-03 02:12:54 +00:00
An open platform for controlling small-gauge film optical printers (16mm, Super8, 8mm).
-------
2018-03-03 02:12:54 +00:00
1. <a href="#intro">Introduction</a>
2018-03-16 14:50:55 +00:00
2. <a href="#downloads">Downloads</a>
1. <a href="#usage">Usage</a>
2018-03-03 02:12:54 +00:00
2. <a href="#software">Software</a>
3. <a href="#firmware">Firmware</a>
3. <a href="#hardware">Hardware</a>
4. <a href="#why">Why?</a>
-------
## Introduction <a name="intro"></a>
2018-03-03 02:12:54 +00:00
The `mcopy` project is comprised of software and hardware for optical printers, built with re-purposed broken projectors.
2018-01-02 06:16:47 +00:00
#### Components
* Sequencer desktop app
2018-03-15 13:35:06 +00:00
* Scripting language, called `mscript`, for orchestrating complex sequences
2018-01-02 06:16:47 +00:00
* Arduino firmware for projectors, cameras, lights and existing printers
2018-03-16 14:50:55 +00:00
* 3D models of parts used for modifying projectors and printers
* Schematics for simple Arduino-based electronics
2018-03-15 13:35:06 +00:00
## Downloads <a name="downloads"></a>
2018-01-02 06:16:47 +00:00
2019-05-28 18:18:15 +00:00
### Latest Installers
* [1.4.9](https://github.com/sixteenmillimeter/mcopy/releases/tag/1.4.9) for macOS and Linux (.deb)
### Older Versions
* [1.2.0](https://github.com/sixteenmillimeter/mcopy/releases/tag/1.2.0) for macOS and Linux (.deb)
2018-03-16 14:50:55 +00:00
* [1.0.3](https://github.com/sixteenmillimeter/mcopy/releases/tag/1.0.3) for macOS and Linux (.deb)
For Windows, you can [install from source](https://github.com/sixteenmillimeter/mcopy/tree/master/app#mcopy-desktop-app) for now.
## Usage <a name="usage"></a>
2018-10-05 22:07:59 +00:00
The software requires your hardware to be in place before the mcopy control app is useful.
![mcopy app](docs/mcopy.png?raw=true "mcopy app")
2018-03-16 14:50:55 +00:00
## Software <a name="software"></a>
2018-03-16 14:50:55 +00:00
The mcopy desktop app is an Electron-based project which can be built for Linux, Windows and macOS.
Pre-built packages will be made available for macOS, initially, with the other two target platforms to follow.
To build the desktop app from source, see the [installation and running instructions](https://github.com/sixteenmillimeter/mcopy/tree/master/app#mcopy-desktop-app).
The desktop software also interoperates with two related projects; the Bluetooth + Wifi capable, Raspberry Pi-based [INTVAL3](https://github.com/sixteenmillimeter/intval3) and the Arduino-based [intval2](https://github.com/sixteenmillimeter/intval2).
2018-03-03 02:12:54 +00:00
## Firmware <a name="firmware"></a>
This project contains Arduino formware for controlling:
2018-03-16 14:50:55 +00:00
* a projector
* a camera (see [intval2](https://github.com/sixteenmillimeter/intval2) for more info)
* a light
* a projector + a camera
* a projector + a light
* a camera + a light
* a camera + a projector + a light
2018-03-03 02:12:54 +00:00
2018-03-16 14:50:55 +00:00
Using a simple serial interface, this modular platform can be used to control DIY components, modified existing optical printers or a mixture of components.
The desktop app can connect to multiple serial devices, so your mcopy optical printer can be built from various designs that suit your hardware tastes/needs/available parts.
2018-01-02 06:16:47 +00:00
## Hardware <a name="hardware"></a>
2018-03-16 14:50:55 +00:00
All non-electronic hardware for this project is available as plaintext OpenSCAD files and 3D print-able .STL files.
The hardware component of this project is aimed at modifying broken Bell & Howell projectors into USB serial-controlled projectors to be used in optical printing.
As a secondary capability, this desktop software and firmware package can be used to replace the sequencers for early-model JK optical printers, with some modification.
2018-01-02 06:16:47 +00:00
## Why? <a name="why"></a>
I'm interested in expanding the viability and access of the 16mm film format and to repurpose thre rising tide of discarded film technology.