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

---
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}),
		...
```