From 9039321733ce63d2bb404eb09709a5cab897b2a0 Mon Sep 17 00:00:00 2001 From: s-ol Date: Sat, 1 Feb 2020 18:48:53 +0100 Subject: add README --- README.md | 36 ++++++++++++++++++++++++++++++++++++ 1 file changed, 36 insertions(+) create mode 100644 README.md diff --git a/README.md b/README.md new file mode 100644 index 0000000..38d0be3 --- /dev/null +++ b/README.md @@ -0,0 +1,36 @@ +# alive-coding + +This is an experimental livecoding langauge and environment, in which +expressions persist and update until they are removed from the source code, and +the interpreter keeps no state that you cannot manipulate directly in the +source. All this is enabled with a purely text-based language and works without +special editor support. + +## dependencies + +- [MoonScript][moonscript]: `luarocks install moonscript` +- [luafilesystem][lfs]: `luarocks install luafilesystem` +- [LPeg][lpeg]: `luarocks install lpeg` +- [osc][osc]: `luarocks install osc` +- [socket][socket]: `luarocks install luasocket` (not required in love2d) +- [posix][posix]: `luarocks install luaposix` (not required in love2d) + +## running + +headless / standalone: + + $ moon init.moon + +or in [LÖVE][love2d] (make sure to install the required modules for lua5.1): + + $ love . + +running in LÖVE adds the additional `gui` module. See [`lib/gui.moon`](lib/gui). + +[moonscript]: https://moonscript.org/ +[lfs]: https://keplerproject.github.io/luafilesystem/ +[lpeg]: http://www.inf.puc-rio.br/~roberto/lpeg/ +[osc]: https://github.com/lubyk/osc +[posix]: https://github.com/luaposix/luaposix +[socket]: http://w3.impa.br/~diego/software/luasocket/ +[love2d]: https://love2d.org/ -- cgit v1.2.3