ZPermissions

Cross-platform file permission manager — built for power users who refuse to guess chmod values.

🌐 Website · 📦 Releases · 🐛 Issues

---

What Is ZPermissions?

ZPermissions is a desktop GUI for reading and modifying file system permissions across Linux, macOS, and Windows — without touching the terminal. It wraps POSIX chmod/chown, Unix ACLs, and Windows file attributes in a spatial dossier interface designed around a staged-changes workflow: you build up a set of changes, review them, and apply atomically — or discard everything and start over.

No cloud. No accounts. No telemetry. Runs entirely on your machine.

---

Features

Feature	Linux	macOS	Windows
POSIX mode bits (chmod)	✅	✅	—
Octal + symbolic notation	✅	✅	—
setUID / setGID / sticky bit	✅	✅	—
Owner & group display	✅	✅	✅
Windows file attributes	—	—	✅
Full ACL editor	🔜	🔜	🔜
Staged change workflow	✅	✅	✅
Protected path guard	✅	✅	✅
Pinned quick-access locations	✅	✅	✅
Custom right-click context menu	✅	✅	✅
Native link opening	✅	✅	✅

---

Installation

Linux

AppImage — universal, no install required

chmod +x ZPermissions_*.AppImage
./ZPermissions_*.AppImage

Works on any x86_64 Linux distribution.

Debian / Ubuntu / Mint / Pop!_OS

sudo dpkg -i ZPermissions_*.deb

Fedora / RHEL / CentOS / openSUSE

sudo rpm -i ZPermissions_*.rpm

macOS

Download the .dmg for your chip, open it, drag ZPermissions to /Applications.

Chip	File
Apple Silicon (M1 / M2 / M3 / M4)	ZPermissions_*_aarch64.dmg
Intel	ZPermissions_*_x64.dmg

Note

macOS may show a Gatekeeper warning on first launch. Right-click the app → Open to bypass it.

Windows

NSIS Installer — recommended

Run ZPermissions_*_x64-setup.exe. Installs to the current user — no admin elevation required.

MSI Package — enterprise / silent install

msiexec /i ZPermissions_*_x64_en-US.msi /quiet

Note

Windows 10 (1903+) and Windows 11 are supported. WebView2 is installed silently on first run if not already present.

---

Building from Source

Prerequisites

Tool	Version
Rust	stable toolchain
pnpm	9+
Tauri prerequisites	platform build tools

Important

Linux requires additional system packages before building:

sudo apt-get install libwebkit2gtk-4.1-dev libappindicator3-dev librsvg2-dev patchelf

Steps

git clone https://github.com/TheHolyOneZ/ZPermission.git
cd ZPermission

pnpm install

# Development — hot reload
pnpm tauri dev

# Production build
pnpm tauri build

Bundles land in src-tauri/target/release/bundle/.

Verify

# TypeScript
pnpm tsc --noEmit

# Rust
cd src-tauri && cargo check

---

Tech Stack

Layer	Technology
Backend	Rust (stable)
Desktop bridge	Tauri v2
Frontend	React 18 + TypeScript
State management	Zustand v5
Animations	Framer Motion v11
Styling	Tailwind CSS v4
Font	JetBrains Mono

---

Architecture

ZPermission/
├── .github/workflows/
│   └── release.yml               # CI/CD — builds all platforms on tag push
├── src/                          # React frontend
│   ├── components/
│   │   ├── layout/               # AppShell, TopBar, DossierPanel
│   │   ├── library/              # File navigator + pinned locations
│   │   ├── dossier/              # Permission matrix, view toggle
│   │   ├── identity/             # Identity cards, ACL rows
│   │   ├── about/                # About modal
│   │   └── ui/                   # Custom context menu
│   ├── store/                    # Zustand stores
│   ├── hooks/                    # usePermissions, useClock
│   └── types/                    # Shared TypeScript types
└── src-tauri/
    ├── src/
    │   ├── commands.rs           # Tauri commands
    │   ├── lib.rs                # App builder + plugin registration
    │   └── permissions/
    │       ├── types.rs          # Shared data structs
    │       ├── unix.rs           # Linux + macOS (POSIX)
    │       └── windows.rs        # Windows (file attributes)
    ├── capabilities/
    │   └── default.json          # Tauri v2 permission grants
    └── tauri.conf.json           # Bundle config (icons, targets, signing)

---

Protected Paths

Caution

ZPermissions hard-blocks writes to these paths on every platform. This cannot be overridden from the UI.

Linux: /proc · /sys · /dev · /run · /boot

macOS: /System · /System/Library · /usr/bin · /usr/sbin · /sbin · /bin · /private/etc · /private/var

Windows: C:\Windows\System32 · C:\Windows\SysWOW64 · C:\Windows\WinSxS

---

License

ZPermissions is free software released under the GNU General Public License v3.0.

Copyright (C) 2026 TheHolyOneZ

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

See LICENSE for the full text.