Personal tools
Namespaces

Variants
Actions

Ledcap

From NiftyWiki
Revision as of 11:18, 4 April 2014 by Admin (talk | contribs) (Usage)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search
Home Documentation Download Support Showroom Links

Flattr-badge-large.png

Description

Capture portion of screen and send it to LED-setup.


Installation

Debian

If not done, yet:

  • import archive key (Fingerprint: 895D 8086 8FEF 100C DA82 0393 16CC 4680 AA46 5E22):
wget -qO - http://debian.niftylight.de/archive.key | sudo apt-key add -
  • register niftylight package source in /etc/apt/sources.list:
deb http://debian.niftylight.de/ unstable main
deb-src http://debian.niftylight.de/ unstable main
  • update
sudo apt-get update


to install, run:

sudo apt-get install ledcap


Gentoo

Emerge layman if you don't have it already.

emerge -va layman

Add the niftyled overlay (if you don't have already)

layman -f -o http://gentoo.niftylight.de/layman.xml -a niftyled

Emerge:

emerge --autounmask-write ledcap


Compile manually

Prerequisites

to compile from sources:

to run:


Get sources

Git: git clone git://github.com/niftylight/ledcap.git
ZIP-Archive: https://github.com/niftylight/ledcap/zipball/master
Browse: github.com.


Compile

If your OS doesn't include the default install prefix, you might have to do that yourself before compiling:

export PKG_CONFIG_PATH="/usr/local/lib/pkgconfig"
export LD_LIBRARY_PATH="/usr/local/lib"
export PATH="${PATH}:/usr/local/bin"


to compile & install, cd into the source directory and run:

autoreconf -is
mkdir build
cd build
../configure
make
sudo make install


If you don't want to install to the default location (/usr/local), you can choose a different install prefix, e.g.:

./configure --prefix=/usr


To freshly rebuild a previously built tree, do (you can skip this if you just checked out the sources):

make maintainer-clean
or just remove all contents of the build directory and repeat the previous steps.


See additional compile time options by running:

./configure --help



Usage

Capture portion of screen & display on LED hardware - http://wiki.niftylight.de/ledcap
Usage: ledcap [options]

Valid options:
    --help                -h          This help text
    --mechanism <name>    -m <name>   Capture mechanism (default: "Xlib")
    --plugin-help         -p          List of installed plugins + information
    --config <file>       -c <file>   Load this config file (default: ~/.ledcat.xml) 
    --x <x>               -x <x>      X-coordinate of capture rectangle (default: 0)
    --y <y>               -y <y>      Y-coordinate of capture rectangle (default: 0)
    --dimensions <w>x<h>  -d <w>x<h>  Define width and height of capture rectangle. (default: auto)
    --fps <n>             -f <n>      Framerate to play multiple frames at (default: 25)
    --loglevel <level>    -l <level>  Only show messages with loglevel <level> (default: info)


Valid loglevels:
 verynoisy noisy debug verbose info warning error 

Supported capture mechanisms:
 Xlib Imlib2

Documentation

Ledcap parses an LED-setup XML file (default: ~/.ledcap.xml). It captures a rectangular portion of the screen (with offset --x and --y, width & height given by --dimensions) and displays it on the LED setup according to the requested framerate (default 25).


Examples

Capture 16x16 pixel @ 30 frames per second:

ledcap -d 16x16 -f 30


Issues

Please report anything via the issue tracker.


Changes


capture portions of the screen and send it to an LED display
http://wiki.niftylight.de/images/c/c9/Logo.png
ledcap
https://github.com/niftylight/ledcap/
Commandline screen capture utility to send screen output to a niftyled setup
niftylight GmbH
2006-2014
hardware
led
niftyled
https://github.com/niftylight/ledcap/releases
linux
libniftyled