<div align="center">
  <a href="https://malpenzibo.github.io/ashell/">
    <img src="https://raw.githubusercontent.com/MalpenZibo/ashell/main/website/static/img/logo_header_dark.svg" alt="ashell" height="140"/>
  </a>
</div>

## What is ashell?

ashell is a ready to go Wayland status bar for Hyprland and Niri.

Feel free to fork this project and customize it for your needs or just open an
issue to request a particular feature.

## 🚀 Getting Started

Refer to the [Getting Started](https://malpenzibo.github.io/ashell/docs/intro)
page on website

## ✨ Features

- OS Updates indicator
- Hyprland/Niri Active Window
- Hyprland/Niri Workspaces
- System Information (CPU, RAM, Disk, Network, Temperature)
- Hyprland/Niri Keyboard Layout
- Hyprland Keyboard Submap
- Tray
- Clock with calendar, weather, timezone cycling, and format cycling (Tempo)
- Privacy (check microphone, camera and screenshare usage)
- Media Player with album art
- Settings panel
  - Power menu
  - Battery information
  - Audio sources and sinks (with microphone)
  - Screen brightness
  - Network
  - VPN
  - Bluetooth
  - Power profiles
  - Idle inhibitor
  - Airplane mode
- Custom Modules
  - Simple (execute command on click)
  - Advanced (update UI with command output)

## 🛠️ Install

[![Packaging status](https://repology.org/badge/vertical-allrepos/ashell.svg)](https://repology.org/project/ashell/versions)

Refer to the [Installation](https://malpenzibo.github.io/ashell/docs/installation)
page for more details.

## ⚙️ Configuration

ashell comes with a default configuration that should work out of the box.

If you want to customize it you can refer to
the [Configuration](https://malpenzibo.github.io/ashell/docs/configuration)
page for more details.

## 📷 Screenshots

I will try my best to keep these screenshots as updated as possible but some details
could be different

#### default style

<img src="https://raw.githubusercontent.com/MalpenZibo/ashell/main/website/static/img/gallery/ashell.png"></img>

#### solid style

<img src="https://raw.githubusercontent.com/MalpenZibo/ashell/main/website/static/img/gallery/ashell-solid.png"></img>

#### gradient style

<img src="https://raw.githubusercontent.com/MalpenZibo/ashell/main/website/static/img/gallery/ashell-gradient.png"></img>

#### opacity settings

<img src="https://raw.githubusercontent.com/MalpenZibo/ashell/main/website/static/img/gallery/opacity.png"></img>

| ![](https://raw.githubusercontent.com/MalpenZibo/ashell/main/website/static/img/gallery/updates-panel.png)   | ![](https://raw.githubusercontent.com/MalpenZibo/ashell/main/website/static/img/gallery/system-menu.png)  |
| ------------------------------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------- |
| ![](https://raw.githubusercontent.com/MalpenZibo/ashell/main/website/static/img/gallery/tray-menu.png)       | ![](https://raw.githubusercontent.com/MalpenZibo/ashell/main/website/static/img/gallery/power-menu.png)   |
| ![](https://raw.githubusercontent.com/MalpenZibo/ashell/main/website/static/img/gallery/sinks-selection.png) | ![](https://raw.githubusercontent.com/MalpenZibo/ashell/main/website/static/img/gallery/network-menu.png) |
| ![](https://raw.githubusercontent.com/MalpenZibo/ashell/main/website/static/img/gallery/bluetooth-menu.png)  | ![](https://raw.githubusercontent.com/MalpenZibo/ashell/main/website/static/img/gallery/vpn-menu.png)     |
