BenjaminOddou / alfred-dashlane

πŸ” Manage your Dashlane vault
MIT License
11 stars 1 forks source link
alfred-workflow cli dashlane password-manager python python3
logo-dark logo-light

made with heart by Benjamin Oddou saythanks Python 3+

Welcome to the Alfred Dashlane repository: An Alfred Workflow ✨

βœ… Prerequisites

🏎️ Dashlane CLI

This workflow uses the Dashlane CLI provided by the Dashlane team.

This workflow doesn't hold or register any private data. No sensible data (password, OTP) are exposed directly to Alfred. If you want to know more on how data is stored on the computer, check this README.

This workflow doesn't allow to update or upload items to the Dashlane vault. You can't connect multiple accounts neither. This is a limitation of the Dashlane CLI for now.

⬇️ Installation

  1. Download the workflow
  2. Double click the .alfredworkflow file to install

🧰 Setup the workflow

  1. Install Python 3 or above. Check your version with :
python --version
  1. Install the Dashlane CLI binary using this guide.

πŸ§™β€β™‚οΈ Invoke the workflow

There is 2 flows in this workflow :

  1. The first one allows you to display all the credentials in your Dashlane vault. It can be triggered by writing pdash keyword.
  2. The second one allows you to display your OTPs from you Dashlane vault. It can be triggered by writing odash keyword.

You can edit these triggers (flagged with a πŸ•ΉοΈ symbol) in the user configuration panel.

πŸ€– Usage of the workflow

Setup variables

  1. πŸ‘€ Login correspond to your address mail link to your Dashlane account. It is required to start the workflow.

  2. πŸ«₯ Icognito mode allows you to hide partially your login (mail address / user name). If ticked :

incognito_yes

if unticked :

incognito_no

  1. πŸ”₯ Allow cache enables the workflow to save a backbone (no confidentital data are stored) of your Dashlane vault as JSON files under the alfred_workflow_cache folder (~/Library/Caches/com.runningwithcrayons.Alfred/Workflow Data/com.benjamino.dashlane). This speeds up the response time.

  2. 🎷 Notification sound allows you to personalize the sound of the workflow notification.

Get your one-time password (OTP) code by mail

Note that if you have enabled the two steps authetication for your Dashlane account, you can skip this section.

In order to connect to your Dashlane account, you'll need an OTP. If you haven't configure the two steps authentication on your Dashlane account, just hit enter to receive the 6 digits code by mail.

otp_mail

Sync your Dashlane account

❗ You need an internet connexion to complete this action.

Hit enter, input your master password and finally the OTP (provided via mail or by your 2FA app). If you are already connected you can press enter to refresh the data.

Note that a sync is already done once per hour by default - see Dashlane CLI docs.

You should have received a βœ… Success ! notification and a mail saying that the connection was successfull.

success_sync_notif

success_sync

Download favicons

❗ You need an internet connexion to complete this action.

Hit enter to download all favicons link to your accounts. Wait few seconds / minutes to receive the below notification. You can see icons under the alfred_workflow_cache folder (~/Library/Caches/com.runningwithcrayons.Alfred/Workflow Data/com.benjamino.dashlane).

notif_icons

Reset local data

If you want to log out and / or remove all local data holds by the Dashlane CLI, hit enter. Confirm your action by inputing yes to the alfred search bar.

confirm_delete

Manage connected devices

Remove access to devices connected to your vault. Press βŒ˜β†©οΈŽ on a device to remove it. You have the possibility to remove all devices (including current device) and other devices (excluding current device).

devices

Get passwords and OTPs

Use pdash / odash keyword to launch these flows.

Search a password / OTP by typing its title (custom name or website link to the credentials).

  1. Press β†©οΈŽ to copy the password. You should see the below notification popping.
  2. Press βŒ˜β†©οΈŽ to copy the login (No Login means that you only register a password for this element).
  3. Press βŒ₯β†©οΈŽ to open the url (No URL means that no website is link to this credentials).
  4. Press β‡§β†©οΈŽ to inject credentials to frontmost application (it will print login + password separated by a β‡₯)

βš–οΈ License

MIT License Β© Benjamin Oddou