Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/roles-ansible/role_akku_warning
ansible role to install a warning if your akku is low
https://github.com/roles-ansible/role_akku_warning
akku ansible-role galaxy role-ansible
Last synced: about 1 month ago
JSON representation
ansible role to install a warning if your akku is low
- Host: GitHub
- URL: https://github.com/roles-ansible/role_akku_warning
- Owner: roles-ansible
- License: mit
- Created: 2019-04-07T16:44:45.000Z (over 5 years ago)
- Default Branch: main
- Last Pushed: 2024-03-21T20:16:15.000Z (10 months ago)
- Last Synced: 2024-05-01T18:37:31.806Z (8 months ago)
- Topics: akku, ansible-role, galaxy, role-ansible
- Language: Shell
- Homepage: https://galaxy.ansible.com/do1jlr/akku_warning
- Size: 46.6 MB
- Stars: 2
- Watchers: 3
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
[](https://galaxy.ansible.com/do1jlr/akku_warning)
[](https://github.com/roles-ansible/role_akku_warning/blob/master/LICENSE)
ansible role: akku warning
==========================
# rewrite in progress!!!
```
cronjob is going to be removed!
systemd timer intruduces
variables may change!
TODO: Verhalten bei akku losen geräten verbessern!
```
This ansible role installs a bash script (per cronjob) which is executed every 3 minutes. This bash script checks if the battery level is below 25 percent and is currently not charging. If this is the case, the program [zenity](https://de.wikipedia.org/wiki/Zenity) installed by this role will generate a popup message stating that the battery is low.
While the battery level is between 15 and 10 percent, it will also attempt to play a sound. But this does not (yet) work reliably.
This role is tested with the [i3 - improved tiling wm](https://i3wm.org/), installed by [this role](https://github.com/chaos-bodensee/role-i3wm.git) at Archlinux, but probably will work on all window magers and the most operating systems!
Installation and Usage
------------------------
### install with galaxy:
```bash
ansible-galaxy install do1jlr.akku_warning
```
You can execute the role **directly via ansible ad-hoc commands**, but it is highly recomended to create a ansible playbook
```bash
# example ad-hoc command
ansible -m include_role -a "name=do1jlr.akku_warning" localhost
```
### example playbook with galaxy
```yaml
---
- hosts:
roles:
- do1jlr.akku_warning
```
### installation via git
```bash
# download this role into your roles directory
git clone https://github.com/roles-ansible/role_akku_warning.git
```
### example playbook
```yaml
---
- name: install akku_warning
hosts: localhost
tags:
- akku_warning
roles:
- role_akku_warning
vars:
submodules_versioncheck: true
```
Variables:
-----------
```yaml
---
# simple version check for this playbook
# true is highly recomended
submodules_versioncheck: false
# which user are we currently using?
akku_user: "{{ ansible_user_id }}"
# which sound should we play?
akku_sound_src: 'files/low_battery.m4a'
akku_sound_dest: '/opt/low_battery.m4a'
# should we install cronie?
install_and_enable_cronie: true
# play a video in the background with sound
multimedia_akku_warning: true
# you want to install missing packages?
manage_packages_akku_warning: true
```
Contribution
------------
If you are missing some features or have an idea for improving this role, please feel free to open an issue - or even better - create a pull request.