bawesome
所属分类:编程语言基础
开发工具:Lua
文件大小:1937KB
下载次数:0
上传日期:2021-07-13 06:28:53
上 传 者:
sh-1993
说明: 更棒的窗口管理器配置
(better awesome window manager configuration)
文件列表:
.lua-format (493, 2021-07-13)
awesome-battery_widget (0, 2021-07-13)
b (0, 2021-07-13)
b\error_handling.lua (903, 2021-07-13)
b\key_bindings.lua (12450, 2021-07-13)
b\pa_widget.lua (961, 2021-07-13)
b\process.lua (1515, 2021-07-13)
b\rules.lua (2010, 2021-07-13)
b\screenshot.lua (617, 2021-07-13)
b\signals.lua (2697, 2021-07-13)
b\taskbar.lua (1171, 2021-07-13)
b\wibar.lua (6477, 2021-07-13)
b\xrandr.lua (3612, 2021-07-13)
default (0, 2021-07-13)
default\background.png (222973, 2021-07-13)
default\background_white.png (267935, 2021-07-13)
default\layouts (0, 2021-07-13)
default\layouts\cornerne.png (272, 2021-07-13)
default\layouts\cornernew.png (272, 2021-07-13)
default\layouts\cornernw.png (263, 2021-07-13)
default\layouts\cornernww.png (264, 2021-07-13)
default\layouts\cornerse.png (264, 2021-07-13)
default\layouts\cornersew.png (264, 2021-07-13)
default\layouts\cornersw.png (263, 2021-07-13)
default\layouts\cornersww.png (264, 2021-07-13)
default\layouts\dwindle.png (320, 2021-07-13)
default\layouts\dwindlew.png (320, 2021-07-13)
default\layouts\fairh.png (245, 2021-07-13)
default\layouts\fairhw.png (245, 2021-07-13)
default\layouts\fairv.png (246, 2021-07-13)
default\layouts\fairvw.png (246, 2021-07-13)
default\layouts\floating.png (282, 2021-07-13)
default\layouts\floatingw.png (282, 2021-07-13)
default\layouts\fullscreen.png (866, 2021-07-13)
default\layouts\fullscreenw.png (865, 2021-07-13)
... ...
# README
## Overview
This is just a specific `awesomewm` configuration that works well on ArchLinux.
This project is not an invention of how things shall be done, but a good maintained example of how to configure `awesomewm` for daily use. It is a current solution to various daily desktop usage needs of the author and is shared here in the hope of helping others to start with `awesomewm`. The author uses XFCE4 as a backup DE. XFCE tools are used when appropriate. Screenshot tool is a good example.
**Status:** it is in daily use.
## Installation
Clone into `$XDG_CONFIG_HOME` directory or `$HOME/.config`:
```
cd $HOME/.config
git clone https://github.com/Kulak/bawesome.git awesome
cd awesome
git submodule init
git submodule update
```
## Screenshots
- [on screen help](https://github.com/kulak/bawesome/blob/master/doc/images/on-screen-help.png) demonstrates that all on screen help text is readable
- [run application](https://github.com/kulak/bawesome/blob/master/doc/images/rofi.png) provides a quick way to start application with `command-shift-Enter` shortcut.
- [clipboard manager](https://github.com/kulak/bawesome/blob/master/doc/images/clipboard-manager.png)
- [active window](https://github.com/kulak/bawesome/blob/master/doc/images/active-window.png) is at the bottom right corner of the screenshot and it has a lighter blue border around the window than others.
## Features
Features at a glance copared to default script:
- better launcher
- blue color scheme
- active window highlight
- readable help screen window
- multiple monitor support
- keyboard shortcuts to manage sound volume mapped to keyboard "volume" management buttons
- laptop keyboard highlight with keyboard shortcuts
- automatic laptop power indicator visible only when battery is present
- screenshooter with keyboard shortcuts
- optional require
- better support for spawning a process
- parts of configuration script are overridable without need to commit upstream
- one large rc script is broken into manageable parts with clear dependencies between scripts (reduced reliance on globals)
### Blue Color Scheme
The color scheme is just a copy of default scheme with tweaks to improve usability.
The color scheme uses classic blue color to indicate window in focus. It uses blue window border for focused window. This visually connects "taskbar" area with window border and makes it more intuitive to identify focused window.
Non-focused windows are of darker blue color.
Minimized windows have dark background.
Keyboard shortcuts text in Help dialog window is readble.
### XFCE4 Screenshooter
Mapped nice XFCE4 screenshot taking application to standard set of Print Scr key combinations.
### Better Launcher
Use of "rofi" as launcher, because it is easy to see and to read. Default launcher steals focus and its focus can be easily missed.
### Alt-Tab Window Switcher
"rofi" is used as Window Switcher and matches standard "Alt-Tab" keyboard shortcut.
### Standard Extended Keys are Mapped
Keyboard volume management keys (up, down and mute toggle) are properly mapped via `pactl`.
Monitor brightness control keys are mapped.
### Battery Power Widget
Requires loading GIT submodule.
## Overrides
### Applications Menu
To generate "classic" menu for your installed applicatinons:
xdg_menu --format awesome --root-menu /etc/xdg/menus/arch-applications.menu > ~/.config/awesome/overrides/xdg_menu.lua
About [xdg_menu](https://github.com/kulak/bawesome/blob/master/https://wiki.archlinux.org/title/Xdg-menu) on ArchLinux.
### Machine Specific Configuration Paramters
Create `overrides/my.lua` file. Start with template:
```sh
cp overrides/templates/my.lua overrides/my.lua
```
### Arrange Multiple Monitors
Included `randr` script from the main website and mapped it to `command-O` to turn on and off multiple monitors.
### Other Notes
See [notes](https://github.com/kulak/bawesome/blob/master/doc/notes.md).
## External Dependencies
References are to Arch Linux packages. Use "Upstream URL" on corresponding package pages to identify actual application dependency for your Linux distribution.
1. [alacritty](https://github.com/kulak/bawesome/blob/master/https://archlinux.org/packages/community/x86_***/alacritty/) default terminal emulator, overridable.
2. [vim](https://github.com/kulak/bawesome/blob/master/https://archlinux.org/packages/extra/x86_***/vim/) required internally.
3. [rofi](https://github.com/kulak/bawesome/blob/master/https://archlinux.org/packages/community/x86_***/rofi/) for effecient program and window management.
3. XFCE4 Tools
- [xfce4-screenshooter](https://github.com/kulak/bawesome/blob/master/https://archlinux.org/packages/extra/x86_***/xfce4-screenshooter/);
- [xfce4-clipman](https://github.com/kulak/bawesome/blob/master/https://archlinux.org/packages/extra/x86_***/xfce4-clipman-plugin/) for screenshooter clipboard support.
4. [pactl](https://github.com/kulak/bawesome/blob/master/https://archlinux.org/packages/extra/x86_***/libpulse/) to raise and reduce volume.
5. [pavucontrol](https://github.com/kulak/bawesome/blob/master/https://archlinux.org/packages/extra/x86_***/pavucontrol/) pulse audio UI control.
6. [xbacklight](https://github.com/kulak/bawesome/blob/master/https://archlinux.org/packages/extra/x86_***/xorg-xbacklight/) for laptop monitor brightness.
7. [pgrep](https://github.com/kulak/bawesome/blob/master/https://archlinux.org/packages/core/x86_***/procps-ng/) to start programs once.
8. [whoami](https://github.com/kulak/bawesome/blob/master/https://archlinux.org/packages/core/x86_***/coreutils/).
近期下载者:
相关文件:
收藏者: