Package: udiskie
udiskieis audisks2front-end that allows to manage removable media such
as CDs or flash drives from userspace.Its features include:automount removable medianotificationstray iconcommand line tools for manual un-/mountingLUKS encrypted devicesunlocking with keyfiles (requires udisks 2.6.4)loop devices (mounting iso archives)password caching (requires python keyutils 0.3)All features can be individually enabled or disabled.NOTE:support for python2 and udisks1 have been removed. If you need a
version of udiskie that supports python2, please check out the1.7.Xreleases or themaint-1.7branch.DocumentationUsageInstallationDebug InfoTroubleshootingFAQMan pageSource CodeLatest ReleaseIssue TrackerHackingudiskieis developed ongithub. Feel free to contribute patches as pull
requests here. If you don’t have nor want a github account, you can send me
the relevant files via email.Further resources:UDisks1 APIUDisks2 APIPyGObject APIsTranslationsTranslations by users are always welcome. The corresponding files are in thelangsubfolder. In order to create a new translation, find out the locale
name for your language, e.g.es_ESfor Spanish, and create a translation
file in thelangfolder as follows:cd lang
make es_ES.poor simply copy theudiskie.potto a.pofile with the name of the
target locale and start editing. It’s also best to fill in your name and email
address.The translations may become outdated as udiskie changes. If you notice an
outdated translation, please edit the corresponding.pofile in submit a
patch, even for very small changes.In order to test udiskie with your locally edited translation files, type
(still from thelangfolder):export TEXTDOMAINDIR=$PWD/../build/locale
export LANG=es_ES.UTF-8

make mo

udiskieCHANGELOG2.5.2Date: 27.01.2024drop external dependency on distutils (#278)rename--notify-commandto--event-hookto prevent misunderstandings (#279)2.5.1Date: 23.11.2023fix default install location for bash completion scripts (#275)fix zsh completion for device names with spaces (#253)2.5.0Date: 03.10.2023add bash completions for CLI options (thanks @oersen)updates for translationsadded German translationadd bright outlines for wayland icons in dark themesignore snap loop devices by defaultmaintenance on CI workflowsfix KeyError when properties are invalidated multiple times (#272)2.4.2Date: 01.03.2022add support for AyatanaAppIndicator3update Turkish translationfix some documentation typos and errors2.4.1Date: 02.02.2022setup loop devices in read-write mode if sufficient permissions are
available2.4.0Date: 30.11.2021add icon name that is specifically designed for tray paneladd Turkish translations (thanks @ersen0!)try to detect installed translation files also in non-system installationsmake it possible to override localedir manually using theTEXTDOMAINDIRenvironment variableadd guide on how to contribute translations and improve the Makefile2.3.3Date: 05.03.2021fix: buttons in “device-added” notifications always mounting the last
partition instead of the selected one2.3.2Date: 27.01.2021fix incorrect use of wayland settings (appindicator+workarounds) within X
session, if a wayland session is or was active under the same user (even if
that was in a different login session)fix incorrect display of image menu items under X due to caching2.3.1Date: 27.01.2021add workaround for missing menu checkboxes on sway/waylandadd workaround for menu not showing up with proper size on sway/waylanddistribute icons within udiskie package (allows displaying icons in
local/venv installations)fix ignored coroutine return values, fixes e.g. program exit code2.3.0Date: 22.01.2021don’t swallow STDOUT for notify-commandsdefault to appindicator if tray is requested under waylanddon’t auto-disable tray when running in “pure” wayland sessionset window role on the password dialog2.2.0Date: 07.05.2020add Italian translationremove unneededxdgfrom optional dependenciesfix a typo in Spanish translation and update russian translation files2.1.1Date: 17.04.2020handle XDG_CONFIG_HOME variable without external pyxdg dependencysilence warning when using AppIndicatormake--appindicatorsufficient to show icon (previously additionally
required--tray)improve wording in password dialog “Remember” -> “Cache”make some of the logging more concisefix recursive adding/removing of some child devices:fix incorrect root device detection for devices without Drive property
(e.g. children of loop devices)fix--detachoption when applied to partitions of loop devices2.1.0Date: 02.02.2020fix some typos (thanks @torstehu, #197)change how device rules are evaluated: lookup undecided rules on parent
device (fixes issue with filters not applying to subdevices of a matched
device, see #198)change builtin rules to not show loop devices withHintIgnore, see #181change how is_external attribute is compute: use the value from udisks
directly (fixes issue with is_external property not behaving as expected,
see #185)add ‘skip’ keyword for rules to skip evaluation of further rules on this
device, and continue directly on the parent2.0.4Date: 21.01.2020fix user commands that output non-utf8 data2.0.3Date: 20.01.2020fix exception when using non-device parameters with DeviceCommand
(e.g. in –notify-command)2.0.2Date: 30.12.2019hotfix for automounting being broken since 2.0.02.0.1Date: 28.12.2019useimportlib.resourcesdirectly on py3.7 and above, rather than
requiringimportlib_resourcesas additional dependency2.0.0Date: 26.12.2019require python >= 3.5drop python2 supportdrop udisks1 supportdrop command line options corresponding to udisks version selection (-1, -2)use py35’sasync deffunctions – improving stack traces upon exceptioninternal refactoring and simplificationsadd “show password” checkbox in password dialog1.7.7Date: 17.02.2019keep password dialog always on topfix stdin-based password prompts1.7.6Date: 17.02.2019add russian translations (thanks @mr-GreyWolf)fixed deprecation warnings in setup.py (thanks @sealj553)1.7.5Date: 24.05.2018fix “NameError: ‘Async’ is not defined” when starting without tray icon1.7.4Date: 17.05.2018fix attribute error when using options in udiskie-mount (#159)fix tray in appindicator mode (#156)possibly fix non-deterministic bugs (due to garbage collection) by keeping
global reference to all active asyncs1.7.3Date: 13.12.2017temporary workaround for udisks2.7 requiringfilesystem-mount-systemwhen trying to mount a LUKS cleartext device diretcly after unlocking1.7.2Date: 18.10.2017officially deprecate udisks1officially deprecate python2 (want python >= 3.5)fix startup crash on py2fix exception when inserting LUKS device if--password-promptor udisks1 is usedfix minor problem with zsh autocompletion1.7.1Date: 02.10.2017add an “open keyfile” button to the password dialogadd warning if mounting device without ntfs-3g (#143)fix problem with LVM devices1.7.0Date: 26.03.2017add joineddevice_configlist in the config filedeprecatemount_optionsandignore_devicein favor ofdevice_configcan configureautomountper device using the newdevice_config[#107]can configure keyfiles (requires udisks 2.6.4) [#66]remove mailing list1.6.2Date: 06.03.2017Show losetup/quit actions only in ex-menuShow note in menu if no devices are found1.6.1Date: 24.02.2017add format strings for the undocumentedudiskie-infoutilityspeed up autocompletion times, forudiskie-mountby about a factor
three, forudiskie-umountby about a factor 101.6.0Date: 22.02.2017fix crash on startup if config file is emptyadd--notify-commandto notify external programs (@jgraef) [#127]can enable/disable automounting via special right-click menu [#98]do not explicitly specify filesystem when mounting [#131]1.5.1Date: 03.06.2016fix unicode issue that occurs on python2 when stdout is redirected (in
particular for zsh autocompletion)1.5.0Date: 03.06.2016make systray menu flat (useudiskie--tray--menusmartto request the
old menu) [#119]extend support for loop devices (requires UDisks2) [#101]support ubuntu/unity AppIndicator backend for status icon [#59]add basic utility to obtain info on block devices [#122]add zsh completions [#26]improve UI menu labels for devicesfix error when force-ejecting device [#121]respect configured ignore-rules inudiskie-umountfix error message for empty task lists [#123]1.4.12Date: 15.05.2016log INFO events to STDOUT (#112)fix exception in notifications when action is not available. This concerns
the retry button in thejob_failednotification, as well as the browse
action in thedevice_mountednotification (#117)don’t show ‘browse’ action in tray menu if unavailable1.4.11Date: 13.05.2016protect password dialog against garbage collection (which makes the invoking
coroutine hang up and not unlock the device)fix add_all/remove_all operations: only consider leaf/root devices within
the handleable devices hierarchy:avoid considering the same device twice (#114)makes sure every handleable device is considered at all in remove_all1.4.10Date: 11.05.2016signal failing mount/unmount operations with non-zero exit codes (#110)suppress notifications for unhandled devicesadd rules for docker devices marking them unhandled to avoid excessive
notifications (#113)allow mounting/unmounting using UUID (#90)prevent warning when starting without X session (#102)can now match against wildcards in config rules (#49)1.4.9Date: 02.04.2016add is_loop and loop_file properties for devicesfix recursive mounting of crypto devices (udiskie-mount)prevent empty submenus from showing1.4.8Date: 09.02.2016fix problem with setupscript if utf8 is not the default encodingfix crash when starting without Xbasic support for loop devices (must be enabled explicitly at this time)fix handling of 2 more error cases1.4.7Date: 04.01.2016fix typo that prevents the yaml config file from being usedfix problem with glib/gio gir API on slackware (olders versions?)fix bug when changing device state (e.g. when formatting existing device or
burning ISO file to device)improve handling of race conditions with udisks1 backendfix notifications for devices without labels1.4.6Date: 28.12.2015cleanup recent bugfixesclose some gates for more py2/unicode related bugs1.4.5Date: 24.12.2015fix another bug with unicode data on command line (py2)slightly improve stack traces in async codefurther decrease verbosity while removing devices1.4.4Date: 24.12.2015fix too narrow dependency enforcementmake udiskie slightly less verbose in default mode1.4.3Date: 24.12.2015fix bug with unicode data on python2fix bug due to event ordering in udisks1fix bug due to inavailability of device data at specific time1.4.2Date: 22.12.2015fix regression in get_password_tty1.4.1Date: 19.12.2015fix problem in SmartTray due to recent transition to async1.4.0Date: 19.12.2015go async (with self-made async module for now, until gbulb becomes ready)specify GTK/Notify versions to be imported (hence fix warnings and a problem
for the tray icon resulting from accidentally importing GTK2)add optional password caching1.3.2revert “respect the automount flag for devices”make dependency on Gtk optional1.3.1use icon hints from udev settings in notificationsrespect the automount flag for devicesdon’t fail if libnotify is not available1.3.0add actions to “Device added” notificationallow to configure which actions should be added to notifications1.2.1fix unicode issue in setup scriptupdate license/copyright notices1.2.0use UDisks2 by defaultadd –password-prompt command line argument and config file entry1.1.3fix password prompt for GTK2 (tray is still broken for GTK2)fix minor documentation issues1.1.2add keydevice_idfor matching devices rather than only file systemsimprove documentation regarding dependencies1.1.1fix careless error in man page1.1.0implemented internationalizationadded spanish translationallow to choose icons from a configurable list1.0.4compatibility with older version of pygobject (e.g. in Slackware 14.1)1.0.3handle exception if no notification service is installed1.0.2fix crash when calling udiskie mount/unmount utilites without udisks1
installed1.0.1fix crash when calling udiskie without having udisks1 installed
(regression)1.0.0port to PyGObject, removing dependencies on pygtk, zenity, dbus-python,
python-notifyuse a PyGObject based password dialogremove –password-prompt parameterrename command line parametersadd negations for all command line parameters0.8.0remove the ‘–filters’ parameter for goodchange config format to YAMLchange default config path to $XDG_CONFIG_HOME/udiskie/config.ymlseparate ignore filters from mount option filtersallow to match multiple attributes against a device (AND-wise)allow to overwrite udiskies default handleability settingsraise exception if –config file doesn’t existadd –options parameter for udiskie-mountsimplify local installations0.7.0There are some backward incompatible changes, hence the version break:command line parameter ‘-f’/’–filters’ renamed to ‘-C’/’–config’add sections in config file to disable individual mount notifications and
set defaults for some program options (udisks version, prompt, etc)refactorudiskie.cli,udiskie.configandudiskie.trayrevert ‘make udiskie a namespace package’add ‘Browse folder’ action to tray menuadd ‘Browse folder’ action button to mount notificationsadd ‘–no-automounter’ command line option to disable automountingadd ‘–auto-tray’ command line option to use a tray icon that
automatically disappears when no actions are availableshow notifications when devices dis-/appear (can be disabled via config
file)show ‘id_label’ in tray menu, if available (instead of mount path or
device path)add ‘Job failed’ notificationsadd ‘Retry’ button to failed notificationsremove automatic retries to unlock LUKS partitionspass only device name to external password promptadd ‘–quiet’ command line optionignore devices ignored by udev rules0.6.4fix logging in setup.pymore verbose log messages (with time) when having -v onfix mounting devices that are added as ‘external’ and later changed to
‘internal’ [udisks1] (applies to LUKS devices that are opened by an udev
rule for example)0.6.3 (bug fix)fix exception in Mounter.detach_device if unable to detachfix force-detach for UDisks2 backendautomatically use UDisks2 if UDisks1 is not availablemount unlocked devices only once, removes error message on UDisks2mention __ignore__ in man page0.6.2 (aesthetic)add custom icons for the context menu of the system tray widget0.6.1 (bug fix)fix udisks2 external device detection bug: all devices were considered
external when usingSniffer(as done in the udiskie-mount and
udiskie-umount tools)0.6.0 (udisks2 support, bug fix)cache device states to avoid some race conditionsshow filesystem label in mount/unmount notificationsretry to unlock LUKS devices when wrong password was entered twiceshow ‘eject’ only if media is available (udisks1 ejects only in this case)(un-) mount/lock notifications shown even when operations failedrefactor internal APIexperimental support for udisks20.5.3 (feature, bug fix)add ‘__ignore__’ config file option to prevent handling specific devicesdelay notifications until termination of long operations0.5.2 (tray icon)add tray icon (pygtk based)eject / detach drives from command line0.5.1 (mainly internal changes)use setuptools entry points to create the executablesmake udiskie a namespace package0.5.0 (LUKS support)support for LUKS devices (using zenity for password prompt)major refactoringuse setuptools as installer