Grid Capture

[Tyler]

Grid Capture

Screenshot/Recording tool for grid and norns.

Requirements

• norns
• grid (any size should work, only tested on 128)
• Imagemagick installed on norns

Example

local g = grid.connect()
local gcap = require 'GridCapture/GridCapture'

function init()
  g:all(0)
  g:refresh()
  gcap:set_grid(g)
end

function g.key(x,y,z)
  g:led(x,y,15)
  g:refresh()
end

function key(n,z)
  if n == 2 then
    gcap:record(24, 5, 'home/we/image.gif')
  elseif n == 3 then
    gcap:screenshot('home/we/screenshot.png')
  end
end

Github Link

Themes

@Tyler

“bw”

(p.s. please share any themes you make!)

[Justmat]

This looks great! My only thought is the yellow is a bit hard to read, something with a little more weight to it might help legibility. Maybe #fff03e or #fff139 if you’re going with yellow?

[tyleretters]

What does it screenshot?

[Justmat]

A grid It can take stills of your grid state, like a screenshot, and even record gif’s!

[junklight]

nice!

+1 on the yellow - kind of hard to read on my laptop screen

[Tyler]

Yes, it’s hard to replicate the glow of the real thing. I think I’ll go with a more visible yellow as a default. Maybe I could make the colors settable.

GridCaptyure:set_colors(args)

Then I could have a table of themes, that could be unpacked for the args.

[tyleretters]

Here’s a color combo I’m using for some of my docs.

[Tyler]

first theme,

“bw”

[tehn]

this is super rad.

i should get imagemagik into the base norns install

[Tyler]

Also, does anyone know how to cancel os.execute() while it’s in progress? I’d like to effectively Ctrl+C it when I mess up a recording.

[tyleretters]

Oh yeah, this is gorgeous. Amazing work.

[csboling]

@Tyler

cancel os.execute()

Should be possible to use io.popen instead of os.execute, and close() the handle to kill the process.

> handle = io.popen('yes')
<ok>
> handle:read('*line')
y
> handle:read('*line')
y
> ret = {handle:close()}
yes: standard output
: Broken pipe
<ok>
> ret[1]
nil
> ret[2]
exit
> ret[3]
1  -- process exit code, I think?

[tehn]

opposite of cancel but thought you’d be interested;

i made a threaded os command queue, where you can assign a callback per command so it will be non-blocking:

monome/norns/blob/master/lua/core/norns.lua#L176

[delineator]

Grid capture looks awesome! Is there a similar library for norns screen capture?

[kbra]

It’s got something built in already: help - docs

[Tyler]

@delineator

Is there a similar library for norns screen capture?

Actually, yes! I was planning to officially release it when I roll grid capture into, but I haven’t touched it in a while. You can get it on github here. It makes use of the clock and the screenshot function that @kbra mentions.

Let me know if you need help getting it to work.

[kbra]

Oh, yes, I got mixed up (library vs command line functionality in general), sorry Good to hear there’s a library for that as well!

[sixolet]

Themes.borderless = {
    "#000000", -- key
    "#ffffff", -- led
    "#000000", -- grid
    "black",   -- outline
}