Need help with r_e_c_u_r?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

181 Stars 18 Forks GNU General Public License v3.0 505 Commits 32 Opened issues


an open diy py/pi based video sampler

Services available


Need anything else?

Contributors list

# 94,229
1 commit


an open diy video sampler


recur is an embedded python/openframeworks application on raspberry pi3 that uses

from the keypad to control
while displaying a simple text ui on a rpi lcd screen

in-depth video demo



  • seamlessly loop video through rpi's HDMI or composite out
  • intuitively browse video files from external and internal disk and map them into recur
  • load and trigger video samples from numbered slots in the sampler bank
  • dynamically set and clear the start/end points of each sample as it plays
  • control and sequence all inputs and more with midi-usb
  • many sampler modes for varied playback including: repeat, one-shot, gated, random, fixed-length, random-start and more
  • exhaustive and extendable settings menu to suit your use


as of V2.0 the recur platform has been extended in a number of directions to complement live performance and _recur_ , the original video playing engine:

  • _captur_ : input live video via CSI or USB , for live sampling and processing
  • _conjur_ : glsl shader engine, map and trigger shader files and control parameters in real time; generate video or process and mix existing sources
  • _detour_ : in-memory frame sampling (up to 500 frames), video scrubbing, playback speed and direction control, finger drumming
  • toggling internal feedback + strobe effect

NOTE: most of the new V2.0 features are optimised for sd composite video output. Some of these extensions will work over HDMI but they are not fully supported - especially the live video input struggles

extension video walkthroughs

  • conjur_walkthrough
  • captur_walkthrough
  • detour_walkthrough

main objectives:

  • Affordable : reducing the entry cost to performing with video
  • Extendable : laying the foundations (of a user interface and code style) that can be easily iterated on by the community
  • Simple : easy to operate (abstracted completely from ‘driving’ a raspi ) , easy to build (no technical computer install-y or circuit-y knowledge required to diy) , easy to develop (human readable code, inviting amateur/first time coders to contribute)


many other things documented on the wiki


The nature of this project is to be open-ended and community driven. my recur already solves the problems i initially built it for. what happens next depends on how it is used and received by you. if you like the idea please let me know / get involved !

contact, donation and thanks

[email protected]

you can find me (and others) at , an online diy av community space. theres a recur channel in the chatroom: there is also a facebook user group :

all feedback is appreciated. if you want to donate to this project you can do so with the above email via paypal : everything i receive will go into improving recur. cheers to Leo Browning for the 3d modelling and vector art and to Ben Caldwell for heaps of help with the code!

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.