Ente Auth - Alfred Workflow for Ente Exports

Easily integrate your Ente Auth with Alfred using this simple workflow to query your Ente Auth TOTP accounts.

The workflow uses Ente CLI to export your secrets from Ente Auth and then stashes them securely into the macOS Keychain.

📸 Shots

🚀 Setup

The Ente Auth CLI is required.

Homebrew (Recommended)

You can install the Ente CLI using Homebrew for a simpler and more automated setup. Run the following command in your terminal:

brew install ente-cli

Once installed, verify the installation:

ente version

Github Release (Optional)

To use the Ente Auth workflow, you'll need the Ente CLI. Follow the steps below to install it:

1. Visit the Ente CLI releases page.

2. Download the latest version for macOS.

3. Move the binary to /usr/local/bin and make it executable with the following commands:

   sudo mv /path/to/ente /usr/local/bin/ente
   sudo chmod +x /usr/local/bin/ente

Once installed, verify that it's working by running the following command in your terminal:

ente version

2. Configure Ente CLI

• Run ente account add to authenticate yourself with Ente CLI.
• You'll first be prompted for the app type. Enter auth.
• Next, you'll be asked for an export directory. You can choose any path you wish, but it must exist before you press return, else Ente CLI will not accept it.
• Finally, you'll be prompted to provide your Ente login credentials.

3. Install the Workflow

Download and open the workflow file from the latest release page.

Note

To ensure the workflow can import your accounts from Ente Auth, you'll need to define the "Ente Export Directory" when you add this workflow to Alfred. This path should be the same one you configured when adding your Ente account. To show the Ente CLI's configured export path, run ente account list and refer to the ExportDir value.

# Example of configured export path from `ente account list`
❯ ente account list
Configured accounts: 1
====================================
Email:     ente@domain.com
ID:        1111111111111111
App:       auth
ExportDir: /foo/bar/ente

Note: In the workflow preferences, Ente Export Directory refers to the exportDir value shown above.

---

📖 Usage Instructions

1. Launch Alfred

2. Import Your Data

   • To import your Ente Auth TOTP accounts, simply trigger the workflow by running ente import in Alfred.

3. Search for an Ente Auth TOTP account

   • To list all of your Ente Auth TOTP accounts, run ente in Alfred.
   • To search for a specific account, simply append a search string to the previous command. Example: ente GitHub
   • The search feature also supports loose search queries, matching words in the account name in any order.
     • For example "Docker Hub" will match with the queries "Docker Hub", "Hub", "Do Hu".

---

🛠 Local Development

Install/Update Dependencies

To set up your local environment, run the following command to install or update the necessary dependencies:

poetry install --only=main

Build the Alfred Workflow File

Once your environment is ready, use this command to build the workflow file:

python3 build.py

---

Making it Better 🤝

Feel free to open issues or submit pull requests.

Disclaimer

This project is not affiliated, associated, authorized, endorsed by, or in any way officially connected with Ente. The official Ente website can be found at https://ente.io. "Ente" as well as related names, marks, emblems and images are registered trademarks of their respective owners.