authy

README

Authy

Authy Commandline Tool mainly for Alfred Workflow

Installation

Pre-built binaries are available from the releases page.

Alternatively, it can be compiled from source, which requires Go 1.20.3 or newer:

go get github.com/momaek/authy

To use it

1. Rename authy-darwin-amd64 or authy-darwin-arm64 to authy
2. Move authy to your local $PATH
3. Run authy account. The command will prompt you for your phone number country code (e.g. 1 for United States) and your phone number. This is the number that you used to register your Authy account originally.
4. If the program identifies an existing Authy account, it will send a device registration request using the push method. This will send a push notification to your existing Authy apps (be it on Android, iOS, Desktop or Chrome), and you will need to respond that from your other app(s).
5. If the device registration is successful, the program will save its authentication credential (a random value) to $HOME/.authy.json for further uses.
6. Run authy refresh. The command will prompt you for your Authy backup password. This is required to decrypt the TOTP secrets for the next step.
7. Run authy fuzz {query} will get an AlfredWorkflow style output
8. Download AlfredWorkflow Authy.alfredworkflow
9. Double click Authy.alfredworkflow or manual import from Alfred
10. Open Alfred and type at {query}

Optional Configuration

By default, the authy config file (.authy.json) and cache (.authy.cache) are stored in $HOME. A custom configuration directory can be set with the environment variable $AUTHY_ROOT

e.g.

export AUTHY_ROOT=~/.dotfiles/secrets/authy

the example above would create the config file ~/.dotfiles/secrets/authy/.authy.json

Attention

To use this tool, you should enable Allow Multi-Device in your Authy App

e.g.

Update

2021-03-11

Default show all results.

FAQ

Telegram Group

TG

Q: Don't work/Don't show result

A: You may update Workflow Configuration(Environment Variables). Add Name/Value:

Name	Value
PATH	/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin:{your_binaryfile_path}

Q: Default don't show all results

A: Switch to Argument Optional

Documentation

Overview

Copyright © 2020 momaek17@gmail.com

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.