Uninstall and Cleanup Guide
This guide provides detailed instructions for completely removing nemo-git-integration from your system.
Table of Contents
- Overview
- Quick Uninstall
- Comprehensive Cleanup
- Verification
- Troubleshooting
- Manual Cleanup
- Forcing Nemo to Reload
Overview
The nemo-git-integration package can be installed in two ways:
- System-wide (via
.debpackage): Files installed to/usr/share/,/etc/xdg/ - User-local (via
install.sh): Files installed to~/.local/,~/.config/
Complete removal requires:
- Removing installed files
- Clearing Nemo caches
- Forcing Nemo to reload configuration
Quick Uninstall
For User-Local Installation
./uninstall.sh
This will:
- Remove all
.nemo_actionfiles - Remove script directories
- Remove Python extensions
- Remove configuration files
- Clear Nemo cache
- Restart Nemo
For System-Wide Installation (Debian Package)
sudo apt-get purge nemo-git-integration
Or:
sudo dpkg --purge nemo-git-integration
The purge operation ensures complete removal including configuration files.
Comprehensive Cleanup
If the standard uninstall leaves residual files, use the comprehensive cleanup script:
Clean User-Local Installation Only
./uninstall.sh
Clean System-Wide Installation Only
sudo ./uninstall.sh --system
Clean Both User-Local and System-Wide
./uninstall.sh --all
Note: This requires sudo for system-wide cleanup.
Verification
After uninstalling, verify complete removal:
./uninstall.sh --verify
This script checks:
- System-wide locations (
/usr/share/,/etc/xdg/) - User-local locations (
~/.local/,~/.config/) - Running Nemo processes
Expected Output
If successful:
✓ All nemo-git-integration files successfully removed!
If files remain:
✗ Found N remaining file(s) or directory(ies).
Troubleshooting
Git Menu Items Still Appear After Uninstall
Cause: Nemo caches action files and doesn’t automatically reload.
Solutions (try in order):
-
Clear cache and restart Nemo:
rm -rf ~/.cache/nemo nemo -q sleep 2 nemo & -
Log out and log back in: This ensures all Nemo processes are terminated and caches are cleared.
-
Reboot the system: If the above doesn’t work, a full reboot ensures complete cleanup.
Permission Denied Errors
Cause: Trying to remove system files without root privileges.
Solution:
sudo ./uninstall.sh --all --system
Nemo Won’t Restart
Cause: Display environment not available or Nemo already running.
Solution:
# Kill all Nemo processes
killall nemo
# Wait a moment
sleep 2
# Restart Nemo
DISPLAY=:0 nemo &
Files Still Present After Cleanup
Cause: Files installed in non-standard locations or by other tools.
Solution: See Manual Cleanup section.
Manual Cleanup
If automated scripts don’t remove everything, manually check and remove files:
System-Wide Locations
# Check and remove action files
sudo rm -f /usr/share/nemo/actions/git*.nemo_action
# Check and remove script directory
sudo rm -rf /usr/share/nemo-git-integration
# Check and remove Python extension
sudo rm -f /usr/share/nemo-python/extensions/nemo_git_status.py
sudo rm -rf /usr/share/nemo-python/extensions/__pycache__
# Check and remove configuration
sudo rm -f /etc/xdg/nemo/actions/actions-tree.json
# Check and remove icons
sudo rm -f /usr/share/icons/hicolor/scalable/apps/{add-file,construction,create,happy-file,important-file,winking-file}.png
# Update icon cache
sudo gtk-update-icon-cache -f /usr/share/icons/hicolor
User-Local Locations
# Check and remove action files
rm -f ~/.local/share/nemo/actions/git*.nemo_action
# Check and remove script directory
rm -rf ~/.local/share/nemo/nemo-git-integration
# Check and remove Python extension
rm -f ~/.local/share/nemo-python/extensions/nemo_git_status.py
rm -rf ~/.local/share/nemo-python/extensions/__pycache__
# Check and remove configuration
rm -f ~/.config/nemo/actions/actions-tree.json
# Check and remove icons
rm -f ~/.local/share/icons/{add-file,construction,create,happy-file,important-file,winking-file}.png
# Clear Nemo cache
rm -rf ~/.cache/nemo
Forcing Nemo to Reload
Nemo caches configuration and action files. To force a complete reload:
Method 1: Restart Nemo (Quickest)
nemo -q # Quit Nemo
sleep 2 # Wait for complete shutdown
nemo & # Restart in background
Method 2: Clear Cache and Restart
rm -rf ~/.cache/nemo # Remove cache
nemo -q # Quit Nemo
sleep 2 # Wait
nemo & # Restart
Method 3: Log Out and Log Back In
This is the most thorough method:
- Save all work
- Log out of your session
- Log back in
- Nemo will start fresh with no cached data
Method 4: Reboot (Most Thorough)
For complete certainty:
sudo reboot
Method 5: Using Desktop Environment Tools
If using Cinnamon:
- Open System Settings
- Go to “Extensions” or “Nemo Settings”
- Disable/Enable or restart Nemo from there
Validation Checklist for Maintainers
Use this checklist to confirm complete removal:
- Run
./uninstall.sh --verify- all checks pass - Right-click a folder in Nemo - no Git menu items appear
- Check
~/.local/share/nemo/actions/- nogit*.nemo_actionfiles - Check
/usr/share/nemo/actions/- nogit*.nemo_actionfiles - Check
~/.cache/nemo/- directory doesn’t exist or is empty - No
nemo_git_status.pyin~/.local/share/nemo-python/extensions/ - No
nemo_git_status.pyin/usr/share/nemo-python/extensions/ - Nemo restarts without errors
- No nemo-git-integration package in
dpkg -l | grep nemo-git
Advanced: Infrastructure-as-Code Testing
For automated testing in CI/CD:
#!/bin/bash
# Test complete uninstall
# Install the package
./install.sh
# Verify installation
test -f ~/.local/share/nemo/actions/git01a-init.nemo_action
# Uninstall
./uninstall.sh
# Verify removal
./uninstall.sh --verify
EXIT_CODE=$?
# Exit with verification result
exit $EXIT_CODE
File Locations Reference
System-Wide Installation Paths
| Type | Location |
|---|---|
| Action files | /usr/share/nemo/actions/*.nemo_action |
| Shell scripts | /usr/share/nemo-git-integration/s0*/*.sh |
| Python extension | /usr/share/nemo-python/extensions/nemo_git_status.py |
| Configuration | /etc/xdg/nemo/actions/actions-tree.json |
| Icons | /usr/share/icons/hicolor/scalable/apps/*.png |
User-Local Installation Paths
| Type | Location |
|---|---|
| Action files | ~/.local/share/nemo/actions/*.nemo_action |
| Shell scripts | ~/.local/share/nemo/nemo-git-integration/s0*/*.sh |
| Python extension | ~/.local/share/nemo-python/extensions/nemo_git_status.py |
| Configuration | ~/.config/nemo/actions/actions-tree.json |
| Icons | ~/.local/share/icons/*.png |
| Cache | ~/.cache/nemo/ |
Getting Help
If you continue to experience issues after following this guide:
- Check the GitHub Issues
- Run
./uninstall.sh --verifyand include output in your issue report - Provide Nemo version:
nemo --version - Provide OS information:
lsb_release -a
See Also
- README.md - Installation and usage
- debian/postrm - Debian package removal script
- uninstall.sh - Uninstall script (supports –system, –all, –verify flags)