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