django-fritzconnection

Web based FritzBox management using Python/Django and the great fritzconnection library.

The basic idea is to block/unblock Internet access to a group of devices as easily as possible.

Current state: early development stage

Existing features:

• actions:
  • Change WAN access of a host or for all host of a group
• models:
  • HostModel - A host/device that is/was connected to your FritzBox
    • "Static" storage for all FritzHosts().get_hosts_info() information
    • Update in Admin via change list tools link and manage command
  • HostGroupModel - Collect host/device into groups to manage "WAN access"
    • Every group are listed on the front page
    • Allow/Disallow "WAN access" for all hosts of a group with one click
• a few "test" views:
  • Host information
    • Get information about registered hosts
    • Get raw mesh topology
  • Diagnose
    • Test FritzBox connection
    • List all FritzBox services

django-fritzconnection_ynh allows you to install django-fritzconnection quickly and simply on a YunoHost server. If you don't have YunoHost, please consult the guide to learn how to install it.

Pull requests welcome ;)

Screenshots

more screenshots

more screenshots

Quick start for developers

~$ git clone https://github.com/jedie/django-fritzconnection.git
~$ cd django-fritzconnection
~/django-fritzconnection$ ./manage.py

FritzBox Credentials

Some of the FritzBox API requests needs a login. Currently the only way to store FritzBox Credentials is to add them into the environment.

Error message if login credentials are missing is: Unable to perform operation. 401 Unauthorized

Shell script work-a-round for developing, e.g.:

#!/bin/bash

(
    set -ex
    export FRITZ_USERNAME="<username>"
    export FRITZ_PASSWORD="<password>"

    ./devshell.py run_dev_server
)

See also: Issues #5

Make new release

We use cli-base-utilities to generate the history in this README.

To make a new release, do this:

• Increase your project version number
• Run tests to update the README
• commit the changes
• Create release

History

See also git tags: https://github.com/jedie/manageprojects/tags

• v0.4.0
  • 2024-09-07 - Update datetime usage
  • 2024-09-07 - Bugfix: Handle missing MAC address
  • 2024-09-07 - Apply manageprojects updates
  • 2023-12-17 - Use "update-readme-history" pre-commit hook
  • 2023-12-17 - Use cli_base.cli_tools.git_history.update_readme_history()
  • 2023-12-17 - Update requirements TODO: Switch to Django 5.0
  • 2023-12-17 - Apply manageprojects migrations
  • 2023-11-28 - Update README.md
• v0.3.0
  • 2023-11-28 - fix CI and activate PYTHONWARNINGS only for the tests
  • 2023-11-28 - fix tox config
  • 2023-11-28 - Revert deletion of AUTHORS and LICENSE and remove obsolete snapshot file
  • 2023-11-28 - Remove different Django version from test matrix: Just use the newest release
  • 2023-11-28 - Fix tests
  • 2023-11-28 - Skip fetching host information if there is no IP address
  • 2023-11-28 - Log any fritzconnection call action
  • 2023-11-28 - generate the history in README
  • 2023-11-28 - fix code style
  • 2023-11-28 - Run django-upgrade
  • 2023-11-28 - +"flake8-bugbear"
  • 2023-11-28 - Switch from drv-shell to manage_django_project
  • 2023-06-11 - Update requirements
  • 2022-09-21 - Setup Github PyPi Cache
  • 2022-09-21 - Replace DynamicViewMenu with bx_django_utils.admin_extra_views
  • 2022-09-21 - Use RunServerCommand from django-tools
  • 2022-08-12 - fix CI
  • 2022-08-12 - update CI
  • 2022-05-29 - Remove Django v2.2 from text matrix
  • 2022-05-29 - "python3 devshell.py" -> "./devshell.py"
  • 2022-05-29 - Update tox setup
• v0.2.0
  • 2022-05-15 - Release v0.2.0
  • 2022-05-15 - Add test for host changelist + unique name filter
  • 2022-05-15 - NEW: Hosts admin action to ping all IPs from selected hosts
  • 2022-05-11 - Add host change list filter "unique name"
  • 2022-04-30 - Update requirements
• v0.1.0
  • 2022-04-08 - Update README.md
  • 2022-04-08 - Skip hosts without IP in group management
  • 2022-04-08 - Handle updating not existing host
  • 2022-04-08 - Set v0.1.0.rc0
  • 2022-04-08 - Bugfix adding new hosts without a group