Add README
This commit is contained in:
parent
fb9ec1184a
commit
7828e6bcd4
1 changed files with 61 additions and 0 deletions
61
README.md
Normal file
61
README.md
Normal file
|
@ -0,0 +1,61 @@
|
|||
# PiHelper
|
||||
|
||||
PiHelper is designed to be a simple, lightweight, portable client library for the
|
||||
[Pi-hole](https://pi-hole.net/). There is also a CLI tool available.
|
||||
|
||||
## CLI Usage
|
||||
|
||||
-c, --configure Configure Pi-Helper
|
||||
-d, --disable <duration> Disable the Pi-hole for a given duration, or permanently if empty
|
||||
-e, --enable Enable the Pi-hole
|
||||
-f, --file <config-file> Use the given config file instead of the default
|
||||
-h, --help Display this message
|
||||
-q, --quiet Don't print anything
|
||||
-v, --verbose Print debug logs
|
||||
|
||||
## Library Usage
|
||||
|
||||
Include the `pihelper.h` file.
|
||||
|
||||
## Building
|
||||
|
||||
PiHelper depends on cmake, curl, openssl, and json-c. On Fedora you can install the dependencies with the
|
||||
following command:
|
||||
|
||||
sudo dnf install cmake \
|
||||
gcc \
|
||||
gcc-c++ \
|
||||
libcurl-devel \
|
||||
openssl-curl \
|
||||
json-c-devel
|
||||
|
||||
Once you have the dependencies installed, you can build the project with cmake:
|
||||
|
||||
mkdir build
|
||||
cd build
|
||||
cmake ..
|
||||
make
|
||||
|
||||
If you'd like to install pihelper to your system, run the following after building:
|
||||
|
||||
sudo make install # This is optional, and only needed if you want to install command line utility
|
||||
|
||||
## License
|
||||
|
||||
Copyright © 2019, 2020 William Brawner.
|
||||
|
||||
This file is part of PiHelper.
|
||||
|
||||
PiHelper 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.
|
||||
|
||||
PiHelper 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 PiHelper. If not, see <https://www.gnu.org/licenses/>.
|
||||
|
Loading…
Reference in a new issue