An open API service indexing awesome lists of open source software.

https://github.com/typovrak/nixos-nemo

πŸ“‚ Declarative NixOS module to create and secure a per-user Nemo configuration directory
https://github.com/typovrak/nixos-nemo

automation declarative file-explorer gtk nemo nix nixos

Last synced: 2 months ago
JSON representation

πŸ“‚ Declarative NixOS module to create and secure a per-user Nemo configuration directory

Awesome Lists containing this project

README

          

[![NixOS 24.11+](https://img.shields.io/badge/NixOS-24.11%2B-a6e3a1?labelColor=45475a)](https://nixos.org/)
[![License MIT](https://img.shields.io/badge/License-MIT-cba6f7.svg?labelColor=45475a)](LICENSE.md)
[![Buy me a coffee](https://img.shields.io/badge/Buy%20me%20a%20coffee-β˜•-fab387?labelColor=45475a)](https://typovrak.tv/coffee)
[![Portal](https://img.shields.io/badge/Portal-typovrak.tv%2Fnixos-eba0ac?labelColor=45475a)](https://typovrak.tv/nixos)
[![Discord join us](https://img.shields.io/badge/Discord-Join%20us-74c7ec?labelColor=45475a&logo=discord&logoColor=white)](https://typovrak.tv/discord)

# πŸ“‚ NixOS Nemo

> Declarative NixOS module to create and secure a per-user Nemo configuration directory, no config files included.

## 🧩 Part of the Typovrak NixOS ecosystem

This module is part of ```Typovrak NixOS```, a fully modular and declarative operating system configuration built entirely with :

- 🧱 **30+ standalone modules :** Each managing a specific tool, feature or aesthetic like ```zsh```, ```i3```, ```lighdm```, ```polybar```, ```gtk``` and more.
- 🎨 **Catppuccin Mocha :** The default theme across terminal, GUI, and login interfaces.
- πŸ›‘οΈ **100% FOSS compliant :** No proprietary software included unless explicitly chosen.
- πŸ§‘β€πŸ’» **Built for developers :** Optimized for speed, keyboard-centric workflows and expressive CLI tooling.

*Explore the full system : πŸ‘‰ [github.com/typovrak/nixos](https://github.com/typovrak/nixos)*

> [!CAUTION]
> This module is opinionated, it may **override**, **replace**, or **remove** files and settings **without** prompt. To avoid unexpected changes, **back up** your existing files or **fork** this module to take full control. **Follow this documentation** to avoid any of this problem.

## πŸ“¦ Features

- πŸ”’ **Secure config directory :** Creates ```~/.config/nemo``` with ```700``` permissions and correct ownership.
- πŸ”„ **Idempotent :** Cleans and recreates the directory on each rebuild without removing user files.
- βš™οΈ **Zero-config setup :** No configuration files provided, just the directory scaffold.
- πŸ’Ύ **Backup guidance :** Documentation outlines how to back up an existing ```~/.config/nemo``` before use.

## πŸ“‚ Repository structure

```bash
❯ tree -a -I ".git*"
.
β”œβ”€β”€ configuration.nix # module configuration
β”œβ”€β”€ LICENSE.md # MIT license
└── README.md # this documentation

1 directory, 3 files
```

## βš™οΈ Prerequisites

### 1. NixOS version
Requires NixOS 24.11 or newer.

### 2. User validation
the target user must be defined in ```config.username```. See [typovrak main nixos configuration](https://github.com/typovrak/nixos) for more details.

### 3. Backup
Before proceeding, back up existing configuration if needed
```bash
cp ~/.config/nemo{,.bak}
```

## ⬇️ Installation

### πŸš€ Method 1 : Out-of-the-box

Fetch the module directly in your [main nixos configuration](https://github.com/typovrak/nixos) at ```/etc/nixos/configuration.nix``` using fetchGit
```nix
# /etc/nixos/configuration.nix

let
nixos-nemo = fetchGit {
url = "https://github.com/typovrak/nixos-nemo.git";
ref = "main";
rev = "924b68b04123a0716bcd16eaa6c329e13ec148f5"; # update to the desired commit
};
in
{
imports = [
/etc/nixos/hardware-configuration.nix # system hardware settings
/etc/nixos/variables.nix # defines config.username and other variables, see https://github.com/typovrak/nixos for more details
(import "${nixos-nemo}/configuration.nix")
];
}
```

Once imported, rebuild your system to apply changes
```bash
sudo nixos-rebuild switch
```

### 🍴 Method 2 : Fork

Want to **personalize** this module ?

Fork it and add this custom module in your [main nixos configuration](https://github.com/typovrak/nixos) at ```/etc/nixos/configuration.nix``` using fetchGit
```nix
let
nixos-nemo = fetchGit {
url = "https://github.com//nixos-nemo.git";
ref = "main";
rev = ""; # see below
};
in {
imports = [
/etc/nixos/hardware-configuration.nix # system hardware settings
/etc/nixos/variables.nix # defines config.username and other variables, see https://github.com/typovrak/nixos for more details
(import "${nixos-nemo}/configuration.nix")
];
}
```

Get the latest commit hash by executing
```bash
git clone https://github.com//nixos-nemo.git &&
cd nixos-nemo &&
git log -1 --pretty=format:"%H"
```

## 🎬 Usage

Verify the directory
```bash
ls -ld ~/.config/nemo # drwx------, owned by your user
```

Then launch this file explorer with the ```nemo``` command.

## πŸ“š Learn more

- πŸ“¦ [Nemo GitHub repository](https://github.com/linuxmint/nemo) : Source code, issues and development history.
- πŸ“˜ [Nemo on Arch wiki](https://wiki.archlinux.org/title/Nemo) : Overview, features, dependencies, and customization options.

## 🌐 Discover my NixOS system portal

Dive into [typovrak.tv/nixos](https://typovrak.tv/nixos) Catppuccin mocha green themed **gateway** to my GitHub and NixOS setup.

Browse **every module**, example and config in a sleek with an interactive interface that feels just like your desktop.

## ❀️ Support

If this module saved you time, please ⭐️ the repo and share feedback.
You can also support me on β˜• [Buy me a coffee](https://typovrak.tv/coffee)

## πŸ’¬ Join the Typovrak community on Discord πŸ‡«πŸ‡·

If you've ever ```rm -rf```ed your config by mistake or rebuilt for the 42nd time because a semicolon was missing…

You're not alone, **Welcome home !**

🎯 [Join us on Discord »](https://typovrak.tv/discord)

🧭 What you’ll find is :

- ```πŸ’» #nixos-setup``` - get help with modules, rebuilds and configs.
- ```🌐 #web-dev``` - talk JS, TypeScript, React, Node and more.
- ```🧠 #open-source``` - share your repos, contribute to others and discuss FOSS culture.
- ```⌨️ #typing``` - layouts, mechanical keyboards and speed goals.
- ```🎨 #ricing``` - dotfiles, theming tips and desktop screenshots.

*Everyone's welcome no matter how many times you've broken your system ~~(except for Windows users)~~ πŸ˜„*

---

Made with πŸ’œ by typovrak