https://github.com/aviolaris/fritzbox-tray

A cross-platform system tray application for interacting with FRITZ!Box devices.
https://github.com/aviolaris/fritzbox-tray

avm-fritz fritz fritz-box fritzbox fritzbox-tray pypi pypi-package python python3 router tray tray-app tray-application

Last synced: 7 months ago
JSON representation

A cross-platform system tray application for interacting with FRITZ!Box devices.

• Host: GitHub
• URL: https://github.com/aviolaris/fritzbox-tray
• Owner: aviolaris
• License: gpl-3.0
• Created: 2023-01-08T18:12:07.000Z (over 3 years ago)
• Default Branch: main
• Last Pushed: 2025-08-19T08:20:44.000Z (12 months ago)
• Last Synced: 2025-09-10T12:31:15.716Z (11 months ago)
• Topics: avm-fritz, fritz, fritz-box, fritzbox, fritzbox-tray, pypi, pypi-package, python, python3, router, tray, tray-app, tray-application
• Language: Python
• Homepage: https://pypi.org/project/fritzbox-tray
• Size: 183 KB
• Stars: 8
• Watchers: 1
• Forks: 1
• Open Issues: 7
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# FritzBox Tray

### A system tray application for interacting with FRITZ!Box devices.

[![fritzbox-tray](https://user-images.githubusercontent.com/48277853/211208943-1cbb41fb-60a7-44d1-a697-5d0493bb167c.png)](https://github.com/aviolaris/fritzbox-tray)

![python-versions](https://img.shields.io/pypi/pyversions/fritzbox-tray)

[![pypi-downloads](https://img.shields.io/pypi/dm/fritzbox-tray.svg?color=blue&label=downloads&logo=pypi&logoColor=gold)](https://pypistats.org/packages/fritzbox-tray)

[![license](https://img.shields.io/pypi/l/fritzbox-tray?color=blueviolet)](https://github.com/aviolaris/fritzbox-tray/blob/master/LICENSE)

![format](https://img.shields.io/pypi/format/fritzbox-tray?color=blueviolet)

![status](https://img.shields.io/pypi/status/fritzbox-tray?color=blue)

[![GitHub Stars](https://img.shields.io/github/stars/aviolaris/fritzbox-tray?color=blue&logo=github&logoColor=white)](https://github.com/aviolaris/fritzbox-tray/stargazers)

## Features

- Display current external IP address

- Renew IP address

## Preview

[![fritzbox-tray](https://github.com/aviolaris/fritzbox-tray/assets/48277853/542c1b6f-77df-4681-b623-a875fadfc005)](https://github.com/aviolaris/fritzbox-tray)

## Requirements

- Python 3.6 or higher

## Installation

To install FritzBox Tray, run the following command:

    pip install fritzbox-tray

## Usage

To launch FritzBox Tray:

 - **On Windows**, double-click the `fritzbox-tray.exe` (usually located in `%LOCALAPPDATA%\Programs\Python\Python##\Scripts`) or run the `fritzbox-tray` command from the command prompt.

 - **On Linux**, double-click the `fritzbox-tray` (usually located in `~/.local/bin`) or run the `./fritzbox-tray` command from the terminal.

Once the program is running, an icon will be added to the system tray. By right-clicking on the icon, a menu will appear containing the following options:

 - **Display Current IP Address**: This option will trigger a notification displaying the current external IP address of the FRITZ!Box device.

 - **Reconnect**: This option allows you to instantly obtain a new IP address by terminating and re-establishing the Internet connection.

 - **Quit**: This option enables you to close the application.

## Common Issues

#### "ValueError: Namespace AppIndicator3 not available" (Linux Only)

This error message indicates that the `AppIndicator3` module, which the application uses to display tray icons on Linux, is not available on your system.

To resolve this issue, you will need to install the `libayatana-appindicator3-dev` package, which provides the necessary files and libraries for the `AppIndicator3` module. To install the package, use the following command:

    sudo apt-get install libayatana-appindicator3-dev

## Contribution

Pull requests and issues are welcome.

## License

This project is licensed under the GNU General Public License v3.0.

See the [LICENSE](https://github.com/aviolaris/fritzbox-tray/blob/master/LICENSE) file for details.