🛠️ Installation
You can install Ashell using the following methods:
Packages
info
I only maintain the Arch Linux package and the Nix configuration included in the repository.
If a package is broken, try building from source first.
Arch Linux
Install a tagged release from the AUR repositories:
yay -S ashell
Or install from the AUR, which compiles the latest source:
yay -S ashell-git
Nix
To install Ashell using the Nix package manager, make sure flakes are enabled, then run:
Tagged Release
nix profile install github:MalpenZibo/ashell?ref=0.5.0
Main Branch
nix profile install github:MalpenZibo/ashell
NixOS / Home Manager
To use this flake, add the input to your flake.nix
:
inputs = {
# ... other inputs
ashell.url = "github:MalpenZibo/ashell";
# ... other inputs
};
outputs = {...} @ inputs: {<outputs>}; # Make sure to pass inputs to your specialArgs!
And in your configuration.nix
:
{ pkgs, inputs, ... }:
{
environment.systemPackages = [inputs.ashell.defaultPackage.${pkgs.system}];
# or home.packages = ...
}
This will build Ashell from source.
Alternatively, you can use pkgs.ashell
from nixpkgs
, which is cached.
Building from Source
To build Ashell from source, ensure the following dependencies are installed:
- Rust (with
cargo
) - wayland-protocols
- clang
- libxkbcommon
- wayland
- dbus
- libpipewire
- libpulse
Then, from the root of the repository, run:
cargo build --release
# To install it system-wide
sudo cp target/release/ashell /usr/bin