-
Couldn't load subscription status.
- Fork 56
Usage
The udiskie daemon must be running for automounting to function, the most common way to run udiskie as a daemon is by adding this to your window manager's startup applications (consult your window manager's documentation) or .xinitrc:
udiskie &This will start udiskie as a background process with default settings (automounting enabled).
Udiskie provides four main commands:
-
udiskie- The main daemon -
udiskie-mount- For mounting devices -
udiskie-umount- For unmounting devices -
udiskie-info- For getting information about devices
Common usage examples:
# Mount all available devices
udiskie-mount -a
# Mount a specific device
udiskie-mount /dev/sdb1
# Unmount a mounted device
udiskie-umount /media/USERNAME/DEVICENAME
# Unmount and power down a USB device
udiskie-umount --detach /media/USERNAME/DEVICENAME
# Unmount all mounted devices
udiskie-umount -a
# List all handleable devices
udiskie-info -aThe file '~/.config/udiskie/config.yml' can be used to configure udiskie defaults for command line parameters and customize further settings. The actual path may differ depending on '$XDG_CONFIG_HOME'.
- If you don't want to install PyYAML, it is possible to use an equivalent JSON file with the name 'config.json' instead.
Here's a very basic configuration example, man udiskie for complete documentation:
program_options:
tray: true # Show tray icon
notify: true # Enable notifications
automount: true # Enable automatic mounting
file_manager: xdg-open # Program to open mounted directories
device_config:
# Example: Special options for specific devices
- id_uuid: "your-device-uuid"
options: [noexec, nodev]
ignore: false
automount: false
notifications:
timeout: 1.5 # Notification timeout in seconds
device_mounted: 5 # Show mount notifications for 5 seconds-
--no-automount- Disable automatic mounting -
--no-notify- Disable notifications -
--tray- Show tray icon -
--smart-tray- Show tray icon only when actions are available -
--password-cache MINUTES- Cache LUKS passwords for specified duration
-
-a, --all- Mount all available devices -
-r, --recursive- Recursively mount LUKS partitions after unlocking -
-o OPTIONS- Specify mount options
-
-d, --detach- Power down the device after unmounting -
-e, --eject- Eject media (for optical drives) -
-f, --force- Force unmount -
-l, --lock- Lock encrypted devices after unmounting
- By default, devices are mounted under
/media/USERNAME/or/run/media/USERNAME/ - LUKS devices require password input unless password caching is enabled
- Mount options can be used to restrict execute permissions and device files
-
man udiskiefor complete documentation