59 lines
2.2 KiB
Markdown
59 lines
2.2 KiB
Markdown
# nc_password_client
|
|
|
|
Command line client (CLI) for the Nextcloud Passwords app.
|
|
Manage your password and import them from [Password Store](https://www.passwordstore.org/).
|
|
|
|
## Requirements
|
|
|
|
See requirements.txt
|
|
|
|
## Installation
|
|
|
|
### Linux
|
|
|
|
To install for example in your ~/.local/bin folder:
|
|
```bash
|
|
./install.sh --destination ~/.local/bin
|
|
```
|
|
|
|
To install system-wide:
|
|
```bash
|
|
sudo ./install.sh --destination /usr/local/bin
|
|
```
|
|
|
|
Change your configuration file in "${HOME}/.config/nc_password_client.conf" (see the example in the config folder).
|
|
|
|
## Usage
|
|
|
|
Usage: nc_password_client.sh [OPTIONS] COMMAND [ARGS]...
|
|
|
|
### Options:
|
|
| option | parameters | description |
|
|
| ------ | ---------- | ----------- |
|
|
| -d, --debug-level | [CRITICAL|ERROR|WARNING|INFO|DEBUG|NOTSET] | Set the debug level for the standard output.|
|
|
| -l, --log-file | TEXT | File to store all debug messages.|
|
|
| -H, --host | TEXT | Nextcloud host name [required]|
|
|
| -u, --user | TEXT | Nextcloud user name [required]|
|
|
| -a, --api-token | TEXT | Nextcloud user's application token [required]|
|
|
| -p, --cse-password | TEXT | Nextcloud user's end-to-end encryption password|
|
|
| -t, --timeout | INTEGER | Timeout for HTTPS requests|
|
|
| -c, --cache-duration | INTEGER | Number of seconds to hold the list of passwords|
|
|
| -P, --https-proxy | TEXT | HTTPS proxy to use to connect to the Nextcloud instance|
|
|
| --config | FILE | Read configuration from FILE.|
|
|
| --help || Show this message and exit.|
|
|
|
|
### Commands:
|
|
| command | description |
|
|
| ------------------------ | ----------- |
|
|
| create-password |Create a password|
|
|
| create-passwords-folder |Create a password folder|
|
|
| delete-all-passwords |Delete all passwords|
|
|
| delete-password |Delete a password|
|
|
| delete-passwords-folder |Delete a password folder|
|
|
| list-passwords-folders |List all password folders|
|
|
| ls |List all password|
|
|
| migrate-pass |Migrate Password Store passwords to Nextcloud...|
|
|
| remove-duplicates |Remove duplicate passwords|
|
|
| show |Show a single password|
|
|
|
|
Use --help after the command to get more details of it's options
|