readme.txt

   1
   2 ==============
   3 Quick Start Guide for the Feisty Meow Codebase
   4
   5 (Commands that you should enter into your terminal are prefixed with "=>" and
   6 conditional portions are prefixed with a '|' character.)
   7
   8 ==============
   9 How to get the feisty meow codebase
  10
  11 | On Microsoft Windows, install the Cygwin tools as documented here:
  12 | ~/feisty_meow/documentation/cygwin_install_list.txt
  13
  14 Retrieve a clone of the feisty meow code:
  15 => git clone git://feistymeow.org/feisty_meow
  16
  17 The remainder of these notes assume that the code is stored in
  18 ~/feisty_meow (aka $HOME/feisty_meow).
  19
  20 ==============
  21 How to load the feisty meow script environment
  22
  23 Set up the feisty_meow scripts; this is only needed once, when you first get
  24 the codebase.  It can also regenerate the scripts using the latest version.
  25 => bash ~/feisty_meow/scripts/core/reconfigure_feisty_meow.sh
  26
  27 Load the script environment into the current shell.
  28 => source ~/feisty_meow/scripts/core/launch_feisty_meow.sh
  29
  30 With the feisty meow script environment loaded, several aliases are now
  31 available for building the codebase and they are used in the sections below.
  32
  33 Closing the current shell will lose the feisty meow environment.  Loading the
  34 environment can be made automatic by adding the 'source' line above to the
  35 shell's startup file.  Example startup files are available in:
  36 ~/feisty_meow/feisty_inits
  37
  38 ==============
  39 How to install the feisty meow script dependencies
  40
  41 These perl modules are required by some of the scripts (e.g. the differ
  42 utility and the feisty meow customization system).
  43 => cpan install Text::Diff File::Which
  44
  45 ==============
  46 How to install the build dependencies for feisty meow
  47
  48 | Ubuntu / Debian:
  49 | => sudo apt-get install build-essential librtmp-dev libcurl4-gnutls-dev libssl-dev
  50
  51 | Centos / Redhat / Fedora:
  52 | => sudo yum install gcc gcc-c++ openssl-devel.x86_64 curl-devel
  53
  54 | Microsoft Windows:
  55 | Download and install the Cygwin environment first from cygwin.com, which is
  56 | documented in ~/feisty_meow/documentation/cygwin_install_list.txt
  57
  58 ==============
  59 How to build the feisty meow codebase
  60
  61 Run the following command to build the feisty meow libraries and applications.
  62 => bash ~/feisty_meow/scripts/generator/produce_feisty_meow.sh
  63
  64 After the build is complete, the feisty meow applications can be found in
  65 $FEISTY_MEOW_BINARIES (environment variable).
  66 => ls $FEISTY_MEOW_BINARIES
  67
  68 ==============
  69 How to clean up the files generated by the build
  70
  71 This command cleans out all the generated files:
  72 => bash ~/feisty_meow/scripts/generator/whack_build.sh clean
  73
  74 ==============
  75 What are the feisty meow dependencies?
  76
  77 The feisty meow scripts depend on these scripting languages and tools:
  78   bash
  79   perl (including Text::Diff and File::Which)
  80   python
  81   gnumake
  82
  83 The feisty meow libraries and applications depend on these tools:
  84   Gnu C++
  85   RTMP streams (?still?  not sure.)
  86   Curl
  87   Open SSL
  88
  89 ==============
  90 More information is available at the official site http://feistymeow.org
  91