conceal 0.6.1

Command line recycle bin
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77

<h1 align="center">🌠 conceal 🌃</h1>

<p align="center">
  <a href="https://crates.io/crates/conceal"><img src="https://img.shields.io/crates/v/conceal.svg?style=flat-square" /></a>
  <a href="https://crates.io/crates/conceal"><img src="https://img.shields.io/crates/d/conceal.svg?style=flat-square" /></a>
</p>

## Introduction

**conceal** is a command line tool based on [trash-rs](https://github.com/Byron/trash-rs) which implements [The FreeDesktop.org Trash specification](https://specifications.freedesktop.org/trash-spec/trashspec-latest.html).

You can use **conceal** to:
- **Throw** the files **in** the recycle bin
- **List** all the discarded files
- **Restore** files discarded under the current directory
- **Delete** discarded files permanently
- **Clean** all the discarded files permanently



## Finder

`conceal restore` and `conceal delete` use [skim](https://github.com/lotabout/skim) and [**fzf**](https://github.com/junegunn/fzf) (default) as finder.
You can choose either one with the `--finder` option whose value is also controlled by environment variable `CONCEAL_FINDER`.

> Value priority: `--finder` > `CONCEAL_FINDER`

### Finder options

`conceal` predefines some options of finder command to make an ergonomic interface:
`--multi --ansi --reverse --cycle --bind='ctrl-a:select-all,ctrl-r:toggle-all'`.
You can add more options you like via environment variable `FZF_DEFAULT_COMMAND`.

> fzf options reference: `man 1 fzf`

Key bindings:

| Key | Action |
| :- | :-: |
| `ctrl-a` | Select all items |
| `ctrl-r` | Inverse selection of all items |



## Installation

### Cargo

You need to install finder [skim](https://github.com/lotabout/skim#installation) or [fzf](https://github.com/junegunn/fzf#installation) before using **conceal**.

```bash
$ cargo install conceal
```

### AUR

```bash
$ paru -S conceal
```

or binary package:

```bash
$ paru -S conceal-bin
```



## Usage

There are two binaries: `cnc` and `conceal`.

`cnc` is to put files into recycle bin; `conceal` is to operate the recycle bin.

[![demo](https://asciinema.org/a/629369.svg)](https://asciinema.org/a/629369?speed=2)

**`Tab` is the multi-selection and multi-cancel key.**