{"id":13404292,"url":"https://github.com/awesomeWM/awesome","last_synced_at":"2025-03-14T09:31:01.515Z","repository":{"id":14659595,"uuid":"17378009","full_name":"awesomeWM/awesome","owner":"awesomeWM","description":"awesome window manager","archived":false,"fork":false,"pushed_at":"2024-10-27T19:31:55.000Z","size":17020,"stargazers_count":6386,"open_issues_count":559,"forks_count":598,"subscribers_count":163,"default_branch":"master","last_synced_at":"2024-10-29T14:55:45.674Z","etag":null,"topics":["awesomewm","c","hacktoberfest","lua","window-manager","xorg"],"latest_commit_sha":null,"homepage":"https://awesomewm.org/","language":"Lua","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/awesomeWM.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2014-03-03T19:56:16.000Z","updated_at":"2024-10-28T15:26:29.000Z","dependencies_parsed_at":"2024-11-13T13:43:00.189Z","dependency_job_id":"479082f5-a99f-42f6-a228-c899e3e80ca6","html_url":"https://github.com/awesomeWM/awesome","commit_stats":{"total_commits":10082,"total_committers":465,"mean_commits":21.68172043010753,"dds":0.622495536599881,"last_synced_commit":"d53eb1be67f594f62fb6134fe40928e8ca17304a"},"previous_names":[],"tags_count":90,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/awesomeWM%2Fawesome","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/awesomeWM%2Fawesome/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/awesomeWM%2Fawesome/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/awesomeWM%2Fawesome/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/awesomeWM","download_url":"https://codeload.github.com/awesomeWM/awesome/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243521268,"owners_count":20304186,"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","c","hacktoberfest","lua","window-manager","xorg"],"created_at":"2024-07-30T19:01:42.360Z","updated_at":"2025-03-14T09:31:00.894Z","avatar_url":"https://github.com/awesomeWM.png","language":"Lua","funding_links":[],"categories":["Lua","Dependencies","Uncategorized","Installation","Window Managers","LUA","This dotfiles contains only terminal (alacritty) and WM setting!!!","Window Manager","TODO","Do NOT send pull requests here","Install","Requirments","💣 Setup Installation","🔥 Information","My Setup","Packages","Official Resources","Awesome lists :heart:","Details"],"sub_categories":["Uncategorized","Volume","Dynamic Window Managers","Needed","Lockscreen","Dynamic","Required Dependencies","Required dependencies","Dynamic window managers","window-managers"],"readme":"# Readme\n\n## About Awesome\n\nAwesome is a highly configurable, next generation framework window manager for X.\n\n## Building and installation\n\nAfter extracting the dist tarball or cloning the repository, run:\n\n```sh\nmake\nsudo make install\n```\n\nThis will\n\n1. create a build directory at `./build`,\n2. run `cmake`,\n3. build Awesome and\n4. install it to the default prefix path `/usr/local`.\n\nAlternatively to the above, you can generate a `.deb` or `.rpm` package, for easy installation management:\n\n```sh\nmake package\n\nsudo dpkg -i awesome-x.y.z.deb\n# or\nsudo rpm -Uvh awesome-x.y.z.rpm\n```\n\n### Advanced options and testing\n\nA full list of dependencies, more advanced build options, as well as instructions on how to use the test suite can be found [here](https://awesomewm.org/apidoc/documentation/10-building-and-testing.md.html).\n\n### Installing current git master as a package receipts\n\n#### Arch Linux AUR\n\n```sh\nsudo pacman -S --needed base-devel git\ngit clone https://aur.archlinux.org/awesome-git.git\ncd awesome-git\nmakepkg -fsri\n```\n\n#### Debian-based\n\n```sh\nsudo apt build-dep awesome\ngit clone https://github.com/awesomewm/awesome\ncd awesome\nmake package\ncd build\nsudo apt install ./*.deb\n```\n\n## Running Awesome\n\nYou can directly select Awesome from your display manager. If not, you can\nadd the following line to your `.xinitrc` to start Awesome using `startx`\nor to `.xsession` to start Awesome using your display manager:\n\n```sh\nexec awesome\n```\n\nIn order to connect Awesome to a specific display, make sure that\nthe `DISPLAY` environment variable is set correctly, e.g.:\n\n```sh\nDISPLAY=foo.bar:1 exec awesome\n```\n\n(This will start Awesome on display `:1` of the host foo.bar.)\n\n## Configuration\n\nThe configuration of Awesome is done by creating a\n`$XDG_CONFIG_HOME/awesome/rc.lua` file, typically `~/.config/awesome/rc.lua`.\n\nAn example configuration named `awesomerc.lua` is provided in the source.\n\n## Troubleshooting\n\nOn most systems any message printed by Awesome (including warnings and errors)\nis written to `~/.xsession-errors`.\n\nIf Awesome does not start or the configuration file is not producing the\ndesired results the user should examine this file to gain insight into the\nproblem.\n\n### Debugging tips\n\nYou can call `awesome` with `gdb` like this:\n\n```sh\nDISPLAY=:2 gdb awesome\n```\n\nThen in `gdb` set any arguments and run it:\n\n```\n(gdb) set args --replace\n(gdb) run\n```\n\n## Asking questions\n\n#### IRC\n\nYou can join us in the `#awesome` channel on the [OFTC](http://www.oftc.net/) IRC network.\n\n[IRC Webchat](https://webchat.oftc.net/?channels=awesome)\n\n#### Stack Overflow\nYou can ask questions on [Stack Overflow](http://stackoverflow.com/questions/tagged/awesome-wm).\n\n#### Reddit\nWe also have an [awesome subreddit](https://www.reddit.com/r/awesomewm/) where you can share your work and ask questions.\n\n## Reporting issues\n\nPlease report any issues you may find on [our bugtracker](https://github.com/awesomeWM/awesome/issues).\n\n## Contributing code\n\nYou can submit pull requests on the [GitHub repository](https://github.com/awesomeWM/awesome).\nPlease read the [contributing guide](https://github.com/awesomeWM/awesome/blob/master/docs/02-contributing.md) for any coding, documentation or patch guidelines.\n\n## Status\n[![Build Status](https://travis-ci.com/awesomeWM/awesome.svg?branch=master)](https://travis-ci.com/awesomeWM/awesome)\n\n## Documentation\n\nOnline documentation is available [here](https://awesomewm.org/apidoc/).\n\n## License\n\nThe project is licensed under GNU General Public License v2 or later.\nYou can read it online at ([v2](http://www.gnu.org/licenses/gpl-2.0.html)\nor [v3](http://www.gnu.org/licenses/gpl.html)).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FawesomeWM%2Fawesome","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FawesomeWM%2Fawesome","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FawesomeWM%2Fawesome/lists"}