# 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.
Raw data
{
"_id": null,
"home_page": "https://github.com/aviolaris/fritzbox-tray",
"name": "fritzbox-tray",
"maintainer": null,
"docs_url": null,
"requires_python": null,
"maintainer_email": null,
"keywords": "fritz, fritzbox, fritz-box, fritzbox-tray, fritzbox_tray, avm-fritz, tray, python, pypi, python3, tray, tray-application, pypi-package, tray-app",
"author": "Andreas Violaris",
"author_email": null,
"download_url": "https://files.pythonhosted.org/packages/9d/fa/6ee44957dfe23398d62d0c815778aa76217c8294ac3275cfbc7c2da6e7b4/fritzbox-tray-1.0.69.tar.gz",
"platform": null,
"description": "# FritzBox Tray\r\n\r\n### A system tray application for interacting with FRITZ!Box devices.\r\n\r\n[![fritzbox-tray](https://user-images.githubusercontent.com/48277853/211208943-1cbb41fb-60a7-44d1-a697-5d0493bb167c.png)](https://github.com/aviolaris/fritzbox-tray)\r\n\r\n![python-versions](https://img.shields.io/pypi/pyversions/fritzbox-tray)\r\n[![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)\r\n\r\n[![license](https://img.shields.io/pypi/l/fritzbox-tray?color=blueviolet)](https://github.com/aviolaris/fritzbox-tray/blob/master/LICENSE)\r\n![format](https://img.shields.io/pypi/format/fritzbox-tray?color=blueviolet)\r\n![status](https://img.shields.io/pypi/status/fritzbox-tray?color=blue)\r\n[![GitHub Stars](https://img.shields.io/github/stars/aviolaris/fritzbox-tray?color=blue&logo=github&logoColor=white)](https://github.com/aviolaris/fritzbox-tray/stargazers)\r\n\r\n\r\n## Features\r\n\r\n- Display current external IP address\r\n- Renew IP address\r\n\r\n## Preview\r\n\r\n[![fritzbox-tray](https://github.com/aviolaris/fritzbox-tray/assets/48277853/542c1b6f-77df-4681-b623-a875fadfc005)](https://github.com/aviolaris/fritzbox-tray)\r\n\r\n## Requirements\r\n\r\n- Python 3.6 or higher\r\n\r\n## Installation\r\n\r\nTo install FritzBox Tray, run the following command:\r\n\r\n pip install fritzbox-tray\r\n\r\n## Usage\r\n\r\nTo launch FritzBox Tray:\r\n\r\n - **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.\r\n\r\n\r\n - **On Linux**, double-click the `fritzbox-tray` (usually located in `~/.local/bin`) or run the `./fritzbox-tray` command from the terminal.\r\n\r\nOnce 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:\r\n\r\n - **Display Current IP Address**: This option will trigger a notification displaying the current external IP address of the FRITZ!Box device.\r\n\r\n\r\n - **Reconnect**: This option allows you to instantly obtain a new IP address by terminating and re-establishing the Internet connection.\r\n\r\n\r\n - **Quit**: This option enables you to close the application.\r\n\r\n## Common Issues\r\n\r\n#### \"ValueError: Namespace AppIndicator3 not available\" (Linux Only)\r\n\r\nThis error message indicates that the `AppIndicator3` module, which the application uses to display tray icons on Linux, is not available on your system.\r\n\r\nTo 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:\r\n\r\n sudo apt-get install libayatana-appindicator3-dev\r\n\r\n\r\n## Contribution\r\n\r\nPull requests and issues are welcome.\r\n\r\n## License\r\n\r\nThis project is licensed under the GNU General Public License v3.0.\r\n\r\nSee the [LICENSE](https://github.com/aviolaris/fritzbox-tray/blob/master/LICENSE) file for details.\r\n\r\n\r\n",
"bugtrack_url": null,
"license": null,
"summary": "A system tray application for interacting with FRITZ!Box devices.",
"version": "1.0.69",
"project_urls": {
"Homepage": "https://github.com/aviolaris/fritzbox-tray"
},
"split_keywords": [
"fritz",
" fritzbox",
" fritz-box",
" fritzbox-tray",
" fritzbox_tray",
" avm-fritz",
" tray",
" python",
" pypi",
" python3",
" tray",
" tray-application",
" pypi-package",
" tray-app"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "a8b96ba50c50905ab138ccd4321b13aaf5e49d242d0b7b0859e6b47945e5f549",
"md5": "1cb671e242dce3b5f765cd291dec0d2c",
"sha256": "e497f2a26309548ef8a35b30056cf5ba64a0f57c28fee6ef13c27e40af37653e"
},
"downloads": -1,
"filename": "fritzbox_tray-1.0.69-py3-none-any.whl",
"has_sig": false,
"md5_digest": "1cb671e242dce3b5f765cd291dec0d2c",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 57150,
"upload_time": "2024-04-16T11:20:05",
"upload_time_iso_8601": "2024-04-16T11:20:05.286908Z",
"url": "https://files.pythonhosted.org/packages/a8/b9/6ba50c50905ab138ccd4321b13aaf5e49d242d0b7b0859e6b47945e5f549/fritzbox_tray-1.0.69-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "9dfa6ee44957dfe23398d62d0c815778aa76217c8294ac3275cfbc7c2da6e7b4",
"md5": "6f73bed814b4e3677a4e7db9fe73132a",
"sha256": "91262a2b1007a7a1fc2f7593ab4f4bca75e9b151d5921e0926bc6cf2b06b1d7f"
},
"downloads": -1,
"filename": "fritzbox-tray-1.0.69.tar.gz",
"has_sig": false,
"md5_digest": "6f73bed814b4e3677a4e7db9fe73132a",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 59365,
"upload_time": "2024-04-16T11:20:07",
"upload_time_iso_8601": "2024-04-16T11:20:07.518648Z",
"url": "https://files.pythonhosted.org/packages/9d/fa/6ee44957dfe23398d62d0c815778aa76217c8294ac3275cfbc7c2da6e7b4/fritzbox-tray-1.0.69.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-04-16 11:20:07",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "aviolaris",
"github_project": "fritzbox-tray",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"requirements": [
{
"name": "certifi",
"specs": [
[
"==",
"2024.2.2"
]
]
},
{
"name": "charset-normalizer",
"specs": [
[
"==",
"3.3.2"
]
]
},
{
"name": "idna",
"specs": [
[
"==",
"3.7"
]
]
},
{
"name": "Pillow",
"specs": [
[
"==",
"10.3.0"
]
]
},
{
"name": "pystray",
"specs": [
[
"==",
"0.19.5"
]
]
},
{
"name": "requests",
"specs": [
[
"==",
"2.31.0"
]
]
},
{
"name": "six",
"specs": [
[
"==",
"1.16.0"
]
]
},
{
"name": "urllib3",
"specs": [
[
"==",
"2.2.1"
]
]
}
],
"lcname": "fritzbox-tray"
}