Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/stanzhai/goldenpassport
A native implementation of Google Authenticator for Mac based on Swift
https://github.com/stanzhai/goldenpassport
authenticator google mac swift
Last synced: 1 day ago
JSON representation
A native implementation of Google Authenticator for Mac based on Swift
- Host: GitHub
- URL: https://github.com/stanzhai/goldenpassport
- Owner: stanzhai
- Created: 2017-02-25T07:54:51.000Z (almost 8 years ago)
- Default Branch: master
- Last Pushed: 2022-07-13T07:53:48.000Z (over 2 years ago)
- Last Synced: 2025-02-12T16:12:29.067Z (8 days ago)
- Topics: authenticator, google, mac, swift
- Language: Objective-C
- Homepage:
- Size: 5.02 MB
- Stars: 399
- Watchers: 16
- Forks: 60
- Open Issues: 14
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# GoldenPassport
A native implementation of Google Authenticator for Mac based on Swift3.
# Screenshot
# Features
- Recognize OTPAuth URL from a QRCode image
- Authentication code management
- Support RESTful API to obtain the verification code
- Use a global hot key(`Shift+Cmd+[0-9]`) to direct fill out the verification code
- Click an auth-menu to copy the verification code to the `PasteBoard`
- Export/Import authentication codes
# How to use
1. Download the latest version of GoldenPassport from the [releases](https://github.com/stanzhai/GoldenPassport/releases) page.
2. Unzip `GoldenPassport.zip` and put `GoldenPassport.app` to your `Application` folder then start it.
3. Add an auth URL from the status menu.
Or you can install if from brew cask
```
brew install --cask goldenpassport
```
Now, you can get the verification code by:
- From the status menu, copy the verification by clicking an auth-menu
- Use a global hot key(`Shift+Cmd+[0-9]`) to direct fill out the verification code
You can also use the RESTful API if you want to get the verification code from a shell script by the following way:
```
# you can get the url from `http://localhost:17304/`
code=$(curl 'http://localhost:17304/code/[email protected]')
# ues the verification code
echo $code
```
# Building
GoldenPassport uses `cocoapods` as the package manager tool, you should install it first.
1. `pod install` to install dependencies
2. Open `GoldenPassport.xcworkspace` with Xcode to build
# Todo
- Support auto startup with system
- i18n
# Resources
- [Swift Resources](https://developer.apple.com/swift/resources/)
- [macOS Development Tutorials](https://www.raywenderlich.com/category/macos)
- [google-authenticator](https://github.com/google/google-authenticator)
- [WeatherBar](http://footle.org/WeatherBar/)
- [swifter](https://github.com/httpswift/swifter)