127 lines
3.6 KiB
Markdown
127 lines
3.6 KiB
Markdown
<div align="center">
|
|
|
|
## 🤖 mechabar
|
|
|
|
A mecha-themed, modular Waybar configuration.
|
|
|
|
|  |
|
|
| :--------------------------------------: |
|
|
|
|
<details>
|
|
<summary><b>Themes</b></summary>
|
|
<br>
|
|
|
|
**Catppuccin:**
|
|
|
|
| Mocha _(default)_ |
|
|
| :----------------------------------------------: |
|
|
|  |
|
|
|
|
| Macchiato |
|
|
| :------------------------------------------------------: |
|
|
|  |
|
|
|
|
| Frappe |
|
|
| :------------------------------------------------: |
|
|
|  |
|
|
|
|
| Latte |
|
|
| :----------------------------------------------: |
|
|
|  |
|
|
|
|
</details>
|
|
</div>
|
|
|
|
#
|
|
|
|
### Requirements
|
|
|
|
1. [Waybar](https://github.com/Alexays/Waybar)
|
|
|
|
> [!WARNING]
|
|
> **Version 0.14.0** has an [issue](https://github.com/Alexays/Waybar/issues/4354) with wildcard includes.
|
|
> Use the `fix/v0.14.0` branch as a temporary workaround.
|
|
|
|
2. A terminal emulator _(default: **Kitty**)_
|
|
|
|
> [!IMPORTANT]
|
|
> If you use a different terminal emulator (e.g., **Ghostty**),
|
|
> you need to replace all instances of `kitty` with your terminal command:
|
|
>
|
|
> ```diff
|
|
> - "on-click": "kitty -e ..."
|
|
> + "on-click": "ghostty -e ..."
|
|
> ```
|
|
|
|
#
|
|
|
|
### Installation
|
|
|
|
1. Back up your current configuration:
|
|
|
|
```bash
|
|
mv ~/.config/waybar{,.bak}
|
|
```
|
|
|
|
2. Clone the repository:
|
|
|
|
```bash
|
|
git clone https://github.com/sejjy/mechabar.git ~/.config/waybar
|
|
```
|
|
|
|
For **Waybar v0.14.0**:
|
|
|
|
```bash
|
|
git clone -b fix/v0.14.0 https://github.com/sejjy/mechabar.git ~/.config/waybar
|
|
```
|
|
|
|
3. Run the [install script](/install.sh):
|
|
|
|
```bash
|
|
~/.config/waybar/install.sh
|
|
```
|
|
|
|
This makes the [scripts](/scripts/) executable and installs all dependencies listed below:
|
|
|
|
| Package | Description |
|
|
| --------------------------------: | ------------------------------------------------------------------------------ |
|
|
| `bluez` | Daemons for the bluetooth protocol stack<tr></tr> |
|
|
| _(bluetoothctl)_ `bluez-utils` | Development and debugging utilities for the bluetooth protocol stack<tr></tr> |
|
|
| `brightnessctl` | Lightweight brightness control tool<tr></tr> |
|
|
| `fzf` | Command-line fuzzy finder<tr></tr> |
|
|
| _(nmcli)_ `networkmanager` | Network connection manager and user applications<tr></tr> |
|
|
| _(checkupdates)_ `pacman-contrib` | Contributed scripts and tools for pacman systems<tr></tr> |
|
|
| `pipewire-pulse` | Low-latency audio/video router and processor - PulseAudio replacement<tr></tr> |
|
|
| `ttf-0xproto-nerd` | Patched font 0xProto from nerd fonts library |
|
|
|
|
#
|
|
|
|
### Customization
|
|
|
|
- To change the theme, copy the file with your preferred theme (e.g., `catppuccin-latte.css`) to `theme.css`:
|
|
|
|
```bash
|
|
cd ~/.config/waybar
|
|
cp themes/catppuccin-latte.css theme.css
|
|
```
|
|
|
|
#
|
|
|
|
### Documentation
|
|
|
|
- [Waybar wiki](https://github.com/Alexays/Waybar/wiki)
|
|
|
|
- Man page:
|
|
|
|
```bash
|
|
man waybar
|
|
```
|
|
|
|
#
|
|
|
|
### Credits
|
|
|
|
- Font: [0xProto](https://github.com/0xType/0xProto)
|
|
- Icons: [Nerd Fonts](https://github.com/ryanoasis/nerd-fonts)
|
|
- Themes: [Catppuccin](https://github.com/catppuccin/waybar)
|