Skip to content

hijera/pyGIFpad

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

12 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

pyGIFpad

Play gifs on your Novation Launchpad! Btw, animated webp is also supported Tested on Launchpad pro and Launchpad S.

Changes

14.05.2022

v. 0.3 :

  • Ableton Link Support
  • Midi CLK support

Demo

lp_s.mp4

Requirements

  • Python 3

Packages:

  • pygame
  • launchpad_py
  • numpy
  • pillow
  • link (if you want to use Ableton Link support)
  • rtmidi (if you want to use Midi support)

Configuration parameters

launchpad_type=1

Selects launchpad for animation. All available devices listed in ini (but not all were tested).

sync_mode = midi

Selects sync mode. Can be one of these values:

  • auto - redraws launchpad in the fixed amount of time
  • ableton_link - sync redraw through Ableton Link
  • midi - sync redraw trough MIDI
ableton_bpm = 120

Used only when sync_mode "ableton_link" is used. Start value of ableton BPM. (it changes after syncing in a fact)

midi_device_id = 6

Used only when sync_mode = "midi". Midi device to receive input CLK signal. If id was wrong, shows available midi devices with id to help and quits:

Midi Port Not Found. Available Ports:
['Arturia MiniLab mkII 0', 'Focusrite USB MIDI 1']
midi_sync_time = 0.25

Used only when sync_mode = "midi" or "ableton_Link" . Describes speed of changing frames. In beats for "ableton_link" and in seconds for "midi".

``ini midi_sync_start = 1

Used only when sync_mode = "midi". Starts animation only when "start" midi command received

`` 
midi_sync_stop = 1

Used only when sync_mode = "midi" .Stops animation only when "stop" midi command received.

gif_folder=.

Directory with all gif/webp files.

defaultgif=name.gif

specifies gif by default.

frame_time=0.03

describes delay per one frame in seconds. For example, 0.03 is about 30 fps. Minimal delay is limited by launchpad performance

Specific configuration sections

Launchpad buttons can be used to switch between animations. To use it, add section

[CONFIG_BUTTON_Y_X]
gif=filename.gif

where X and Y - coordinates of launchpad button , which will switch to animation filename.gif Button coordinates equals to launchpad_py coordinates (look documentation at https://github.com/FMMT666/launchpad.py)

Usage with Ableton Link

  1. Set sync_mode = ableton_link
  2. Launch Ableton
  3. Launch pygifPad.
  4. Turn on "Link" on the left upper corner of the Ableton's window: изображение
  5. Press "play" in Ableton. Animation will be synchronised with Ableton.

Usage with MIDI

(Will be pretty easy later)

  1. Set sync_mode = midi
  2. Set midi_device_id = 10
  3. Launch pyGIFpad . It will say that port is not found and will show available ports
  4. Change midi_device_id to preferable port.
  5. Launch pyGIFpad. Animation will be synchronised with midi CLK.

Examples in Usage

Videos, where application was used in.

About

Play gifs (and webp) on your Launchpad!

Resources

Stars

Watchers

Forks

Packages

No packages published

Languages