{"id":16974413,"url":"https://github.com/macunha1/awesomewm-memory-notifier","last_synced_at":"2026-02-20T08:30:18.077Z","repository":{"id":174960881,"uuid":"152891684","full_name":"macunha1/awesomewm-memory-notifier","owner":"macunha1","description":"Simple and minimalistic memory (RAM) pop-up notifier for AwesomeWM.","archived":false,"fork":false,"pushed_at":"2020-05-21T08:50:27.000Z","size":262,"stargazers_count":5,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2024-04-22T14:04:08.540Z","etag":null,"topics":["awesomewm","awesomewm-memory-notifier","notifier","ram"],"latest_commit_sha":null,"homepage":"","language":"Lua","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"unlicense","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/macunha1.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null}},"created_at":"2018-10-13T16:31:55.000Z","updated_at":"2023-07-18T12:50:06.000Z","dependencies_parsed_at":null,"dependency_job_id":"6ba06f89-2a79-4079-a05b-a59708be4278","html_url":"https://github.com/macunha1/awesomewm-memory-notifier","commit_stats":null,"previous_names":["macunha1/awesomewm-memory-notifier"],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/macunha1%2Fawesomewm-memory-notifier","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/macunha1%2Fawesomewm-memory-notifier/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/macunha1%2Fawesomewm-memory-notifier/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/macunha1%2Fawesomewm-memory-notifier/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/macunha1","download_url":"https://codeload.github.com/macunha1/awesomewm-memory-notifier/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":239671411,"owners_count":19677870,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["awesomewm","awesomewm-memory-notifier","notifier","ram"],"created_at":"2024-10-14T01:06:17.946Z","updated_at":"2026-02-20T08:30:18.031Z","avatar_url":"https://github.com/macunha1.png","language":"Lua","funding_links":[],"categories":["User Interface Related"],"sub_categories":["Notifications"],"readme":"\u003ch1 align=\"center\"\u003eAwesomeWM Memory Notifier plug-in\u003c/h1\u003e\n\nSimple and minimalistic Memory (RAM) notifier for AwesomeWM.\nUsing [Wibox widget piechart](https://awesomewm.org/apidoc/widgets/wibox.widget.piechart.html) to display memory usage in GB and percentage.\n\n![Screenshot](/screenshot.png?raw=true \"Screenshot\")\n\nRAM notifier plugin code was initially based on [deficient/calendar](https://github.com/deficient/calendar.git),\ndisplaying a small text using [Naughty](https://awesomewm.org/doc/api/libraries/naughty.html).\n\nLater it evolved into a pie chart notification using [streetturtle](https://github.com/streetturtle/awesome-wm-widgets/blob/master/ram-widget/ram-widget.lua) implementation as an inspiration.\n\n### Installation\n\nDrop the plugin code into your AwesomeWM config folder. e.g.:\n\n```bash\n[[ -d ~/.config/awesome/plugins ]] || mkdir ~/.config/awesome/plugins\ncd ~/.config/awesome/plugins\ngit clone https://github.com/macunha1/awesomewm-memory-notifier ~/.config/awesome/plugins/memory-notifier\n```\n\nIf your AwesomeWM config is a git repository, you can add as a submodule with\n\n``` bash\ncd ~/.config/awesome\n\ngit submodule add -b master \\\n    -f --name memory-plugin \\\n    https://github.com/macunha1/awesomewm-memory-notifier \\\n    plugins/memory-notifier\n\ngit submodule sync --recursive .\n```\n\n### Usage\n\nAnd then import the plugin into your `rc.lua`:\n\n```lua\n-- load the widget code\nlocal memory_widget = require(\"plugins.memory-notifier\")\n\n-- attach it as popup to your memory widget:\nmem_widget({\n    colors = {\n        theme.fg_focus,\n        theme.bg_normal,\n        theme.fg_normal,\n    },\n    font  = theme.font, -- not supported\n    fg    = theme.fg_normal,\n    bg    = theme.bg_focus,\n\n    border_width = theme.border_width,\n    border_color = theme.border_color\n}):attach(ram_wid)\n```\n\n### Requirements\n\n* [awesome 4.0](http://awesome.naquadah.org/). May work on 3.5 with minor changes.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmacunha1%2Fawesomewm-memory-notifier","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmacunha1%2Fawesomewm-memory-notifier","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmacunha1%2Fawesomewm-memory-notifier/lists"}