ansible-role-conky

This is an Ansible role for installing Conky and setting it up with basic configurations. The default configuration file, .conkyrc, is based on a template from [doyousketch2] (https://gist.github.com/doyousketch2/c0088f3827025ee037735f156e2c903c) and has been modified a bit.

Requirements

You need to have Poetry installed. You can find installation instructions at https://python-poetry.org/docs/.

Role Variables

config_owner:
  String (required) to set the Linux user for whom Conky will be set up.
  Default: "{{ ansible_user_id }}"

config_owner_primary_group:
  String (optional) to define the group that will own the Conky setup.
  Default: "{{ config_owner }}"

These variables are located in defaults/main.yml, and most of them are used with the conkyrc.j2 template.

alignment
background
border_outer_margin
border_width
cpu_avg_samples
default_color: white
default_outline_color
default_shade_color
draw_borders
draw_graph_borders
draw_outline
draw_shades
double_buffer
extra_newline
font
gap_x
gap_y
no_buffers
out_to_console
out_to_stderr
own_window
own_window_class
own_window_transparent
own_window_type
own_window_hints
short_units
stippled_borders
update_interval
uppercase
use_xft
use_spacer
show_graph_scale
show_graph_range
conky_text

Dependencies

There are no dependencies.

Example Playbook

- hosts: all
  roles:
     - { role: avnes.ansible-role-conky, config_owner: 'maya' }

For pip compatibility

To export requirements for pip, run:

poetry export --dev --output requirements.txt

Test

To test the setup, use:

poetry install
poetry shell
molecule test

License

This project is licensed under the MIT License.

Author Information

You can find more about the author at https://github.com/avnes/.