linux-utils/readme.md
Reinout Meliesie ebf814a6ff
Add PKGBUILD info to readme
Also clarify readme info about individual nix package expressions.
2026-05-15 14:41:31 +02:00

52 lines
1.5 KiB
Markdown

# Linux Utils
## Description
A packaged assortment of helpers for Arch Linux and NixOS.
## Structure
`nixos-module.nix`
- The top-level NixOS module containing all package expressions as an overlay, and all package modules.
Once imported the overlay contents can be found under `pkgs` like any other.
`<util-name>/PKGBUILD`
- Arch Linux PKGBUILD for the individual utility.
`<util-name>/package.nix`
- The Nix package expression for the individual utility.
`<util-name>/nixos-module.nix`
- NixOS module providing additional features for the package in question, such as for example systemd units.
Can be imported directly, but is also imported by the top-level module.
Not present for all packages.
## Usage examples
> **Note:**
> You should replace the commits here with the latest one, or whichever one you want to use.
> The hashes will of course differ.
Using the top-level NixOS module:
```nix
imports = [
(fetchTarball {
url = "https://kernelmaft.com/forgejo/zedfrigg/nix-packages/archive/f91196c8a4a3ba6953c85b94ea75dee5e331548f.tar.gz";
sha256 = "sha256:1wx7ljabgndandcd11jmr590jfpkhs55mqrgksf24ji90m37wpq0";
} + "/nixos-module.nix")
];
```
Using a specific package expression:
```nix
pkgs.callPackage (import (pkgs.fetchurl {
url = "https://kernelmaft.com/forgejo/zedfrigg/nix-packages/raw/commit/c45884c66f31f8d8d80866bebc13e9e963e02a70/python3.11-django-imagekit/package.nix";
hash = "sha256-AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA=";
})) {}
```