{"id":13897678,"url":"https://github.com/thytom/dwmbar","last_synced_at":"2026-03-04T00:40:54.653Z","repository":{"id":37677586,"uuid":"216628501","full_name":"thytom/dwmbar","owner":"thytom","description":"A Modular Status Bar for dwm.","archived":false,"fork":false,"pushed_at":"2025-01-12T22:43:27.000Z","size":177,"stargazers_count":130,"open_issues_count":2,"forks_count":23,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-01-12T23:28:17.448Z","etag":null,"topics":["dwm","linux"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/thytom.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"COPYING","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2019-10-21T17:40:28.000Z","updated_at":"2025-01-12T22:56:16.000Z","dependencies_parsed_at":"2022-09-15T09:10:13.396Z","dependency_job_id":null,"html_url":"https://github.com/thytom/dwmbar","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/thytom/dwmbar","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thytom%2Fdwmbar","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thytom%2Fdwmbar/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thytom%2Fdwmbar/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thytom%2Fdwmbar/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/thytom","download_url":"https://codeload.github.com/thytom/dwmbar/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thytom%2Fdwmbar/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":265616835,"owners_count":23798905,"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":["dwm","linux"],"created_at":"2024-08-06T18:03:48.048Z","updated_at":"2026-03-04T00:40:49.614Z","avatar_url":"https://github.com/thytom.png","language":"Shell","funding_links":[],"categories":["Shell","Packages"],"sub_categories":["Bars, Panels, and Widgets"],"readme":"dwmbar - A Modular Status Bar for dwm\n=====================================\n![Example image](res/example.png)\n\ndwmbar is a very simple status bar written for dwm.\n\n**This project is no longer actively maintained. You will likely not receive support from the devs if something's not right. If you are somebody who is interested in taking over this project, please contact me (thytom) and we can discuss adding you as a contributor. You are also more than welcome to fork the project if you wish to make improvements on your own.**\n\n# Installation\n\n## Prerequisites\n\nWhile some modules will work without these dependencies, we recommend grabbing\nthe ones you want for specific modules.\n\nHighly Recommended:\n* Any patched Nerd Font for icons.\n\nOptional (By module):\n\nSee [module prerequisites](#module-prerequisites).\n\n\n## Arch Linux\n\nThere is an [AUR package](https://aur.archlinux.org/packages/dwmbar-git) for\ndwmbar, which can be installed with your favourite aur helper, or manually.\n\nPlease see the [archwiki\npage](https://wiki.archlinux.org/index.php/Arch_User_Repository#Installing_packages)\nfor how to manually install AUR packages.\n\n## Manual Installation\n\n```bash\n$ git clone https://github.com/thytom/dwmbar\n$ cd dwmbar\n$ sudo ./install.sh\n```\n# Usage\n\ndwmbar works by setting the root window name, which dwm displays. It does this\nby calling the dwmbarrc file in your .config/dwmbar folder.\n\nAdd the line `dwmbar \u0026` to your .xinitrc file to run on startup. You can also\nrun `dwmbar` in terminal for testing purposes.\n\n# Customisation\n\n## Configuring the Bar\n\nMost non-modular configuration is done in `~/.config/dwmbar/dwmbarrc`, a bash\nscript that calls scripts in turn, caching their output and then constructing\nthe bar from that.\n\nTo add a module to the bar, simply include its name in the MODULES variable:\n\n```bash\nMODULES=\"mpd volumebar wifi battery\"\n```\n\nModules are displayed left-to-right in the order they are written in `MODULES`.\nBy default, they are delimited by the `SEPARATOR` variable, which you can\nchange.\n\nWe also offer a `PADDING` variable, which contains a string you can include at\nthe start of your bar, on the very right. This can either be padding spaces, to\nmove the bar away from the right edge, or even text. By default, we set\n`PADDING` to `$USER@$HOSTNAME`. Feel free to change this.\n\n## Writing Modules\n\nDefault modules are located within `/usr/share/dwmbar/modules`, and custom\nmodules can be placed in `~/.config/dwmbar/modules/custom`. If a default module\nexists with the same name as a custom module, then the custom module will take\nprecedence.\n\n**Default modules will possibly be overwritten during updates, so if you want\nto modify them be sure to make a copy in the custom folder, which will not be\ntouched, and edit it there.**\n\nModules can be written in any language, so long as they are executable and\nprint their output to stdout.\n\nCurrently available default modules are:\n- archupdates\t\t - Gets the number of updates available **Arch Linux Only**\n- backlight\t\t\t - Shows the brightness of the screen\n- battery\t\t\t - Gets battery percentage\n- bluetooth\t\t\t - Shows bluetooth status\n- cpuload\t\t\t - Shows the CPU load in %\n- date\t\t\t\t - Shows the calendar date\n- daypercentage\t\t - Shows how far through the day you are, in %\n- disksize\t\t\t - Shows the disk usage\n- ethernet\t\t\t - Shows ethernet connection\n- fanspeed           - Shows the rpm of your main fan\n- hostname           - Shows your current user and hostname\n- internet\t\t\t - Shows whether internet is available (TODO)\n- kernel             - Shows the kernel version\n- localip            - Shows your local IP address\n- mail\t\t\t\t - Shows how much mail you have\n- mpd\t\t\t\t - Shows MPD status\n- networkdowntraffic - Gets the download traffic in Kb/s\n- networkuptraffic   - Gets the upload traffic in Kb/s\n- publicip           - Shows your public IP address\n- ram\t\t\t\t - Shows RAM usage\n- redshift\t\t\t - Shows current screen temperature from Redshift\n- sunmoon\t\t\t - Displays a sun or moon for time of day\n- temperature\t\t - Displays the temperature of the CPU\n- time\t\t\t\t - Displays time\n- todo\t\t\t\t - Prints the number of todos for the \"t\" todo manager\n- tor\t\t\t\t - Prints if the tor service is enabled\n- voidupdates        - Gets the number of updates available **Void Linux Only**\n- volumebar\t\t\t - Displays a volume bar\n- volume\t\t\t - Prints volume in %\n- weather\t\t\t - Shows weather info\n- wifi\t\t\t\t - Shows wifi connection\n\n## Module Prerequisites\n\nSee Module Dependencies\n * archupdates\n\t- Arch Linux\n\t- yay\n\t- pacman-contrib\n* backlight\n\t- light\n* bluetooth\n\t- bluez\n* fanspeed\n        - lm_sensors\n* mail\n\t- mutt/neomutt (We recommend [Luke Smith's Mutt-Wizard](https://github.com/LukeSmithxyz/mutt-wizard)) for configuration.\n* mpd\n\t- mpd\n\t- mpc\n* publicip\n    - curl\n* redshift\n\t- redshift\n* sunmoon\n\t- redshift\n* temperature\n\t- lm_sensors\n* todo\n\t- [t todo manager](https://github.com/sjl/t)\n* tor\n\t- tor\n* voidupdates\n    - xbps package manager\n* volume\n\t- pulseaudio\n* volumebar\n\t- pulseaudio\n* weather\n\t- curl\n\t- Internet connection\n* wifi\n\t- Wifi card\n\n# Feature Wishlist\n\n* Paralellised Modules\n\t- Some modules are slower than others. Have modules set a DELAY variable;\n\t\tif they don't have one, use a default.\n\t- Modules are called and bar is updated when a module finishes, but an\n\t\tinternal bar clock updates the clock at a specific delay.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthytom%2Fdwmbar","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fthytom%2Fdwmbar","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthytom%2Fdwmbar/lists"}