Contributions are welcome! Here's how to get started.
- Fork this repository
- Create a branch for your change (
git checkout -b feat/my-feature) - Make your changes
- Test locally (see below)
- Commit with a clear message (
feat: add Xorfix: resolve Y) - Open a Pull Request
- PHP 8.2+
- Python 3.10+ (for the hotplug daemon)
- Nextcloud 34 development environment
- Composer 2.x
pyudevanddbus-python(daemon dependencies)
cd app
composer install
# Daemon dependencies
pip install pyudev dbus-python# Static analysis
./vendor/bin/phpstan analyse --level 5# Symlink the app
ln -s /path/to/devnull/app /var/www/nextcloud/apps/devnull
# Enable it
sudo -u www-data php occ app:enable devnull
# Run the daemon (needs root for udev)
sudo python3 daemon/devnull_daemon.pyWe follow Conventional Commits:
feat:— new featurefix:— bug fixdocs:— documentation onlychore:— maintenance, deps, CI
- Bug fixes with evidence (logs, screenshots, steps to reproduce)
- New features discussed in an Issue first
- Documentation improvements
- Support for additional filesystem types or device classes
- Breaking changes without prior discussion
- Code without testing instructions
- PRs that mix unrelated changes
- Direct commits to
master— always use a PR
- NC App (PHP): mount management, scan jobs, deduplication, dashboard widget
- Daemon (Python): pyudev hotplug detection, dbus bridge to NC app
- Storage: Nextcloud user filesystem (not AppData)
- Dedup: SHA-256 fingerprinting before import
Open an Issue. We'll respond as soon as possible.