An open source day-to-day bash library
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.


An open source day-to-day bash library.

Build Status

Key features:

  • manage strings, files, integers and arrays easily
  • build colorized contents with text effect, foreground and background colors
  • execute sub-jobs with a large control upon outputs, errors and status
  • build some scripts with command line options and arguments easily
  • the library is well-documented and unit-tested

To begin, have a look at the wiki.


Installing the Piwi Bash Library is as simple as making a copy of two files in your target directory: the library source itself and its Unix manual page.

You can install the package in many ways explained in the Global documentation ; the best practice is to use the internal interface as it presents facilities to update the library.

wget --no-check-certificate
tar -xvf master.tar.gz
cd piwi-bash-library-master
./bin/piwi-bash-library help

To read the library's manpage, run:

man man/


To use the library in a bash script, just source it at the top of your code or before any call of its methods or variables:

source path/to/piwi-bash-library.bash

The full documentation of the library is available online at


A set of test and demonstration files is included in the samples/ directory of the package. These files are not required for a normal usage of the library.

To run one of these tests, just run:

cd path/to/downloaded/package/piwi-bash-library

You can use the --help option to get help or info:

./samples/ --help

Author & License

  • For sources & updates, see

  • For documentation, see

  • To transmit bugs, see

  • To read GPL-3.0 license conditions, see

    Piwi Bash Library - An open source day-to-day bash library Copyleft (ↄ) 2013-2015 Pierre Cassat & contributors - Some rights reserved.

    This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

    This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

    You should have received a copy of the GNU General Public License along with this program. If not, see