https://github.com/nicholaswilde/lastpass-clean
📜Bash scripts to help clean up a LastPass vault
https://github.com/nicholaswilde/lastpass-clean
bash bash-script lastpass-cli password-manager passwords
Last synced: 3 months ago
JSON representation
📜Bash scripts to help clean up a LastPass vault
- Host: GitHub
- URL: https://github.com/nicholaswilde/lastpass-clean
- Owner: nicholaswilde
- License: apache-2.0
- Created: 2022-05-19T01:40:26.000Z (about 3 years ago)
- Default Branch: main
- Last Pushed: 2022-05-23T04:28:40.000Z (about 3 years ago)
- Last Synced: 2025-01-22T22:29:35.047Z (4 months ago)
- Topics: bash, bash-script, lastpass-cli, password-manager, passwords
- Language: Shell
- Homepage:
- Size: 72.3 KB
- Stars: 0
- Watchers: 3
- Forks: 0
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Codeowners: .github/CODEOWNERS
Awesome Lists containing this project
README
# lastpass-clean
Bash scripts to help clean up a [LastPass][1] vault
> :warning: Warning: Theses scripts remove items from a LastPass vault! Use with cation!
## :rocket:Â TL;DR
```shell
brew install lastpass-cli jq whois
chmod +x check-urls.sh rm-dead-url-items.sh
./check-urls.sh dead-urls.csv
./rm-dead-url-items.sh dead-urls.csv
rm dead-urls.csv
```
## :framed_picture:Â Background
I have been using [LastPass][1] as my password manager for quite some time and now have over 1,000 items.
I have realized that a lot of my items haven't been used in quite some time and so I wanted to clean it up.
Going through all of the entries manually is a daunting task and so I decided to leverage [lastpass-cli][3] to automate the cleanup.
One cleanup task is to remove items to websites that no longer exist.
One way of doing this is to check if the `url` parameter is actually a dead url.
Sometime the sub domain isn't available anymore but the website still exists.
Another cleanup task is to rename the items. Since I am using the command line client more, I decided to replace spaces with
dashes and convert the names to lowercase to make it easier to work with the command prompt.
## :gear:Â Prerequisites
```shell
brew install lastpass-cli jq whois
# or
task deps
# or
brew install $(cat formulas)
```
## :scroll:Â Scripts
| Script | Description |
|-------------------------|---------------------------------------------------------|
| `check-urls.sh` | Check LastPass vault for dead urls |
| `rm-dead-url-items.sh` | Remove items with dead urls from LastPass vault |
| `check-names.sh` | Check LastPass vault for items that need to be renamed |
| `rename-items.sh` | Rename items from LastPass vault |
`check-urls.sh` checks each item for the following:
- Skips the item if no URL is set or is equal to `ns`
- Checks if the main domain exists with [`whois`][4]. It does not check the sub domain. It also does not handle urls
with more than one suffix (such as `co.uk`).
`check-names.sh` renames the files with the following changes:
- Remove `.com`, `.gov`, `.net`
- Replace spaces with dashes
- Remove trailing and leader white space
- Remove apostrophes
- Convert to lowercase
## :gear:Â Configuration
`check-names.sh` - groups can be ignred by changing the `IGNORE_GROUPS` array in the header of the file.
Be sure to put the names in double quotes with no commas in between
```bash
...
IGNORE_GROUPS=("Shared-Us" "Secure Notes")
...
```
## :floppy_disk:Â Backup
Be sure to backup the vault before using these scripts.
```shell
lpass export > backup.csv
# or
task backup
```
## :book:Â Usage
Make the scripts executable
```shell
chmod +x check-urls.sh rm-dead-url-items.sh check-names.sh rename-items.sh
```
### :link:Â Remove Dead URL Items
Check items for dead urls and export them to a csv file
```shell
./check-urls.sh dead-urls.csv
# or
task urls
```
Manually review the csv file to confirm that there aren't any items that should not be deleted.
Remove the items with dead urls.
```shell
./rm-dead-url-items.sh dead-urls.csv
# or
task rm
```
Remove the dead url csv file.
```shell
rm dead-urls.csv
```
### :open_file_folder:Â Rename Items
Rename items and export them to a csv file
```shell
./check-names.sh rename.csv
# or
task names
```
Manually review the csv file to confirm that there aren't any items that should not be renamed.
Rename items that need to be renamed.
```shell
./rename-items.sh rename.csv
# or
task rename
```
Remove the rename csv file.
```shell
rm rename.csv
```
## :robot:Â Task
This repository uses [`go-task`][5] to automate tasks.
> :warning: Warning: `task clean` removes all `csv` files including `backup.csv`
```shell
# Print a list of tasks
task
```
## :balance_scale:Â License
[Apache 2.0 License](../LICENSE)
## :pencil:Â Author
This project was started in 2022 by [Nicholas Wilde][2].
[1]: https://www.lastpass.com/
[2]: https://github.com/nicholaswilde/
[3]: https://github.com/lastpass/lastpass-cli/
[4]: https://manpages.debian.org/stretch/whois/whois.1.en.html
[5]: https://taskfile.dev/#/