ProjectorRays is a decompiler for Adobe Shockwave and Adobe Director (formerly known as Macromedia Shockwave and Macromedia Director, and not to be confused with Shockwave Flash).

Director was released in 1987, and it quickly became the world's leading multimedia platform. Beginning in 1995, Director movies could be published as DCR files and played on the web with the Shockwave plugin. Over the years, the platform was used for countless CD-ROM and web games, before being fully discontinued in 2019.

Nowadays, Shockwave games are unplayable on the modern web, and their original source code is often lost or unavailable. ProjectorRays can take a published game, reconstruct its Lingo source code, and generate editable project files to aid preservation efforts.

If you have a DCR (published Shockwave movie) or DXR (protected Director movie), ProjectorRays can generate a DIR (editable Director movie).

If you have a CCT (published Shockwave cast) or CXT (protected Director cast), ProjectorRays can generate a CST (editable Director cast).

ProjectorRays is a work in progress. If you run into any issues, please report them on the issue tracker.

Windows builds are available on the releases page.

To use it, drag and drop a movie/cast file (or a folder containing multiple of them) onto projectorrays-0.2.0.exe. ProjectorRays will create an unprotected/decompressed version of the input file(s) with the source code restored. The outputted file(s) can then be opened in Director.

To use ProjectorRays on the command line, run projectorrays-0.2.0.exe decompile <input path>.

Install Boost 1.72.0 or later, mpg123, and zlib. Run make to build.

To use it, run ./projectorrays decompile <input path>. The input can be either a movie/cast file or a directory containing multiple of them. ProjectorRays will create an unprotected/decompressed version of the input file(s) with the source code restored. The outputted file(s) can then be opened in Director.

ProjectorRays is written by Debby Servilla, based on the disassembler by Anthony Kleine.

This could not exist without the reverse-engineering work of the Earthquake Project, the Just Solve the File Format Problem wiki, and the ScummVM Director engine team.

The projector icon is by DangerouslySlowCat.

ProjectorRays is licensed under the Mozilla Public License 2.0.