awesome-wm-widgets/_widgets/apt-widget.md

48 lines
1.1 KiB
Markdown

---
layout: page
---
# APT widget
Widget which shows a list of APT packages to be updated:
![screenshot](../awesome-wm-widgets/assets/img/widgets/screenshots/apt-widget/screenshot.gif)
Features:
- scrollable list !!! (thanks to this [post](https://www.reddit.com/r/awesomewm/comments/isx89x/scrolling_a_layout_fixed_flexed_layout_widget/) of reddit)
- update single package
- update multiple packages
## Customizations
It is possible to customize widget by providing a table with the following config parameters:
| Name | Default | Description |
|---|---|---|
| `icon_control` | `false` | Set or unset whether _any_ click on the screen closes the dropdown after it has been opened. |
## Installation
Clone the repo under ~/.config/awesome/ folder, then in rc.lua add the following:
```lua
local apt_widget = require("awesome-wm-widgets.apt-widget.apt-widget")
...
s.mytasklist, -- Middle widget
{ -- Right widgets
layout = wibox.layout.fixed.horizontal,
...
apt_widget(),
...
```
Or use the following.
```lua
...
apt_widget({icon_control=true}),
...
```