https://github.com/nwg-piotr/obhud
Openbox HUD ia s Python script for handling laptop-specific keys and events in Openbox window manager
https://github.com/nwg-piotr/obhud
openbox openbox-configuration openbox-desktop-environment
Last synced: 27 days ago
JSON representation
Openbox HUD ia s Python script for handling laptop-specific keys and events in Openbox window manager
- Host: GitHub
- URL: https://github.com/nwg-piotr/obhud
- Owner: nwg-piotr
- License: gpl-3.0
- Created: 2018-06-11T10:38:34.000Z (almost 7 years ago)
- Default Branch: master
- Last Pushed: 2020-02-16T16:01:13.000Z (over 5 years ago)
- Last Synced: 2025-03-31T09:41:14.193Z (2 months ago)
- Topics: openbox, openbox-configuration, openbox-desktop-environment
- Language: Python
- Homepage:
- Size: 5.05 MB
- Stars: 9
- Watchers: 3
- Forks: 3
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Openbox HUD
This script is intended to simplify assigning
laptop-specific keys and events to actions and display ~~slightly gnomish~~
graphical messages in [Openbox](http://openbox.org) window manager.
This way one can, for instance, change volume level or screen brightness,
or switch primary / secondary display and see a graphical confirmation
by just binding a key to a single command.
Furthermore - assigning a command in [Tint2](https://gitlab.com/o9000/tint2)
preferences allows to see alerts concerning the AC and
battery state, and also suspend on critical battery level.
### v0.2.3-1
Temporary file name changed: `~/tmp` -> `~/obhud-tmp` to avoid possible name conflict.
Bug reported by [entr0py](https://forum.archlabslinux.com/u/entr0py/summary) - thanks!
### New in 0.2.1 version
**Optional use of the `light` package**.
Listed as an optional dependency. Install if brightness keys don't work for you (e.g. with Radeon graphics).
See [Wiki](https://github.com/nwg-piotr/obhud/wiki/Openbox-HUD-Wiki) (scroll to the very bottom)
for more info.
### New in 0.1.9 version
**Timer/Stopwatch icon**. Please check "Show icons" checkbox in the relevant Tint2 executor.
Or you can set `execp_has_icon` to `1` in the tnt2rc file. If the executor has not yet
been added, running `obhud --autoconfig tint2` will do the job.
### New in 0.1.8 version
**Timer/Stopwatch added**. Please run `obhud --autoconfig tint2` to add the executor.
### New in 0.1.7 version
**Sound added** to the battery low notification. Launch `obhuh --autoconfig tint2` or just
replace `obhud --battery low` with `obhud --battery LOW` in Tint2 / Battery alert, to hear
sound before the notification and suspending the system.
## Installation
Arch Linux: search the [obhud](https://aur.archlinux.org/packages/obhud)
package in AUR.
## Quick start
Type `obhud` in terminal to access the menu, which allows to add
default keybindings to `rc.xml` and commands to `tint2rc` file
automatically. You'll also find syntax of each command here.
Alternatively you can use the `obhud --autoconfig all` command.
**CAUTION:**
*I did my best to test the script and make sure it's safe. However, the `--autoconfig`
options make changes to essential system configuration files. Making backups of
`~/.config/openbox/rc.xml` and `~/.config/tint2/tint2rc` files is recommendable.*
For more info [check Wiki](https://github.com/nwg-piotr/obhud/wiki/Openbox-HUD-Wiki).
## Credits
I used icons from [numix-gtk-theme](https://www.archlinux.org/packages/community/any/numix-gtk-theme)
by [Numix Project](http://numixproject.org) as the base of the icon set. Thanks!