ranger_udisk_menu/README.md

43 lines
1.5 KiB
Markdown
Raw Normal View History

2021-04-25 20:11:15 +02:00
# Ranger udisk menu
This script draws menu to mount and unmount partitions using udisksctl and ncurses
2021-04-25 20:26:38 +02:00
![Screenshot](screenshot.png)
2021-04-25 20:11:15 +02:00
# Requirements
- python3.8 or newer
2021-04-25 20:11:15 +02:00
- udisks2 (for udisksctl)
- lsblk 2.3 or newer
2021-04-25 20:11:15 +02:00
# How to install
Firstly you need to clone this repo to the plugins directory of ranger
2021-04-25 20:11:15 +02:00
```Bash
cd ~/.config/ranger/plugins
2021-04-25 20:11:15 +02:00
git clone https://github.com/SL-RU/ranger_udisk_menu
```
2021-04-25 20:13:13 +02:00
Then you need to add to `~/.config/ranger/commands.py` line:
2021-04-25 20:11:15 +02:00
```Python3
from plugins.ranger_udisk_menu.mounter import mount
2021-04-25 20:11:15 +02:00
```
Thats all
# How to use
Enter in ranger `:mount`, than will be shown menu. In this menu you can press:
- `j` or `arrow down` or `Ctrl+n` to move selection down
- `k` or `arrow up` or `Ctrl+p` to move selection up
- `Ctrl+g` or `Esc` or `q` to quit
- `g` or `r` to refresh all partitions and drives
- `m` to mount selected partition
- `u` to unmount selected partition
- `e` to unmount all partitions of selected partition's drive
2021-06-12 14:52:06 +02:00
- `p` to power off selected the selected partition's drive (also called safely remove). It can be done only when all partitions of the drive are unmounted
- `ENTER` to open selected mountpoint in current tab of the ranger
# Troubles
If there is trouble with permissions, then you need to create group `storage` and add your user to it. Then you need to update your Polkit or PolicyKit permissions like it shown [here: https://github.com/coldfix/udiskie/wiki/Permissions](https://github.com/coldfix/udiskie/wiki/Permissions)