Plugins
Tildr provides native integration with popular Linux file managers through plugins, allowing you to manage your files directly from the context menu without using the terminal.
Nautilus
Integration with Nautilus (GNOME Files) is done via nautilus-python, a Python extension API that allows adding custom items to the context menu.
Requirements
| Distribution | Package |
|---|---|
| Arch Linux | python-nautilus |
| Debian / Ubuntu / Mint | python3-nautilus |
| Fedora | nautilus-python |
Install with your package manager:
# Arch Linux
sudo pacman -S python-nautilus
# Debian/Ubuntu
sudo apt install python3-nautilus
# Fedora
sudo dnf install nautilus-python
Features
- Context menu with submenu Tildr → Add / Unlink / Restore
- Supports single and multiple file selection
- Available only for files and symlinks (not directories)
- Only appears inside the user’s home directory (
~/)
Manual Installation
mkdir -p ~/.local/share/nautilus/python-extensions
curl -fsSL https://raw.githubusercontent.com/orbitbits/tildr/main/tools/plugins/nautilus/tildr.py \
-o ~/.local/share/nautilus/python-extensions/tildr.py
nautilus -q
Restart Nautilus
After installation, restart Nautilus:
nautilus -q
Or log out and log back in.
Troubleshooting
Plugin not appearing in context menu:
- Verify the plugin is installed:
ls -la ~/.local/share/nautilus/python-extensions/tildr.py - Check Nautilus version:
nautilus --version - Restart Nautilus:
nautilus -q - Check for errors in the terminal:
nautilus --no-desktop 2>&1 | grep -i tildr
Permission denied errors:
Ensure the plugin file is executable:
chmod +x ~/.local/share/nautilus/python-extensions/tildr.py
Dolphin
Integration with Dolphin (KDE) is done via KIO Service Menus, a .desktop file mechanism that adds custom actions to the context menu. No additional dependencies are required beyond Dolphin itself.
Features
- Context menu with submenu Tildr → Add / Unlink / Restore
- Supports single and multiple file selection
- Available for files and symlinks
Manual Installation
mkdir -p ~/.local/share/kio/servicemenus
curl -fsSL https://raw.githubusercontent.com/orbitbits/tildr/main/tools/plugins/dolphin/tildr.desktop \
-o ~/.local/share/kio/servicemenus/tildr.desktop
No restart required — Dolphin picks up new service menus automatically.
Troubleshooting
Plugin not appearing in context menu:
- Verify the desktop file is installed:
ls -la ~/.local/share/kio/servicemenus/tildr.desktop - Check the desktop file syntax:
cat ~/.local/share/kio/servicemenus/tildr.desktop - Restart Dolphin:
dolphin --quit dolphin
Desktop file validation:
desktop-file-validate ~/.local/share/kio/servicemenus/tildr.desktop
Automatic Installation
Both plugins are installed automatically by the Tildr installer script when the respective file manager is detected on the system:
curl -fsSL https://orbitbits.github.io/tildr/linux.sh | sh
If the file manager is not installed at the time of Tildr installation, you can install the plugin manually at any time using the commands above.
Plugin Limitations
| Feature | Nautilus | Dolphin |
|---|---|---|
| Add | Yes | Yes |
| Unlink | Yes | Yes |
| Restore | Yes | Yes |
| Directories | No | No |
| Outside $HOME | No | No |
| Multiple selection | Yes | Yes |
Disabling Plugins
To remove a plugin:
Nautilus:
rm ~/.local/share/nautilus/python-extensions/tildr.py
nautilus -q
Dolphin:
rm ~/.local/share/kio/servicemenus/tildr.desktop
No restart required for Dolphin.
Alternative File Managers
If your file manager is not supported by a native plugin, you can:
- Use the CLI directly (
tildr add,tildr unlink,tildr restore) - Create a custom integration using the Tildr CLI
- Request support by opening an issue on the GitHub repository