diff --git a/Readme.md b/Readme.md new file mode 100644 index 0000000..97ff666 --- /dev/null +++ b/Readme.md @@ -0,0 +1,62 @@ +WORK IN PROGRESS + +All updates at your FUNK-Account ar disabled atm + +# Funk Manager +Funk-Manager is a Python Web-GUI to Manage multible [Freenet Funk](https://freenet-funk.de/) SIM-Cards. Its a Python Project use the inoffical [freenet-funk-api](https://pypi.org/project/freenet-funk-api/). + +With this WebGui you can manage all your Sim Cards at one place without logging in and out in your Freenet Funk app. Also you can set a Default Plan where the Software always switch back to if for some reasons your current Plan changed (e.g. you can set it on Break, Funk will end the Break after 14 days, the software will start a new break the next day). Also you can define Special-Days in the furute where you want to switch to another Plan so e.g. you can set it for some Weekends to unlimit. + +# WebGUI +You have a list of your Funk-Contracts + +![List][doc/list.png] + +And you can see your Contract-Details: + +![List][doc/details.png] + +# Install + +## Docker +Clon this Project and build the Docker container + +``` +git clone ssh://git@git.keks.cloud:32222/kekskurse/funk-manager.git +docker build -t funk-manager . +``` + +than you can run it + +``` +docker run -p 5000:5000 funk-manager +``` + +You can open it in your Browser by go to http://localhost:5000 + +## Source +You need to setup python3, pip3 and python3-setuptools on your System. Than you can clone the Projekt and install the Requirmentes + +``` +git clone ssh://git@git.keks.cloud:32222/kekskurse/funk-manager.git +pip3 install requirements.txt +``` + +to start it just start the server.py + +``` +python3 server.py +``` + +You can open it in your Browser by go to http://localhost:5000 + +# Config +You can add a Basic-Auth to the Webgui by setting 3 enviroment Varieables + +| Enviroment Variable | Description | +|---------------------|-------------| +| FUNK_USER | HTTP Basic Auth Username | +| FUNK_PASS | HTTP Basic Auth Password | +| FUNK_AUTH | Must be set (e.g. to one) to enabled Basic-Auth | + +Also you can change the Path of sqlite Database file with the enviroment variable FUNK_DATABASE e.g. if you want to save it in the tmp folder ```FUNK_DATABASE=/tmp/funk.db``` \ No newline at end of file diff --git a/doc/details.png b/doc/details.png new file mode 100644 index 0000000..9dce24b Binary files /dev/null and b/doc/details.png differ diff --git a/doc/list.png b/doc/list.png new file mode 100644 index 0000000..2f7282f Binary files /dev/null and b/doc/list.png differ