screenshots and readme

README.md

@@ -18,6 +18,6 @@ These widgets use [Arc icon theme](https://github.com/horst3180/arc-icon-theme)
 
 [Install](https://github.com/horst3180/arc-icon-theme#installation) Arc icon theme and follow installation instructions of each widget.
 
-In case of any questions/suggestions don't hesitate to contact me, I would be happy to help =)
+In case of any questions/suggestions don't hesitate to contact me, I would be happy to help :)
 
 PRs/issues are welcome!

volume-widget/README.md

@@ -0,0 +1,31 @@
+# Volume widget
+
+Simple and easy-to-install widget for Awesome Window Manager.
+
+This widget represents the sound level: ![Volume Wiget](./vol-wid-1.png)
+
+## Installation
+
+- clone/copy **volume.lua** file;
+
+- include `volume.lua` and add volume widget to your wibox in rc.lua:
+
+```lua
+require("volume")
+...
+s.mytasklist, -- Middle widget
+	{ -- Right widgets
+    	layout = wibox.layout.fixed.horizontal,
+		...
+		volume_widget,
+		...      
+```
+
+## Control volume
+
+To be able to control volume level add following lines in shortcut section of the **rc.lua** (the command could be slightly different depending on your pc configuration):
+
+```lua
+awful.key({ modkey}, "[", function () awful.spawn("amixer -D pulse sset Master 5%-") end, {description = "increase volume", group = "custom"}),
+awful.key({ modkey}, "]", function () awful.spawn("amixer -D pulse sset Master 5%+") end, {description = "decrease volume", group = "custom"}),
+```