Skip to main content

Web based FritzBox management using Python/Django.

Project description

django-fritzconnection

django-fritzconnection @ PyPi Python Versions License GPL V3+

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

Install django-fritzconnection with YunoHost

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


Group Management


Host Change List


more screenshots

Quick start for developers

~$ git clone https://github.com/jedie/django-fritzconnection.git
~$ cd django-fritzconnection
~/django-fritzconnection$ ./devshell.py
...
Developer shell - djfritz - v0.1.0
...

(djfritz) run_testserver

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_testserver
)

See also: Issues #5

versions

  • dev
    • Replace DynamicViewMenu with bx_django_utils.admin_extra_views
    • Use RunServerCommand from django-tools
    • Update test/CI setup
    • TBC
  • v0.2.0 - 15.05.2022
    • NEW: Hosts admin action to ping all IPs from selected hosts
    • NEW: "unique host name" change list filter
  • v0.1.0 - 08.04.2022
    • NEW: 'Manage host WAN access via host-groups'
    • NEW: Add "host group" model to collect hosts into groups
    • NEW: 'List "last connect" information about hosts' view
    • Display FRITZ_USERNAME and FRITZ_PASSWORD (anonymized) on connection info page
  • v0.0.2 - 04.04.2022
    • Store Host information
    • Possible to set WAN access for one host
  • v0.0.1-alpha - 24.03.2022
    • init the project

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

django-fritzconnection-0.3.0rc1.tar.gz (53.2 kB view hashes)

Uploaded Source

Built Distribution

django_fritzconnection-0.3.0rc1-py3-none-any.whl (91.3 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page