From f0524d3a679652a062c8f0515200ebc31430fb5d Mon Sep 17 00:00:00 2001 From: streetturtle Date: Tue, 14 Jul 2020 10:44:20 -0400 Subject: [github-activity-widget] fix #166 Add Installation section to the readme --- github-activity-widget/README.md | 24 ++++++++++++++++++++++++ 1 file changed, 24 insertions(+) (limited to 'github-activity-widget') diff --git a/github-activity-widget/README.md b/github-activity-widget/README.md index 4f69eb5..2dbf98b 100644 --- a/github-activity-widget/README.md +++ b/github-activity-widget/README.md @@ -18,6 +18,30 @@ It is possible to customize widget by providing a table with all or some of the | `username` | your username | Required parameter | | `number_of_events` | 10 | Number of events to display in the list | +## Installation + +Clone repo under **~/.config/awesome/** and add widget in **rc.lua**: + +```lua +local github_activity_widget = require("awesome-wm-widgets.github-activity-widget.github-activity-widget") +... +s.mytasklist, -- Middle widget + { -- Right widgets + layout = wibox.layout.fixed.horizontal, + ... + -- default + github_activity_widget{ + username = 'streetturtle', + }, + -- customized + github_activity_widget{ + username = 'streetturtle', + number_of_events = 5 + }, + +``` + + ## How it works Everything starts with this timer, which gets recent activities by calling GitHub [Events API](https://developer.github.com/v3/activity/events/) and stores the response under /.cache/awmw/github-activity-widget/activity.json directory: -- cgit v1.2.3