nirinit 0.2.2

A session manager for Niri, a scrollable-tiling Wayland compositor
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97

# nirinit

Session manager for [Niri](https://github.com/YaLTeR/niri) that automatically saves
and restores your window layout.

## Features

- Auto-saves session every 5 minutes (configurable)
- Restores windows to their workspaces on startup
- Preserves workspace names, indices, outputs, and window sizes
- Map `app_id` to custom launch commands
- Skip specific apps from being restored

## Installation

### NixOS + Home Manager

Add nirinit to your flake inputs:

```nix
{
  inputs.nirinit = {
    url = "github:amaanq/nirinit";
    inputs.nixpkgs.follows = "nixpkgs";
  };
}
```

Import the NixOS module and configure:

```nix
# configuration.nix
{ inputs, ... }:
{
  imports = [ inputs.nirinit.nixosModules.nirinit ];

  services.nirinit = {
    enable = true;
    settings = {
      # Map app_id to launch command (useful for PWAs, flatpaks, etc.)
      launch = {
        "chromium-example.com__-Default" = "example-web-app";
      };
      # Apps to skip during restore
      skip.apps = [ "steam" ];
    };
  };
}
```

Import the Home Manager module to generate the config file:

```nix
# home.nix
{ inputs, ... }:
{
  imports = [ inputs.nirinit.homeModules.nirinit ];
}
```

Note: Settings are defined in the NixOS module. The Home Manager module reads
from `osConfig` and generates `$XDG_CONFIG_HOME/nirinit/config.toml`.

### Manual

```bash
cargo install --path .

# Run as systemd user service or manually
nirinit --save-interval 300
```

## Configuration

The config file is located at `$XDG_CONFIG_HOME/nirinit/config.toml`
(typically `~/.config/nirinit/config.toml`).

```toml
[skip]
apps = ["steam"]

[launch]
# Map app_id to the actual command to spawn
"chromium-example.com__-Default" = "example-web-app"
```

## Session File

The session file is located at `$XDG_DATA_HOME/nirinit/session.json`
(typically `~/.local/share/nirinit/session.json`).

You shouldn't need to touch this. However, if session restore is acting up,
deleting it is a safe way to start fresh and might fix issues.

## License

MPL-2.0