Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/maximtrp/ranger-archives
Ranger Plugin for Creating and Extracting Archives
https://github.com/maximtrp/ranger-archives
extracting-archives python ranger ranger-archives ranger-fm ranger-plugin shortcuts
Last synced: about 23 hours ago
JSON representation
Ranger Plugin for Creating and Extracting Archives
- Host: GitHub
- URL: https://github.com/maximtrp/ranger-archives
- Owner: maximtrp
- License: mit
- Created: 2020-03-07T15:16:21.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2024-04-18T15:27:38.000Z (7 months ago)
- Last Synced: 2024-08-03T18:21:05.320Z (3 months ago)
- Topics: extracting-archives, python, ranger, ranger-archives, ranger-fm, ranger-plugin, shortcuts
- Language: Python
- Homepage:
- Size: 29.3 KB
- Stars: 94
- Watchers: 2
- Forks: 5
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- ranger-awesome - ranger-archives
README
# ranger-archives
This is a plugin for [ranger](https://ranger.github.io) file manager that makes it much easier to compress and extract archives. It depends on archivers/compression programs such as `tar`, `zip`, `7z`, etc. It also supports and prioritizes parallelized versions of compression programs (like `pbzip2`, `pigz`, `pixz`, etc).
[](https://asciinema.org/a/ii764wsN8rWZfMCwVlnJAWcPM)
## Donate
If you find this plugin useful, please consider donating any amount of money. This will help me spend more time on supporting open-source software.
## Installation
Clone this repo into ranger plugins folder. In Linux, it is typically located here: `~/.config/ranger/plugins`.
```bash
cd ~/.config/ranger/plugins
git clone https://github.com/maximtrp/ranger-archives.git
```
## Usage
The following commands are available:
* `:extract [DIRECTORY]`: extracting files to a current or specified directory (optional).
* `:extract_raw [FLAGS]`: extracting files with specific flags (optional).
* `:extract_to_dirs [FLAGS]`: extracting each archive to a separate directory. E.g.: `1.zip` to dir `1`, `2.zip` to dir `2`, etc.
* `:compress [FLAGS] [FILENAME.EXT]`: compressing selected/marked files/directories to an archive. If an archive filename is not specified, it will be named after a parent dir.
## Examples
### Extraction
#### Basic
Select an archive and type:
```
:extract some_dir
```
Or even just:
```
:extract
```
#### Using flags
This is an example of extracting a zip archive to a directory `dirname` and escaping all non-ASCII Unicode chars:
```
:extract_raw -U -d dirname
```
### Compression
#### Basic
Select a file or a folder (or multiple files and folder) in *ranger* and enter:
```
:compress files.zip
```
or (use quotation marks with filenames containing spaces)
```
:compress "my important files.zip"
```
#### Using flags
`zip` archiver provides a flag for better compression ratio `-9` (just like `gzip` and many others).
We can just add it before an archive filename:
```
:compress -9 file.zip
```
The other flags can be used likewise.
## Shortcuts
You can also add these lines to `~/.config/ranger/rc.conf` to use these keyboard shortcuts (`ec`, `ex`):
```
map ex extract
map ec compress
```