Blinkenlights

your pc binary emulating visualizer

Download Prebuilt Releases

blinkenlights-2020-12-28.com
384k - PE+ELF+MachO+ZIP+SH executable

blinkenlights-2020-12-28.com.dbg
4.5mb - ELF debug symbols and DWARF data (optional)

CLI Install

url=https://storage.googleapis.com/justine/blinkenlights
curl $url/hello.elf >hello.elf
curl $url/blinkenlights-latest.com >blinkenlights.com
chmod +x blinkenlights.com
./blinkenlights.com -?                 # show help
./blinkenlights.com -t hello.elf       # launch tui w/ example program

Linux Notes

If you get an error like "unable to find an interpreter" or "err:module:import_dll Library" then your system has likely been tuned to use binfmt-misc. You can safely restore the default Linux behavior for just Actually Portable Executables by running the following command:

sudo sh -c "echo ':APE:M::MZqFpD::/bin/sh:' >/proc/sys/fs/binfmt_misc/register"

Mac OS X Notes

You may need to run:

bash blinkenlights.com -?
Instead of:
./blinkenlights.com -?
This only applies to the first invocation, after which the executable header is patched to have the MachO magic number. It's needed because the recently introduced zsh shell has backwards compatibility issues with UNIX.

Windows Notes

You may need to run:

blinkenlights.com -?
Instead of:
./blinkenlights.com -?

OpenBSD Notes

Recent OpenBSD releases might impose restrictions on using your CPU's SYSCALL instruction without authorization from the OpenBSD C Library DSO. Until APE is patched to use syscall() we'd recommend OpenBSD v6.4.

Release History

2020-12-28

2020-11-03