Skip to content

Commit 77ec9ac

Browse files
committed
Add Readme
1 parent fd64e03 commit 77ec9ac

File tree

1 file changed

+81
-0
lines changed

1 file changed

+81
-0
lines changed

README.md

Lines changed: 81 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,81 @@
1+
<div align="center">
2+
<img src="assets/logo.png"/>
3+
<h2> TUI for managing wifi </h2>
4+
</div>
5+
6+
## 💡 Prerequisites
7+
8+
A Linux based OS with [iwd](https://iwd.wiki.kernel.org/) and [ConnMan](https://git.kernel.org/pub/scm/network/connman/connman.git/about/) installed.
9+
10+
## 🚀 Installation
11+
12+
### 📥 Binary release
13+
14+
You can download the pre-built binaries from the release page [release page](https://github.com/pythops/impala/releases)
15+
16+
### 📦 crates.io
17+
18+
You can install `impala` from [crates.io](https://crates.io/crates/impala)
19+
20+
```shell
21+
cargo install impala
22+
```
23+
24+
### ⚒️ Build from source
25+
26+
Run the following command:
27+
28+
```shell
29+
git clone https://github.com/pythops/impala
30+
cd impala
31+
cargo build --release
32+
```
33+
34+
This will produce an executable file at `target/release/impala` that you can copy to a directory in your `$PATH`.
35+
36+
## 🪄 Usage
37+
38+
### Global
39+
40+
`Tab`: Switch between different sections.
41+
42+
`j` or `Down` : Scroll down.
43+
44+
`k` or `Up`: Scroll up.
45+
46+
`s`: Start scanning.
47+
48+
`Space`: Connect/Disconnect the network.
49+
50+
`?`: Show help.
51+
52+
`esc`: Dismiss the help pop-up.
53+
54+
`q` or `ctrl+c`: Quit the app.
55+
56+
### Device
57+
58+
`i`: Show device information.
59+
60+
### Known Networks
61+
62+
`d`: Remove the network from the known networks list.
63+
64+
## Custom keybindings
65+
66+
Keybindings can be customized in the config file `$HOME/.config/impala/config.toml`
67+
68+
```toml
69+
toggle_scanning = "s"
70+
toggle_connect = " "
71+
72+
[device]
73+
infos = "i"
74+
75+
[known_network]
76+
remove = "d"
77+
```
78+
79+
## ⚖️ License
80+
81+
GPLv3

0 commit comments

Comments
 (0)