|Version| |License| |Translations|
udiskie is a udisks2_ front-end that allows to manage removable media such as CDs or flash drives from userspace.
|Screenshot|
Its features include:
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 the 1.7.X
releases or the maint-1.7 branch.
.. _udisks2: https://www.freedesktop.org/wiki/Software/udisks
Documentation_
Debug Info_Man page_
Source Code_
Latest Release_
Issue Tracker_
.. _Documentation: https://github.com/coldfix/udiskie/wiki .. _Usage: https://github.com/coldfix/udiskie/wiki/Usage .. _Installation: https://github.com/coldfix/udiskie/wiki/Installation .. _Debug Info: https://github.com/coldfix/udiskie/wiki/Debug-Info .. _Troubleshooting: https://github.com/coldfix/udiskie/wiki/Troubleshooting .. _FAQ: https://github.com/coldfix/udiskie/wiki/FAQ
.. _Man Page: https://raw.githubusercontent.com/coldfix/udiskie/master/doc/udiskie.8.txt .. _Source Code: https://github.com/coldfix/udiskie .. _Latest Release: https://pypi.python.org/pypi/udiskie/ .. _Issue Tracker: https://github.com/coldfix/udiskie/issues .. _Roadmap: https://github.com/coldfix/udiskie/blob/master/HACKING.rst#roadmap
.. Badges:
.. |Version| image:: https://img.shields.io/pypi/v/udiskie.svg :target: https://pypi.python.org/pypi/udiskie :alt: Version
.. |License| image:: https://img.shields.io/pypi/l/udiskie.svg :target: https://github.com/coldfix/udiskie/blob/master/COPYING :alt: License: MIT
.. |Translations| image:: http://weblate.coldfix.de/widgets/udiskie/-/udiskie/svg-badge.svg :target: http://weblate.coldfix.de/engage/udiskie/ :alt: Translations
.. |Screenshot| image:: https://raw.githubusercontent.com/coldfix/udiskie/master/screenshot.png :target: https://raw.githubusercontent.com/coldfix/udiskie/master/screenshot.png :alt: Screenshot
udiskie is developed on github_. 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 API_UDisks2 API_PyGObject APIs_.. _github: https://github.com/coldfix/udiskie
.. _PEP8: http://www.python.org/dev/peps/pep-0008/
.. _unit tests: http://docs.python.org/2/library/unittest.html
.. _UDisks1 API: http://udisks.freedesktop.org/docs/1.0.5/
.. _UDisks2 API: http://udisks.freedesktop.org/docs/latest/
.. _PyGObject APIs: http://lazka.github.io/pgi-docs/index.html
Translations by users are always welcome. The corresponding files are in the
lang_ subfolder. In order to create a new translation, find out the locale
name for your language, e.g. es_ES for Spanish, and create a translation
file in the lang folder as follows::
cd lang
make es_ES.po
or simply copy the udiskie.pot_ to a .po file 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 .po file in submit a
patch, even for very small changes.
In order to test udiskie with your locally edited translation files, type
(still from the lang folder)::
export TEXTDOMAINDIR=$PWD/../build/locale
export LANG=es_ES.UTF-8
make mo
udiskie
.. _lang: https://github.com/coldfix/udiskie/tree/master/lang .. _udiskie.pot: https://raw.githubusercontent.com/coldfix/udiskie/master/lang/udiskie.pot
2.5.7
Date: 11.12.2024
- remove keyutils from CI workflow to avoid failure on python>=3.11
2.5.6
Date: 11.12.2024
setup.py2.5.5
Date: 11.12.2024
- add translations for ``zh_CN``
2.5.4
Date: 11.12.2024
python setup.py installDate: 24.04.2024
device_config)
[thanks @dajt1725]--terminal command line option (was not doing anything) [@dajt1725]2.5.2
Date: 27.01.2024
- drop external dependency on distutils (#278)
- rename ``--notify-command`` to ``--event-hook`` to prevent misunderstandings (#279)
2.5.1
Date: 23.11.2023
2.5.0
Date: 03.10.2023
- add bash completions for CLI options (thanks @oersen)
- updates for translations
- added German translation
- add bright outlines for wayland icons in dark themes
- ignore snap loop devices by default
- maintenance on CI workflows
- fix KeyError when properties are invalidated multiple times (#272)
2.4.2
Date: 01.03.2022
2.4.1
Date: 02.02.2022
- setup loop devices in read-write mode if sufficient permissions are
available
2.4.0
Date: 30.11.2021
TEXTDOMAINDIR
environment variable2.3.3
Date: 05.03.2021
- fix: buttons in "device-added" notifications always mounting the last
partition instead of the selected one
2.3.2
Date: 27.01.2021
2.3.1
Date: 27.01.2021
- add workaround for missing menu checkboxes on sway/wayland
- add workaround for menu not showing up with proper size on sway/wayland
- distribute icons within udiskie package (allows displaying icons in
local/venv installations)
- fix ignored coroutine return values, fixes e.g. program exit code
2.3.0
Date: 22.01.2021
2.2.0
Date: 07.05.2020
- add Italian translation
- remove unneeded ``xdg`` from optional dependencies
- fix a typo in Spanish translation and update russian translation files
2.1.1
Date: 17.04.2020
--appindicator sufficient to show icon (previously additionally
required --tray)--detach option when applied to partitions of loop devices2.1.0
Date: 02.02.2020
- fix 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 with ``HintIgnore``, see #181
- change 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 parent
2.0.4
Date: 21.01.2020
2.0.3
Date: 20.01.2020
- fix exception when using non-device parameters with DeviceCommand
(e.g. in --notify-command)
2.0.2
Date: 30.12.2019
2.0.1
Date: 28.12.2019
- use ``importlib.resources`` directly on py3.7 and above, rather than
requiring ``importlib_resources`` as additional dependency
2.0.0
Date: 26.12.2019
async def functions -- improving stack traces upon exception1.7.7
Date: 17.02.2019
- keep password dialog always on top
- fix stdin-based password prompts
1.7.6
Date: 17.02.2019
1.7.5
Date: 24.05.2018
- fix "NameError: 'Async' is not defined" when starting without tray icon
1.7.4
Date: 17.05.2018
1.7.3
Date: 13.12.2017
- temporary workaround for udisks2.7 requiring ``filesystem-mount-system``
when trying to mount a LUKS cleartext device diretcly after unlocking
1.7.2
Date: 18.10.2017
--password-prompt or udisks1 is used1.7.1
Date: 02.10.2017
- add an "open keyfile" button to the password dialog
- add warning if mounting device without ntfs-3g (#143)
- fix problem with LVM devices
1.7.0
Date: 26.03.2017
device_config list in the config filemount_options and ignore_device in favor of
device_configautomount per device using the new device_config [#107]1.6.2
Date: 06.03.2017
- Show losetup/quit actions only in ex-menu
- Show note in menu if no devices are found
1.6.1
Date: 24.02.2017
udiskie-info utilityudiskie-mount by about a factor
three, for udiskie-umount by about a factor 101.6.0
Date: 22.02.2017
- fix crash on startup if config file is empty
- add ``--notify-command`` to 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.1
Date: 03.06.2016
1.5.0
Date: 03.06.2016
- make systray menu flat (use ``udiskie --tray --menu smart`` to 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 devices
- fix error when force-ejecting device [#121]
- respect configured ignore-rules in ``udiskie-umount``
- fix error message for empty task lists [#123]
1.4.12
Date: 15.05.2016
job_failed notification, as well as the browse
action in the device_mounted notification (#117)1.4.11
Date: 13.05.2016
- protect 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_all
1.4.10
Date: 11.05.2016
1.4.9
Date: 02.04.2016
- add is_loop and loop_file properties for devices
- fix recursive mounting of crypto devices (udiskie-mount)
- prevent empty submenus from showing
1.4.8
Date: 09.02.2016
1.4.7
Date: 04.01.2016
- fix typo that prevents the yaml config file from being used
- fix 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 backend
- fix notifications for devices without labels
1.4.6
Date: 28.12.2015
1.4.5
Date: 24.12.2015
- fix another bug with unicode data on command line (py2)
- slightly improve stack traces in async code
- further decrease verbosity while removing devices
1.4.4
Date: 24.12.2015
1.4.3
Date: 24.12.2015
- fix bug with unicode data on python2
- fix bug due to event ordering in udisks1
- fix bug due to inavailability of device data at specific time
1.4.2
Date: 22.12.2015
1.4.1
Date: 19.12.2015
- fix problem in SmartTray due to recent transition to async
1.4.0
Date: 19.12.2015
1.3.2
- revert "respect the automount flag for devices"
- make dependency on Gtk optional
1.3.1
1.3.0
- add actions to "Device added" notification
- allow to configure which actions should be added to notifications
1.2.1
1.2.0
- use UDisks2 by default
- add --password-prompt command line argument and config file entry
1.1.3
1.1.2
- add key ``device_id`` for matching devices rather than only file systems
- improve documentation regarding dependencies
1.1.1
1.1.0
- implemented internationalization
- added spanish translation
- allow to choose icons from a configurable list
1.0.4
1.0.3
- handle exception if no notification service is installed
1.0.2
1.0.1
- fix crash when calling udiskie without having udisks1 installed
(regression)
1.0.0
0.8.0
- remove the '--filters' parameter for good
- change config format to YAML
- change default config path to $XDG_CONFIG_HOME/udiskie/config.yml
- separate ignore filters from mount option filters
- allow to match multiple attributes against a device (AND-wise)
- allow to overwrite udiskies default handleability settings
- raise exception if --config file doesn't exist
- add --options parameter for udiskie-mount
- simplify local installations
0.7.0
There are some backward incompatible changes, hence the version break:
udiskie.cli, udiskie.config and udiskie.tray0.6.4
- fix logging in setup.py
- more verbose log messages (with time) when having -v on
- fix 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)
0.6.2 (aesthetic)
- add custom icons for the context menu of the system tray widget
0.6.1 (bug fix)
~~~~~~~~~~~~~~~
- fix udisks2 external device detection bug: all devices were considered
external when using ``Sniffer`` (as done in the udiskie-mount and
udiskie-umount tools)
0.6.0 (udisks2 support, bug fix)
0.5.3 (feature, bug fix)
- add '__ignore__' config file option to prevent handling specific devices
- delay notifications until termination of long operations
0.5.2 (tray icon)
~~~~~~~~~~~~~~~~~
- add tray icon (pygtk based)
- eject / detach drives from command line
0.5.1 (mainly internal changes)
0.5.0 (LUKS support)
- support for LUKS devices (using zenity for password prompt)
- major refactoring
- use setuptools as installer
FAQs
Removable disk automounter for udisks
We found that udiskie demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
PyPI confirms no security flaws were exploited in the Ultralytics supply chain attack and highlights improvements for safer package publishing.
Security News
Research
The Socket Research Team breaks down a malicious wrapper package that uses obfuscation to harvest credentials and exfiltrate sensitive data.
Research
Security News
Attackers used a malicious npm package typosquatting a popular ESLint plugin to steal sensitive data, execute commands, and exploit developer systems.