Introduction

Straightforward, lightweight and extendable Node.js library to communicate with FRITZ!Box devices.

Full compatibility with PBKDF2 (from FRITZ!OS 7.24) for more secure authentication process is implemented. Backwards compatibility with MD5 is supported. The algorithm is automatically selected based on the version of the challenge.

Flexible data accessing by parameterizing data.lua endpoint. API can return JSON response for every single WebUI page.

This library fully supports TR-064 for controlling and interacting with FRITZ!Box devices.

• Device Communication: The library allows you to initiate calls and hang up devices via the FRITZ!Box API using TR-064 endpoints.
• Digest Authentication: To ensure secure communication, the library supports Digest Authentication, which is required for TR-064 API access.
• SOAP API Support: Supports interaction with TR-064 SOAP actions, including sending and receiving XML-based data for device control.

Make sure that dialing assistance is enabled and an outgoing device is selected in your FRITZ!Box settings before using the TR-064 functionality.

Installing

Using npm:

$ npm install fritzbox-api

Once the package is installed, you can import the class:

import FritzBoxApi from 'fritzbox-api';

Usage

Basic API

const fritzBoxApi = new FritzBoxApi({ url: 'http://192.168.178.1' });

if (await fritzBoxApi.login('username', 'password')) {
    const data = await fritzBoxApi.getData({ page: 'overview' });
}

TR-064

const fritzBoxApi = new FritzBoxApi({ url: 'http://192.168.178.1' });

fritzBoxApi.setCredentials('username', 'password');

const response = await fritzBoxApi.callDevice('**610');

See examples to get an insight.

License

This project is licensed under MIT.