screen recording wrapper for Unix cli screencast utilities | Custom version
Switch branches/tags
Nothing to show
Clone or download
Permalink
Failed to load latest commit information.
Makefile initial upload Mar 22, 2014
README.md s/chilicuil/javier-lopez/ Jun 7, 2017
TODO initial upload Mar 22, 2014
ffcast.1.pod add --help option Sep 7, 2014
ffcast.bash-completion update usage message Sep 13, 2014
ffcast.sh s/chilicuil/javier-lopez/ Jun 7, 2017
xrectsel.c initial upload Mar 22, 2014

README.md

ffcast

ffcast helps the user interactively select a screen region and hands over the geometry to an external command, such as ffmpeg, for screen recording. This is a custom version for POSIX sh shells, refer to lolilolicon for the original one.

ffcast

Quick start

On Ubuntu (only LTS releases)

  1. Set up the minos archive:

    $ sudo add-apt-repository ppa:minos-archive/main
    
  2. Install:

    $ sudo apt-get update && sudo apt-get install ffcast
    
  3. Enjoy ☺!

On other Linux distributions + BSD

  1. Type make

  2. Type make install

Requirements

  • POSIX compatible shell
  • avconv || ffmpeg || byzanz-record || recordmydesktop
  • xdpyinfo - for the -x option
  • xrectsel - for the -s option (included)
  • xwininfo - for the -w and -f options
  • xrectsel
  • libX11

Usage

ffcast [-l|-s|-w|-f|-k|-x <n|list>|-m <n>|-p|-q|-v|-h] [command [args] [--] [args]]"

Examples

$ ffcast -h    #show help
$ ffcast       #record fullscreen and save it to $HOME
$ ffcast -s    #record a region selected with mouse and save it to $HOME
$ ffcast -w    #record a selected window and save it to $HOME
$ ffcast -f -w #record a selected window including window frames and save it to $HOME
$ ffcast -k    #stop latest ffcast started session
$ ffcast -w % echo %wx%h+%x+%y # print width, hight, x and y coordinates
$ ffcast -vv -s ffmpeg -r 25 -- -f alsa -i hw:0 -vcodec libx264 cast.mkv
$ ffcast -vv -s ffmpeg -follow_mouse centered -r 25 -- -f alsa -i hw:0 -vcodec libx264 cast.mkv
$ ffcast -w recordmydesktop -- -o cast.ogv

Differences

  • Doesn't require bash, any posix shell is enough
  • Geometry options were removed
  • Options must be separated by -, -vv -s instead of -vvs
  • No multiple ws options allowed, -s is preferred over -w
  • Default file is a random 8 character string with a .mkv suffix saved to $HOME
  • Uses notifications when available
  • Support avconv