Installation
Fern Shell is distributed as a Nix flake with Home-Manager and NixOS modules.
Prerequisites
- Nix with flakes enabled
- Hyprland compositor
- QuickShell (provided by flake)
Home-Manager Installation
Add the flake to your flake.nix inputs:
{
inputs = {
nixpkgs.url = "github:NixOS/nixpkgs/nixos-unstable";
home-manager.url = "github:nix-community/home-manager";
fern-shell.url = "github:adanoelle/fern-shell";
};
}
Enable the module in your Home-Manager configuration:
{ inputs, ... }:
{
imports = [ inputs.fern-shell.homeManagerModules.default ];
programs.fern-shell = {
enable = true;
# Optional: customize settings
settings = {
appearance = {
theme = "dark";
accent = "#89b4fa";
};
bar = {
position = "left";
width = 48;
};
};
};
}
NixOS Installation
For system-wide installation, use the NixOS module:
{ inputs, ... }:
{
imports = [ inputs.fern-shell.nixosModules.default ];
programs.fern-shell.enable = true;
}
Manual / Development
Clone and run directly:
git clone https://github.com/adanoelle/fern-shell
cd fern-shell
nix develop
# Run with live reload
qs -p fern/shell.qml
Verifying Installation
After installation, start Hyprland. Fern Shell should appear as a bar on the left edge of your screen.
If you don't see the bar:
- Check that Hyprland is running
- Look for errors:
journalctl --user -u fern-shell - See Troubleshooting