Meme as Code. A programming language where memes are first-class citizens.
@two_panel {
top: "Me: it works on my machine"
bottom: "Prod: lol no"
} |> glitch => "meme.png"
curl -fsSL https://macstudio.meme/install.sh | bashOr build from source:
cmake -S . -B build && cmake --build buildEvery meme expression follows a composable grammar. Here's how all the pieces fit together:
@<template> [WxH] [style] { top: "..." bottom: "..." } [|> effect] [=> "path"]
@<template> [WxH] [style] "one-liner text" [|> effect] [=> "path"]
@"path/to/image.png" [WxH] [style] { ... } [|> effect] [=> "path"]
@blank "Hello" // minimal
@two_panel { top: "A" bottom: "B" } // block with positions
@square 800x800 { top: "Sized" } // with dimensions
@dark neon { top: "Styled" } // with style
@dark 800x800 neon { top: "All" } |> glitch // size + style + effect
@"photo.png" { top: "Custom" } => "out.png" // custom template + save
effect <name> = <effect> >> <effect> >> ... ;
effect glitch = pixelate(4) >> contrast(1.8) >> noise(0.2);
effect vintage = sepia >> brightness(0.9);
effect cyberpunk = hueShift(180) >> contrast(1.5) >> chromatic(3) >> glow(4);
style <name> {
color: "#RRGGBB"
outline: <pixels>
outlineColor: "#RRGGBB"
shadow: <offset>
shadowColor: "#RRGGBBAA"
}
style neon {
color: "#00FF41"
outline: 4
outlineColor: "#003300"
shadow: 3
shadowColor: "#00FF4180"
}
gif [loop] {
<meme> [|> effect] : <duration>
<meme> [|> effect] : <duration>
...
} [=> "path"]
gif loop {
@blank "3" : 500ms
@blank "2" : 500ms
@blank "GO!" : 1s
} => "countdown.gif"
timeline [loop] {
<meme> [|> effect] : <duration>
--- <transition> <duration> [easing] ---
<meme> [|> effect] : <duration>
...
} [=> "path"]
timeline loop {
@two_panel { top: "Act 1" } |> vintage : 3s
--- crossfade 300ms ease ---
@two_panel { top: "Act 2" } |> glitch : 3s
--- fadeBlack 400ms ---
@blank "fin." : 2s
} => "story.gif"
grid <cols>x<rows> {
<meme> [|> effect]
<meme> [|> effect]
...
} [|> pad(n)] [|> border(n)] [=> "path"]
grid 2x2 {
@blank "A" |> sepia
@blank "B" |> glitch
@blank "C" |> vintage
@blank "D" |> deepfry
} |> pad(5) |> border(2) => "grid.png"
beside(<meme>, <meme>) // side by side
stack(<meme>, <meme>) // vertical
<expr> |> pad(<px>) // padding
<expr> |> border(<px>) // border
<expr> |> <fn> // pass as first arg
<expr> |> <fn>(args) |> <fn> ... // chain
<fn> >> <fn> >> <fn> // compose into new function
<array> |> map(<fn>) // transform each
<array> |> filter(<fn>) // keep matches
<array> |> reduce(<fn>, <init>) // fold to value
<array> |> zip(<array>) // pair elements
["Mon", "Tue", "Wed"]
|> map(d -> @two_panel { top: d })
|> reduce((g, m) -> g.frame(m, Duration(500)), Gif())
|> save("week.gif")
<expr> => "filename.png" // save to ~/mac/output/
<expr> => "filename.gif" // auto-detects format
<expr> => "subdir/file.png" // explicit relative path
<expr> => "/tmp/file.png" // explicit absolute path
If MAC_OUTPUT_DIR is set, saves are redirected there and only the filename portion is kept.
| Element | Options |
|---|---|
| Templates | two_panelthree_panelbottom_textblankdarkwidetallsquarefour_panelcaption_bar or @"path" |
| Positions | topbottomcenter |
| Effects (param) | blur(n)pixelate(n)noise(n)saturate(n)contrast(n)brightness(n)jpeg(n)hueShift(n)glow(n)posterize(n)chromatic(n)threshold(n)tint(n) |
| Effects (direct) | invertsepiasharpenvignettegrayscaledeepfry |
| Transitions | crossfadeslideLeftslideRightslideUpslideDownwipefadeBlackzoom |
| Easing | easeeaseIneaseOuteaseInOut |
| Durations | 400ms2sDuration(400) |
| Sizes | 800x600Size(800, 600) |
Mac is a dynamically typed language with functions, closures, classes, arrays, maps, arrow functions, pipes, and operator overloading.
See LANGUAGE.md for the full reference.
Syntax highlighting, LSP (hover, go-to-definition, inlay hints, semantic tokens, signature help, find references, document symbols), snippets, and file icons.
cd mac-lang && npm install && npx tsc &&cd ..
ln -sf "$(pwd)/mac-lang"~/.vscode/extensions/mac-langcmake --build build && bash tests/run_tests.shSee docs/BUILDING.md and docs/ARCHITECTURE.md.
MIT