68 lines
2.0 KiB
Markdown
68 lines
2.0 KiB
Markdown
# ouch.yazi
|
|
|
|
[ouch](https://github.com/ouch-org/ouch) plugin for [Yazi](https://github.com/sxyazi/yazi).
|
|
|
|
|
|
|
|
## Features
|
|
- Archive preview
|
|
- Compression
|
|
|
|
## Installation
|
|
|
|
```bash
|
|
# Linux/macOS
|
|
git clone https://github.com/ndtoan96/ouch.yazi.git ~/.config/yazi/plugins/ouch.yazi
|
|
|
|
# Windows
|
|
git clone https://github.com/ndtoan96/ouch.yazi.git %AppData%\yazi\config\plugins\ouch.yazi
|
|
```
|
|
|
|
Make sure you have [ouch](https://github.com/ouch-org/ouch) installed and in your `PATH`.
|
|
|
|
## Usage
|
|
|
|
### Preview
|
|
For archive preview, add this to your `yazi.toml`:
|
|
|
|
```toml
|
|
[plugin]
|
|
prepend_previewers = [
|
|
# Archive previewer
|
|
{ mime = "application/*zip", run = "ouch" },
|
|
{ mime = "application/x-tar", run = "ouch" },
|
|
{ mime = "application/x-bzip2", run = "ouch" },
|
|
{ mime = "application/x-7z-compressed", run = "ouch" },
|
|
{ mime = "application/x-rar", run = "ouch" },
|
|
{ mime = "application/x-xz", run = "ouch" },
|
|
]
|
|
```
|
|
|
|
Now go to an archive on Yazi, you should see the archive's content in the preview pane. You can use `Alt-j` and `Alt-k` to roll up and down the preview.
|
|
|
|
If you want to change the icon or the style of text, you can modify the `peek` function in `init.lua` file (all of them are stored in the `lines` variable).
|
|
|
|
### Compression
|
|
For compession, add this to your `keymap.toml`:
|
|
|
|
```toml
|
|
[[manager.prepend_keymap]]
|
|
on = ["C"]
|
|
run = "plugin ouch --args=zip"
|
|
desc = "Compress with ouch"
|
|
```
|
|
|
|
The `--args=zip` part tells the plugin that default format is `zip`. You can change that to whatever format you want.
|
|
|
|
### Decompression
|
|
This plugin does not provide a decompression feature because it already is supported by Yazi.
|
|
To decompress with `ouch`, configure the opener in `yazi.toml`.
|
|
|
|
```toml
|
|
[opener]
|
|
extract = [
|
|
{ run = 'ouch d -y "%*"', desc = "Extract here with ouch", for = "windows" },
|
|
{ run = 'ouch d -y "$@"', desc = "Extract here with ouch", for = "unix" },
|
|
]
|
|
```
|