2019-03-13 18:38:12 +00:00
# UTPass
A password management app for Ubuntu Touch aiming to be compatible with [ZX2C4’ ](https://www.passwordstore.org/ ) the standard unix password manager.
# Building
* Install [clickable ](https://github.com/bhdouglass/clickable ).
2019-03-13 18:49:34 +00:00
* Clone this repo : ```git clone --recursive https://github.com/qrouland/UTPass```
2019-03-22 15:07:04 +00:00
* Move to app directory: ```cd UTPass```
* Build third parties : ```clickable third_build```
* Build the app : ```clickable```
2019-03-13 18:38:12 +00:00
For more options/details see the [clickable documentation ](http://clickable.bhdouglass.com/en/latest/index.html )
2019-03-15 16:53:40 +00:00
## Custom clickable command
2019-03-22 15:07:04 +00:00
* ```clickable third_build ``` : build third dependencies for arm architecture
* ```clickable third_build_d ``` : build third dependencies for amd64 architecture
* ```clickable third_clean ``` : clean third parties
* ```clickable style ``` : reformat the code (Required [astyle ](astyle.sourceforge.ne ) & [qmlfmt ](https://github.com/jesperhh/qmlfmt ) installed)
2019-03-15 16:53:40 +00:00
2019-03-13 18:38:12 +00:00
# Contributing
2019-03-21 23:11:36 +00:00
Any contributions are welcome using the github issue & pull request system.
Please try to respect the code style format by running ```clickable style``` before committing.
2019-03-13 18:38:12 +00:00
# Features
The goal is to be closest possible of the features offer by [ZX2C4’ ](https://www.passwordstore.org/ ):
---
- [ ] pass init [--path=subfolder,-p subfolder] gpg-id...
Initialize new password storage and use gpg-id for encryption.
Selectively reencrypt existing passwords using new gpg-id.
- [ ] Interactive dialog to init a new password storage
- [ ] Support subfolder
- [ ] Support reencrypt
---
- [x] pass [ls] [subfolder]
List passwords.
- [x] UI allowing to navigate through the password store showing the available passwords
---
2019-03-21 23:11:36 +00:00
- [ ] pass find pass-names...
2019-03-13 18:38:12 +00:00
List passwords that match pass-names
- [ ] Search bar allowing searchs by pass-names
---
- [ ] pass [show] [--clip[=line-number],-c[line-number]] pass-name
Show existing password and optionally put it on the clipboard.
If put on the clipboard, it will be cleared in 45 seconds.
- [ ] Click on a pass show the password
- [ ] Add option to put the password to the clipboard
- [ ] Clearing clipboard after 45 secs
- [ ] Line number option ???
---
- [ ] pass grep search-string
Search for password files containing search-string when decrypted.
- [ ] TBD
---
- [ ] pass insert [--echo,-e | --multiline,-m] [--force,-f] pass-name
Insert new password. Optionally, echo the password back to the console
during entry. Or, optionally, the entry may be multiline. Prompt before
overwriting existing password unless forced.
- [ ] TBD
---
- [ ] pass edit pass-name
Insert a new password or edit an existing password using editor.
- [ ] TBD
---
- [ ] pass generate [--no-symbols,-n] [--clip,-c] [--in-place,-i | --force,-f] pass-name [pass-length]
Generate a new password of pass-length (or 25 if unspecified) with optionally no symbols.
Optionally put it on the clipboard and clear board after 45 seconds.
Prompt before overwriting existing password unless forced.
Optionally replace only the first line of an existing file with a new password.
- [ ] TBD
---
- [ ] pass rm [--recursive,-r] [--force,-f] pass-name
Remove existing password or directory, optionally forcefully.
- [ ] TBD
---
- [ ] pass mv [--force,-f] old-path new-path
Renames or moves old-path to new-path, optionally forcefully, selectively reencrypting.
- [ ] TBD
---
- [ ] pass cp [--force,-f] old-path new-path
Copies old-path to new-path, optionally forcefully, selectively reencrypting.
2019-03-21 23:11:36 +00:00
2019-03-13 18:38:12 +00:00
- [ ] TBD
---
- [ ] pass git git-command-args...
If the password store is a git repository, execute a git command
specified by git-command-args.
- [ ] TBD
---
- [ ] pass help
Show this text.
2019-03-21 23:11:36 +00:00
2019-03-13 18:38:12 +00:00
- [ ] TBD
---
- [ ] pass version
Show version information.
- [ ] TBD
---
# License
Copyright (C) 2007 Free Software Foundation, Inc. < https: / / fsf . org / >
This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program. If not, see < http: / / www . gnu . org / licenses / > .
2019-03-15 16:53:40 +00:00
# Useful Links
Some useful links related to UTpass development :
* [Ubports ](https://ubports.com/ ) : Ubuntu Touch Community
* [ZX2C4’ ](https://www.passwordstore.org/ ) : the standard unix password manager.
2019-03-21 23:11:36 +00:00
* [Clickable ](https://github.com/bhdouglass/clickable ) : Compile, build, and deploy Ubuntu Touch click packages
2019-03-15 16:53:40 +00:00
* [Gpgme ](https://www.gnupg.org/software/gpgme/index.html ) : GnuPG Made Easy (GPGME) is a library designed to make access to GnuPG easier for applications
