{"id":15720839,"url":"https://github.com/ia/battery-status","last_synced_at":"2025-04-22T23:52:51.100Z","repository":{"id":911000,"uuid":"670903","full_name":"ia/battery-status","owner":"ia","description":"Battery applet/indicator for the GNOME","archived":false,"fork":false,"pushed_at":"2010-05-25T23:28:32.000Z","size":147,"stargazers_count":4,"open_issues_count":0,"forks_count":2,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-04-16T01:51:10.952Z","etag":null,"topics":["appindicator","bonobo","gnome2","gnulinux","gtk2","gui","laptop","notify","notify-osd","pygtk","python2","usability","ux"],"latest_commit_sha":null,"homepage":"https://wiki.gnome.org/Attic/BatteryStatus","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ia.png","metadata":{"files":{"readme":"README","changelog":null,"contributing":null,"funding":null,"license":"COPYING","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2010-05-17T13:01:20.000Z","updated_at":"2024-06-11T00:33:44.000Z","dependencies_parsed_at":"2022-07-18T16:31:36.645Z","dependency_job_id":null,"html_url":"https://github.com/ia/battery-status","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ia%2Fbattery-status","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ia%2Fbattery-status/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ia%2Fbattery-status/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ia%2Fbattery-status/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ia","download_url":"https://codeload.github.com/ia/battery-status/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":250343914,"owners_count":21415037,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["appindicator","bonobo","gnome2","gnulinux","gtk2","gui","laptop","notify","notify-osd","pygtk","python2","usability","ux"],"created_at":"2024-10-03T22:00:32.305Z","updated_at":"2025-04-22T23:52:51.082Z","avatar_url":"https://github.com/ia.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\t\t\tGNOME Battery Status\n\tBattery Applet/Indicator for GNOME Power Management\n\n\nGNOME Battery Status is a project for GNOME, that shows information about\nlaptop battery state. It has some additional features, so usual icon of\ngnome-power-manager can be removed from notification/indicator area.\nBattery Status doesn't rely on gnome-power-manager directly, but counting\non presence in system for some useful integration with it.\n\nTable of Content\n\t0. Rationale\n\t1. Installation\n\t2. Basic Usage\n\t3. Additional Settings\n\t4. Technical Details\n\t5. Links\n\n====\n\n0. Rationale\n\ngnome-power-manager's icon has got main user interface shortcoming (if its\npurpose - to show battery information) - for see exactly battery percentage or\nbattery lifetime, user should hover mouse to icon, wait couple seconds, and\nonly then user could see required information (tooltip - the bad way for\ngetting information in such cases). Such behavior pretty annoying, so\nBattery Status' applet hasn't got such behavior and allow to user see\npercentage/lifetime/charge time of battery right in panel next to icon.\nAlso, using gnome-power-manager's icon, user can't direct place, where exactly\nbattery information should be showing.\n\n/!\\ Problems, which has been described above, can be solved\nby using battstat-applet (Battery Charge Monitor applet), but it has some\nhistorical architectural disadventages (such as relies on ACPI and HAL) and\nuser interface problems (such as using non-consistent icons) itself, and by\nthese reasons this applet has been declared as obsolete, has been deprecated\nand removed from set of standart gnome-applets package in such key GNOME Desktop\nGNU/Linux distributions as Fedora and Ubuntu (see also this [1] discussion for\nmore information)\n\nAnother impovement - warning message about critical battery charge.\ngnome-power-manager supports notifications (via notification-daemon/notify-osd),\nand this is very useful. But when user is deep in thoughts about his current\nwork/task/action/etc, his locus of attention (see [2] for more details)\nmay just couldn't see notification-like warning about critical low (which very\nimportant if user hasn't get access for power) - it should be message on top of\nall windows.\n\nDevice information dialog (which has been totaly deprecated in last versions)\nfrom gnome-power-manager's icon has been replaced by battery\nstatus dialog in Battery Status. In \"Device Information\" dialog all battery\ninformation puts in one non-human-readable heap and this dialog doesn't meet\nGNOME HIG requirements partially, but in \"Battery Status\" dialog battery\ninformation divided by two easy-readable areas - one for battery capacity,\nand another for battery charge.\n\n====\n\n1. Installation\n\nBattery Status can be installed from package, or from sources.\nFor better experience you should re-login after installation.\nPackages for Ubuntu can be found in this launchpad repository:\nhttp://launchpad.net/~iaz/+archive/battery-status\nDebian/Ubuntu-related source code tree (with debian/ directory for packaging):\nbzr co lp:battery-status\nnon-Debian/Ubuntu source code tree (without debian/ directory):\ngit clone git://github.com/ia/battery-status.git\nCommand for installation from sources:\npython setup.py install\n\n====\n\n2. Basic Usage\n\nAfter adding applet at panel, by default it shows icon only.\nFrom main menu user (by default) can get access to:\n - Battery Status dialog\n - Power Statistics (provided by gnome-power-manager)\n - Show setting\n - Text Size setting\n - CPU frequency scaling (provided by cpufreq-applet)\n - Power Management preferences (provided by gnome-power-manager)\nFrom context menu (by clicking right mouse button at applet) user can get\nacces to:\n - Bug Reporting (apport/launchpad integration)\n - GNOME Power Management help\n - About information dialog\n - generic applet-related options (such as Remove, Move, Lock To Panel)\n\n====\n\n3. Additional settings\n\nBattery Applet uses GConf for settings. All keys can be found in\n/apps/battery_status. Description for each key you\ncan find using gconf-editor.\n\n====\n\n4. Technical Details\n\nBattery Status written in Python with using:\n - PyGTK - python bindings to GTK library\n - python-appindicator - python bindings to AppIndicator library\n - Bonobo - for integration application in GNOME panel as applet\n - GConf - for keep and manage applet settings\n - UPower/DeviceKit-power - for getting power information\n - D-Bus - for getting power information from DeviceKit-power and update it on changes\n\n====\n\n5. Links\n\nhomepage - http://live.gnome.org/BatteryStatus\ngithub page - http://github.com/ia/battery-status\nlaunchpad page - http://launchpad.net/battery-status\n\n[1] https://lists.ubuntu.com/archives/ubuntu-desktop/2009-August/002183.html\n[2] \"The Humane Interface: New Directions for Designing Interactive Systems\",\n\tJeff Raskin\n\nRelated links to other discussions and bugs:\nhttp://www.omgubuntu.co.uk/2010/03/16-things-that-could-be-improved-in.html\n(the same post - http://humphreybc.wordpress.com/2010/03/11/its-the-little-things-that-count\n see \"What happened to the nice battery stats window?\" section)\nhttps://bugs.edge.launchpad.net/ubuntu/+source/gnome-applets/+bug/462267\nhttps://bugs.edge.launchpad.net/ubuntu/+source/indicator-application/+bug/541609\nhttp://ubuntuforums.org/showthread.php?t=1263401\nhttp://ubuntuforums.org/showthread.php?t=1460826\nhttp://chrisjohnston.org/2010/no-more-battery-status-tooltip-in-lucid\nhttp://design.canonical.com/2010/04/battery\nhttps://wiki.ubuntu.com/BatteryStatusMenu\n\nFeel free for sending any questions/advices/UX improvements/bug reports/feature requests/patches/etc.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fia%2Fbattery-status","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fia%2Fbattery-status","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fia%2Fbattery-status/lists"}