{"id":15148988,"url":"https://github.com/zaitsev-dev/polybar-online","last_synced_at":"2026-02-06T21:02:46.282Z","repository":{"id":65206161,"uuid":"587510778","full_name":"zaitsev-dev/polybar-online","owner":"zaitsev-dev","description":"Script for Polybar that checks connection to the Internet","archived":false,"fork":false,"pushed_at":"2023-01-12T12:34:16.000Z","size":30,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-10-27T10:52:44.900Z","etag":null,"topics":["awesomewm","i3wm","polybar","python","tiling-window-manager","tuning","unixporn","xmonad"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/zaitsev-dev.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2023-01-10T23:14:48.000Z","updated_at":"2023-01-15T12:52:45.000Z","dependencies_parsed_at":"2023-01-15T15:00:44.798Z","dependency_job_id":null,"html_url":"https://github.com/zaitsev-dev/polybar-online","commit_stats":null,"previous_names":["leetovskiy/polybar-online"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/zaitsev-dev/polybar-online","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zaitsev-dev%2Fpolybar-online","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zaitsev-dev%2Fpolybar-online/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zaitsev-dev%2Fpolybar-online/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zaitsev-dev%2Fpolybar-online/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/zaitsev-dev","download_url":"https://codeload.github.com/zaitsev-dev/polybar-online/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zaitsev-dev%2Fpolybar-online/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29175829,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-06T20:14:21.878Z","status":"ssl_error","status_checked_at":"2026-02-06T20:14:21.443Z","response_time":59,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["awesomewm","i3wm","polybar","python","tiling-window-manager","tuning","unixporn","xmonad"],"created_at":"2024-09-26T13:40:57.571Z","updated_at":"2026-02-06T21:02:46.259Z","avatar_url":"https://github.com/zaitsev-dev.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Polybar Online\n\n**Polybar Online** is a script for Polybar that displays an internet connection indicator\nin a\npanel with the ability to send a notification when the connection is broken and restored.\n\n\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"example.png\"\n     alt=\"The appearance of Polybar Online in a Nord-themed environment\"\u003e\n\u003c/div\u003e\n\n## Why another one?\n\nI've been looking for a similar module for myself and even found a couple. But they didn't\nrun on my machine... So I decided that it would be faster to write my own than to poke\naround in someone else's. (and others are not able to send notifications!!!)\n\n## Requirements\n\nThe script tested on Python 3.10 and does not use any third-party libraries, but you will\nneed to install some [Nerd fonts](https://github.com/ryanoasis/nerd-fonts) in order for\nthe icons to be displayed. It's not necessary if you're going to use your own icons from\nother fonts, though.\n\nYou should also make sure that you have `libnotify` on your Linux system, because the\nscript uses the `notify-send` command\n\n## Installing\n\nClone the repository to a convenient location. For example, in `~/.config/polybar/`:\n\n```shell\ncd ~/.config/polybar/\ngit clone https://github.com/Leetovskiy/polybar-online \n```\n\nYou can also globally install Polybar Online from PyPI using `pip`.\n\n```shell\nsudo pip install polybar-online\n```\n\n## Configuration\n\nThe script takes some arguments from the terminal to control its operation. These are, for\nexample, enabling and disabling Internet connection status change notifications, setting\nicons, etc.\n\nUse the command `polybar-online -h` to see the full list of available options.\n\n```\n  -h, --help            show this help message and exit\n  -n, --notify, --no-notify\n                        send a notification if the internet connection is broken (default: False)\n  --online-icon ONLINE_ICON\n                        icon that will be displayed when the Internet connection is available (default: 度)\n  --offline-icon OFFLINE_ICON\n                        icon that will be displayed when there is no Internet connection (default: ﴹ)\n  -ci CHECK_INTERVAL, --check-interval CHECK_INTERVAL\n                        Interval between checks (in seconds)\n  -ri RETRY_INTERVAL, --retry-interval RETRY_INTERVAL\n                        Interval between checks when Internet connection is unavailable (in seconds)\n```\n\n## Using\n\nYou need to put the script path in a special `custom/script` section of your Polybar\nconfiguration file. You also need the tail parameter set to true. Do not forget to add\nthe new module to your panel's module list and set the Nerd font.\n\nExample:\n\n```ini\n[bar/mybar]\nmodules-right = online\nfont-0 = \"Ubuntu Nerd Font:size=12\"\n\n[module/online]\ntype = custom/script\nexec = python ~/.config/polybar/polybar-online/polybar_online/main.py --notify -ci 5\ntail = true\n\n# or like this, if you installed the script globally with pip\nexec = polybar-online --notify -ci 5\n```\n\n## License\n\nThis little project is licensed under the Apache 2.0 license, so you are free to use it\naccording to the terms of the license.\n\n## Contribution\n\nIf you know how to improve this project or would like to contribute yourself, you are\nwelcome. I'm open to suggestions, so you can create an issue, and I'll consider pull\nrequests from you as well.\n\n## Roadmap\n\n- [ ] Localization in Russian and other languages\n- [ ] Distribution as a binary (using nuitka)\n- [ ] AUR package","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzaitsev-dev%2Fpolybar-online","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fzaitsev-dev%2Fpolybar-online","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzaitsev-dev%2Fpolybar-online/lists"}