blob: d99fdf19cbabf192a5651e72de99b0ab94df2d43 (
plain)
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
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
|
[![Linux build](https://github.com/kamiyaa/joshuto/actions/workflows/rust-linux-main.yml/badge.svg)](https://github.com/kamiyaa/joshuto/actions/workflows/rust-linux-main.yml)
[![MacOS build](https://github.com/kamiyaa/joshuto/actions/workflows/rust-macos-main.yml/badge.svg)](https://github.com/kamiyaa/joshuto/actions/workflows/rust-macos-main.yml)
# joshuto
[ranger](https://github.com/ranger/ranger)-like terminal file manager written in Rust.
![Alt text](screenshot.png?raw=true "joshuto")
## Dependencies
- [cargo](https://github.com/rust-lang/cargo/)
- [rustc](https://www.rust-lang.org/)
- xsel/xclip/wl-clipboard (optional, for clipboard support)
Also see [Cargo.toml](Cargo.toml)
## Building
```
~$ cargo build
```
## Installation
#### For single user
```
~$ cargo install --path=. --force
```
#### System wide
```
~# cargo install --path=. --force --root=/usr/local # /usr also works
```
#### Packaging status
##### Fedora ([COPR](https://copr.fedorainfracloud.org/coprs/atim/joshuto/))
```
sudo dnf copr enable atim/joshuto -y
sudo dnf install joshuto
```
##### Arch ([AUR](https://aur.archlinux.org))
* [release](https://aur.archlinux.org/packages/joshuto)
```
[yay/paru] -S joshuto
```
* [build from source](https://aur.archlinux.org/packages/joshuto-git)
```
[yay/paru] -S joshuto-git
```
## Usage
```
~ $ joshuto
```
## Configuration
Check out [wiki/Configuration](https://github.com/kamiyaa/joshuto/wiki/Configuration) for details
and [config/](config/) for examples
#### [joshuto.toml](config/joshuto.toml)
- general configurations
#### [keymap.toml](/config/keymap.toml)
- for keybindings, please take a look at [src/util/key_mapping.rs](/src/util/key_mapping.rs#L18) for non-printable keys
- for commands, please take a look at [src/commands/commands.rs](/src/commands/commands.rs#L139)
#### [mimetype.toml](/config/mimetype.toml)
- for opening files with applications
#### [theme.toml](/config/theme.toml)
- color customizations
## Contributing
See [wiki/Contributing](https://github.com/kamiyaa/joshuto/wiki/Contributing)
## Features/Bugs
Please create an issue :)
## TODOs
- [x] Migrate to [tui-rs](https://github.com/fdehau/tui-rs)
- [x] Tab support
- [x] Ctrl/Shift/Alt support
- [x] Asynch File IO (cut/copy/paste)
- [ ] Built-in command line (in progress)
- Currently implementation is kind of janky
- [ ] File previews (in progress)
- Waiting for tui-rs to support parsing ANSI color codes
- [ ] Tab autocomplete (in progress)
- [x] Bulk rename
|