Skip to content

Commit 905fba2

Browse files
committed
Update the readme!
1 parent 28355be commit 905fba2

File tree

1 file changed

+67
-9
lines changed

1 file changed

+67
-9
lines changed

README.md

Lines changed: 67 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -1,11 +1,69 @@
1-
# wardenpy
2-
cli python password manager
1+
<div align="center">
2+
<hr />
33

4-
## First iteration
5-
thinking that only one user would use the tool
4+
# WardenPy
65

7-
[] - Fix the autentication logic
8-
[] - add migration logic to main inti logic
9-
[] - fix todo and warning notations
10-
[] - fix funtions return type to optimize the thing
11-
[] - add colors for all the funtions
6+
[![codecov](https://codecov.io/github/deepattic/wardenpy/graph/badge.svg?token=U6U8SOJUNW)](https://codecov.io/github/deepattic/wardenpy)
7+
[![License](https://img.shields.io/github/license/deepattic/wardenpy)](https://github.com/deepattic/wardenpy/blob/main/LICENSE)
8+
[![GitHub stars](https://img.shields.io/github/stars/deepattic/wardenpy)](https://github.com/deepattic/wardenpy/stargazers)
9+
[![GitHub issues](https://img.shields.io/github/issues/deepattic/wardenpy)](https://github.com/deepattic/wardenpy/issues)
10+
[![GitHub release](https://img.shields.io/github/v/release/deepattic/wardenpy)](https://github.com/deepattic/wardenpy/releases)
11+
12+
wardenpy is a **cli-password manager**, inspired by bitwarden and 1pass.
13+
14+
It uses the most modern and up-to-date hashing algorithms, such as argon 2, and encryption techniques, such as ChaCha20-Poly1305.
15+
16+
| [Getting started](#getting-started)
17+
[Installation](#installation) |
18+
19+
</div>
20+
21+
## Getting started
22+
23+
![Tutorial][tutorial]
24+
25+
Run With python :
26+
```sh
27+
wardenpy init [username] # Set up a SQLite database and create a new user named {username}.
28+
wardenpy -u [username] # Login with your username
29+
wardenpy -u [*] -p [password] # Login with your username and password.
30+
31+
wardenpy export # Export all the entries of a user
32+
33+
```
34+
## Installation
35+
36+
wardenpy can be installed in these easy steps:
37+
38+
1. **Manual Installation**
39+
40+
wardenpy runs on most major platforms.
41+
42+
<details>
43+
<summary>Linux / WSL</summary>
44+
45+
> Just clone the repo and install the requirements:
46+
>
47+
> ```sh
48+
> git clone --depth=1 https://www.github.com/deepattic/wardenpy
49+
> cd wardenpy
50+
> pip install -r requirements.txt
51+
> ```
52+
</details>
53+
54+
<details>
55+
<summary>macOS</summary>
56+
57+
> I just dont have an apple device if you have one plz consider putting a pull request :)
58+
59+
</details>
60+
61+
<details>
62+
<summary>Windows</summary>
63+
64+
> And i also dont have a windows pc if you have one plz consider putting a pull request :/
65+
</details>
66+
67+
68+
69+
[tutorial]: contrib/tutorial.webp

0 commit comments

Comments
 (0)