https://github.com/gyaneesh/alfred-totp

Alfred 2-factor authentication workflow with steamguard support.
https://github.com/gyaneesh/alfred-totp

alfred alfred-4 alfred-workflow oathtool otp steamguard

Last synced: 4 months ago
JSON representation

Alfred 2-factor authentication workflow with steamguard support.

• Host: GitHub
• URL: https://github.com/gyaneesh/alfred-totp
• Owner: gyaneesh
• License: mit
• Created: 2019-10-12T17:39:11.000Z (about 6 years ago)
• Default Branch: master
• Last Pushed: 2020-01-27T16:29:20.000Z (over 5 years ago)
• Last Synced: 2025-06-13T09:06:12.338Z (4 months ago)
• Topics: alfred, alfred-4, alfred-workflow, oathtool, otp, steamguard
• Language: Crystal
• Homepage:
• Size: 1.74 MB
• Stars: 11
• Watchers: 1
• Forks: 2
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          


  

    

  

  


  Alfred TOTP Workflow





  Obtain one time passwords from alfred.

[![Version](https://img.shields.io/github/tag/iganeshk/alfred-totp.svg?style=flat-square&label=release)](https://github.com/iganeshk/alfred-totp/tags)

[![Build Status](https://travis-ci.com/iganeshk/alfred-totp.svg?branch=master)](https://travis-ci.com/iganeshk/alfred-totp)

[![Issues](https://img.shields.io/github/issues/iganeshk/alfred-totp.svg?style=flat-square)](https://github.com/iganeshk/alfred-totp/issues)

[![MIT License](https://img.shields.io/badge/license-MIT-blue.svg?style=flat-square)](LICENSE.md)



## Requirements

* [AlfredApp](https://www.alfredapp.com/) (Alfred 3 & 4 tested)

* [Brew](https://brew.sh/) package manager

* Python3 (SteamGuard OTP support)

## Installation

`$ brew install oauthtool`

Now [download](https://github.com/iganeshk/alfred-totp/releases/latest) the latest workflow and install it.

## Obtaining your TOTP secrets

You could either export it from the existing applications you're using or generate a new secret from the website's user control panel.

For SteamGuard OTP, follow [this guide](https://github.com/SteamTimeIdler/stidler/wiki/Getting-your-'shared_secret'-code-for-use-with-Auto-Restarter-on-Mobile-Authentication) to obtain your secret key.

Then insert your totp secret codes into the macOS keychain `alfred-totp.keychain` like so:

```

$ security -i

> create-keychain alfred-totp.keychain

> set-keychain-settings alfred-totp.keychain

> add-generic-password -a alfred-totp -s "name of service" -w "totp secret" alfred-totp.keychain

> # repeat above command as needed, crtl-c to quit.

```

## Usage

In alfred just type `otp` then start typing the name of your service. 



The TOTP code will be pasted to the top most app by default and copied to the clipboard on option return.



If you would like to display all the service's passwords at once, configure the object (script filter) of alfred-totp's workflow as below





* Note: Icons reflected in the results are located at workflow's icon directory and follow service name as entered in the keychain.

## Thanks

Thanks to [waynehoover](https://github.com/waynehoover/) and [aria.ia](https://www.aria.ai/blog/posts/storing-secrets-with-keychain.html) for the code on how to list items from macOS keychain.