Skip to content


Subversion checkout URL

You can clone with
Download ZIP
A Lua minifier written in JavaScript
JavaScript HTML
Branch: master
Failed to load latest commit information.
bin Test in Node.js v0.12, io.js, and Rhino 1.7R5
man Test in Node.js v0.12, io.js, and Rhino 1.7R5
tests Don’t rename `self`
.gitattributes Initial commit
.gitignore Add code coverage using Istanbul
.npmignore Add component.json
.travis.yml Update dependencies
Gruntfile.js Test in Node.js v0.12, io.js, and Rhino 1.7R5
LICENSE-MIT.txt Test in Node.js v0.12, io.js, and Rhino 1.7R5 Test in Node.js v0.12, io.js, and Rhino 1.7R5
bower.json Tag the v0.2.8 release
component.json Tag the v0.2.8 release
luamin.js Don’t rename `self`
package.json Update dependencies

luamin, a Lua minifier written in JavaScript

Build status Dependency status

luamin uses the excellent luaparse library to parse Lua code into an Abstract Syntax Tree. Based on that AST, luamin then generates a (hopefully) more compact yet semantically equivalent Lua program. Here’s an online demo.

luamin was inspired by the LuaMinify and Esmangle projects.

Feel free to fork if you see possible improvements!

Installation and usage

Via npm:

npm install luamin

Via Bower:

bower install luamin

Via Component:

component install mathiasbynens/luamin

In a browser:

<script src="luamin.js"></script>

In Narwhal, Node.js, and RingoJS:

var luamin = require('luamin');

In Rhino:


Using an AMD loader like RequireJS:

    'paths': {
      'luamin': 'path/to/luamin'
  function(luamin) {

Usage example:

var luaCode = 'a = ((1 + 2) - 3) * (4 / (5 ^ 6)) -- foo';
luamin.minify(luaCode); // 'a=(1+2-3)*4/5^6'

// `minify` also accepts luaparse-compatible ASTs as its argument:
var ast = luaparse.parse(luaCode, { 'scope': true });
luamin.minify(ast); // 'a=(1+2-3)*4/5^6'

Using the luamin binary

To use the luamin binary in your shell, simply install luamin globally using npm:

npm install -g luamin

After that you will be able to minify Lua scripts from the command line:

$ luamin -c 'a = ((1 + 2) - 3) * (4 / (5 ^ 6))'
$ luamin -f foo.lua

See luamin --help for the full list of options.


luamin has been tested in at least Chrome 25-27, Firefox 3-22, Safari 4-6, Opera 10-12, IE 6-10, Node.js v0.10.0, Narwhal 0.3.2, RingoJS 0.8-0.9, PhantomJS 1.9.0, and Rhino 1.7RC4.

Unit tests & code coverage

After cloning this repository, run npm install to install the dependencies needed for luamin development and testing. You may want to install Istanbul globally using npm install istanbul -g.

Once that’s done, you can run the unit tests in Node using npm test or node tests/tests.js. To run the tests in Rhino, Ringo, Narwhal, and web browsers as well, use grunt test.

To generate the code coverage report, use grunt cover.


Mathias Bynens


luamin is available under the MIT license.

Something went wrong with that request. Please try again.