Files
quartz/content/10-19 LIFE/13 TECH SETUP/13.13 OS SETUP/Ashell.md
Quartz Syncer fe0581e423
All checks were successful
Build and Deploy Quartz / build (push) Successful in 27s
Published multiple files
2026-02-05 12:24:25 -07:00

123 lines
2.9 KiB
Markdown

---
publish: true
permalink: /os/ashell
title: Ashell
created: 2026-01-29T15:16:18.996-07:00
modified: 2026-02-05T12:17:52.901-07:00
tags:
- hyprland
- statusbar
- wayland
cssclasses: ""
---
Ashell is a lightweight status bar for Wayland compositors like [[10-19 LIFE/13 TECH SETUP/13.13 OS SETUP/Hyprland Setup\|Hyprland]].
## Installation
**From AUR:**
```bash
paru -S ashell
```
**From source:**
```bash
git clone https://github.com/malpenzibo/ashell
cd ashell
cargo build --release
cp target/release/ashell ~/.local/bin/
```
## Hyprland Integration
Add to `~/.config/hypr/hyprland.conf`:
```bash
exec-once = ashell
```
## My Configuration
Config location: `~/.config/ashell/config.toml`
```toml
log_level = "warn"
outputs = { Targets = ["eDP-1"] }
position = "Top"
app_launcher_cmd = "walker"
[modules]
left = [ [ "appLauncher", "Updates", "Workspaces" ] ]
right = [ "SystemInfo", [ "Tray", "Clock", "Privacy", "Settings" ] ]
[updates]
check_cmd = "checkupdates; paru -Qua"
update_cmd = 'kitty -e bash -c "paru; echo Done - Press enter to exit; read" &'
[system_info]
indicators = ["Cpu", "Memory", "Temperature", "IpAddress", "DownloadSpeed", "UploadSpeed"]
[workspaces]
enable_workspace_filling = true
[[CustomModule]]
name = "appLauncher"
icon = "󱗼"
command = "walker"
[window_title]
truncate_title_after_length = 100
[settings]
lock_cmd = "playerctl --all-players pause; hyprlock &"
audio_sinks_more_cmd = "pavucontrol -t 3"
audio_sources_more_cmd = "pavucontrol -t 4"
wifi_more_cmd = 'kitty -e bash -c "impala"'
vpn_more_cmd = "nm-connection-editor"
bluetooth_more_cmd = 'kitty -e bash -c "bluetui"'
shutdown_cmd = "hyprshutdown -t 'Shutting down...' --post-cmd 'shutdown -P 0'"
suspend_cmd = "systemctl suspend"
hibernate_cmd = "systemctl hibernate"
reboot_cmd = "hyprshutdown -t 'Restarting...' --post-cmd 'reboot'"
logout_cmd = "loginctl kill-user $(whoami)"
[appearance]
style = "Islands"
primary_color = "#7aa2f7"
success_color = "#9ece6a"
text_color = "#a9b1d6"
workspace_colors = [ "#7aa2f7", "#9ece6a" ]
special_workspace_colors = [ "#7aa2f7", "#9ece6a" ]
[appearance.danger_color]
base = "#f7768e"
weak = "#e0af68"
[appearance.background_color]
base = "#1a1b26"
weak = "#24273a"
strong = "#414868"
[appearance.secondary_color]
base = "#0c0d14"
```
## Key Features
- **Islands style** — Floating pill-shaped modules
- **Tokyo Night theme** — Colors match my Hyprland/terminal theme
- **Custom app launcher** — Uses Walker with a custom icon
- **System info** — CPU, memory, temp, network speeds
- **Update checker** — Shows pending pacman/AUR updates
- **Integration apps:**
- `walker` — App launcher
- `pavucontrol` — Audio settings
- `impala` — WiFi TUI
- `bluetui` — Bluetooth TUI
- `hyprshutdown` — Graceful shutdown with animation
## Resources
- Documentation: https://malpenzibo.github.io/ashell/
- GitHub: https://github.com/malpenzibo/ashell