Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/jwilk/fbcat
framebuffer grabber
https://github.com/jwilk/fbcat
Last synced: about 1 month ago
JSON representation
framebuffer grabber
- Host: GitHub
- URL: https://github.com/jwilk/fbcat
- Owner: jwilk
- License: gpl-2.0
- Created: 2016-06-10T20:51:53.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2024-01-29T10:50:49.000Z (11 months ago)
- Last Synced: 2024-08-09T00:21:57.430Z (5 months ago)
- Language: C
- Homepage: https://jwilk.net/software/fbcat
- Size: 143 KB
- Stars: 81
- Watchers: 7
- Forks: 6
- Open Issues: 3
-
Metadata Files:
- Readme: README.rst
- Funding: .github/FUNDING.yml
- License: COPYING
Awesome Lists containing this project
README
Overview
========
**fbcat** takes a screenshot using the Linux framebuffer device.
Two executables are provided:
* Low-level ``fbcat`` that operates on the current virtual terminal and writes
the screenshot to stdout in the PPM_ format:
.. code:: console
$ fbcat > screenshot.ppm
$ file screenshot.ppm
screenshot.ppm: Netpbm image data, size = 1280 x 1024, rawbits, pixmap
.. _PPM: https://netpbm.sourceforge.net/doc/ppm.html
* High-level ``fbgrab`` that supports the PNG format and virtual terminal
switching:
.. code:: console
$ fbgrab '-?'
Usage: fbgrab [option...]
Options:
-c grab from /dev/ttyN
-C grab from /dev/ttyN, for slower devices
-d use framebuffer device
-i turn on PNG interlacing
-s sleep seconds before making screenshot
-? show this help message and exit
If the specified destination is "-", the PNG output is piped to stdout.
See the manual pages for details.
The following visuals are supported:
- ``TRUECOLOR``
- ``DIRECTCOLOR``
- ``PSEUDOCOLOR``
- ``STATIC_PSEUDOCOLOR``
- ``MONO01``
- ``MONO10``
Prerequisites
=============
The following software is needed to build ``fbcat``:
- C compiler
- Linux kernel userspace headers
- GNU make
Additionally, the following software is needed to rebuild the manual pages from
source:
- ``xsltproc`` (part of libxslt_)
- `DocBook XSL stylesheets`_
``fbgrab`` requires the following software:
- ``chvt`` (part of KBD_)
- ``pnmtopng`` (part of Netpbm_) or GraphicsMagick_ or ImageMagick_
.. _libxslt:
http://xmlsoft.org/xslt/
.. _DocBook XSL stylesheets:
https://github.com/docbook/xslt10-stylesheets
.. _KBD:
https://kbd-project.org/
.. _Netpbm:
https://netpbm.sourceforge.net/
.. _GraphicsMagick:
http://www.graphicsmagick.org/
.. _ImageMagick:
https://imagemagick.org/
Installation
============
To install system-wide::
$ make
$ sudo make install
The default installation prefix is ``/usr/local``.
You can specify different one using the ``PREFIX`` variable, e.g.::
$ make install PREFIX="$HOME/.local"
.. vim:ft=rst ts=3 sts=3 sw=3 et