/freebox-api

Manage your freebox in Python using the Freebox OS API

Primary LanguagePythonGNU General Public License v3.0GPL-3.0

freebox-api

PyPI Python Version License

Read the documentation at https://freebox-api.readthedocs.io/ Tests Codecov

pre-commit Black

Features

Easily manage your freebox in Python using the Freebox OS API. Check your calls, manage your contacts, configure your dhcp, disable your wifi, monitor your LAN activity and many others, on LAN or remotely.

freebox-api is a python library implementing the freebox OS API. It handles the authentication process and provides a raw access to the freebox API in an asynchronous manner.

This project is based on fstercq/freepybox, which provides the same features as freebox-api in a synchronous manner.

Requirements

  • TODO

Installation

You can install freebox-api via pip from PyPI:

$ pip install freebox-api

Or manually download the last version from github and install it with Poetry

$ git clone https://github.com/hacf-fr/freebox-api.git
$ python poetry install

Usage

# Import the freebox-api package.
from freebox_api import Freepybox

async def reboot()
   # Instantiate the Freepybox class using default options.
   fbx = Freepybox()

   # Connect to the freebox with default options.
   # Be ready to authorize the application on the Freebox.
   await fbx.open('192.168.0.254')

   # Do something useful, rebooting your freebox for example.
   await fbx.system.reboot()

   # Properly close the session.
   await fbx.close()

Have a look at the example.py for a more complete overview.

Notes on HTTPS

When you access a Freebox with its default-assigned domain (ending in fbxos.fr), the library verifies its certificate by automatically trusting the Freebox certificate authority. If you want to avoid this, you can setup a custom domain name which will be associated with a Let's Encrypt certificate.

Resources

Freebox OS API documentation : http://dev.freebox.fr/sdk/os/

Contributing

Contributions are very welcome. To learn more, see the Contributor Guide.

License

Distributed under the terms of the GNU GPL v3 license, freebox-api is free and open source software.

Issues

If you encounter any problems, please file an issue along with a detailed description.

Credits

This project was generated from @cjolowicz's Hypermodern Python Cookiecutter template.