Desktop shell based on Quickshell and configured using nix options.
  • QML 85.2%
  • GLSL 7.9%
  • Nix 6.9%
Find a file
2026-06-05 20:58:21 +02:00
colorschemes dev: first draft of color config 2025-12-17 17:15:46 +01:00
docs fix: Clock config string keys could not contain special characters. Updated docs accordingly. 2026-05-27 09:18:28 +02:00
ISSUE_TEMPLATE docs: issue templates 2025-12-04 20:55:20 +01:00
lib ref: moved import functions to subdirectory. 2026-02-17 14:38:00 +01:00
merremia fix: runtime dependencies missing in homemanager module and when running standalone. 2026-06-05 14:47:00 +02:00
nix fix: runtime dependencies missing in homemanager module and when running standalone. 2026-06-05 14:47:00 +02:00
.gitignore fix: remove local language server file from repo 2026-02-04 23:56:57 +01:00
flake.lock fix: clock not displaying minutes 2026-05-26 09:28:17 +02:00
flake.nix current state. 2026-05-27 09:55:33 +02:00
LICENSE Initial commit 2025-11-17 15:43:09 +01:00
README.md docs: Added documentation for the most important options. 2026-02-05 01:58:58 +01:00

Merremia

System shell based on quickshell and configured using nix options.

Getting Started

Add required input

merremia = {
  url = "git+https://codeberg.org/lunalorea/Merremia?ref=main";
};

and enable the module

modules = [ merremia.nixosModules.default ]; # Imports the merremia nix config, gives access to the merremia options.

Example flake:

{
  description = "NixOS configuration with Merremia";

  inputs = {
    nixpkgs.url = "github:nixos/nixpkgs/nixos-unstable";

    merremia = {
      url = "git+https://codeberg.org/lunalorea/Merremia?ref=main";
      inputs.nixpkgs.follows = "nixpkgs"; # Make sure dependencies are not installed twice by using the same version of nixpkgs. Lowers reproducabillity, by bugs try without this option.
    };
  };

  outputs = inputs@{ self, nixpkgs, ... }: {
    nixosConfigurations.awesomebox = nixpkgs.lib.nixosSystem {
      modules = [
        merremia.nixosModules.default
        # ... other modules
        ./
      ];
    };
  };
}

After this enable Merremia in your nixos config like this:

merremia = {
  enable = true; # Enables the quickshell config
  systemd.enable = true; # Enables the systemd user service that automatically starts the shell.
};

Configuration

Find the most important options here

Development

Clone repository:

git clone ssh://git@codeberg.org/lunalorea/Merremia.git

Active development:

If you run

nix develop

inside the repository, then this will link everything into .dev and run quickshell from there. This allows you to edit the symlinks within .dev and get live updates through quickshell.

Testing in your system config:

Make sure your System config is set up according to the Getting Started section. Change the url in your flake from

merremia = {
  url = "git+https://codeberg.org/lunalorea/Merremia?ref=main";
};

to

merremia = {
  #url = "git+https://codeberg.org/lunalorea/Merremia?ref=main";
  url = "path:</absolute/path/to/repository>";
};

Make sure the path points to the root directory of this repository and rebuild.